home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / graphics / polynet_1 / ReadMe < prev   
Text File  |  1997-08-31  |  9KB  |  227 lines
  1.                       !PolyNet (Demo Version)
  2.   'Fortran Friends', P.O.Box 64, Didcot, Oxon, OX11  0SE
  3.               telephone:  +44  (0)  1235  834357
  4.  
  5. Introduction
  6.     !PolyNet is an interactive program which creates planar nets from files
  7. containing data on how to draw polyhedra.  The full version allows you to
  8. save Draw and datafiles; you cannot save any files with this demo version,
  9. you can only use the supplied datafiles, and cannot change the 'Choices' file.
  10.  
  11. Machine and operating system requirements: Any Acorn computers using RISC-OS
  12. operating systems  3.XX, including networks and StrongARM.
  13.  
  14. Copyright and copying: 
  15. This program remains the copyright of 'Fortran Friends'; this demo version
  16. is given to you on the understanding that if you give a copy to anyone else
  17. you will copy all the files, unchanged, including this one.
  18.  
  19. To get the Full Version:
  20.  
  21.  Send a cheque for £20 payable to 'Fortran Friends' at the address above. 
  22.  
  23.   With the full version you can:
  24.  
  25.   1. Save diagrams as 'Drawfiles' and data files for use later.
  26.   2. Use more datafiles: any of the Platonic and Archimedean solids and duals.
  27.   3. Use your own new datafiles
  28.   4. Read more documentaion (see contents of full version directory Docs below)
  29.   5. Send us suggestions for improvements and report problems which we will
  30.       try to correct.
  31.  
  32. --------------------------------------------------------------------
  33.                       Contents of the !PolyNet Demo Disc
  34.                        
  35. Top level directory
  36.  
  37.   !PolyNet application
  38.   Calend98 - a dodecahedron for you to make into a 3D calendar for 1998
  39.   ReadMe (This file)
  40.  
  41.   Examples Directory
  42.    This contains the datafiles. 
  43.  
  44.    Within the !Polynet application, in addition to the usual files, 
  45.    there is a sub-directory 'Docs' which contains some example Drawfiles
  46.  
  47.      Defn     - a Drawfile with an explanatory diagram showing some
  48.                   of the terms used in 'Glossary'
  49.      NetEx1, NetEx2 - two examples of nets saved from !PolyNet
  50.      WorkEx1  - an example of a worksheet for students
  51.  
  52. ------------------------------------------------------------------
  53.        
  54. The rest of this file is the 'ReadMe' from the full version.
  55.  
  56. **************************************************************************
  57.                             !PolyNet
  58.   'Fortran Friends', P.O.Box 64, Didcot, Oxon, OX11  0SE
  59.               telephone:  +44  (0)  1235  834357
  60.  
  61. Introduction
  62.  
  63.     !PolyNet is an interactive program which creates planar nets from files
  64. containing data on how to draw polyhedra, such as that used in !PolyDraw. 
  65.  
  66. Machine and operating system requirements: 
  67.  
  68. Any Acorn computers using RISC-OS operating systems  3.XX, 
  69. including networks and StrongARM.
  70.  
  71. Copyright and copying: 
  72.  
  73. Further details are in the file Docs.CopyRight.
  74. This program remains the copyright of 'Fortran Friends': it is licensed to
  75. you for single use only; you may copy it to a backup floppy disc or to your
  76. own hard disk but giving copies to others is illegal.   Your registration
  77. number is unique; any illegal copies found will be reported to the
  78. 'Federation Against Software Theft' and you will be liable for prosecution.  
  79.  
  80. Getting Started:
  81.  
  82. These instructions assume some knowledge of how to use an Acorn computer. 
  83. If you are a new user, more detailed instructions on how to copy files, use
  84. the windows and the mouse can be found in the 'User Guide' manual for your
  85. computer system. !PolyNet is a RISC-OS compliant program which runs in the
  86. Acorn Desktop and tries to conform to the operating conventions in the Acorn
  87. Style guide; it supports Acorn interactive help.
  88.  
  89. Fortran Friends welcome comments and requests for new features for future
  90. versions of this program. 
  91.  
  92. --------------------------------------------------------------------
  93.                       Contents of the !PolyNet Disc
  94.  
  95. Top level directory
  96.  
  97.   !PolyNet application
  98.   Calend98 - a dodecahedron for you to make into a 3D calendar for 1998
  99.   ReadMe (This file)
  100.  
  101.   Examples Directory
  102.    This contains an index, in file 'ExIndex', to the data files, which make 
  103.    the Platonic and Archimedean solids, their duals and a few others. 
  104.  
  105.    Within the !Polynet application, in addition to the usual files, 
  106.    the directory 'Docs' contains:
  107.  
  108.    Text files
  109.      Activities - some suggested activities to get you started
  110.      BookKits   - suggested reading, and suppliers of model kits
  111.      CopyRight - a statement of 'Fortran Friends' copyright
  112.      FaultRep - a form for you to return if you find any problems
  113.      FormData - a definition of the format of the data files
  114.      Glossary - definitions of terms associated with polyhedra
  115.      Versions - history of changes in previous versions
  116.      WishList - requested improvements
  117.  
  118.    Draw files
  119.      Defn     - a Draw file with an explanatory diagram showing some
  120.                 of the terms used in 'Glossary'
  121.      NetEx1, NetEx2 - two examples of nets saved from !PolyNet
  122.      WorkEx1  - an example of a worksheet for students
  123.               We would be most grateful for copies of further worksheets
  124.               to pass on to other users.
  125.  
  126.  Please send yours and any other suggestions to 'Fortran Friends' 
  127.     at the address above.
  128.      
  129.  --------------------------------------------------------------------
  130.  
  131. Installing !PolyNet
  132.  
  133. 1. Make a working copy on floppy disc. Store the original safely, in case
  134. your working copy becomes damaged. Your license allows you to make a
  135. single copy for your own use. If the disc supplied has been damaged and
  136. will not copy, return it to us for a free replacement within 3 months of
  137. purchase.
  138.  
  139. Use the 'working' copy for the rest of the instructions. You can run from the
  140. floppy if you want to.
  141.  
  142. 2. Installation on hard disc: 
  143. Make yourself a directory for storing your programs, with
  144. a name such as 'Polyhedra' and copy the contents of the floppy disc to it.
  145.  
  146. 3. Read the Documentation. 
  147. Before trying to run the application, look at the file !Help file for
  148. operating instructions and in the sub-directory 'Docs'  which includes
  149. suggested activities and worksheets, a glossary of terms and example
  150. Draw files.  You may want to print these out for future reference.
  151.  
  152. Operating instructions:
  153. Running instructions are in the file !Help of the application; Acorn
  154. interactive help is supported.
  155.  
  156. Starting the program:
  157.  
  158. 1. Double click on the application !PolyNet to start the program, and load
  159. an icon on to the iconbar. Click the mouse 'MENU' button when the pointer is
  160. over this icon to see the options.  Select 'info' to see the program name,
  161. version number and your registration number, which should be quoted in any
  162. correspondence with 'Fortran Friends'.
  163.  
  164. 2. Drag any of the files from the 'Examples' directory on to the icon to
  165. open a window showing the polyhedron drawn as a 3D solid.  Click with the
  166. 'Select' button over the first face which you want in the planar net. This
  167. opens the 'net' window and shows you that face.  Then click on the next face
  168. you want, which should be adjacent to one of the ones you have drawn
  169. previously. When you have clicked on all the faces a small window appears
  170. allowing you to save a Drawfile. See !Help for further instructions.
  171.  
  172. Stopping the program:
  173. Click 'MENU' over the icon on the iconbar and choose the last option, 'quit'.
  174.  
  175. Displaying your own data files:
  176.  
  177. The format of the data files is defined in the file Docs.FormData which
  178. lists all the possible lines of the file. You need not make all the lines,
  179. but the first line must have the string ':name ' as the 1st 6 characters,
  180. and the last line must begin ':end'.  The faces must be described in
  181. clockwise direction as they are seen from inside the polyhedron. If they are
  182. not, the results are unpredictable, usually, the face is missing from the 3D
  183. plot. 
  184.  
  185. For example:
  186.  
  187. :name my new cube
  188. :comment designed by me on 22 June 97
  189. :solidf 6 4
  190.  4 1 2 3 4 1
  191.  4 4 5 6 1 2
  192.  4 2 1 6 7 7
  193.  4 8 3 2 7 5
  194.  4 8 5 4 3 3
  195.  4 6 5 8 7 4
  196. :solidv    8
  197.    0  0.8 0.58
  198.  -0.8 0 0.58
  199.  0 -0.8 0.58
  200.  0.8 0 0.58
  201.  0.8 0 -0.58
  202.  0 0.8 -0.58
  203.  -0.8 0  -0.58
  204.  0 -0.8 -0.58
  205. :end
  206.  
  207.  
  208. Possible Faults:
  209. Error conditions we have thought about have 'traffic sign' windows which
  210. should allow you to choose whether to stop the program or try to carry on.
  211.  
  212. If your working disc is damaged, you may find when you try to start the
  213. program you merely get an 'error window' saying your user registration file
  214. has been corrupted. Delete all the files from your working disc, and make a
  215. new copy from your original disc. 
  216.  
  217. If you find the program stops in an uncontrolled way, please try to write
  218. down details of what you were doing just before the error, and send them to
  219. us, preferably using the fault report form in file !PolyNet.Docs.FaultRep. 
  220.  
  221. If you have changed any of the !PolyNet files, or the fault is in reading a
  222. new polyhedron of your own, please check carefully that you have listed the
  223. face vertices in the correct order before contacting us. The usual symptom
  224. of this is that the face with incorrect vertices is not plotted in the 3D
  225. window.  Please supply copies of the files on floppy disc which you were
  226. using when the error occurred.
  227.