home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / graphics / stell_1 / ReadMe < prev   
Text File  |  1998-03-02  |  12KB  |  274 lines
  1.                      !Stellate (Demo Version)
  2.   ‘Fortran Friends’, P.O.Box 64, Didcot, Oxon, OX11  0TH
  3.               telephone:  +44  (0)  1235  834357
  4.  
  5. Introduction
  6.      !Stellate is an interactive program which creates uniform polyhedra and
  7. their stellations. The full version allows you to save:
  8.  • Draw files of the stellation diagrams,
  9.  • Draw files of the 3D solids,
  10.  • data files for Stellate,
  11.  • PolyData for PolyDraw and PolyNet.
  12. You can not save any files with this demo version and can only use the
  13. supplied data files.
  14.  
  15. Machine and operating system requirements: Any Acorn computers using RISC-OS
  16. operating systems: 3.XX, including networks and StrongARM with 288K spare
  17. Application memory space.
  18.  
  19. Copyright and copying: 
  20. This program remains the copyright of ‘Fortran Friends’; this demo version
  21. is given to you on the understanding that if you give a copy to anyone else
  22. you will copy all the files, unchanged, including this one.
  23.  
  24. To get the Full Version:
  25.  
  26.  Send a cheque for £20 payable to ‘Fortran Friends’ at the address above. 
  27.  
  28.   With the full version you can:
  29.  
  30.   1. Save diagrams and 3D views as ‘Draw’ files or to !Draw for printing and
  31.       combining with others.
  32.   2. Save new polyhedra for reading back into !Stellate
  33.   3. save PolyData for !PolyDraw and !PolyNet.
  34.   4. Use more data files; the standard distribution data file contains
  35.       instructions for drawing 112 polyhedra.
  36.   5. Use your own new data files.
  37.   6. Read more documentation (see below)
  38.   7. Send us suggestions for improvements and report problems which we will
  39.       try to correct.
  40.  
  41.                       Contents of the !Stellate Demo Disc
  42.                        
  43. Top level directory
  44.  
  45.   !Stellate demonstration application
  46.   Products - software available from Fortran Friends
  47.   AllPoly  - A squashed sprite showing all the polyhedra available on the
  48.              standard distribution data file.
  49.   ReadMe   - This file
  50.  
  51.   Within the !Stellate application, in addition to the usual files, there is
  52. the first standard tutorial (Tutorial1) which you may use with the demo
  53. restricted data file. There is also a sub-directory, ‘Resources’, with files
  54. used by the program. You must not change any of the files in this directory.
  55.  
  56. --------------------------------------------------------------------
  57.  
  58. Documentation files supplied with the full version of !Stellate
  59.  
  60.     Text files:
  61.  
  62.   BookKits   - WWW URLS, suggested reading, and suppliers of model kits
  63.   CopyRight  - a statement of ‘Fortran Friends’ copyright
  64.   FaultRep   - a form for you to return if you find any problems
  65.   Versions   - record of the differences between versions of !Stellate
  66.   WishList   - current planned enhancements for !Stellate
  67.  
  68.  
  69.     Directory ‘Reference’:
  70.  
  71.   Component  - Draw file showing the characteristics of the 9 possible
  72.                components used to make polyhedra in !Stellate
  73.   CrossRef   - listings of the polyhedra stored in ‘Resources.StellaList’
  74.                in various orders 
  75.   Faces      - Draw file showing the characteristics of the 9 possible
  76.                face types used to make polyhedra in !Stellate
  77.   FormChoice - defines the format of ‘Resources.Choices’ file
  78.   FormCols   - defines the format of ‘Resources.Colours’ file
  79.   FormComps  - defines the format of ‘Resources.Components’ file and
  80.                explains how to enter formulae instead of numbers
  81.   FormList   - defines the format of ‘Resources.StellaList’ file
  82.   Glossary   - defines terms associated with polyhedra
  83.   Intro      - explains what uniform polyhedra are and gives an introduction
  84.                on how to make them using !Stellate
  85.   ReadStel   - skeleton BASIC program for reading ‘Resources.StellaList’
  86.   WennError  - some problems in the stellation diagrams in the book:
  87.                ‘Polyhedron Models’ by M.J. Wenninger
  88.   WennIndex  - Type and alphabetical list of the polyhedra in 
  89.                ‘Polyhedron Models’ by M.J. Wenninger
  90.  
  91.     Directory ‘TryThese’:
  92.  
  93.   Activities - suggestions for things to try out with !Stellate. It is
  94.                organised as a series of questions.
  95.   Answer-n   - compressed Draw files and text files giving possible answers
  96.                to the questions posed in ‘Activities’
  97.   NewLine9   - StellaList format file answer to question 9.
  98.  
  99.  
  100.     Directory ‘Tutorials’ contains three tutorials to help show you what
  101. is possible with !Stellate. Each assumes that you have worked through the
  102. previous ones.
  103.  
  104.   Tutorial1 - Instructions for beginners - shows how to make the 3D view
  105.               plot from the stored command data (this is included also with
  106.               the demo version of !Stellate)
  107.  
  108.   Tutorial2 - Instructions for making your own selections from the
  109.               stellation diagram to make your own version of a polyhedron
  110.               from the stored instructions; the second section shows how to
  111.               select star faces and selecting faces from more than one
  112.               component
  113.  
  114.   Tutorial3 - Instructions for making a new polyhedron by selecting your
  115.               face types to make stellation diagram(s) and a new polyhedron 
  116.  
  117.   pictures  - sub-directory of squashed Draw files of figures used in the
  118.               tutorials
  119.  
  120.  
  121. --------------------------------------------------------------------
  122.        
  123. The rest of this file is the ‘ReadMe’ from the full version.
  124.  
  125. **************************************************************************
  126.                    ReadMe for  !Stellate 
  127.                  last updated 15 Feb 1998
  128.  
  129.  !Stellate is an interactive program which creates uniform polyhedra and
  130. their stellations using stellation diagrams. There are 112 pre-stored 
  131. polyhedra which are printed on the single A4 page enclosed in your manual. 
  132. !Stellate is written in the Fortran programming language by:
  133.  
  134.  ‘Fortran Friends’, P.O.Box 64, Didcot, Oxon OX11 0TH
  135.  
  136.    tel: (01235) 834357
  137.  
  138. Machine and operating system requirements: 
  139.  
  140. Any Acorn computers using RISC-OS operating systems 3.XX and at least 288K
  141. available application workspace, including networks and StrongARM.
  142.  
  143. Copyright and copying:
  144.  
  145. Further details can be found in the file ‘Docs.CopyRight’
  146. This program remains the copyright of ‘Fortran Friends’: it is licensed for
  147. use at one site only; you may copy it to a backup floppy disc or to your own
  148. hard disk but giving copies to others is illegal. Your registration number
  149. is unique; any illegal copies found will be reported to the ‘Federation
  150. Against Software Theft’ and you will be liable for prosecution. 
  151.  
  152. Getting Started:
  153.  
  154. These instructions assume some knowledge of how to use an Acorn computer. 
  155. If you are a new user, more detailed instructions on how to copy files, use
  156. the windows and the mouse can be found in the ‘User Guide’ manual for your
  157. computer system. !Stellate is a RISC-OS compliant program which runs in the
  158. Acorn Desktop and tries to conform to the operating conventions in the Acorn
  159. Style guide; it supports Acorn interactive help.
  160.  
  161. Fortran Friends welcome comments and requests for new features for future
  162. versions of this program. 
  163.  
  164. --------------------------------------------------------------------
  165.                       Contents of the !Stellate Disc
  166.  
  167. This section is for reference only, you may never need to use it if you just
  168. want to use the supplied data file to create and save stellations. All Draw
  169. files on the distribution disc have been compressed using the standard
  170. ‘Squash’ program.
  171.  
  172. Top level directory
  173.  
  174.   !Stellate - application
  175.   Docs      - directory of documentation; ‘Docs.Readme’ explains what is in
  176.               each file
  177.   Products  - software available from Fortran Friends
  178.   ReadMe    - (This file)
  179.  
  180. Skip to the section headed ‘Installation’ if this is the first time you have 
  181. looked at this file, and you are not interested in technicalities.
  182.  
  183.    Within the !Stellate application, in addition to the usual files, 
  184.    there is the directory ‘Resources’.
  185.  
  186.    This has the standard Acorn files, ‘Messages’ and ‘Templates’;
  187.    there are several other files, which the program may change for you,
  188.    but which most users need not bother with.
  189.  
  190.     ‘Choices’   defines the initial settings of various options.
  191.     ‘Colours’   defines all the colours used initially. The program can
  192.                 change this file if the user changes the colours and then
  193.                 asks to save the ‘Colours’ file before quitting the program.
  194.     ‘Components’ definitions of components’ names, symmetry and interplanar
  195.                 angles.
  196.     ‘Register’  this file contains your name and registration information.
  197.                 It must not be changed by the user.
  198.     ‘Sprites’   sprites used in the tools pane of the 3D display window.
  199.     ‘StellaList’ list of instructions for drawing stored polyhedra
  200.  
  201.  --------------------------------------------------------------------
  202.  
  203. Installation:
  204.  
  205. 1. Make a working copy on floppy disc. Store the original safely, in case
  206. your working copy becomes damaged. Your license allows you to make a
  207. single copy for your own use. If the disc supplied has been damaged and
  208. will not copy, return it to us for a free replacement within 3 months of
  209. purchase.
  210.  
  211. Use the ‘working’ copy for the rest of the instructions. You can run from
  212. the floppy if you want to.
  213.  
  214. 2. Installation on hard disc: 
  215. Make yourself a directory for storing your programs, with a name such as
  216. ‘Polyhedra’ and copy the contents of the floppy disc to it.
  217.  
  218. 3. Read the Documentation. 
  219. Before trying to run the application, look at the file !Help file for
  220. operating instructions, and in the directory ‘Docs.Reference’ for a glossary
  221. of terms and an ‘Intro’ which explains how !Stellate uses stellation
  222. diagrams to draw polyhedra. The sub-directory ‘Tutorials’ has more detailed
  223. explanations with Draw file figures to help you understand better how to get
  224. the most from !Stellate. The directory ‘TryThese’ has some suggested
  225. activities and answers. You may want to print some of these out for future
  226. reference.
  227.  
  228. 4. Operating instructions:
  229. Running instructions are in the file !Help of the application. 
  230. Acorn interactive help is supported.
  231.  
  232. 5. Starting the program:
  233.  
  234. Double-click on the application !Stellate to start the program; this loads
  235. an icon on to the icon bar. Click MENU when the pointer is over this icon to
  236. see the options.  Choose ‘info’ to see the program name, version number and
  237. your registration number, which should be quoted in any correspondence with
  238. ‘Fortran Friends’. Click SELECT to choose a polyhedron.
  239.  
  240. 6. Stopping the program:
  241.  
  242. Click MENU over the icon on the icon bar and choose the last option, ‘quit’.
  243. If windows are hiding the icon bar, press key F12 while holding down the
  244. SHIFT key, to bring the icon bar to the front of the windows.
  245.  
  246. 7. Colour Changing:
  247. You can change the colour used for particular faces of a polyhedron in some
  248. of the display forms, and other colours of lines, or window backgrounds etc.
  249. from the icon bar menu. If you try to do this and get an error message saying
  250. ‘Colour Picker module is not loaded’, then if you have a copy of the Acorn
  251. Colour Picker Module load it using commands as described in the !Run file.
  252. If you have not got this module you can get it off the Acorn User Cover Disc
  253. for September 97 (in directory ‘System.!System.Modules.Toolbox’) or send a
  254. blank disc plus return envelope and postage to ‘Fortran Friends’ at the
  255. address above.
  256.  
  257. 8. Possible Faults:
  258.  
  259. Error conditions we have thought about have ‘traffic sign’ windows which
  260. should allow you to choose whether to stop the program or try to carry on.
  261.  
  262. If your working disc is damaged, you may find when you try to start the
  263. program you merely get an ‘error window’ saying your user registration file
  264. has been corrupted. Delete all the files from your working disc, and make a
  265. new copy from your original disc. 
  266.  
  267. If you find the program stops in an uncontrolled way, please try to write
  268. down details of what you were doing just before the error, and send them to
  269. us, preferably using the fault report form in file ‘Docs.FaultRep’. 
  270.  
  271. If you have changed any of the !Stellate files, please supply copies of the
  272. files on floppy disc which you were using when the error occurred.
  273.  
  274.