home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / program / fortran77_210 / _wimppoly / readme < prev    next >
Encoding:
Text File  |  1994-01-30  |  5.2 KB  |  109 lines
  1.        !WimpPoly a demonstration of the use of the Desktop from Fortran 
  2.                using the "Fortran Friends"  library.
  3.                       Version 2.00 2 February 1992
  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. Examples of window creation are in routine INIT,
  9.  some using Templates, others calling create window routines directly.
  10.  
  11.   ************************************************************************
  12.                     C O P Y R I G H T    N O T I C E
  13.  
  14.                      Copyright D.J & K.M. Crennell,
  15.                   P.O. Box 64, Didcot, Oxon, OX11 0TH.
  16.  
  17.  This software, including the datafiles, is in the Public Domain and may not  be sold or included in any program that will be sold.
  18.  
  19.  The authors must be given credit in any publications using this software.
  20.  
  21.  The software may be freely copied and distributed for academic use as long
  22.  as no changes are made and this copyright notice is included. Please send
  23.  any suggested improvements to the authors. 
  24.  
  25.  In no circumstances shall the authors be liable for any damage, loss of
  26.  profits, or any indirect or consequential loss arising out of the use of
  27.  this software or inability to use this software, even if they have been
  28.  advised of the possibility of such loss.
  29.  
  30.  The authors do their best to ensure that this disc is distributed virus
  31.  free.
  32.   ************************************************************************
  33.  
  34. Files in !WimpPoly
  35.    !Boot, !Run, !Sprites, Templates 
  36.        usual files needed to run the application
  37.    
  38. Sub directories
  39.      aif contains the compiled program run by !Run
  40.      cde text files to be included in the Fortran source of Wimp Poly
  41.      Dat1 |
  42.      Dat2 | data files from netlib
  43.      Dat3   data files made by K.M.Crennell
  44.      f77  Text file of the Fortran source of WimpPoly
  45.  
  46. Essential Textfiles read by WimpPoly while executing
  47.      PolyHelp  Running instructions seen in the 'Help' window in response to
  48.                clicking the 'menu' button over the 'choice' window with the
  49.                lists of polyhedron names.  If you change this file to make it
  50.                more meaningful, remember that only 25 lines are displayed.
  51.      PolyList  The list of polyhedron names stored in the datafiles, Dat1,
  52.                Dat2, Dat3. Lines beginning with a blank space are section 
  53.                titles, plotted in red on the polyhedron choice window.
  54.                Positive numbers at the beginning of a line are the polyhedron
  55.                index number used to find the datafile for the polyhedron of
  56.                that name. The name makes an icon in the choice window which 
  57.                you 'select' with the mouse button to see the polyhedron. 
  58.                Negative numbers are alternative names shown in green.
  59.                There are 3 'test' files at the end to let you add more
  60.                datafiles without changing PolyList. The current maximum 
  61.                number of lines allowed in PolyList is 160 
  62.      
  63. Textfiles for your Information 
  64.   DataFormat defines the datafile format so that you can add your own.
  65.   ReadMe     This file
  66.  
  67. DrawFiles
  68.   IcosaNet a planar net of the Icosahedron, with 'tabs' drawn on manually
  69.            using 'Draw' to show you how to construct a solid model.
  70.  
  71.   There are also a variable number of other Drawfiles depending on how much
  72. space there is on the disc. They are composite files showing selections of
  73. Polyhedra, made using 'Draw' to combine the files of single polyhedra
  74. 'saved' from !WimpPoly. Their names should explain what they are, e.g.
  75. 'Platonic' shows all the Platonic solids, 'ArchiDual', the Archimedean
  76. duals, 'Prisms', shows prisms and anti-prisms.
  77.  
  78.  
  79. Notes.
  80.   1. Known Errors in datafiles.
  81.     The algorithm used to plot the polyhedra assumes they are made from
  82. non-intersecting plane faces. This is not true for some of the 'netlib' data
  83. which plot incorrectly.  Files with known errors are: 
  84.  
  85.     No.      problem
  86.      8  has same net as 4
  87.     32  no 3d vertices only the planar net        
  88.  66-69  3D connectivity of some vertices missing from central region
  89.  
  90. If you can correct these, or make new datafiles, please send them to the
  91. library organiser, address above, so that others can share them. 
  92.  
  93.  2. Making Models and Useful books 
  94.     You can make your own models by plotting the 'Drawfiles' saved from
  95.     the 'net' window, sticking them on card, and cutting them out leaving
  96.     flaps to stick the sides together as shown in the example 'IcosaNet'.
  97.     We find it easier to bend along the dotted lines of this icosahedron
  98.     before cutting anything out. Please tell us if you find a good way to
  99.     glue in the last piece!
  100.   
  101.     You can learn more about making models of polyhedra and their 
  102.     stellations from the following paperback books:
  103.  
  104.    'Polyhedron Models' M.J.Wenniger 
  105.        Cambrige University Press   SBN 521 09859 9
  106.    'Mathematical Models' H.M.Cundy and A.P.Rollet 
  107.         Tarquin Publications  ISBN 0 906212 20 0  
  108.     'The Geometrical Foundation of Natural Structure' Robert Williams
  109.         Dover Publications  ISBN 0 486 23729 X