home *** CD-ROM | disk | FTP | other *** search
/ Computer Panoráma / computer_panorama_1997-12-hibas.iso / SHARE / GRAPH / SPI31V10.ZIP / README.TXT < prev    next >
Text File  |  1997-08-28  |  9KB  |  162 lines
  1. Spirograph 1.00  (C) Michael Husted
  2. ===================================
  3.  
  4. About installation - see INSTAL31.TXT
  5.  
  6. Sorry about my English, but I just didn't bother finding the dictionary and
  7. grammar to write this document :-)
  8.  
  9. ABOUT THE PROGRAM
  10.  
  11. This program draws some very pretty graphic figures from the parameters, that
  12. you enter. Try it out, and you may be amazed. The program is freeware. Feel
  13. free to distribute it to anyone, upload it to a BBS or put it on a CDROM.
  14.  
  15. INSTRUCTIONS
  16.  
  17. To get an impression of the program, I can suggest, that you begin with
  18. pressing "AutoRun", which draws random figures until you press "Stop Draw".
  19.  
  20. In manual mode you can enter parameters for drawing figures, which can be
  21. differed for the x- and y-axis. If you don't enter a value in the y-column,
  22. the same value is used here as entered in the x-column. 
  23.  
  24. The figures are calculated from the following formula:
  25.  
  26. x = cos(t)^xPwr1 - xFreq * cos(xAmp * t)^xPwr2
  27. y = sin(t)^yPwr1 - yFreq * cos(yAmp * t)^yPwr2
  28.  
  29. "Amp" is the "amplitude". For example will 0.1 give a little change from
  30. the correct circle of 1/10, while 1 gives a change from the correct circle of
  31. the radius of the circle, and 1 a change larger than radius. Negative values 
  32. will rotate the figure a little.
  33.  
  34. "Freq" is the frequency. This is the number of "leaves", that you will get 
  35. on the figure (actually it's one more than the number you enter). If you enter
  36. a negative value, the "leaves" are drawn towards the centre of the figure 
  37. instead of normal "leaves" of a flower. When negative values are used, the 
  38. number of leaves is one less than the number entered. Decimal values can be
  39. used too.
  40.  
  41. "Pwr1" and "Pwr2" are powers, to which the calculated values can be raised to.
  42. For example if you use the power 2 for all field, you will see, that a 
  43. square will be drawn (with leaves accordingly to "Amp" and "Freq"), which is
  44. given from the "oldie": sin^2(x)+cos^2(x)=1. Negative powers can be used for
  45. drawing only a part of the figure.
  46.  
  47. "Rot" is the rotation, and this is the percentage, that you wish the figure
  48. to be rotated. For example means 10, that the figure is rotated 10 percent.
  49. If you use a negative value, the absolute value is used as a factor, to which 
  50. the first cosine/sine value is multiplied, when drawing the value.
  51.  
  52. "Wst" is the whisting value, and you can strech the figure by entering another
  53. value than zero here. For example to illustrate this parameter, try 10. If you
  54. use 50, the figure is "reversed" (try it - can't be described) until you get
  55. to 100, which is the same as 0 (no whisting). A negative value multiplies the
  56. absolute value of this field to the "Amp"-value. By using 6 to 8 you will get a
  57. ribbon-like figure.
  58.  
  59. You can click on < and > , when a field got focus, to change the value 
  60. down/up. Doubleclick will change the parameters with ten times the speed.
  61.  
  62. You have the possibility to change the foreground and background colour using
  63. "Foreground" and "Background". You can erase the screen using "Clean", if
  64. "AutoClean" isn't active, and you can save and load drawn pictures or their 
  65. parameters, if you wish to draw the same figure again in an easy way.
  66.  
  67. Eventually try loading the DEMO-?.PAR-files, which illustrate the capabilities
  68. of the program better than all my descriptions. You can also print the figures,
  69. but be aware, that the "AutoRedraw" option should be turned on or you will not
  70. get anything printed, which also is necessary if you wish to save a picture.
  71. If you print a figure, you should consider changing the foreground and 
  72. background colours, as the printer will soon dry out of ink, if you print a
  73. figure using the default black colour! "AutoRedraw" turned on means, that if
  74. another window is positioned upon the figure, Windows will automatically 
  75. redraw it, and if it's turned off, the figure is not redrawn (i.e. there is
  76. a "hole", where the window was). The speed of drawing is although lower,
  77. when AutoRedraw is turned on.
  78.  
  79. And now for the drawing: "Draw" (as you might have figured out:-) draws a
  80. figure with the entered values. If no values are entered, a random figure
  81. is drawn. "AutoRun" always draws random figures, and you can stop the "AutoRun"
  82. mode using the "Stop Draw" button, which is actually the same button.
  83.  
  84. "Close" closes the program after asking, if you wish to save the setup.
  85. But this button has more functions. It can be used for changing the setup
  86. while running the program, by entering ! in the x-column of "Amp". Then you
  87. enter setup parameters in the other fields. See SETUP PARAMETERS for this.
  88. You can open this file by entering ? in the x-column of "Amp" and click 
  89. "Close".
  90.  
  91. Other facilities: If you wish to draw more figures on the same screen,
  92. turn off "AutoClean" and click with the mouse on the corner, from which you
  93. want to draw from, hold down the mouse botton, and release, when you get to
  94. the corner (diagonally) to which, the figure should be. If you don't see a
  95. line, when choosing the last corner, change the value "Mouse Delay" in the
  96. setup parameters to a larger value.
  97.  
  98. SETUP PARAMETERS
  99.  
  100. In the text file SPIRODEF.TXT the setup parameters are saved. Most of these
  101. can be changed from the program too as described earlier (use ! in the X-Amp).
  102. In the description below the field names (for example Y-Pwr2 means the Pwr2 
  103. field in the y column) are found in the []-brackets after the description.
  104.  
  105. You can use everything after the ' for comments, but if you save settings in
  106. the program, these comments are lost! (This is not a good solution, but a
  107. coming version of the program should take hand of this).
  108.  
  109. 255 ' foreground colour (red) 
  110. 255 ' foreground colour (green)  <- 255 in all these results in white 
  111. 255 ' foreground colour (blue)  
  112. 0 ' background (red)
  113. 0 ' background (green)   <- 0 in all these results in black
  114. 0 ' background (blue)
  115. 0 ' 1=random choice of foreground colour / 2=random choice of background
  116.     3=both 1 & 2 [Y-Pwr2]
  117. 0 ' frame background colour (RGB)
  118. 65535 ' frame foreground colour i.e. texts like "Freq" (RGB)
  119. 1 ' AutoClean (1=Auto clean screen, when a new figure is drawn)
  120. 0 ' AutoRedraw (1=screen is automatically redrawn, if other windows have
  121.     "spoiled" it. Also set this to 1, if you wish to save or print a figure,
  122.     but beware, that drawing figures takes more time, when this is on.
  123. 300 ' step size - the size of the steps used, when a figure is drawn.
  124.       The larger this value the longer drawing time, but you may have to
  125.       lower this program, if you want to draw advanced figures. I use 1000
  126.       on my oldie (486/66), which gives rather coarse drawn figures. [X-Pwr1]
  127. 1 ' numbers of times, a drawing should be repeated. If you draw advanced
  128.     figures, use a larger number than one, and if you use an old and slow pc,
  129.     use a lower value. [X-Freq]
  130. 1 ' pen size (the thickness of the drawing pen  - 1 is recommended)  [Y-Amp]
  131. 13 ' draw mode - not all values are interesting, but nevertheless:
  132.      1=blackness / 2=not merge / 3=mask not pen / 4= not copy
  133.      pen / 5=mask pen not / 6=invert / 7=xor pen / 8=not mask pen /
  134.      9=mask pen / 10=not xor pen / 11=no operation / 12=merge not pen /
  135.      13=copy (default) / 14=merge pen not / 15=merge pen / 16=whiteness
  136.      Some of the invert/xor modes are interesting, if you change the pen size
  137.      and turn off the AutoRedraw. [Y-Freq]
  138. 0 ' Height of the program window (0=height is set to screen height)
  139. 0 ' Distance from top of screen to program window
  140. 0 ' Width of the program windows (0=suitable for the height - recommended)
  141. 0 ' Distance from the left size of the screen to program window
  142. 0 ' The distance of the frame from the right edge of the program window.
  143.     With some screen drivers, you will have to raise this value to 50 or 100.
  144. 50 ' Distance (x) from left side of program window when drawn [Y-Rot]
  145. 50 ' Distance (y) from top of program window when drawn [Y-Wst]
  146. 1 ' Part of screen used (x) (1=all screen width - recommended)
  147. 1 ' Part of screen used (y) (1=all screen height - recommended)
  148. 300 ' Mouse delay used, when clicking on the screen is used for determin