home *** CD-ROM | disk | FTP | other *** search
/ Mac Expert 1995 Winter / Mac Expert - Winter 95.iso / Les fichiers / Utilitaires divers / Images / Mac POV Utils 1.1 ƒ / POV-Utils Docs.Raw / Raw2POV / RAW2POV.DOC < prev    next >
Encoding:
Text File  |  1992-11-30  |  7.1 KB  |  172 lines  |  [TEXT/ttxt]
  1.                     Raw to POV-Ray Converter v1.6
  2.                     Copyright (c) 1992 Steve Anger
  3.  
  4.   RAW2POV converts lists of triangle coordinates in raw ASCII text format to
  5. POV-Ray 1.0 compatible scene files. The program automatically adds nested
  6. bounding shapes and generates smooth triangles. The triangle data can be
  7. organized in one of three formats:
  8.  
  9.  
  10. 1) Default - Nine numbers per triangle
  11.  
  12.       Ax  Ay  Az  Bx  By  Bz  Cx  Cy  Cz
  13.  
  14. e.g.  -3.5 -4.1 -5.0  -3.9 -6.2 -5.0  -3.4 -6.2 -7.0
  15.  
  16.  
  17. 2) Fractint colour (-fc) - Twelve numbers per triangle
  18.  
  19.       R  G  B  Ax  Ay  Az  Bx  By  Bz  Cx  Cy  Cz
  20.  
  21. e.g.  1.0 1.0 0.0  -3.5 -4.1 -5.0  -3.9 -6.2 -5.0  -3.4 -6.2 -7.0
  22.  
  23.  
  24. 3) Texture names (-ft) - Nine numbers and one texture name per triangle
  25.  
  26.       Ax  Ay  Az  Bx  By  Bz  Cx  Cy  Cz  TEXTURE
  27.  
  28. e.g.  -3.5 -4.1 -5.0  -3.9 -6.2 -5.0  -3.4 -6.2 -7.0  RedPlastic
  29.  
  30.  
  31.   Ax, Ay, etc are the x,y,z coordinates of the three triangle vertices A, B,
  32. and C.  R, G, and B represent the Red, Green, and Blue components of the
  33. triangle colour and range from 0.0 to 1.0.  TEXTURE is a string indicating
  34. the texture name. The numbers/names can be separated by spaces, tabs, or
  35. carriage returns.
  36.  
  37.   Non-numeric identifiers can be used to separate groups of triangles
  38. representing different objects. See CHESS.RAW for an example.
  39.  
  40.  
  41. Hardware Requirements:
  42.  
  43. Two version of the executable are included in this archive, RAW2POV.EXE and
  44. RAW2POVX.EXE. The first version will run on all machines from XT's to 486's
  45. but is only capable of using 640k of memory. The second version requires a
  46. minimum of a 386 with a co-pro to run but can use all available memory plus
  47. up to 128M of virtual memory.
  48.  
  49. Note: I've experienced some problems with the GCC 2.2.2 compile (raw2povx.exe) 
  50. when converting very large raw files. Usually the computer reboots or locks 
  51. up. So far this appears to affect my machine only, however if you encounter 
  52. any problems like this let me know and I'll try to track it down. Include
  53. your hardware and memory manager setup if possible.
  54.  
  55.  
  56. Usage: raw2pov inputfile[.raw] [outputfile[.pov]] [options]
  57.  
  58. Options:
  59.  
  60. -snnn - Generates smooth triangles. The boundary between triangles are only
  61.         smoothed if the angle between the triangles is less that nnn deg.
  62.         -s0 will not smooth any triangles while -s180 will smooth all
  63.         triangles. Values from -s45 to -s90 usually work well. If
  64.         unspecified smoothing defaults to -s60.
  65.  
  66. -1    - Optimize all of the input objects as a single object. By default all
  67.         objects are optimized separately and then combined. This option may
  68.         produce better results in some cases, especially if the input file
  69.         contains a large number of very small objects.
  70.  
  71. -x    - Exchanges the Y and Z coordinates of all triangle vertices. Useful
  72.         if the input file was generated from a program that uses the Z
  73.         coordinate as vertical rather that the Y coord as is normally used in
  74.         POV-Ray.
  75.  
  76. -v    - Turn on verbose status messages.
  77.  
  78. -fc   - Specifies that the input file is in Fractint style colour format
  79.         with 12 numbers per triangle.
  80.  
  81. -ft   - Specified that the input file contains texture names.
  82.  
  83.  
  84. ex. raw2pov chess.raw chess.pov -s60 -v
  85.  
  86. Note: Smooth triangles will only work properly if the input file uses
  87. consistent vertex ordering.  Most CAD packages that output triangular data
  88. will already have the data in the proper order.  DXF2DKB is one program that
  89. does NOT preserve vertex order so you cannot use data extracted from a
  90. DXF2DKB generated file.
  91.  
  92. Changes in v1.6
  93. - Put the named texture feature back in with a command line option to turn
  94.   it on (-ft). A few people missed it.
  95.  
  96. Changed in v1.5
  97. - Outputs POV-Ray 1.0 format files only.
  98. - Uses the new box primitive available in POV-Ray 1.0 as a bounding shape.
  99. - Accepts unformatted input rather than the one triangle per line format
  100.   used with previous versions.
  101.  
  102. Changes in v1.4
  103. - Name changed from TXT2POV to RAW2POV.
  104. - Now outputs only lower case keywords. I'll assume nobody's using DKB any
  105.   more.
  106. - Allows you to swap the Y and Z axis when converting for those files that  
  107.   use the Z coord as vertical.
  108. - Automatically removes illegal characters in object/texture names.
  109. - Better rejection of degenerate triangles.
  110. - Little bug fixes here and there.
  111.  
  112. Changes in v1.3
  113. - Name changed from TXT2DKB to TXT2POV although the version number was not
  114.   reset. The output files should be compatible with both DKB 2.12 and POV
  115.   0.50 beta.
  116. - Nothing new as far as faster rendering times. :(
  117. - The graphic preview was getting to be a pain to maintain in this version so
  118.   I dropped it.
  119. - Protected mode compile (TXT2POVX) is now VCPI compliant and should work  
  120.   with most 386 memory managers. Desqview and Windows are still no-no's.
  121. - Now outputs both a data (.dat) file and a separate include (.inc) file  
  122.   instead of one big data file.
  123. - Generated files are about 30% smaller.
  124. - You can now specify object and texture names in the input file.
  125.  
  126. Changes in v1.2:
  127. - Added nested bounding shapes for improved rendering times (especially for
  128.   very large objects). Uses a mangled version of the octree method.
  129. - Bounding shapes optionally shown in preview.
  130.  
  131. Changes in v1.1:
  132. - The optimization routines can now handle input files that contain very  
  133.   large numbers of different colours such as those generated by Fractint.
  134.  
  135.  
  136.  
  137. Bench Marks:
  138.                                   ------ Render Time -------
  139.                     Optimization     Before        After      Speed-up
  140. Object  Triangles      Index *    Optimization  Optimization   Factor
  141. -------- ---------  ------------  ------------  ------------  --------
  142. CHAIR       2331        43.2           506s           34s       14.9 
  143. SKULL       1489        16.1           626s          107s        5.9 
  144. CAR1        3357        33.9          1245s           86s       14.5 
  145. CHESS2     12583       165.5          7755s          234s       33.1 
  146. PLASMA      3672        52.9          2235s           99s       22.6  
  147. ROBOTECH    2488        27.3           727s           57s       12.8  
  148. VENUS       1417        19.2           349s           46s        7.6
  149.  
  150. * Bounding index reported by RAW2POV
  151. All images rendered at 80x50 on 20Mhz 386/387. Results should be scalable to
  152. higher resolutions. Note: These benchmarks are for version 1.4 of raw2pov.
  153. Speedups should be much better for version 1.6.
  154.  
  155. Files:
  156. RAW2POV.C     - Source code for converter
  157. RAYOPT.C      - Source code for optimizer
  158. RAYOPT.H      -   "     "    "      "
  159. RAW2POV.EXE   - Raw to POV executable (compiled with Borland C++). Can handle
  160.                 files of up to approximately 4500 triangles. Less when
  161.                 generating smooth triangles. 
  162. RAW2POVX.EXE  - 32 bit version of converter (compiled with MS-DOS GNU C++ 
  163.                 v1.05). Limited only by available memory and disk space. 
  164.                 Requires 386 /w 387 or 486 CPU. 2Mb or more of RAM is   
  165.                 recommended.
  166. RAW2POV.DOC   - What you're reading.
  167. RAYOPT.DOC    - A brief description of the optimization code routines.
  168. CHESS.RAW     - Example of RAW input file format.
  169.  
  170.                                            CompuServe: 70714,3113
  171.                               You Can Call me Ray BBS: (708)358-5611
  172.