home *** CD-ROM | disk | FTP | other *** search
/ Computer Shopper 108 / gp2demo.iso / editor / acorn / TEXTURE / TEXTURE.ZIP / !TexturGdn / !Help next >
Encoding:
Text File  |  1996-11-25  |  12.1 KB  |  267 lines
  1.  
  2.           Texture Garden's !Help file
  3.               ===========================
  4.            0.57 ⌐ Tim Tyler 21-Nov-96
  5.  
  6.              (distributed on Computer Shopper magazine
  7.              cover CD, issue 108, coverdate 1997 February)
  8.  
  9. Index
  10. ~~~~~
  11. 1.0 Short description
  12. 1.1 Longer description
  13.  
  14. 2.0 Getting started
  15. 2.1 Use of the mouse in the main window
  16. 2.2 Use of the mouse in the control window
  17. 2.3 Hotkey operations
  18.  
  19. 3.0 Options
  20.  
  21. 4.0 Preferences
  22.  
  23. 5.0 A brief index to the rest of the documentation
  24.  
  25.  
  26. 1.0 Short description
  27. ~~~~~~~~~~~~~~~~~~~~~
  28. Texture Garden is an algorithmic texture generation program for RISC OS.
  29.  
  30. 1.1 Longer description
  31. ~~~~~~~~~~~~~~~~~~~~~~
  32. Texture Garden generates algorithmic textures using a range of techniques
  33. including inverse two dimensional fast-fourier-transforms of filtered noise.  
  34. Genetic methods are used to seed the textures enabling breeding, selective
  35. mutation, cultural transmission of colour and sexual recombination to be
  36. implemented.  The program supports seamless tesselation, twenty-four bit
  37. colour and full control over texture animation.
  38.  
  39. 2.0 Getting started
  40. ~~~~~~~~~~~~~~~~~~~
  41. This program supports interactive help.  After loading the program onto the
  42. icon bar, and viewing its main window, the first thing to do is to load some
  43. textures.  The program should normally have been supplied with a reasonable
  44. range of textures in the "Textures" directory.  These are plain text files
  45. which may be dragged into the program's main window.  When one has been dragged
  46. in, an hourglass will appear for a moment, and then the texture is displayed.
  47.  
  48. 2.1 Use of the mouse in the main window
  49. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  50. Although the use of the mouse may seem a little complex from this description,
  51. after a little use the more commonly used options should become intuitive.
  52.  
  53. Dragging with SELECT on a texture enables it to be moved between different
  54. areas of the main window, allowing copies of the texture to be made.  If the
  55. window has areas of different sizes then the texture will be appropriately
  56. scaled.
  57.  
  58. Dragging with SELECT on the bottom and right-hand edges of a texture enables
  59. it to be dynamically resized.  If the edges are dragged, resizing occurs in
  60. one dimension, whereas if the corner is dragged, resizing in both dimensions
  61. happens simultaneously.  Texture size is always considered to be relative to
  62. the size of the icon it is being displayed in, so to make a texture larger
  63. than the icon displaying it, you have to drag it to a larger icon.
  64.  
  65. Clicking with MENU will provide a "Texture" menu.  If the click is not over a
  66. texture then the options will all be greyed out.  Otherwise an "Options" menu
  67. will be displayed.  From the main "Texture" menu, the menu options will all
  68. relate specifically to the texture clicked over.
  69.  
  70. The texture may have its palette manipulated by the first option, "Palette". 
  71.  
  72. The second option, "SaveSprite" allows the bitmap of the texture to be saved. 
  73. Hidden beneath the main icons here are a number of pieces of information
  74. concerning the size of the sprite and the mode in which the texture was
  75. generated.  These may be viewed by toggling the window's size.
  76.  
  77. The third option, "SaveText" allows the textfile generation program to be 
  78. exported as a text file.
  79.  
  80. Lastly the "Animation" option enables animation types to be selected and
  81. animations of variable lengths to be exported.  The "Technical" file contains
  82. more information about this.
  83.  
  84. These options are also available through the use of hotkeys and some are also
  85. available by clicking with the mouse in conjunction with SHIFT, CTRL or ALT.
  86. More information concerning this is given later in this file.
  87.  
  88. Clicking with ADJUST toggles the selection state of a texture.  This state is
  89. indicated by a thickening of the border of the texture.  It means that the
  90. texture is to be protected from being overwritten by the dragging in of new
  91. textures, palettes or by the breeding process.
  92.  
  93. Double-clicking with SELECT on a texture initiates a breeding process which
  94. produces offspring in all the other areas of the main window which are not
  95. selected.  These offspring are variants on the parental type, with random
  96. variations of a magnitude specified by the "mutation rate" bar in the control
  97. window  The "Technical" file contains information about how the mutation
  98. processes are carried out.
  99.  
  100. CTRL-dragging with SELECT enables the textfile generation program to be
  101. exported directly without negotiating a menu structure.  ALT-dragging with
  102. SELECT enables the bitmap of the texture to be saved in a similar manner. 
  103. SHIFT-dragging with SELECT enables just the palette to be dragged from one
  104. texture to another.  This operation may also be performed by pressing and
  105. holding ADJUST and then tapping MENU.  This allows the operation to be
  106. executed without recourse to the menu or the keyboard.
  107.  
  108. 2.2 Use of the mouse in the control window
  109. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  110. Pressing MENU in a blank area of the control window produces the Options menu.
  111.  
  112. In the control window there are three texture areas marked "Mother", "Father"
  113. and "Offspring".  These areas act in a similar manner to those in the main
  114. window.  However they are unaffected by the generation of new textures by
  115. mutating an original one.  They are also not able to be selected with ADJUST.
  116.  
  117. As you can probably guess from the names in this area, this is where sexual
  118. recombination of the textures takes place.  By dragging textures into
  119. both the "Mother" and "Father" slots and then pressing the "=" button, a new
  120. texture is produced in the "Offspring" area, based on its parents.  Child
  121. textures are heavily derived from the mother texture, with the father
  122. contributing a few important bits of information here and there.  Textures
  123. are not considered to have any sex, but not all textures will breed equally
  124. well with one another.  While some textures are fertile, others produce
  125. offspring that are of little interest, and others will not breed at all.
  126.  
  127. To find out more about how the sexual recombination works, please refer to the
  128. "Technical" file).
  129.  
  130. There are options in the control window for controlling the rate of mutation
  131. and whether mutations should be allowed to affect the texture, its palette or
  132. both.  There is also a "STOP" button which may be employed (when illuminated)
  133. instead of the ESCAPE button to terminate long processes.
  134.  
  135. 2.3 Hotkey operations
  136. ~~~~~~~~~~~~~~~~~~~~~
  137. There are a number of hotkeys that are recognised by the system to assist
  138. users familiar with them to execute common operations more rapidly.
  139.  
  140. Firstly, ESCAPE often provides an abortive action either when dragging or in
  141. the midst of any time consuming operation.
  142.  
  143. Next, various function keys provide short cuts to useful functions as follows:
  144.  
  145.   F1 - Shows the palette manipulation dialogue-box [TextureGdn.Palette].
  146.   F2 - Save sprite [TextureGdn.SaveSprite].
  147.   F3 - Save text [TextureGdn.SaveText].
  148.        (also SHIFT-F3: save text with no prompt).
  149.   F4 - Save animation [TextureGdn.Animation].
  150.   F5 - [Options.Screen].
  151.   F6 - [Options.Output].
  152.   F7 - [Options.Animation].
  153.   F8 - [Options.Templates].
  154.   F9 - Loads the texture's textfile generation program into a text editor.
  155.  F10 - Copies options to preferences [Options.CopyOpts].
  156.  
  157. Items in square brackets indicate the equivalent menu options.
  158.  
  159. Operations F1, F2, F3, F4 and F9 will be applied to the texture under the
  160. pointer at the time the hot key is pressed.
  161.  
  162. 3.0 Options
  163. ~~~~~~~~~~~
  164. There are currently options to control a number of aspects of the program's
  165. operation.  Most of these are available through the options menu which may
  166. normally be accessed by pressing menu over a blank area of the control panel
  167. or the main window.
  168.  
  169. Options take effect when the "OK" icon is clicked on.  They may be copied to
  170. the preferences which may then be saved to disc.
  171. This saves the positions and states of the other windows as well, enabling
  172. them to be set up as the user wishes.
  173.  
  174. There are four main section of options available through the menu: "General",
  175. "Output", "Animation" and "Templates".  These mirror the settings in the 
  176. preferences windows.  These are explained below.
  177.  
  178. 4.0 Preferences
  179. ~~~~~~~~~~~~~~~
  180. Preferences are options which may be saved to disc.
  181. The preferences window may be accessed by means of an ADJUST-click on the icon
  182. bar icon, or through the icon bar menu by selecting the "Prefs..." entry.
  183.  
  184. Preferences may be copied to the options of the main program by clicking on
  185. the "Set" icon.
  186. They may be saved by clicking on the "Save" icon.
  187.  
  188. There are four main section of preferences: "General", "Output", "Animation"
  189. and "Templates".  These are on separate pages which can be flipped between by
  190. clicking on their headings.
  191.  
  192.                        General
  193.                        ~~~~~~~
  194. An item in the preferences window controls the default value of the "Screen
  195. blanking" option.  On older series machines some increase in speed of texture
  196. generation may be obtained (at the cost of display continuity) by the use of
  197. this option.
  198.  
  199. Options for altering if and when the options menu is displayed may be
  200. changed from here.
  201.  
  202. Preferences affecting how the program starts up may be altered from here.
  203.  
  204. The default settings of the mutator are also set up here.
  205.  
  206.                        Output
  207.                        ~~~~~~
  208. There are a number of settings controlling how textfiles are exported from
  209. the program on the left-hand side of this window.
  210.  
  211. The default settings of the "Use ChangeFSI" option may be changed from here.
  212. This option controls post-processing of saved sprites and animations.
  213. This option is normally set from the "SaveSprite" Dialogue box.
  214. The !ChangeFSI-associated string may be altered and details about how to do
  215. this are in the "Technical" file, which should be read in conjunction with
  216. the documentation to !ChangeFSI.
  217.  
  218. The JPEG preferences are intended to provide a simple interface for those who
  219. do not wish to concern themselves unnecessarily with command-line options.
  220.  
  221. There are two preferences which change the default settings of the options
  222. allowing the export of 16 or 24 bit colour sprites.  These settings are
  223. discussed further in the "Technical" file.
  224.  
  225.                        Animation
  226.                        ~~~~~~~~~
  227. The default number of frames and the default animation type may be controlled
  228. from here.  The values actually used may be altered from the menu obtained by
  229. clicking with MENU over an animating icon, or from the [Options.Animation]
  230. menu.  For more information on animation see the "Technical" file.
  231.  
  232.                        Templates
  233.                        ~~~~~~~~~
  234. A number of combinations of sizes and shapes of the areas of the main window
  235. which display textures may be selected between, and several sizes of control
  236. window are available.
  237.  
  238. 5.0 A brief index to the rest of the documentation
  239. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  240. File:       : Description:
  241. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  242. !Help       : This file.  Contains basic operating instructions and hints
  243. !Index     : This file contains an expanded index with extended descriptions
  244. Contact    : Ways of communicating with the author
  245. Distribute : Describes the distribution channels of extensions and textures
  246. Extensions : How to write your own extensions to the texture language
  247. Features   : List of the good features of this program (more sales talk)
  248. Files      : A list of the files you should have received with this program
  249. History    : Tales of previous versions of the program
  250. Technical  : Details not covered in "Language" or "Extensions"
  251. Language   : Syntax, grammar, and vocabulary of the texture language
  252. License    : Please read before copying this program
  253. Plans       : Details of my hopes, dreams and future development plans
  254. Problems   : List of the not-so-good "features" of this program 
  255. Register   : Sales talk trying to persuade you to send cash to the author
  256. Reg_Form   : You can register the Texture Garden program using this form
  257. TreeShaped : Discussion of the virtues of employing tree-shaped chromosomes
  258. Versions   : Describes the various versions which are available
  259.  
  260. Enjoy
  261.  
  262. ⌐ Tim Tyler 1996.
  263.  _____  __  __  _____             The Mandala Centre,
  264. |_   _||  \/  ||_   _| 11 Alexandra Road, Clifton, Bristol, BS8 2DD.
  265.   | |  | |\/| |  | |     tim@varuna.demon.co.uk / tt@cryogen.com
  266.   |_|  |_|  |_|  |_|       http://www.varuna.demon.co.uk/tmc/
  267.