home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / graphics / polydraw_1 / !PolyDraw / !Help < prev    next >
Text File  |  1997-08-29  |  11KB  |  284 lines
  1.                             !PolyDraw 
  2.  
  3. The PolyDraw application can draw two kinds of plot for
  4. one of a set of stored polyhedra.
  5.  
  6. Starting the application:
  7.  
  8. Click on !PolyDraw to load it on to the icon bar.
  9.  
  10. Stopping the application:
  11.  
  12. Click MENU over the icon on the iconbar and choose the
  13. last option, 'quit'. If windows are hiding the icon bar,
  14. press key F12 while holding down the SHIFT key, to bring
  15. the iconbar to the front of the windows.
  16.  
  17. Turn on !Help (in Apps) for continuous help over windows
  18.  
  19. Click SELECT over the !PolyDraw icon on the icon bar to
  20. see the 'Selected Polyhedra' window, which shows blue
  21. polyhedron names in white boxes. 
  22.  
  23. Red titles separate the types of polyhedra.
  24.  
  25. Some polyhedra have alternate names listed below them in
  26. green. Use the scroll bar to see more polyhedra names.
  27.  
  28. Plot a polyhedron either by clicking SELECT on a blue
  29. name, by dropping a data file on to the icon on the 
  30. iconbar, or by double clicking on a data file with 
  31. filetype 'PolyData' 152. (Click ADJUST over a 
  32. highlighted blue icon to display the data in an editor.)
  33.  
  34. You should see more windows, there are three by default,
  35. showing different forms of plot, with a planar net on the
  36. left, a wire 3D solid view on the right, and text 
  37. describing the solid in a small window on the left below. 
  38.  
  39. Rotating the solid:
  40.  
  41. The arrowed Cursor keys, and the 'Page up' and 'Page down'
  42. keys rotate the solid; < and > change its size, when the 
  43. top bar of the 3D window is coloured yellow.
  44. Click SELECT anywhere inside the window to turn the top
  45. bar yellow when it is grey. 
  46.  
  47. Hold down the 'CTRL' key at the same time as you press 
  48. a cursor key for continuous rotation at timed intervals. 
  49. Stop this by pressing any key or clicking the mouse. 
  50. If your computer is very fast you can get faster rotation
  51. by holding down a cursor key. 
  52.  
  53. The default angle through which the solid rotates is 10°.
  54. To change this click MENU over the 3D window as described
  55. below.
  56.  
  57. Click over the direction 'rotation' icons of the 'tools' 
  58. pane to rotate the solid, or hold down a mouse key for 
  59. continuous rotations. The SELECT button gives rotation 
  60. one way, ADJUST the opposite way.
  61.  
  62. 3D MENU and plotting options
  63.  
  64. The 3D window has the name of the polyhedron as the title
  65. of the window. Click MENU over the 3D window to:
  66.  
  67.  • change the form of the display. 
  68.    Forms are:
  69.    - a 'wire' frame view, front edges black,
  70.       back ones green
  71.    - red/green stereo 2 'wire' plots to see as 3D
  72.    - onecolour - all faces are the same colour, white by 
  73.       default for grey scale shading 
  74.    - datacolour - face colours are set by the colour
  75.       index read from the data file. These can be changed
  76.       on the screen; all faces with that colour index
  77.       will change.
  78.    - sidecolour - face colours depend on the number of
  79.       sides of the polygon making the face.
  80.    - localcolour - initially the same as datacolour, but
  81.       now if the colour is changed, only the one face
  82.       changes. Try colour 'None' on a face to see inside.
  83.    All coloured forms can be shaded using the sub-menu.
  84.    To see them correctly shaded the mode of your Desktop
  85.    should use at least 256 colours.
  86.  • alter the angle by which the 3D solid is rotated for
  87.    one key press, or mouse button click.
  88.  • add perspective to the plot (useful for stereo pairs)
  89.  • change the light direction
  90.    (only affects the shaded types)
  91.  • see the 'tools' pane
  92.  • ask to see the dual of this polyhedron, provided it is
  93.    named in the data file. 
  94.  • save the plot as a Draw file in the usual way by
  95.    dragging icon to a filer window.
  96.  
  97. Click SELECT over a face or vertex to list its number,
  98. colour number, and number of vertices in the face in a
  99. small 'Face Data' window at lower right.
  100.  
  101. Click ADJUST over a face to change its colour using the
  102. Acorn 'Colour Picker' window, the results depend on which
  103. display form you have selected. Colour 'None' allows you
  104. to see though the face to the inside of the polyhedron, 
  105. where all faces are drawn black with white lines round them.
  106. If you make enough faces colour 'None' you can see through
  107. the polyhedron to the other side.
  108.  
  109. Measuring distances and angles on the 3D solid
  110.  
  111. You can measure:
  112.  
  113.  • a distance (D) between 2 points (must be different)
  114.  • the angle between 2 lines  (A) defined by 3 points
  115.  • the angle between 2 planes, the inter-planar angle (I)
  116.      defined by 2 faces
  117.  
  118. First tell the program which measurement to do by:
  119.  
  120. either clicking SELECT over the icon in the tools pane
  121.  or    by pressing one of the 'short cut' keys, D, A, I
  122.          (the letters in the ( ) above) 
  123.  
  124. The text in the small 'face data' window changes to tell 
  125. you what to do next. Define a face by clicking SELECT
  126. over it; define a vertex by clicking SELECT over it.
  127. Click ADJUST anywhere in the 3D solid window to abandon
  128. any measurement. 
  129.  
  130. A 'bell' sound while measuring means the program does not
  131. understand what you want; make sure the pointer is over a 
  132. face, or near to a vertex before clicking again. 
  133. A successful click gives a line in the 'face data' window
  134. telling you the point or face you clicked over. The last
  135. line gives the result of the measurement.
  136.  
  137. Notes:
  138.  1. The distance is scaled to the original size as in the
  139.      data file before printing, it does not depend on the
  140.      size seen on the screen.
  141.  2. An interplanar angle of
  142.     •   0° means the faces are in the same plane
  143.     • 180° means the faces are parallel to one another, 
  144.       but are pointing in opposite directions.
  145.  
  146. Net plotting options
  147.  
  148. The net window also has the name of the polyhedron 
  149. as the window title. Click MENU over the net window to:
  150.  
  151.  • change the form of the display, the colours are the
  152.     same as those for the 3D solid.
  153.  • save the plot as a Draw file.
  154.  
  155. Click SELECT over a face or vertex to list its number,
  156. colour number, and number of vertices in the face in a
  157. small 'Face Data' window at lower right.
  158.  
  159. Click MENU over the icon on the icon bar for a menu
  160. where you can turn off any of the display windows,
  161. save the choices, display this help,
  162. show the 'selections' window or quit.
  163.  
  164. Making Selections
  165.  
  166. You can change the list of polyhedra either by dropping
  167. a file from the 'PolyLists' directory on to the icon on
  168. the icon bar, or by using the 'Selections' window. 
  169. You can get this either by choosing 'Select' from the 
  170. menu over the iconbar icon or by clicking with MENU 
  171. over the polyhedron list window.
  172.  
  173. This window is divided into three parts.
  174.  
  175. 1) Down the left side you can select the type of
  176. polyhedra to display. At least one of the boxes will
  177. always be selected. Either use 'All' or any number of
  178. the types below. Click SELECT or ADJUST over box or name
  179. to change its state. A 'tick' or other symbol in the box
  180. means this type of polyhedron will be selected.
  181.  
  182. 2) The top part of the right hand side then lets you
  183. restrict the selection to polyhedra having:
  184.  • a text string as part of its name,
  185.  • faces with a range of numbers of sides,
  186.  • a range of numbers of faces
  187. The default values for these ranges are the minimum and 
  188. maximum found in the types in the PolyList file. The
  189. selection is active only if it is ticked.
  190.  
  191. Click with SELECT over the white indented boxes to see
  192. the caret, then type into them, pressing the RETURN key
  193. at the end, which will store the data and tick the box
  194. above to show that the selection is active.
  195.  
  196. Alternatively use the up/down arrow icons to the right of
  197. the numeric selections.
  198.  
  199. For example, to select only solids made of triangles and 
  200. squares, with less than 20 faces, type 4 into the
  201. 'polygon sides' max box, and 20 into the 'polyhedron
  202. faces' max box.
  203.  
  204. 3) the action icons at the bottom right:
  205.  • Save the selections to the Choices file for use next
  206.    time you use the program,
  207.  • Cancel the changes you have just made to the
  208.    selections,
  209.  • Reset the selections from the Choices file
  210.  • OK to apply the choices
  211. In fact all these actions apply the selections and open
  212. the Polyhedron list window. Clicking with ADJUST over the
  213. actions leaves the Selection Window open so you can
  214. compare the selections with the resulting list of
  215. polyhedra while clicking SELECT closes the window.
  216.  
  217. Key shortcuts
  218.  
  219. You may prefer to use the keyboard instead of the mouse.
  220.  
  221. The following keys are used in !PolyDraw:
  222.  
  223.  • F1  displays this on-line help
  224.  • F12 with SHIFT brings the iconbar to the front
  225.  
  226.  • <> make the 3D solid view bigger and smaller within limits
  227.  • arrow keys and 'Page Up', 'Page Down' rotate the solid
  228.      CTRL with any rotate key gives continuous timed rotations
  229.  
  230.  •  D (or d ) measure a distance between 2 vertices
  231.  •  A (or a ) measure an angle between 3 vertices
  232.  •  I (or i ) measure an inter-planar angle
  233.  
  234. Making a stereo pair Draw file
  235.  
  236. You can see a red/green stereo view on the screen, to see
  237. it in 3D use the red/green cardboard viewing glasses
  238. provided. It is often easier to see the effect if the
  239. solid is rotating. Red/Green stereo cannot be easily seen
  240. in a Draw file because these do not have a black
  241. background. 
  242.  
  243. You can see stereo in a Draw file using two
  244. 'side-by-side' stereo images. Some people can defocus
  245. their eyes slightly, to see the polyhedron in 3D. ( I
  246. can't do this myself,  I need to have a small cardboard
  247. viewer with clear plastic lenses. We are trying to find
  248. a cheap source of these; if you know of one please let us
  249. know the address.
  250.  
  251. The file 'Docs.Stereo' is an example of a 3D plot. You
  252. make it by saving one plot to a Draw file; use !Draw to
  253. reduce the size to fit in a square of about 6.5cm on a
  254. side. Then rotate the plot in !PolyDraw by 5 degrees to
  255. the left in the X direction, save the plot to the same
  256. Draw file, use !Draw to fit the plot into a 6.5cm square,
  257. and place it just to the right of the 1st one. The 6.5cm
  258. is the distance between your eyes, if yours are a
  259. different distance, use that instead. 
  260.  
  261.  
  262. Further information:
  263.  
  264. This is stored in the directory '!PolyDraw.Docs' 
  265. including an explanation of all files needed, 
  266. definitions of file formats and instructions on 
  267. how to add your own new polyhedra.
  268.  
  269. Look at the Draw file 'Docs.DrawEx1',
  270. to see how the appearance changes with the 
  271. different forms of display. 
  272.  
  273. Fault Reports:
  274.  
  275. If you find an error, please copy the file
  276. 'Docs.FaultRep' to another one, named for example
  277. 'EReport', and use an editor to complete the form to
  278. tell us what you were doing when the error happened.
  279. Send the report to us at the address below, preferably
  280. with an example data file. The more details you can give
  281. us the more likely it is that we shall be able to
  282. reproduce your problem and correct the fault.
  283.  
  284. 'Fortran Friends', P.O.Box 64, Didcot, Oxon, OX11 0TH