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