aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDimitri Sokolyuk <demon@dim13.org>2012-10-05 17:01:11 +0000
committerDimitri Sokolyuk <demon@dim13.org>2012-10-05 17:01:11 +0000
commita54ee392602c49638650a91abe1f811492cf2aab (patch)
tree75129b82fe9aaca53053999f23e97e2979e72a6b
parentdd2d56fd3ba069162189e4a26418edaf65064d55 (diff)
Mackapar Suspended Particle Exciter Display, Rev 3 (SPED-3)
-rw-r--r--doc/sped-3.txt103
1 files changed, 103 insertions, 0 deletions
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
+