Conv3ds.exe Optional Arguments

Conv3ds.exe -A

If the 3DS file contains key frame data, you can use the -A option to produce an X file that contains an animation set. The command for this would be:

conv3ds -A File.3ds

The File.3ds parameter is the name of the file to be converted. You can use IDirect3DRMAnimationSet::Load to load the animation.

Conv3ds.exe -m

Use the -m option to make an X file that contains a single mesh made from all the objects in the 3DS file.

conv3ds -m File.3ds

Use IDirect3DRMMeshBuilder::Load to load the mesh.

Conv3ds.exe -T

Use the-T option to wrap all the objects and frame hierarchies in a single top level frame. Using this option, all the frames and objects in the 3DS file can be loaded with a single call to IDirect3DRMFrame::Load. The first top level frame hierarchy in the X file will be loaded. The frame containing all the other frames and meshes is called "x3ds_filename" (without the .3ds extension). The -T option will have no effect if it is used with the -m option.

Conv3ds.exe -s

The -s option allows you to specify a scale factor for all the objects converted in the 3DS file. For example, the following command makes all objects 10 times bigger:

conv3ds -s10 File.3ds

The following command makes all objects 10 times smaller:

conv3ds -s0.1 File.3ds

Conv3ds.exe -r

The -r option reverses the winding order of the faces when the 3DS file is converted. If, after converting the 3DS file and viewing it in Direct3D, the object appears "inside-out" try converting it with the -r option. All Lightwave models exported as 3DS files need this option. See 3DS Files Produced from Lightwave Objects for details.

Conv3ds.exe -v

The -v option turns on verbose output mode. Specify an integer with it. The integers that are currently supported are:

Option Meaning
-v0 Default. Verbose mode off.
-v1 Prints warnings about bad objects, and prints general information about what the converter is doing.
-v2 Prints basic keyframe information, the objects being included in the conversion process, and information about the objects being saved.
-v3 Very verbose. Mostly useful for the debugging information it provides.

Conv3ds.exe -e

The -e option allows you to change the extension for texture map files. For example, consider the command:

conv3ds -e"ppm" File.3ds

If File.3ds contains objects that reference the texture map file brick.gif, the X file will reference the texture map file brick.ppm. The converter does not convert the texture map file. The texture map files must be in the D3DPATH when the resulting X File is loaded.

Conv3ds.exe -x

The -x option forces Conv3ds to produce a text X file, instead of a binary X file. Text files are larger but can be hand edited easily.

Conv3ds.exe -X

The -X option forces Conv3ds to include the Direct3DRM X File templates in the file. By default the templates are not included.

Conv3ds.exe -t

The -t option specifies that the X File produced will not contain texture information.

Conv3ds.exe -N

The -N option specifies that the X file produced will not contain normal vector information. All the Direct3DRM Load calls will generate normal vectors for objects with no normal vectors in the X file.

Conv3ds.exe -c

The -c option specifies that the X file produced should not contain texture coordinates. By default, if you use the -m option, the mesh that is output will contain (0,0) uv texture coordinates if the 3DS object had no texture coordinates.

Conv3ds.exe -f

The -f option specifies that the X file produced should not contain a Frame transformation matrix.

Conv3ds.exe - z and Conv3ds.exe -Z

The -z and -Z options allow you to adjust the alpha face color value of all the materials referenced by objects in the X File. For example, the following command causes Conv3ds.exe to add 0.1 to all alpha values under 0.2:

conv3ds -z0.1 -Z0.2 File.3ds

The following command causes Conv3ds.exe to subtract 0.2 from the alpha values for all alphas:

conv3ds-z"-0.2" -z1 File.3ds

Conv3ds.exe -o

The -o option allows you to specify the filename for the .X File produced.

Conv3ds.exe -h

The -h option tells the converter not to try to resolve any hierarchy information in the 3DS file (usually produced by the keyframer). Instead, all the objects are output in top level frames if -m option is not used.