home *** CD-ROM | disk | FTP | other *** search
/ Learn 3D Graphics Programming on the PC / Learn_3D_Graphics_Programming_on_the_PC_Ferraro.iso / rwwin / read0.tx_ / read0.bin
Text File  |  1995-11-14  |  4KB  |  96 lines
  1.          RenderWare(tm) v1.4 d Translation Filters Utilities
  2.          =====================================================
  3.  
  4. ----------------------------------------------------------------------------
  5. These programs are provided as is with no warranties of any kind and are
  6. provided without any obligation on Criterion Software Ltd. to assist in
  7. their use.
  8.  
  9. Criterion Software Ltd. will not, under any circumstances, be liable for any
  10. lost revenue or other damages arising from the use of these programs.
  11. ----------------------------------------------------------------------------
  12.  
  13. This directory contains utilities to help you convert files in foreign
  14. formats for use by RenderWare. For this release a single utility is 
  15. included.  An ASCII AutoCad DXF (.dxf) to RenderWare script file
  16. format (.rwx) converter called dxftorwx.exe.
  17.  
  18. ============
  19.  
  20. DXFTORWX.EXE is a DOS program which converts ASCII AutoCad DXF (.dxf)
  21. files to RenderWare script file (.rwx) format. It has been enhanced
  22. significantly since the last release of RenderWare. Please note,
  23. however, that due to the diversity and complexity of the DXF format
  24. - particularly for 3D data - this utility still only converts a sub-set of
  25. possible DXF files.
  26.  
  27. The dxftorwx utility should be invoked as:
  28.  
  29. dxftorwx [<options>]    <input-file>
  30.  
  31. The ASCII DXF input model is read from the specified input file.  If
  32. no file is specified, a usage warning is printed.  Otherwise, the
  33. converted Renderware script file is output, by default, to a file with
  34. the same basename but the characteristic ".rwx" extension.
  35.  
  36. Valid options are as follows (default values bracketed) :-
  37.  
  38. -a <double>    : Ambient reflectance                      (0.142857)
  39.     Set the ambient reflectance of output polygons.
  40.  
  41. -c        : Toggle comments in output file                 (on)
  42.     Select/suppress comments in output file
  43.  
  44. -d <double>    : Diffuse reflectance                      (0.285714)
  45.     Set diffuse reflectance of output polygons.
  46.  
  47. -g        : Toggle global normalization                    (on)
  48.     By default, output polygons are normalized to lie within a normalized
  49.     [-1,1] x [-1,1] x [-1,1] box.  With global normalization all DXF
  50.     layers are normalized simultaneously.  Without global normalization,
  51.     DXF layers are normalized independently.
  52.  
  53. -m        : Toggle merging of layers into a single clump   (on)
  54.     Select/suppress merging of polygons from all layers into a single
  55.     clump
  56.  
  57. -n        : Toggle size normalization to range [-1,1]      (on)
  58.     Select/suppress normalization of layers
  59.  
  60. -o <string>    : Output file name                        (input.rwx)
  61.     Select the output file name.  A dash - selects output to the stdout
  62.     stream.
  63.  
  64. -s <double>    : Specular reflectance                     (0.571429)
  65.     Set the specular reflectance of output polygons.
  66.  
  67. -t <double>    : Tolerance for vertex comparison            (0.0001)
  68.     Set the tolerance value for matching shared vertices across DXF 3DFACE
  69.     entities in each layer.
  70.  
  71. -v        : Toggle vertex sharing                          (on)
  72.     Select/suppress the sharing of vertices across DXF 3DFACE entities in
  73.     each layer.
  74.  
  75. -z        : Toggle exact vertex sharing                    (on)
  76.     Select/suppress the sharing of exactly co-incident vertices across DXF
  77.     3DFACE entities in each layer.
  78.  
  79. -?        Displays a help message.
  80.  
  81. The converter recognizes four types of 3D DXF entities: 3DFACE,
  82. POLYLINE3D, POLYLINE3D/IMPLICIT MESH and POLYLINE3D/FACE MESH.  The
  83. number of successfully converted entities of each type is reported.
  84. If an error is encountered in the input file, the number of the
  85. offending line is reported together with the DXF string table context;
  86. only polygons converted prior to such an error are output.
  87.  
  88. Note that by default the converter attempts to share vertices across
  89. 3DFACES in order to form connected polygon meshes suitable for smooth
  90. shading - as with the RenderWare light sampling frequency set to
  91. "rwVERTEX".  Such sharing may occasionally produce geometry which 
  92. RenderWare will not accept, such as a clump polygon with only 2 distinct
  93. vertex indices.  Any such DXF files should be re-converted with vertex
  94. sharing suppressed.
  95.  
  96.