home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / anim / progs / scheme / !Scheme / Scheme / UGuide
Encoding:
Text File  |  1993-07-21  |  10.7 KB  |  266 lines
  1. Scheme - Version 1.02
  2. ~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. By Andrew Barron
  5.  
  6. -----------------------------------------------------------------
  7.  
  8. Scheme is a display creator designed to allow you to put together 
  9. folders combining sprites, text files, animations and tracker 
  10. music (standard Sound Trackers or 4-Track (Stereo) trackers.)  
  11. The folders it creates are self supportive and once loaded can be 
  12. left to run constantly repeating themselves.  An !Example folder 
  13. is provided.
  14.  
  15. -----------------------------------------------------------------
  16.  
  17. Instructions
  18. ~~~~~~~~~~~~
  19. Before you begin to create a folder there are a few things you 
  20. must decide:
  21. What will be the directory root and filename of the folder?
  22. Do you want to use Sound Trackers?
  23. How do you want escape to affect the folder?
  24.  
  25. The options for escape are:
  26. Return to desktop;
  27. Return to first page;
  28. Disable escape completely.
  29.  
  30. Once you have decided on these double click on the '!Make-Fold' 
  31. application.  You will then be presented with a screen containing 
  32. copyright information and the first question above.  Answer it, 
  33. press 'RETURN' if you just want the folder in the $ directory.  
  34. Now you will be asked for the filename it must be prefixed by the 
  35. '!' provided.  The filename must be less than 10 characters long.
  36.  
  37. Next you be asked if you want to use any type of sound tracker, 
  38. answer 'Y'es or 'N'o.  The next question is the escape affect 
  39. answer with '1', '2' or '3'.  The final question asks if you want 
  40. disk change prompts.  If you are coping onto different disks in 
  41. the same drive press 'Y' ,if not 'N'.  Now press any key to 
  42. create the folder.  (Press space on change prompts if selected.)  
  43. The folder will be made in the currently selected drive and 
  44. filing system.
  45.  
  46. You will now be returned to the desktop.  You now need to put all 
  47. the files you are going to use in the correct directories of the 
  48. folder.  To bring up the directories hold down 'SHIFT' while 
  49. double clicking the folder.  Either three or four windows will 
  50. open (hour if sound trackers are to be used.)  Copy all your 
  51. files into the correct directories:
  52. Text directory    - Empty;
  53. Sprite directory  - Contains DirSprites + SchemeInfo;
  54. Tracker directory - Contains STDocs4/06;
  55. Palette directory - Contains Default palette.
  56. Animations should be placed in the Sprites directory.
  57.  
  58. The current contents of these are explained later.  Once you have 
  59. copied your files into these directories double click on '!Edit-
  60. Fold'.  You will be presented with basically the same screen as 
  61. in !Make-Fold, enter in the same directory details as before 
  62. (make sure you have the correct folder disk in the drive.)  You 
  63. can perform '*' commands by pressing 'ESCAPE'.
  64.  
  65. Now a menu will appear with eleven options and various 
  66. information at the bottom.  One of these pieces of information is 
  67. the screen mode, the default is 12, if any of the sprites that 
  68. you going to use are not in that mode you must change it by 
  69. selecting option 6 and typing in the new mode.
  70.  
  71. Once this is correct you can add a sprite to the screen.  Select 
  72. 3 to do this.  You will be presented with a catalogue of the 
  73. 'Sprites' directory, type in the filename of the one you want.  
  74. The sprite will be loaded and you will be asked for which sprite 
  75. you want.  Now, using the mouse, position the sprite.  All other 
  76. sprites and text boxes will be shown when you do this.
  77.  
  78. To add a text box select 2 from the main menu.  You will be 
  79. presented with the catalogue the text file directory.  Type in 
  80. the file you want.  Now create the box.  This is done by placing 
  81. the pointer at one corner of the box, clicking 'Select' and 
  82. dragging the box out.  To change the corner point click 'Adjust'.  
  83. When you have finished click 'Select' the box will be filled with 
  84. the text file.  You will be then asked if this is OK if not press 
  85. 'N' and remake the box.
  86.  
  87. As text boxes only appear as a green box when editing you can use 
  88. option 6 to display the page.  If anything is wrong with the page 
  89. you can use option 5 to change boxes.  On selecting this you will 
  90. be asked for the box number, if you do not know this just press 
  91. 'RETURN' and each box will be displayed separately.
  92.  
  93. If the box you are editing is a text box you will be asked if you 
  94. want to reposition the box, change the text file or if you want 
  95. to change it into a sprite box, these are done in the same way as 
  96. described above.  The final option allows you to delete the box.  
  97. If you are editing a sprite box the same basic options apply.
  98.  
  99. If you are using tracker files select 7 to change the one for the 
  100. current page.  A catalogue of the Stracker directory will appear 
  101. and type in the name of the tracker you want.  If you want the 
  102. music stopped on that page type in 'Unused'.
  103.  
  104. To add an animation select option 9.  Animations are placed in 
  105. the Sprites directory so this list is brought up.  After you have 
  106. typed in the animation file name Scheme will check if the sprites 
  107. are setup correctly.  They must be have named with their frame 
  108. number starting at 1.  After this you will position the sprite 
  109. and then set its speed using the arrow keys.  To change the 
  110. animation select 9 again from the main menu.  Only one animation 
  111. is allowed per page.
  112.  
  113. All sprites have palettes that control their colours.  Scheme 
  114. loads in a palette file every time a new page is drawn.  This is 
  115. important because the colours of the sprites could seem quite 
  116. strange without it.  For this reason every page you create needs 
  117. to have a palette file set for it.  The default one provided is 
  118. the desktop palette (do not delete this palette because Scheme 
  119. uses it when it returns to the desktop.)  The page's palette is 
  120. changed using option 8 on the menu.  After selecting this you are 
  121. asked for the filename.  Palettes can be extracted from sprites 
  122. using !Paint.
  123.  
  124. To move onto the next page select 1 from the main menu.  You will 
  125. be asked for the page you want to edit.  This page will be loaded 
  126. or created.  The whole folder must be saved before leaving the 
  127. editor.  Select 0 from the main menu to do this.  Finally press Q 
  128. to return to the desktop.
  129.  
  130. Now double click on your folder to run it.  If you are using 
  131. tracker files a few errors may occur.  Firstly if an 'No room in 
  132. RMA' type error appears you need to extend the module area using 
  133. the task manager.  If no music plays check the speakers are on 
  134. and if so you will have to free more memory for them to run.
  135.  
  136. -----------------------------------------------------------------
  137.  
  138. Miscellaneous Information
  139. ~~~~~~~~~~~~~~~~~~~~~~~~~
  140. When the directories of a folder open they will contain the 
  141. following:
  142. DirSprites - the sprites which are displayed in the disk window. 
  143.              You may edit these if you wish.  This file must not 
  144.              be deleted.
  145. STDocs4/06 - the documentation which accompanies the Tracker 
  146.              module 4.06.
  147. SchemeInfo - Information file about scheme it must be kept if 
  148.              you plan to pass the folder onto third-parties.
  149. Default    - This the desktop palette - it must not be deleted.
  150.  
  151. Scheme automatically claims sprite memory so if any memory type 
  152. error occurs during sprite use it means you need to free more 
  153. memory for sprites.  Also all sprites will be cleared when using 
  154. any of Scheme's programs.
  155.  
  156. Scheme is created to work in all standard modes.  However, it is 
  157. not advisable to use modes 2 or 5.  I do not have multiscan, HRM 
  158. or VGA to test modes 18 to 28 so I cannot guarantee that they 
  159. will work, but I see no reason why not.  User defined modes will 
  160. generally not work correctly.
  161.  
  162. The maximum number of boxes allowed on one page is 100.
  163.  
  164. Yes/No questions can be answered by the mouse.  Select for yes or 
  165. any other button no.
  166.  
  167. Standard Sound Trackers are played in Stereo.
  168.  
  169. -----------------------------------------------------------------
  170.  
  171. Changing Sprite modes and palettes.
  172. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  173. This can be done by using Paint on the desktop.  Load in your 
  174. sprite and change the desktop mode to the one you want to use the 
  175. sprite in (change mode using the palette manager.)  Load in your 
  176. palette file.  Click 'Menu' on the Paint icon and select 'Get 
  177. screen area' now select the screen area of the sprite (this 
  178. process is described on page 138 of the RISC OS User Guide.)
  179.  
  180. -----------------------------------------------------------------
  181.  
  182. Using Draw files
  183. ~~~~~~~~~~~~~~~~
  184. Load in Paint, Draw and your draw file.  Invert the palette and 
  185. select the mode you want to use it in (described above) and 'get 
  186. the screen area' of the draw file (also described above.)
  187.  
  188. -----------------------------------------------------------------
  189.  
  190. Copyright
  191. ~~~~~~~~~
  192. All the Scheme programs, Obey files etc. are:
  193.  
  194. Copyright © Andrew Barron 1991
  195.  
  196. They can be copied without my prior permission providing:
  197. The programs are not altered in ANY way;
  198. The application is copied as one unit (i.e. all the supplied 
  199. files are copied);
  200. No profit is made from sales of the application.
  201.  
  202.  
  203. The tracker module is:
  204.  
  205. Copyright © H. Fiennes, H. Mercier and M. Farrow
  206.  
  207. It can be freely copied, for full information read ST-Docs4/06.
  208.  
  209.  
  210. The MemAlloc utility I cannot trace although it is used by 
  211. !Lander on the RISC OS Apps. Disks.
  212.  
  213.  
  214. The folders created are:
  215.  
  216. Copyright © Andrew Barron 1991
  217.  
  218. The sprites, text files and trackers in them will be of another 
  219. source not within my copyright.
  220.  
  221. These can be freely copied providing no profit is made and that 
  222. the Scheme program and Obey files are no altered.
  223.  
  224. -----------------------------------------------------------------
  225.  
  226. Have fun
  227.  
  228. Andrew Barron
  229.  
  230. -----------------------------------------------------------------
  231.  
  232. Version history
  233. ~~~~~~~~~~~~~~~
  234. 1.00 - First release of demonstration version with basic 
  235.        features. 
  236. 1.01 - Copyright notices changed, version not public domain.  
  237.        Palette manager and animation options added.  Designing 
  238.        system rewrote without the flicker.  All programs updated 
  239.        so that the mouse can be used to answer Y/N questions.  
  240.        Sprite memory claiming system rewrote to save memory. 
  241.        Folders can now be moved around into different 
  242.        directories.  Sound Tracker changed to version 4.  Other 
  243.        minor handling changes made.
  244.  
  245. 1.02 - Returned to Public Domain due to the number of registered 
  246.        users being so low.  Various small errors corrected.  
  247.        Memory management of the folder display program rewrote.  
  248.        Folders will now attempt to load in all sprite files 
  249.        before beginning the display providing enough memory is 
  250.        available.  This speeds up page changes especially when 
  251.        animations are used.  Sound Tracker module updated to 
  252.        version 4.06.
  253.  
  254. -----------------------------------------------------------------
  255.  
  256. Credits
  257. ~~~~~~~
  258. I would like to thank the following people for their unknown 
  259. contribution to Scheme:
  260.  
  261. Hugo Fiennes, F. Mercier and M. Farrow for putting together the 
  262. tracker module
  263.  
  264. The unknown writer of the MemAlloc module.
  265.  
  266.