home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / graphics / utility / spritest / spritest.doc < prev    next >
Encoding:
Text File  |  1989-04-26  |  7.1 KB  |  290 lines
  1. ----------- SpriteST -----------
  2. --- by CHRIS GREEN (ME) 1989 ---
  3.  
  4. --------- Instructions ---------
  5. ------------ (V1.0) ------------
  6.  
  7.  
  8.   SpriteST is a versatile, cheap!
  9. (ie for nothin') sprite designer
  10. for, of course, designing sprites
  11. to use in your own programs. Or
  12. you could just use it to try your
  13. hand at animaing objects and creating
  14. your own short "stories".
  15.  
  16.   There are four different sizes of
  17. sprite possible; having a width of
  18. either 16 or 32 pixels, and also
  19. either a heght of 16 or 32 pixels.
  20. You can use all 16 colours and mix
  21. your own colours from the ST's
  22. standard palette.
  23.  
  24.   You can have up to 128 different
  25. sprites(Frames) and string them
  26. together into an animation "sequence".
  27. This sequence can be up to 140 frames
  28. in length, but of course some sprites
  29. would have to be shown twice.
  30.  
  31.   On the main screen you will see
  32. the main grid which shows a
  33. magnification of the current frame.
  34. Clicking in that grid will set that
  35. particular square with the currently
  36. selected colour.
  37.     
  38.   In the top right hand corner is the
  39. current frame number, beneath that
  40. is the sprite shown exactly as it
  41. would appear in your programs,
  42. i.e. its true size.
  43.  
  44.   On the middle right are the 16
  45. colours in the current palette, with
  46. the currently selected one denoted
  47. with a 'tick'.To change the 'pen'
  48. colour, just click on whichever
  49. colour you wish to use.
  50.  
  51.   Below that, in the bottom right-
  52. hand corner are 12 icons, through
  53. which you tell the program what to do
  54. with your sprite.
  55.  
  56.   The icons are:
  57.  
  58. SAVE : (1st row,1st column)
  59.     
  60.       This icon does exactly as it
  61. suggests, saves all sprites to disk,
  62. displaying the standard GEM file
  63. selector through which you can select
  64. a file to save to or create a new one
  65.  
  66. LOAD : (1st row,2nd column)
  67.  
  68.       To load in a previously saved
  69. file, click on this icon.The load
  70. will fail if the file is not the
  71. correct format (more about that in
  72. a bit).REMEMBER TO SAVE ANY SPRITES
  73. THAT ARE ALREADY IN MEMORY BEFORE
  74. LOADING ANY NEW ONES IN.
  75.  
  76. QUIT : (1st row,3rd column)
  77.  
  78.       This icon (the one with the 'Q'
  79. on it) will QUIT SpriteST and return
  80. to DESKTOP, but asks for confirmation
  81. first, just in-case.
  82.  
  83. FLIP : (2nd row,1st column)
  84.  
  85.       You can flip the current sprite
  86. using this icon either horizontally
  87. or vetically, just click on the icon
  88. and you will be asked which way, or
  89. to cancel if you have changed your
  90. mind.
  91.  
  92. CLEAR : (2nd row,2nd column)
  93.  
  94.       This will clear the current
  95. sprite to the background colour,
  96. and asks for confirmation first.
  97.  
  98. FILL : (2nd row,3rd column)
  99.  
  100.       Clicking on this icon will
  101. fill the whole sprite with the the
  102. currently selected colour,this also
  103. asks for confirmation.
  104.  
  105. ANM ON : (3rd row,1t column)
  106.  
  107.       This will turn the animation
  108. on (ANM ON!) pressing enter will
  109. stop the animation and return you
  110. to designing your sprites. Of course,
  111. if you haven't set any animation
  112. (using the next function), animation
  113. will not be turned on.
  114.  
  115. ANM SET : (3rd row,2nd column)
  116.  
  117.       To set the various parameters
  118. of the animation, use this function.
  119. All about this later.
  120.  
  121. COL SET : (3rd row,3rd column)
  122.  
  123.       This function changes the RGB
  124. values of the current colour. A
  125. small box will appear in the bottom
  126. right corner with the RGB value of
  127. the colour. Clicking on the up
  128. arrow increases the value, the down
  129. arrow to decrease. Double-click to
  130. return to your drawin'.
  131.  
  132. RESIZE : (4th row,1st column)
  133.  
  134.       You can change the size of the
  135. current sprite using this icon. You
  136. will be asked for the width+height.
  137.  
  138.    NOTE:If a sprite is resized, all
  139. previous data will be erased. if you
  140. stumble into this by accident, set
  141. the values to the same as the current
  142. sprite and nothing will happen.
  143.  
  144. FRAME FORWARD : (4th row,2nd column)
  145.  
  146.       This will move you onto the
  147. next frame, up to a maximum of 128.
  148.  
  149. FRAME BACK : (4th row,2nd column)
  150.  
  151.       This will move you back to the
  152. previous frame, down to number 1.
  153.  
  154.  
  155.  
  156.  
  157.  
  158. ------------ ANIMATION ------------
  159.  
  160.  
  161.  
  162.  You can animate frames, of different
  163. sizes, by following the following 
  164. steps:
  165.  
  166. 1:  Draw your sequence.
  167.  
  168. 2:  Click on the ANM SET icon.
  169.  
  170.   You will first be asked whether
  171. you want to load in a previously
  172. saved sequence. Then comes a little
  173. reminder, press RETURN and up comes
  174. a sequnce of numbers. These are the
  175. order in which you would like your
  176. frames to be shown in the sequnce.
  177. Move about the grid using the cursors
  178. and type in your sequnce.When
  179. finished, you will be asked what
  180. speed you would like the animation
  181. to run at, and what happens at the
  182. end. These can be either:
  183.  
  184.       LOOP - When the animation
  185.              reaches the end of
  186.              your sequence, the
  187.              sequence loops back
  188.              to the beginning
  189.              and starts again.
  190.              
  191.       STOP - At the end of your
  192.              sequence, animation
  193.              stops and you can
  194.              press SPACE to see
  195.              your sequence again.
  196.              
  197.    GO BACK - At the end of your
  198.              sequence,animation
  199.              then flows backwards
  200.              through your sequence
  201.              upon reaching the
  202.              beginning when it
  203.              loops through again.
  204.              
  205.   When you have finished watching
  206. your sequence, press RETURN to end
  207. and enter the drawing again.
  208.  
  209.  
  210. ----- SpriteST File Format -----
  211.  
  212.  
  213.    The sprite files saved using
  214. SptiteST have the following format:
  215.  
  216.  
  217.   4.L(16 bytes) - these 1st four
  218.   long words are used internally by
  219.   SpriteST to signal where certain
  220.   sprites should appear within the
  221.   block of 128.
  222.   
  223.   1.W(2 bytes) - this contains the
  224.   number of sprites in the file.
  225.   
  226.   16.W(32 bytes) - this is the colour
  227.   palette which the sprites use.
  228.   
  229.     Following these is the sprite
  230.   data,each block of data has the
  231.   following format:
  232.   
  233.   1st byte - width of sprite.
  234.   2nd byte - height of sprite.
  235.   
  236.     The actual sprite data appears
  237.   here. Which is either 128, 256
  238.   or 512 bytes in size, depending
  239.   on the size of the sprite.
  240.   
  241.   
  242.  
  243. ---- Animation Set File Format ----
  244.  
  245.  
  246.    This file is 174 bytes long. The
  247. first 140 bytes are the numbers of
  248. the sequence, the rest are used
  249. internally.
  250.  
  251.  
  252. --------------- Demo ---------------
  253.  
  254.    On the disk is a short demo to get
  255. you used to using the various
  256. features of SpriteST. It is 12 frames
  257. of dripping water. Load the sprites
  258. in and set the animation for the 12
  259. frames, they run straight through
  260. from 1 to 12. Change the other
  261. settings to see the differences. Feel
  262. free to change any of the sprites to
  263. do what you want.
  264.  
  265.   That's just about all you need to
  266. know about creating your own sprites
  267. using SpriteST, hope you have fun,
  268. and watch out for updates and later
  269. versions containing many extra
  270. features and improvements.
  271.  
  272.  
  273.  
  274. --CREDITS AN ALL THAT BORIN' STUFF--
  275.  
  276.  
  277.   Thanks to :-
  278.  
  279.       HIM,MAD,YOU(KIERAN-K),DIGA,
  280.   MARK-C,GAZZ(HIM'S BROTHER),PAUL-K,
  281.   HISOFT FOR A SUCH A BRILLIANT
  282.   ASSEMBLER AND LOTS+LOTS OF JAMES
  283.   BROWN!!!!!!.
  284.       WATCH OUT FOR OUR FIRST MEGA-
  285.   GAME.
  286.   
  287.   last modified-20th FEB 1989
  288.   
  289. -------------------------------------
  290.