home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / education / b / wimppoly / ReadMe
Encoding:
Text File  |  1996-10-17  |  5.5 KB  |  120 lines
  1.        !WimpPoly a demonstration of the use of the Desktop from Fortran 
  2.                using the "Fortran Friends" ShareWare library.
  3.                       Version 2.34 17 October 1996
  4.  
  5.  WimpPoly plots two views of a polyhedron, a 3D solid and a planar net, from
  6.  over 140 possible data files mostly downloaded from 'netlib' on the Joint
  7.  Academic Network. It uses the 16 colours natural to the Wimp, so should be
  8.  run in 16 colour modes.
  9.  
  10.  Version 2.33 (and corrected 2.34) work also on StrongARM processors.
  11.  
  12.  'Fortran Friends' is a self-help group for Fortran users of the Archimedes,
  13. which collects libraries of useful routines, information on 'bugs', sources
  14. of PD software, and anything of use to Fortran programmers. Their first disc
  15. contains a Desktop Development System for Fortran, graphics, SpriteOps,
  16. Wimp, Binaryio and other utilities as well as the source files for
  17. !WimpPoly. Further contributions to the collection are always welcome,
  18. please send yours to the address below.
  19.  
  20.   ************************************************************************
  21.                     C O P Y R I G H T    N O T I C E
  22.  
  23.                            Copyright 1991
  24.    K.M. Crennell, Greytops, The Lane, Chilton, Didcot, Oxon, OX11 0SE.
  25.  
  26.  The software and the data files on this disc are in the Public Domain and
  27.  may not be sold or included in any program that will be sold for commercial  gain; the authors must be acknowledged in any publications using them.
  28.  
  29.  This copyright notice must be included in any redistribution.
  30.  
  31.  In no circumstances shall the authors be liable for any damage, loss of
  32.  profits, or any indirect or consequential loss arising out of the use of
  33.  this software or inability to use this software, even if they have been
  34.  advised of the possibility of such loss.
  35.  
  36.   ************************************************************************
  37.  
  38.                       DISK Ffriends_2 Contents
  39.                           2 February 1992
  40.  
  41. Files in !WimpPoly
  42.    !Boot, !Run, !Sprites, Templates 
  43.        usual files needed to run the application
  44.    
  45. Sub directories
  46.      aif contains the compiled program run by !Run
  47.      dat1 & dat2: data files from netlib
  48.      dat3:        data files made by K.M.Crennell
  49.  
  50. Essential Textfiles read by WimpPoly while executing
  51.  
  52.      PolyHelp  Running instructions seen in the 'Help' window in response to
  53.                clicking the 'menu' button over the 'choice' window with the
  54.                lists of polyhedron names. If you change this file to make it
  55.                more meaningful, remember that only 25 lines are displayed.
  56.      PolyList  The list of polyhedron names stored in the data files, dat1,
  57.                dat2, dat3. Lines beginning with a blank space are section 
  58.                titles, plotted in red on the polyhedron choice window.
  59.                Positive numbers at the beginning of a line are the polyhedron
  60.                index number used to find the data file for the polyhedron of
  61.                that name. The name makes an icon in the choice window which 
  62.                you 'select' with the mouse button to see the polyhedron. 
  63.                Negative numbers are alternative names shown in green.
  64.                There are 3 'test' files at the end to let you add more
  65.                data files without changing PolyList. The current maximum 
  66.                number of lines allowed in PolyList is 160. 
  67.      
  68. Textfiles for your Information 
  69.  
  70.   DataFormat defines the data file format so that you can add your own.
  71.  
  72. DrawFiles
  73.  
  74.   IcosaNet a planar net of the Icosahedron, with 'tabs' drawn on manually
  75.            using 'Draw' to show you how to construct a solid model.
  76.  
  77.   There are also a variable number of other Drawfiles depending on how much
  78.  space there is on the disc. They are composite files showing selections of
  79.  Polyhedra, made using 'Draw' to combine the files of single polyhedra
  80.  'saved' from !WimpPoly. Their names should explain what they are, e.g.
  81.  'Platonic' shows all the Platonic solids, 'ArchiDual', the Archimedean
  82.  duals, 'Prisms', shows prisms and anti-prisms.
  83.  
  84.  
  85. Notes.
  86.   1. Known Errors in data files.
  87.     The algorithm used to plot the polyhedra assumes they are made from
  88. non-intersecting plane faces. This is not true for some of the 'netlib' data
  89. which plot incorrectly.  Files with known errors are: 
  90.  
  91.     No.      problem
  92.      8  has same net as 4
  93.     32  no 3d vertices only the planar net        
  94.  66-69  3D connectivity of some vertices missing from central region
  95.  
  96. If you can correct these, or make new data files, please send them to the
  97. library organiser, address above, so that others can share them. 
  98.  
  99.  2. Making Models and Useful books 
  100.     You can make your own models by plotting the 'Drawfiles' saved from
  101.     the 'net' window, sticking them on card, and cutting them out leaving
  102.     flaps to stick the sides together as shown in the example 'IcosaNet'.
  103.     It is easier to bend along the dotted lines of this icosahedron before
  104.     cutting anything out. Please tell us if you find a good way to glue in
  105.     the last piece!
  106.  
  107.     Note to chemists: One of the recently discovered forms of carbon, C60
  108.       ( the 'bucky ball') takes the form of a truncated icosahedron.
  109.   
  110.     You can learn more about making models of polyhedra and their 
  111.     stellations from the following paperback books:
  112.  
  113.    'Polyhedron Models' M.J.Wenniger 
  114.         Cambridge University Press   SBN 521 09859 9
  115.  
  116.    'Mathematical Models' H.M.Cundy and A.P.Rollet 
  117.         Tarquin Publications  ISBN 0 906212 20 0 
  118.  
  119.    'The Geometrical Foundation of Natural Structure' Robert Williams
  120.         Dover Publications  ISBN 0 486 23729 X