home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / sillies / silly9 / StickMan / !Player / !Help < prev    next >
Text File  |  1992-05-07  |  6KB  |  188 lines
  1. !Help for !Player Version 1.00
  2. ------------------------------
  3.  
  4. [Docs as of 22-April-90]
  5.  
  6. Files included in this package :-
  7.  
  8.   !Run
  9.   !RunImage
  10.   !Sprites
  11.   !Help
  12.   Templates
  13.   chkspr    ) my chkspr util, rename the app and see what
  14.   !Boot     ) happens (nothing!). Notes in Comments.
  15.  
  16.   There are several apps avaliable at the mo that animate a
  17. specific sprite file. In general they don't work properly
  18. except if they are run in a specific mode. I decided
  19. (having aquired a multisync, where they very rarely work)
  20. to write the definitive animator app, that will animate a
  21. sprite file created in any mode in any mode.
  22.  
  23. Usage
  24. -----
  25.  
  26.   Load the application by doubling clicking on the !Player
  27. icon (a tv). To animate a sprite file drag the file onto
  28. the tv icon installed on the iconbar or double click on the
  29. sprite file. If you wish to change the animation you can
  30. drag a different file onto tv icon, the animation window or
  31. double click on the file.
  32.  
  33.   Of course it is possible to load single image sprite
  34. files into !Player as well, !Player will not attempt to
  35. animate these (!) so there is no worry of loss of processor
  36. bandwidth.
  37.  
  38.   It is possible to alter the magnification or speed of the
  39. animation via the 'Options' submenu in the iconbar menu.
  40. The X scale and Y scale factilites behave exactly like the
  41. zoom dialogues in Paint and Draw. The speed option allows
  42. you to alter the time interval between displaying each
  43. frame (ie the lower the value for speed, the faster the
  44. animation procceds). The 'reverse' option allows you to
  45. choose whether to cycle through the sprites from first to
  46. last (and then from the beginning again) [off] or going
  47. backwards and forwards through the list [on] (useful if the
  48. beginning and end don't match up properly)
  49.  
  50.  
  51. Notes On Sprite File Format
  52. ---------------------------
  53.  
  54.   This application was written with maximum flexabilty in
  55. mind. Sprite names are irrelavent, the application will
  56. animate cyclicly from the first image to the last. The mode
  57. and palette data for the whole animation is taken from the
  58. first sprite (if the first sprite is different from the
  59. rest then problems occur!). It is advisable to define a
  60. palette for the first sprite otherwise the default mode
  61. palette is used, which is completely different from the
  62. desktop one.
  63.  
  64.  
  65. Facilites For Animation Applications
  66. ------------------------------------
  67.  
  68. The application is run via this call in the !Run file:-
  69.  
  70. Run <Obey$Dir>.!RunImage [options] %*0
  71.  
  72. The options allow complete control over the bootup aspects.
  73.  
  74. -quit             Application quits when the close box is
  75.                   clicked
  76.  
  77. -load <pathname>  Application loads <pathname> on bootup
  78.  
  79. -iconbar          No iconbar and quit on close box click
  80.  
  81. -reverse          Selects the reverse mode
  82.  
  83. -speed <int>      As options menu, range 1-99
  84.  
  85. -xmag <int>       As options menu, range 1-99
  86.  
  87. -xdiv <int>       As options menu, range 1-99
  88.  
  89. -ymag <int>       As options menu, range 1-99
  90.  
  91. -ydiv <int>       As options menu, range 1-99
  92.  
  93. So a standalone animation would probably call :-
  94.  
  95. Run <Obey$Dir>.!RunImage -ic -load <Obey$Dir>.Photos %*0
  96.  
  97. (Note the order and case of the options is irrelevent and
  98. all of them can be shortened to a '-' followed by the first
  99. two letters. If any are not present then the system will
  100. adopt its defaults)
  101.  
  102. (To change the name of the application all that is needed
  103. to to rename the directory. The chkspr utility will alter
  104. the name of the first sprite in the !Sprites directory and
  105. the application uses the first sprite for the icon bar, no
  106. matter what its name)
  107.  
  108. Versions
  109. --------
  110.  
  111. V1.00 Release version, fully functional.
  112.       If anyone wants an unsquashed version, just send me a
  113.       disc and postage and I will send you that along with
  114.       the rest of my stuff.
  115.  
  116.  
  117. Comments
  118. --------
  119.  
  120.   The ChkSpr Utility
  121.  
  122.   The chkspr utility will, when run, examine the '!Sprites'
  123. file and check if the first sprite is the directory's name.
  124. If not the sprites name will be changed to the directory's
  125. name. The !Boot file contains on it's FIRST line 'Run
  126. ChkSpr', this runs the util, the next line contains
  127. 'IconSprites <Obey$Dir>.!Sprites' this loads the new sprite
  128. in. The filer always calls any new (ie renamed) app's !Boot
  129. file so the new sprite is automatically loaded for display,
  130. et voilà! Please feel free to use the utility separately
  131. from the rest of the package, I think it is very useful!
  132.       
  133.  
  134. Conditions of Use
  135. -----------------
  136.  
  137.   This application is supplied free to everyone 'as is', I
  138. do not give any guarantee that it is free of bugs, or
  139. supply any warranty about its suitabliliy for use. However
  140. if there are any problems with it and you notify me of them
  141. then I probably will do my best to recify them.
  142.  
  143.   You are may give this application to anyone, via any
  144. medium, so long as :- 
  145.  
  146.   1) It is delivered with ALL the supplied files and
  147.      unaltered (except !Run & !Boot files) .
  148.  
  149.   2) It is not supplied on a disc you are charging
  150.      for (except for media and postage costs).
  151.   
  152.   You have permission to use any part or the whole
  153. application in a project you intend to place in the public
  154. domain, as long as I am fully credited. If you wish to use
  155. these routines in a program that is for sale (for however
  156. much and for whatever reasons) or released as copyright
  157. material then my express permission in writing must be
  158. obtained. I maintain copyright on all the material
  159. supplied and reserve the right to amend these conditions in
  160. cases where I deem misuse.
  161.  
  162.    A large number of hours of work have gone into the
  163. production and maintenance of this application and although
  164. I have supplied the application free donations will be
  165. gratefully received (and if over 7 pounds I will send you a
  166. disc with updates of this and all other pd stuff I have
  167. written. Please include a letter telling me which apps of
  168. mine you use and their version numbers).
  169.  
  170.  
  171. Contacts
  172. --------
  173.  
  174. My address:
  175.  
  176.   6 Parklands Place,
  177.   Guildford,
  178.   Surrey GU1 2PS.
  179.  
  180. BBSs I call frequently:
  181.  
  182.   Archive BBS          [0603 745932]   mbx 23
  183.   Arcade BBS           [01 654 2212]   mbx 23
  184.   The World of Cryton  [0749 679794]   mbx 273
  185.  
  186.  
  187. © Emmet Spier 1990 - USE and Enjoy!
  188.