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
Wrap
Text File
|
1995-11-14
|
4KB
|
96 lines
RenderWare(tm) v1.4 d Translation Filters Utilities
=====================================================
----------------------------------------------------------------------------
These programs are provided as is with no warranties of any kind and are
provided without any obligation on Criterion Software Ltd. to assist in
their use.
Criterion Software Ltd. will not, under any circumstances, be liable for any
lost revenue or other damages arising from the use of these programs.
----------------------------------------------------------------------------
This directory contains utilities to help you convert files in foreign
formats for use by RenderWare. For this release a single utility is
included. An ASCII AutoCad DXF (.dxf) to RenderWare script file
format (.rwx) converter called dxftorwx.exe.
============
DXFTORWX.EXE is a DOS program which converts ASCII AutoCad DXF (.dxf)
files to RenderWare script file (.rwx) format. It has been enhanced
significantly since the last release of RenderWare. Please note,
however, that due to the diversity and complexity of the DXF format
- particularly for 3D data - this utility still only converts a sub-set of
possible DXF files.
The dxftorwx utility should be invoked as:
dxftorwx [<options>] <input-file>
The ASCII DXF input model is read from the specified input file. If
no file is specified, a usage warning is printed. Otherwise, the
converted Renderware script file is output, by default, to a file with
the same basename but the characteristic ".rwx" extension.
Valid options are as follows (default values bracketed) :-
-a <double> : Ambient reflectance (0.142857)
Set the ambient reflectance of output polygons.
-c : Toggle comments in output file (on)
Select/suppress comments in output file
-d <double> : Diffuse reflectance (0.285714)
Set diffuse reflectance of output polygons.
-g : Toggle global normalization (on)
By default, output polygons are normalized to lie within a normalized
[-1,1] x [-1,1] x [-1,1] box. With global normalization all DXF
layers are normalized simultaneously. Without global normalization,
DXF layers are normalized independently.
-m : Toggle merging of layers into a single clump (on)
Select/suppress merging of polygons from all layers into a single
clump
-n : Toggle size normalization to range [-1,1] (on)
Select/suppress normalization of layers
-o <string> : Output file name (input.rwx)
Select the output file name. A dash - selects output to the stdout
stream.
-s <double> : Specular reflectance (0.571429)
Set the specular reflectance of output polygons.
-t <double> : Tolerance for vertex comparison (0.0001)
Set the tolerance value for matching shared vertices across DXF 3DFACE
entities in each layer.
-v : Toggle vertex sharing (on)
Select/suppress the sharing of vertices across DXF 3DFACE entities in
each layer.
-z : Toggle exact vertex sharing (on)
Select/suppress the sharing of exactly co-incident vertices across DXF
3DFACE entities in each layer.
-? Displays a help message.
The converter recognizes four types of 3D DXF entities: 3DFACE,
POLYLINE3D, POLYLINE3D/IMPLICIT MESH and POLYLINE3D/FACE MESH. The
number of successfully converted entities of each type is reported.
If an error is encountered in the input file, the number of the
offending line is reported together with the DXF string table context;
only polygons converted prior to such an error are output.
Note that by default the converter attempts to share vertices across
3DFACES in order to form connected polygon meshes suitable for smooth
shading - as with the RenderWare light sampling frequency set to
"rwVERTEX". Such sharing may occasionally produce geometry which
RenderWare will not accept, such as a clump polygon with only 2 distinct
vertex indices. Any such DXF files should be re-converted with vertex
sharing suppressed.