home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilst / texturgdn / !TexturGdn / !Help next >
Text File  |  1996-09-28  |  12KB  |  269 lines
  1.  
  2.           Texture Garden !Help file.
  3.               ~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.           0.44 © Tim Tyler 29-Sep-96
  5.  
  6. Index
  7. ~~~~~
  8. 1.0 Short description
  9. 1.1 Longer description
  10.  
  11. 2.0 Getting started
  12. 2.1 Use of the mouse in the main window
  13. 2.2 Use of the mouse in the control window
  14. 2.3 Hotkey operations
  15.  
  16. 3.0 Options
  17.  
  18. 4.0 Preferences
  19.  
  20. 5.0 A brief index to the rest of the documentation
  21.  
  22. 1.0 Short description
  23. ~~~~~~~~~~~~~~~~~~~~~
  24. Texture Garden is an algorithmic texture generation program for RISC OS.
  25.  
  26. 1.1 Longer description
  27. ~~~~~~~~~~~~~~~~~~~~~~
  28. Texture Garden generates algorithmic textures using a range of techniques
  29. including inverse two dimensional fast-fourier-transforms of filtered noise.  
  30. Genetic methods are used to seed the textures enabling breeding, selective
  31. mutation, cultural transmission of colour and sexual recombination to be
  32. implemented.  The program supports seamless tesselation, twenty-four bit
  33. colour and full control over texture animation.
  34.  
  35. 2.0 Getting started
  36. ~~~~~~~~~~~~~~~~~~~
  37. This program supports interactive help.  After loading the program onto the
  38. icon bar, and viewing its main window, the first thing to do is to load some
  39. textures.  The program should normally have been supplied with a reasonable
  40. range of textures in the "Textures" directory.  These are plain text files
  41. which may be dragged into the program's main window.  When they are dragged
  42. into the window an hourglass will normally appear for a second or so and then
  43. the texture should be displayed.
  44.  
  45. 2.1 Use of the mouse in the main window
  46. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  47. Although the use of the mouse may seem a little complex from this description,
  48. after a little use the more commonly used options should become intuitive.
  49.  
  50. Dragging with SELECT on a texture enables it to be moved between different
  51. areas of the main window, allowing copies of the texture to be made.  If the
  52. window has areas of different sizes then the texture will be appropriately
  53. scaled.
  54.  
  55. Dragging with SELECT on the bottom right-hand corner of a texture enables it
  56. to be dynamically resized.  Texture size is always considered to be relative
  57. to the size of the icon it is being displayed in, so to make a texture larger
  58. than the icon displaying it, drag it to a larger icon.
  59.  
  60. Clicking with MENU will provide a "Texture" menu.  If the click is not over a
  61. texture then the options will all be greyed out.  Otherwise an "Options" menu
  62. will be displayed.  From the main "Texture" menu, the menu options will all
  63. relate specifically to the texture clicked over.
  64.  
  65. The texture may have it's palette manipulated by the first option, "Palette". 
  66.  
  67. The second option, "SaveSprite" allows the bitmap of the texture to be saved. 
  68. Hidden beneath the main icons here are a number of pieces of information
  69. concerning the size of the sprite and the mode in which the texture was
  70. generated.  These may be viewed by toggling the window's size.
  71.  
  72. The third option, "SaveText" allows the textfile generation program to be 
  73. exported as a text file.
  74.  
  75. Lastly the "Animation" option enables animation types to be selected and
  76. animations of variable lengths to be exported.  The "Technical" file contains
  77. more information about this.
  78.  
  79. These options are also available through the use of hotkeys and some are also
  80. available by clicking with the mouse in conjunction with SHIFT, CTRL or ALT.
  81. More information concerning this is given later in this file.
  82.  
  83. Clicking with ADJUST toggles the selection state of a texture.  This state is
  84. indicated by a thickening of the border of the texture.  It means that the
  85. texture is to be protected from being overwritten by the dragging in of new
  86. textures, palettes or by the breeding process.
  87.  
  88. Double-clicking with SELECT on a texture initiates a breeding process which
  89. produces offspring in all the other areas of the main window which are not
  90. selected.  These offspring are variants on the parental type, with random
  91. variations of a magnitude specified by the "mutation rate" bar in the control
  92. window  The "Technical" file contains information about how the mutation
  93. processes are carried out.
  94.  
  95. CTRL-dragging with SELECT enables the textfile generation program to be
  96. exported directly without negotiating a menu structure.  ALT-dragging with
  97. SELECT enables the bitmap of the texture to be saved in a similar manner. 
  98. SHIFT-dragging with SELECT enables just the palette to be dragged from one
  99. texture to another.  This operation may also be performed by pressing and
  100. holding ADJUST and then tapping MENU.  This allows the operation to be
  101. executed without recourse to the menu or the keyboard.
  102.  
  103. 2.2 Use of the mouse in the control window
  104. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  105. Pressing MENU in a blank area of the control window produces the Options menu.
  106.  
  107. In the control window there are three texture areas marked "Mother", "Father"
  108. and "Offspring".  These areas act in a similar manner to those in the main
  109. window.  However they are unaffected by the generation of new textures by
  110. mutating an original one.  They are also not able to be selected with ADJUST.
  111.  
  112. As you can probably guess from the names in this area, this is where sexual
  113. recombination of the textures takes place.  By dragging textures into
  114. both the "Mother" and "Father" slots and then pressing the "=" button, a new
  115. texture is produced in the "Offspring" area, based on its parents.  Child
  116. textures are heavily derived from the mother texture, with the father
  117. contributing a few important bits of information here and there.  Textures
  118. are not considered to have any sex, but not all textures will breed equally
  119. well with one another.  While some textures are fertile, others produce
  120. offspring that are of little interest, and others will not breed at all.
  121.  
  122. To find out more about how the sexual recombination works, please refer to the
  123. "Technical" file).
  124.  
  125. There are options in the control window for controlling the rate of mutation
  126. and whether mutations should be allowed to affect the texture, its palette or
  127. both.  There is also a "STOP" button which may be employed (when illuminated)
  128. instead of the ESCAPE button to terminate long processes.
  129.  
  130. 2.3 Hotkey operations
  131. ~~~~~~~~~~~~~~~~~~~~~
  132. There are a number of hotkeys that are recognised by the system to assist
  133. users familiar with them to execute common operations more rapidly.
  134.  
  135. Firstly, ESCAPE often provides an abortive action either when dragging or in
  136. the midst of any time consuming operation.
  137.  
  138. Next, various function keys provide short cuts to useful functions as follows:
  139.  
  140.   F1 - Shows the palette manipulation dialogue-box [TextureGdn.Palette].
  141.   F2 - Save sprite [TextureGdn.SaveSprite].
  142.   F3 - Save text [TextureGdn.SaveText].
  143.        (also SHIFT-F3: save text with no prompt).
  144.   F4 - Save animation [TextureGdn.Animation].
  145.   F5 - [Options.Screen].
  146.   F6 - [Options.Output].
  147.   F7 - [Options.Animation].
  148.   F8 - [Options.Templates].
  149.   F9 - Loads the texture's textfile generation program into a text editor.
  150.  F10 - Copies options to preferences [Options.CopyOpts].
  151.  
  152. Items in square brackets indicate the equivalent menu options.
  153.  
  154. Operations F1, F2, F3, F4 and F9 will be applied to the texture under the
  155. pointer at the time the hot key is pressed.
  156.  
  157. 3.0 Options
  158. ~~~~~~~~~~~
  159. There are currently options to control a number of aspects of the program's
  160. operation.  Most of these are available through the options menu which may
  161. normally be accessed by pressing menu over a blank area of the control panel
  162. or the main window.
  163.  
  164. Options take effect when the "OK" icon is clicked on.  They may be copied to
  165. the preferences which may then be saved to disc.
  166. This saves the positions and states of the other windows as well, enabling
  167. them to be set up as the user wishes.
  168.  
  169. There are four main section of options available through the menu: "General",
  170. "Output", "Animation" and "Templates".  These mirror the settings in the 
  171. preferences windows.  These are explained below.
  172.  
  173. 4.0 Preferences
  174. ~~~~~~~~~~~~~~~
  175. Preferences are options which may be saved to disc.
  176. The preferences window may be accessed by means of an ADJUST-click on the icon
  177. bar icon, or through the icon bar menu by selecting the "Prefs..." entry.
  178.  
  179. Preferences may be copied to the options of the main program by c