1.  
  2.  
  3.  
  4. .!.
  5. !!!!!.
  6. . '!!!!!.
  7. .!!!. '!!!!!.
  8. .!!!!!!!. '!!!!!.
  9. .!!!!!!!!!' .!!!!!!!.
  10. '!!!!!!!' .!!!!!!!!!'
  11. '!!!!!. '!!!!!!!'
  12. '!!!!!. '!!!'
  13. '!!!!!. '
  14. '!!!!!
  15. '!'
  16.  
  17.  
  18. M A C K A P A R M E D I A
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25. .---------------------.
  26. ----! DCPU-16 INFORMATION !-----------------------------------------------------
  27. '---------------------'
  28.  
  29. Name: Mackapar Suspended Particle Exciter Display, Rev 3 (SPED-3)
  30. ID: 0x42babf3c, version: 0x0003
  31. Manufactorer: 0x1eb37e91 (MACKAPAR)
  32.  
  33.  
  34.  
  35. .-------------.
  36. ----! DESCRIPTION !-------------------------------------------------------------
  37. '-------------'
  38.  
  39. The Mackapar Suspended Particle Exciter Display, Rev 3 ("the device") is a 3D
  40. vector display unit. Straight lines are drawn between consecutive vertices in a
  41. constant loop, with customizable colors per vertex. The effect is similar to a
  42. free floating 3D model.
  43. The area of the projected model is about 1x1x1 meters, and projection occurs
  44. 1.5 meters above the device.
  45. The emitters are capable to rotate at 50 degrees per second, allowing for easy
  46. animation of projected models.
  47. Up to 65535 lines may be projected, but severe flickering occurs if more than
  48. 100 lines are projected.
  49.  
  50.  
  51.  
  52. .--------------------.
  53. ----! INTERRUPT BEHAVIOR !------------------------------------------------------
  54. '--------------------'
  55.  
  56. A, B, C, X, Y, Z, I, J below refer to the registers on the DCPU
  57.  
  58. A: Behavior:
  59.  
  60. 0 Poll device. Sets B to the current state (see below) and C to the last error
  61. since the last device poll.
  62.  
  63. 1 Map region. Sets the memory map offset to X, and the total number of vertices
  64. to render to Y. See below for the encoding information.
  65.  
  66. 2 Rotate device. Sets the target rotation for the device to X%360 degrees.
  67.  
  68.  
  69.  
  70. .-----------------.
  71. ----! VERTEX ENCODING !---------------------------------------------------------
  72. '-----------------'
  73.  
  74. Each vertex occupies one word of information in the main DCPU RAM. Each word
  75. is encoded as (in LSB-0 format):
  76. CZZZZZYYYYYXXXXX
  77. Where XXXXX is the X-coordinate of the vertex, YYYYY is the Y-coordinate, ZZZZZ
  78. is the Z-coordinate, and C is color, where 0 is green and 1 is red.
  79.  
  80.  
  81.  
  82. .-------------.
  83. ----! STATE CODES !-------------------------------------------------------------
  84. '-------------'
  85.  
  86. 0x0000 STATE_NO_DATA No vertices queued up, device is in stand-by
  87. 0x0001 STATE_RUNNING The device is projecting lines
  88. 0x0002 STATE_TURNING The device is projecting lines and turning
  89.  
  90.  
  91.  
  92. .-------------.
  93. ----! ERROR CODES !-------------------------------------------------------------
  94. '-------------'
  95.  
  96. 0x0000 ERROR_NONE There's been no error since the last poll.
  97. 0xffff ERROR_BROKEN There's been some major software or hardware problem,
  98. try turning off and turning on the device again.
  99.  
  100.  
  101.  
  102. COPYRIGHT 1988 MACKAPAR MEDIA ALL RIGHTS RESERVED DO NOT DISTRIBUTE