home *** CD-ROM | disk | FTP | other *** search
/ X-Ray / X-Ray.iso / gfx-soft / dust / utilities / reducer.doc < prev    next >
Encoding:
Text File  |  1996-09-20  |  3.2 KB  |  93 lines
  1. #####################################################################
  2. #                                                                   #
  3. #       Reducer v0.1 (22 November 1995) - ©1995 by A.Maschke        #
  4. #                                                                   #
  5. #####################################################################
  6.  
  7. CONTENTS
  8.  
  9. 1. Introduction
  10. 2. Usage
  11. 3. Author/Registration
  12. 4. History/TODO
  13.  
  14. 1. Introduction
  15. --------------------------------------------------------------------
  16.  
  17. One week ago I downloaded a starfield from Aminet which consists
  18. of polygons with 6 edges. Because the object was in TDDD-format (triangles)
  19. and I had to render a scene using Lightwave I wanted to merge the
  20. polygons. So I tried out PixPro which needed a lot of time and
  21. finally destroyed the object.
  22. O.k., I said, write your own one.
  23.  
  24. The program reducer is the result (of some hours hacking C-language). It's
  25. faster than PixPro and produces a starfield I can use.
  26.  
  27. Summary:
  28.  Advantages:     -speed
  29.                  -external small program which can be invoked
  30.                   via batchfiles,...
  31.                  -merges only polygons which remain to same surface
  32.  Disadvantages:  -the fast (GCC-)version crashes after a stack-overflow
  33.                  -It can't close polygons which use one edge two or
  34.                   more times, e.g. the front-face of an "O"-letter
  35.  
  36.                          /-----\
  37.                         | /---\ |
  38.                         | |   |-| <- edge used twice
  39.                         | |   | |
  40.                         | \---/ |
  41.                          \-----/
  42.  
  43. 2. Usage
  44. --------------------------------------------------------------------
  45.  
  46.  Two executables are supplied
  47.   reducer (needs 68020)
  48.   reducer.FAST (needs 68030+, 68881, ixemul.library)
  49.  
  50.  Usage: reducer <input-file> <output-file> [ZERO]
  51.  (ZERO defaults to 0.001, if the normals of two polygons differ
  52.   by a value less equal than zero the polygons are merged.)
  53.  
  54.  Examples:
  55.   reducer obj obj.m
  56.   reducer obj obj.m 0.01
  57.  
  58.  Notes: 1. In case of a complicaed face the program reports
  59.            a "merge-error"-this means that two polygons
  60.            where skipped (No problem having 10000 faces)
  61.         2. The procedure works recursively (stack)
  62.            If you want to reduce really huge objects set the stack
  63.            to 1MB and you will get no problems.
  64.         3. If you have a huge object then try to split it in smaller
  65.            sub-objects before merging (time)
  66.  
  67.  
  68.  
  69. 3. Author/Registration
  70. --------------------------------------------------------------------
  71.  The reducer-package belongs to the Dust-project, to get
  72.  registered for Dust, DustMD, Mesh2TDDD, makeHaze,... send
  73.  $25+postage to the author:
  74.  
  75.                          Andreas Maschke
  76.                          Zenkerstraße 5
  77.                          06108 Halle/Saale
  78.                          Germany
  79.  
  80.                    Phone: ++49 (0)345/5170331
  81.                    EMail: epgbc@cluster1.urz.Uni-Halle.DE
  82.  
  83. 4. History/TODO
  84. --------------------------------------------------------------------
  85.  
  86. History
  87.  v0.1 (22 November 1995)  - seems to work
  88.  
  89. TODO
  90.  -more messages (no error-message is shown)
  91.  -more speed
  92.  -complicated polygons (like front-face of an "O"-letter)
  93.