home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / geokit10.zip / GEOKIT.DOC next >
Text File  |  1994-08-23  |  5KB  |  117 lines
  1.                                   GEOKIT V1.0
  2.                            Geodesic Structure Generator
  3.                                   for PovRay
  4.  
  5.                               Author: Rob Richards
  6.                    RAYTECH BBS - Scotland,UK - (44) (0)862 832020                                 
  7.                                  CIS 100330,2512
  8.                            PCGNET RAYTRACE Conference
  9.  
  10.  
  11.                  GEOKIT is copyright (C) 1994 by Rob Richards.
  12.                        PovRay program is (C) POV-Ray team
  13.  
  14. This program stems from a fascination I've had with geodesic
  15. domes etc. Written in compiled QuickBasic, this is a first release and is 
  16. pretty basic having the following features:-
  17.  
  18.  
  19. This program requires 538K of conventional memory to run. Its not a big 
  20. program code wise but I have dimensioned some internal dynamic arrays quite 
  21. large to cope with BIG/Complex geodesic structures.
  22.  
  23. Create normal Dome type structures as well as open ended tube-like
  24. structures. 
  25.  
  26. Dome Type structures are assumed to have eliptical cross-sections
  27. in both the horizontal and vertical planes. The base width and
  28. depth and the height are prompted for.
  29.  
  30. For open-ended structures, you can define different depth and 
  31. width's for each end of the structure.
  32.  
  33. In both cases a complete structure is defined as having ....
  34.    
  35.     LINKS .... Cylindrical sections forming the framework of
  36.                the structure.
  37.     NODES .... Spheres at the intersections of the Links.
  38.     PANES .... These form the main surface of the structure.
  39.  
  40. One or more of these three constituent parts may be generated.
  41.  
  42. The program prompts for all required parameters (Sorry no command
  43. line arguments (yet!) ) as follows.
  44.  
  45. Structure Type :  1 for a Dome type Structure or 2 for Open Ended
  46.  
  47. Base X Radius  :  For both types of structure, this defines the
  48.                   base width of the structure.
  49. Base z Radius  :  For both types of structure, this defines the
  50.                   base Depth of the structure.
  51. Structure Height: Height of Structure
  52.  
  53. Top X Radius   :  Only prompted for type 2 structures, this 
  54.                   defines the width at the top of the structure.
  55.                
  56. Top Z Radius   :  Only prompted for type 2 structures, this 
  57.                   defines the depth at the top of the structure.
  58.  
  59. Vertical Sections: This defines the number of rows of Panes in the
  60.                    structure. More sections, the smoother the 
  61.                    vertical cross section will be. This number 
  62.                    should be an Even Number less than 201.
  63.  
  64. Horizontal Sections: This defines the number of steps around the 
  65.                      horizontal cross-section of the structure. 
  66.                      Again, the more steps, the smoother the 
  67.                      strucure. This should be an even number less
  68.                      than 201.
  69.  
  70. Generate Links (Y/n): This tells the program whether or not to 
  71.                       generate structure Links.
  72. Generate Nodes (Y/n): This tells the program whether or not to 
  73.                       generate structure Nodes.
  74. Generate Panes (Y/n): This tells the program whether or not to 
  75.                       generate structure Panes.
  76.  
  77. Link Radius   : This will define the radius of the cylindrical 
  78.                 Links (If required).
  79. Node Radius   : This will define the radius of the spherical 
  80.                 nodes (if required).
  81. Pane Type     : This defines the type of framework generated.
  82.                 1=Triangular - The links of the structure form
  83.                 triangles.
  84.                 2=Squareish - The links of the structure form 
  85.                 squareish windows which generate two panes each.
  86.  
  87. Pov or Raw Output : This is only asked for if you specify Panes only above.
  88.                     Enter P to generate Povray Include file or R to generate
  89.                     a basic RAW file one triabgle per line.
  90.  
  91. Base Name for Structure: With a maximum of eight characters, this
  92.                          is used both to create the Include file 
  93.                          name as well as the structure unions.
  94.                          A complete structure would contain three
  95.                          seperate UNION definitions i.e. 
  96.                          StructLinks for the links
  97.                          StructNodes for the nodes
  98.                          StructPanes for the panes where "Struct"
  99.                          is the Base Name.
  100.  
  101. *Note* The base name is case sensitive in creating the union 
  102. declarations. Base name STRUCT generates a different union declaration
  103. to Struct !
  104.  
  105. *Beware* depending on how many vertical and horizontal sections
  106. you define, this program can generate LARGE include files.
  107.                          
  108. A sample image is included with this release which shows what can
  109. be done. 
  110.  
  111. As mentioned, the program is pretty basic, I'm working on that as 
  112. well as a windows version. Any comments or suggestions or reports
  113. of bugs would be gratefully received.
  114.  
  115. Enjoy.
  116. Rob Richards
  117.