From a54ee392602c49638650a91abe1f811492cf2aab Mon Sep 17 00:00:00 2001 From: Dimitri Sokolyuk Date: Fri, 5 Oct 2012 17:01:11 +0000 Subject: Mackapar Suspended Particle Exciter Display, Rev 3 (SPED-3) --- doc/sped-3.txt | 103 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 103 insertions(+) create mode 100644 doc/sped-3.txt diff --git a/doc/sped-3.txt b/doc/sped-3.txt new file mode 100644 index 0000000..3b4e196 --- /dev/null +++ b/doc/sped-3.txt @@ -0,0 +1,103 @@ + + + + .!. + !!!!!. + . '!!!!!. + .!!!. '!!!!!. + .!!!!!!!. '!!!!!. + .!!!!!!!!!' .!!!!!!!. + '!!!!!!!' .!!!!!!!!!' + '!!!!!. '!!!!!!!' + '!!!!!. '!!!' + '!!!!!. ' + '!!!!! + '!' + + + M A C K A P A R M E D I A + + + + + + + .---------------------. +----! DCPU-16 INFORMATION !----------------------------------------------------- + '---------------------' + +Name: Mackapar Suspended Particle Exciter Display, Rev 3 (SPED-3) +ID: 0x42babf3c, version: 0x0003 +Manufactorer: 0x1eb37e91 (MACKAPAR) + + + + .-------------. +----! DESCRIPTION !------------------------------------------------------------- + '-------------' + +The Mackapar Suspended Particle Exciter Display, Rev 3 ("the device") is a 3D +vector display unit. Straight lines are drawn between consecutive vertices in a +constant loop, with customizable colors per vertex. The effect is similar to a +free floating 3D model. +The area of the projected model is about 1x1x1 meters, and projection occurs +1.5 meters above the device. +The emitters are capable to rotate at 50 degrees per second, allowing for easy +animation of projected models. +Up to 65535 lines may be projected, but severe flickering occurs if more than +100 lines are projected. + + + + .--------------------. +----! INTERRUPT BEHAVIOR !------------------------------------------------------ + '--------------------' + +A, B, C, X, Y, Z, I, J below refer to the registers on the DCPU + +A: Behavior: + +0 Poll device. Sets B to the current state (see below) and C to the last error + since the last device poll. + +1 Map region. Sets the memory map offset to X, and the total number of vertices + to render to Y. See below for the encoding information. + +2 Rotate device. Sets the target rotation for the device to X%360 degrees. + + + + .-----------------. +----! VERTEX ENCODING !--------------------------------------------------------- + '-----------------' + +Each vertex occupies one word of information in the main DCPU RAM. Each word +is encoded as (in LSB-0 format): + CZZZZZYYYYYXXXXX +Where XXXXX is the X-coordinate of the vertex, YYYYY is the Y-coordinate, ZZZZZ +is the Z-coordinate, and C is color, where 0 is green and 1 is red. + + + + .-------------. +----! STATE CODES !------------------------------------------------------------- + '-------------' + +0x0000 STATE_NO_DATA No vertices queued up, device is in stand-by +0x0001 STATE_RUNNING The device is projecting lines +0x0002 STATE_TURNING The device is projecting lines and turning + + + + .-------------. +----! ERROR CODES !------------------------------------------------------------- + '-------------' + +0x0000 ERROR_NONE There's been no error since the last poll. +0xffff ERROR_BROKEN There's been some major software or hardware problem, + try turning off and turning on the device again. + + + + COPYRIGHT 1988 MACKAPAR MEDIA ALL RIGHTS RESERVED DO NOT DISTRIBUTE + -- cgit v1.2.3