home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / pottery / !Pottery / !Help < prev    next >
Text File  |  1993-11-26  |  6KB  |  127 lines
  1. !Pottery
  2. ********
  3.  
  4. Version 2.10 3rd September 1993
  5. By Richard Seago 
  6. With routines from Rob Miller of BBC Acorn User (May 1990)
  7.  
  8. Pottery is a program which allows you to create solids of rotation from a
  9. simple path defined by a few mouse clicks.
  10.  
  11. Pottery has two windows. One in which you design the outline of your shape,
  12. and one in which you see what it looks like. The black one is the one which
  13. displays the shape. Because the program trys to use 256 colours it needs one
  14. of these modes to show the solid properly but it will try its best with the
  15. ColourTrans module in other modes and for printing (which produces best
  16. results with grey on a monochrome printer).
  17.  
  18. The left hand side of the edit window contains the functions. The long,
  19. vertical, black line is the axis about which the solids are formed. The
  20. functions are (from top to bottom):
  21.  
  22. i)   Line  - this draws a line on the edit window and a three dimensional
  23. shape in the draw window.
  24.  
  25. ii)  Move  - this draws a faint line in the edit window and allows gaps in
  26. the picture in the draw window.
  27.  
  28. iii) Grey  - this word changes telling you which hue the currently selected
  29. colours will produce on screen.
  30.  
  31. iv)  Blue  - this selects/deselects the blue component of the shape's
  32. colour.
  33.  
  34. v)   Red   - this selects/deselects the red component of the shape's colour.
  35.  
  36. vi)  Green - this selects/deselects the green component of the shape's
  37. colour.
  38.  
  39. The shape is entered as a continuous path. The path can be started at the
  40. top or bottom of the edit window, although the direction should be kept
  41. consistent through out because of the way that the shape is drawn. If the
  42. shape is drawn top down, in order to represent it correctly on screen the
  43. entire shape must be redrawn. This can slow things down for complex shapes
  44. so you may wish to turn off continous update. This option is in the 'Update'
  45. sub-menu which can be called up from the display window. There are no such
  46. problems if you draw bottom up, because the shapes are drawn in order that
  47. you might look at them from slightly above.
  48.  
  49. Each segment has a seperate colour characteristic which is set before it is
  50. drawn. However, this can be changed by clicking with Menu on the point
  51. before the segment you wish to change the colour of. The selected segment
  52. will turn orange, the colour may then be changed via the Colour sub-menu.
  53.  
  54. The last point in the path may be deleted or the entire path cleared. You
  55. may also drag any point with Adjust to change its position. If the program
  56. gets behind with updating the sprite, or you have turned off the continuous
  57. update option, you will have to select 'Update' from the draw menu to see
  58. the shape properly - this may take a few moments.
  59.  
  60. The sprite is also completely redrawn when you click Select on the iconbar
  61. icon. Adjust will open the edit window only. The windows can be closed
  62. separately, and no data will be lost. Mostly, however, the program is self
  63. explanatory and should display helpful messages if something's wrong.
  64.  
  65. The program can load and save in its own file format which can be treated as
  66. if it had just been created. The program can also save the 3D shape as a
  67. sprite file. The sprite will be saved as a sprite in whatever mode is
  68. currently in use.
  69.  
  70. A second method of inputting shapes into !Pottery is from a shape
  71. description file in the form of a text file. This allows greater accuracy
  72. and can be editted as if it were an ordinary !Pottery file. However it
  73. cannot be saved back as a text file. The file does not have to be
  74. filetyped as text as long as the format of the file is correct. The text
  75. file should be of the format:
  76.  
  77. Shape                   - This is a literal keyword and is case sensitive,
  78.                           it allows !Pottery to determine what sort of file
  79.                           has been loaded. It should always be the first
  80.                           word of the file and the file should be continued
  81.                           on the next line. Comments may be added but not on
  82.                           the first line of file. Any line whose first word
  83.                           is not one of those below, will be treated as a
  84.                           comment.
  85.  
  86. gcol <colour>           - This keyword allows you to set the colour of the
  87.                           path segments upto the next gcol. The <colour>
  88.                           parameter is a word from the following list:
  89.                                   grey or white
  90.                                   magenta
  91.                                   cyan
  92.                                   yellow
  93.                                   green
  94.                                   blue
  95.                                   red
  96.                                   clear or black (has the same effect as a
  97.                                                   move)
  98.  
  99. move xxx,yyy            - This keyword moves the drawing cursor to the point 
  100.                           xxx,yyy. It is up to the user to ensure that the
  101.                           points lie within the viewing area, as no error is 
  102.                           produced otherwise.
  103.  
  104. draw xxx,yyy            - This keyword draws from the previous cursor to the
  105.                           point xxx,yyy. The same constraints as above
  106.                           apply.
  107.  
  108. All these commands (and parameters) are case sensitive - if they are not
  109. correct they will be ignored as comments.
  110.  
  111. The print option uses RISC OS printer drivers. The printing of the shapes is
  112. not done from the sprite but from the outline so the best image possible
  113. should be produced on all printers.
  114.  
  115. If you should change modes within the desktop, !Pottery will take a few
  116. moments to readjust, making sure that the sprite appears the same size and
  117. in the best colours possible. It will also warn you on entering (or starting
  118. up in) a non-256 colour mode that it cannot do its best when drawing the
  119. shape in that mode.
  120.  
  121. The program is slightly naughty in that it uses RMA space to hold the
  122. sprite. This has never caused me any problems, and I don't see why it
  123. should.
  124.  
  125. I can only say that the best way to get to grips with !Pottery is to try it.
  126. The sprites produced can be very effective.
  127.