home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / STFORMAT / STF40A.MSA / STOS_STE / STOS_STE.DOC < prev   
Encoding:
Text File  |  1992-09-06  |  5.4 KB  |  196 lines
  1.  
  2.  
  3. The STOS STE Extension
  4.  
  5. By Asa Burrows
  6.  
  7. The New STOS STE Commands :
  8.  
  9.  
  10. x = STE
  11.  
  12. This function returns 1 if the machine is an STE or 0 if it isn't. You
  13. can test to see if it's an STE or not and adjust your game to suit,
  14. giving STE owners the extra features but still making the program
  15. compatible with all STs.
  16.  
  17.  
  18. Joysticks
  19.  
  20. Your STE now has the ability to use up to six of the little wagglers.
  21.  
  22. x= LSTICK (j)
  23. Returns the current status of the joystick's left
  24. position. The value x holds either -1 if the joystick is in the left
  25. position or zero if it isn't. You can access up to six joysticks, j
  26. holds the number of the stick you want, one to six.
  27.  
  28. The following functions work exactly the same way for the other
  29. directions and the <fire> button.
  30.  
  31. x= RSTICK (j) right
  32. x= USTICK (j) up
  33. x= DSTICK (j) down
  34. x= FSTICK (j) fire
  35.  
  36. To access joysticks one & two you need to use these other
  37. commands.
  38.  
  39. STICKS ON
  40. This command activates the interrupt routine for twin joysticks
  41. control on the ST and STE, it also disables the mouse.
  42.  
  43. STICKS OFF
  44. This de-activates the interrupt routine and reactivates the
  45. mouse.
  46.  
  47. The new extension is completely compatible with the twin sticks
  48. extension, so if you have that you can use the same commands without
  49. any bother. They have been included in the STE extension to maintain
  50. compatibility.
  51.  
  52. x =STICK1 and x =STICK2
  53.  
  54. Returns the status of joysticks 1 and 2 respectively. The variable
  55. holds one byte laid out as follows. This is a bit of a bind and it's
  56. better to stick with the easier joystick commands.
  57.  
  58.        Bit     description
  59.  
  60.        0       UP      if bit set
  61.        1       DOWN    if bit set
  62.        2       LEFT    if bit set
  63.        3       RIGHT   if bit set
  64.        4       UNUSED
  65.        5       UNUSED
  66.        6       UNUSED
  67.        7       FIRE    if bit set
  68.  
  69. Light Gun/Pen
  70.  
  71. If you've a light gun or pen you can now write a shoot-'em-up for it.
  72.  
  73. x =LIGHT X and y =LIGHT Y
  74.  
  75. These two commands return the x and y co-ordinates of your gun or pen
  76. when the <fire> button is pressed and holds it until it's pressed
  77. again. You can check the button using the FSTICK (3) command because
  78. the To check the <fire> button use the FSTICK (3) command, the button
  79. is returned as joystick three.
  80.  
  81.  
  82. Extended colour palette
  83.  
  84. The STE has a palette of 4096 colours rather than an ST's 512.
  85.  
  86. E PALETTE $RGB,$RGB,...(up to 16 colour values)
  87.  
  88. This command works exactly as the PALETTE command in STOS,
  89. except that it uses a hex number for the colour values. Hex uses base
  90. sixteen rather than the decimal base 10. Letters are used for values
  91. over nine. Ten is represented by 'a', eleven by 'b' and so on. White
  92. now becomes $fff.
  93.  
  94. E COLOUR colour,$RGB
  95.  
  96. The same as the COLOUR command but using hex values and access to the
  97. 4096 colours.
  98.  
  99. x= E COLOR (colour)
  100.  
  101. No it isn't a spelling mistake, it's just a limitation of
  102. STOS. You can't use the same name for a command and function.
  103. This command returns the RGB value of the colour number, 0 to 15.
  104.  
  105.  
  106. STE DAC and Microwire Interface
  107.  
  108. The DAC is one of the best things added to the ST. This brilliant
  109. Digital to Analogue Converter plays raw sample sound in stereo, and
  110. with the Microwire Interface you can set left and right volume control
  111. as well as treble and bass.
  112.  
  113. DAC CONVERT start address of sample, end address of sample
  114.  
  115. Because the STE DAC plays raw sampled sound you'll need to
  116. convert your Maestro samples. DAC CONVERT does the job almost
  117. instantly. Ideal for using the same sample data for the ST and STE.
  118.  
  119. DAC SPEED
  120.  
  121. Sets the speed of sample replay. 0=6Khz, 1=12.5Khz, 2=25Khz and 4 is a
  122. pretty amazing 50Khz.
  123.  
  124. DAC RAW start address of sample,end address of sample
  125.  
  126. Plays your raw sample.
  127.  
  128. DAC MONO and DAC STEREO
  129.  
  130. Guess what, sets the sample to be mono or stereo.
  131.  
  132. DAC LOOP ON and DAC LOOP OFF
  133.  
  134. Want an endless wall of noise? Set the loop function on and off with
  135. these commands.
  136.  
  137. DAC M VOLUME volume
  138. DAC L VOLUME volume
  139. DAC R VOLUME volume
  140. DAC TREBLE volume
  141. DAC BASS volume
  142.  
  143. These commands set the master, left and right volume as well as the
  144. treble and bass. The volume can be anywhere from 0 to 12.
  145.  
  146. DAC MIX ON and DAC MIX OFF
  147.  
  148. These commands allow you to mix the PSG sound chip with the
  149. STEs DAC.
  150.  
  151. DAC STOP
  152.  
  153. Tricky one this, it er, stops the DAC.
  154.  
  155.  
  156. Hardware Scrolling
  157.  
  158. The STE has hardware scrolling which enables screen data to be shifted
  159. in bytes rather than words using the hardware. All this adds up to
  160. single pixel scrolling.
  161.  
  162. HARD SCREEN SIZE w,h,mode
  163.  
  164. Sets the screens logical size. w=width of screen and h=height of
  165. screen ready for scrolling.
  166.  
  167. HARD SCREEN OFFSET x,y
  168.  
  169. This command tells the ST where to start displaying the screen.
  170.  
  171. x = HARD PHYSIC (screen address)
  172.  
  173. This command tells the ST where the screen is stored.
  174.  
  175. HARD INTER ON and HARD INTER OFF
  176.  
  177. Once you have set all the hardware scrolling commands you can turn on
  178. the scrolling with these two. While the interrupt routine is running
  179. you use the HARD SCREEN OFFSET to get scrolling effect. If an error
  180. occurs while interrupt is on STOS turns hardware scrolling off.
  181.  
  182.  
  183. Register Me
  184.  
  185. To get the most from this STE extension and the blitter extension then
  186. register your copy with the author. You'll get upgrades,technical
  187. support and a comprehensive manual with copious examples. All for £10.
  188. Send cheques or postal orders to :
  189.  
  190. Asa Burrows
  191. 67 Malvern Road
  192. Leytonstone
  193. London E11 3DJ
  194.  
  195.  
  196.