home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / IRIT / POLY3DHS.ZIP / POLY3D-H.DOC < prev    next >
Encoding:
Text File  |  1990-05-05  |  4.0 KB  |  89 lines
  1.     POLY3D-H - 3d polygonal hidden line removal
  2.     -------------------------------------------
  3.  
  4.   BECAUSE POLY3D-H IS LICENSED FREE OF CHARGE, I PROVIDE ABSOLUTELY NO
  5. WARRANTY, TO THE EXTENT PERMITTED BY APPLICABLE STATE LAW. EXCEPT WHEN
  6. OTHERWISE STATED IN WRITING, I GERSHON ELBER PROVIDE POLY3D-H PROGRAM "AS IS"
  7. WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT
  8. NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  9. PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  10. PROGRAM IS WITH YOU. SHOULD THE POLY3D-H PROGRAM PROVE DEFECTIVE, YOU ASSUME
  11. THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  12.  
  13.   IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW WILL GERSHON ELBER,
  14. BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY LOST PROFITS, LOST MONIES,
  15. OR OTHER SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  16. USE OR INABILITY TO USE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR A
  17. FAILURE OF THE PROGRAM TO OPERATE WITH PROGRAMS NOT DISTRIBUTED BY GERSHON
  18. ELBER) THE PROGRAM, EVEN IF YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF
  19. SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  20.  
  21.     A program to remove hidden line of a given polygonal model. The
  22. program does 4 passes over the input:
  23. 1. Preprocess and map all polgons in scene, and sort them.
  24. 2. Generating edges out of the polygonal model and sort them (preproceesing
  25.    for the scan line algorithm) into buckets.
  26. 3. Intersects edges, and split edges with non homogeneous visibility (the
  27.    scan line algorithm)
  28. 4. Visibility test of each edge.
  29.  
  30.     This programs can handle CONVEX polygons only. See poly3d.doc,
  31. Appendix A, for exact text format definition. From irit given object O,
  32. issue the command 'O = convex(O);' to make sure object has convex polygons
  33. only before dumping it out.
  34.  
  35. Options:
  36. --------
  37.  
  38. poly3d-h [-b] [-m] [-i] [-e #Edges] [-o Objects...] [-v ViewFile] [-z] DFiles
  39.                                 [> OutFile]
  40.  
  41.   -b : BackFacing - if object is closed (such models dumped from irit solid
  42.        modeller), back facing polygons will be deleted, and therefore speed
  43.        up the process by at list factor of two.
  44.   -m : More - give some more information on the data file(s) parsed.
  45.   -i : Internal edges (created by IRIT) - default is not to display them, and
  46.        this option will force displaying them also.
  47.   -e n : # Edges to use from each given polygon (default all). Very handy to do
  48.        '-e 2' on data created from DRAWFN3D.
  49.   -o Object(s) : Objects to display (all by default). Object is the name as
  50.        appears after the OBJECT key word the data files
  51.        (do 'grep OBJECT datafile'...).
  52.   -v ViewFile : View file - file of the view matrix transformation
  53.   -z : Print version number and current defaults.
  54.  
  55. Configuration:
  56. --------------
  57.  
  58.   The program can be configured using a configuration file named poly3d-h.cfg.
  59.   This is a plain ascii file you can edit directly and set the parameters
  60. according to the comments there. executing 'poly3d-h -z' will show the
  61. current configuration as read from the configuration file. This file, in
  62. msdos environment, can be in any directory which is in your path - the same
  63. place as poly3d-h.exe is probably a good choice. In unix environment, this
  64. file is searched in current directory, or if an environment variable IRIT_PATH
  65. is set, it is assumed to hold the directory to look for the config file with
  66. postfix '/' (i.e. 'poly3d-h.cfg' is simply appended to it.).
  67.  
  68.   MSDOS version:
  69.   The program will use 80?87 (msdos only...) if it detects one - again uses
  70. the Turbo C 80?87 autodetect, or will run (much!) slower without it...
  71.  
  72. Usage:
  73. ------
  74.   As this program is not interactive, usage is quite simple, and only
  75. control available is using the command lines options.
  76.  
  77. Bugs:
  78. -----
  79.   O.k. if you do have any question, suggestion, or even want to report a bug
  80. feel free to send me email (see below)
  81.  
  82.   Feel free to make copies of this program, and distribute them FREE of
  83. charge, provided that all this package is distributed.
  84.  
  85. Have Fun
  86.  
  87. Gershon Elber
  88. gershon@cs.utah.edu
  89.