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