home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 047.lha / SpiroDraw / SpiroDraw.doc < prev    next >
Text File  |  1986-11-20  |  7KB  |  159 lines
  1.  
  2.                   "Spiro Draw"
  3.  
  4.                    Written by:
  5.                   Jon G. Walke
  6.                    Lompoc, CA
  7.  
  8.                    Version 1.0
  9.                     July 1987
  10.  
  11. This program is freely distributable for noncommercial
  12. use as long as the credit screen and this file remain
  13. with the program and no charge is made for the program.
  14. (SMALL duplication and distribution fees may be charged
  15. to redistribute this program on public domain disks).
  16.  
  17. This program lets you setup and draw "Spirograph" pictures.
  18. This version of SpiroDraw was written in AmigaBasic and
  19. compiled with AC Basic.  You can setup any two wheel com-
  20. bination and draw with 16 different colors.  Although it
  21. takes a while (2.5 mins to read, 1.5 mins to write), you
  22. can save and restore the SpiroDraw pictures in IFF format.
  23.  
  24. The archieve should contain a file called "wait.p".  This
  25. file contains a "WAIT" message sprite used by the program
  26. and must be in the same directory as the program.  Execute
  27. the file "execute.me" to rename the .info file for this
  28. program.
  29.  
  30.  
  31.  
  32. INSTRUCTIONS:
  33.  
  34. For those who are unfamiliar with "Sprirograph", there are
  35. two wheels, a larger one and a smaller one.  The smaller wheel
  36. can be put on the inside or outside edge of the large wheel
  37. (actually, the large "wheel" is a ring).  Then a pen is put in
  38. a hole in the smaller wheel and the smaller wheel is rotated
  39. around the edge (inside or out) of the larger ring and a pattern
  40. is produced (You get different patterns depending on the sizes
  41. of the ring and the small wheel and where the pen is placed in the
  42. smaller wheel as well as whether it is rotated around the inside
  43. or outside).  A "Spirograph" set actually has other shapes that
  44. can be used, but this program only does a ring and a wheel.
  45.  
  46. The program is run by two menus: PROJECT and SETUP.  Each of these
  47. menus have the following selections (Highlight the desired selection
  48. by pressing and holding the right mouse button and move the mouse to
  49. the right selection, then release):
  50.  
  51. PROJECT:
  52.  
  53. Erase Screen - This will erase the entire screen to start a new
  54.                picture.
  55.  
  56. Draw Setup - This will draw a pattern using the setup that is
  57.              presently set in the SETUP menu.  (There is a default
  58.              setup when the program is first run.)  After the
  59.              selection is made, a color bar will appear at the
  60.              top of the screen.  Select the desired color to draw
  61.              the pattern with and the drawing will start.  Anytime
  62.              while the program is drawing, you can hit the space
  63.              bar to stop the drawing and change colors or quit
  64.              drawing the present pattern.  This way multiple colors
  65.              can be used in the same pattern.
  66.  
  67.              NOTE:  THE ONLY WAY TO STOP DRAWING THE PRESENT PATTERN
  68.                     IS TO HIT THE SPACE BAR AND THEN CHOOSE QUIT,
  69.                     OTHERWISE THE PATTERN CONTINUES TO BE DRAWN AND
  70.                     THE MENU SELECTIONS DO NOT WORK.  EVEN IF THE
  71.                     PATTERN IS COMPLETE, IT WILL CONTINUE TO DRAW OVER
  72.                     ITSELF UNTIL YOU HIT THE SPACE BAR AND SELECT QUIT.
  73.  
  74. Open IFF - This will open a previously saved picture from disk.  You
  75.            will be prompted for the name of the file (include the drive:
  76.            path/).  If a nonexisted file is entered, the program will just
  77.            stop with an error message.  Just start the program again.
  78.            The loading of a file takes approximately 2.5 mins.  This is
  79.            long, but the best I could do with BASIC.  Actually, any
  80.            640x200, 16 color picture can be loaded. If the file exists,
  81.            but is not a 640x200, 16 color picture, the program will give
  82.            a message saying so and continue.
  83.  
  84. Save as IFF - This will save your present screen as an IFF standard format
  85.               picture which can later be loaded into DPAINT or printed out
  86.               with other software.  The saving process takes about 1.5
  87.               minutes, but the best I could do with BASIC.  The picture is
  88.               not saved in a compressed format, so you will need approxi-
  89.               mately 64K of space to save a picture.
  90.  
  91. Quit - This does just what it says and quits the entire program.
  92.  
  93.  
  94.  
  95. SETUP:
  96.  
  97. Center - This determines where the center (in pixels) of the pattern will
  98.          be.  The screen is 640x200 pixels.
  99.  
  100. Big Wheel Radius - This sets the radius (in pixels) of the big wheel (ring).
  101.                    The radius is to the inside if the little wheel is set
  102.                    to rotate on the inside and it is the radius to the
  103.                    outside if the little wheel is set to rotate around the
  104.                    outside.
  105.  
  106. Little Wheel Radius - This sets the radius (in pixels) of the little
  107.                       wheel.
  108.  
  109. Toggle IN/OUTside - This toggles whether the little wheel will rotate
  110.                     around the INside or OUTside of the big wheel (ring).
  111.  
  112. Radius to Pen - This sets the radius (in pixels) from the center of the
  113.                 little wheel to the pen in the little wheel.
  114.  
  115. Orientation Angle - This determines where the little wheel will start
  116.                     around the circumference of the big wheel (the
  117.                     result is that the pattern will be rotated by this
  118.                     angle).  Zero degrees is to the right and the angle
  119.                     increases couterclockwise.  ie: 90 is up, 180 left
  120.                     and 270 down.
  121.  
  122. Angular Step - This sets how many degrees (around the big wheel) the
  123.                little wheel will be moved for each step.  If your pat-
  124.                tern is not solid enough, then decrease this value.  The
  125.                pattern will be more solid the lower this value, but it
  126.                will also take longer to draw.
  127.  
  128. Change Palette - This will allow you to change the RGB value for each of
  129.                  the sixteen colors.  Click on the color to be changed and
  130.                  the present value will be displayed and you will be asked
  131.                  to enter a new RGB value.
  132.  
  133.         NOTE:  SINCE THE PROGRAM IS NOT PHYSICALLY CONSTRAINED, VALUES FOR
  134.                THE SIZES OF THE WHEELS AND RADIUS TO THE PEN CAN BE USED
  135.                THAT WOULD NOT BE PHYSICALLY POSSIBLE WITH A "SPIROGRAPH"
  136.                SET.  IE:  THE RADIUS TO THE PEN CAN BE LARGER THAN THE
  137.                RADIUS OF THE LITTLE WHEEL, OR THE LITTLE WHEEL CAN BE
  138.                LARGER THAN THE BIG WHEEL AND STILL ROTATE ON THE INSIDE.
  139.                THESE TYPES OF COMBINATIONS CAN PRODUCE SOME INTERESTING
  140.                PATTERNS.
  141.  
  142. Please let me know if you have any suggestions or improvements for furture
  143. upgrades of this program.
  144.  
  145. Have Fun!
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.            
  155.          
  156.  
  157.  
  158.  
  159.