Poodletooth-iLand/build/nirai/panda3d/doc/man/dxf2egg.1

73 lines
3.5 KiB
Groff
Raw Permalink Normal View History

2015-11-14 13:28:53 -06:00
.\" Automatically generated by dxf2egg -write-bam
.TH DXF2EGG 1 "27 December 2014" "1.9.0" Panda3D
.SH NAME
dxf2egg \- convert AutoCAD .dxf files to .egg files
.SH SYNOPSIS
\fBdxf2egg\fR [opts] input.dxf output.egg
.br
\fBdxf2egg\fR [opts] -o output.egg input.dxf
.br
\fBdxf2egg\fR [opts] input.dxf >output.egg
.SH DESCRIPTION
This program converts DXF (AutoCAD interchange format) to egg. It only converts polygon data, with no fancy tricks. DXF does not support hierarchical databases, so dxf2egg creates a single group at the root level for each layer in the DXF file.
.SH OPTIONS
.TP
.B \-noabs
Don't allow the input DXF file to have absolute pathnames. If it does, abort with an error. This option is designed to help detect errors when populating or building a standalone model tree, which should be self-contained and include only relative pathnames.
.TP
.B \-noexist
Don't treat it as an error if the input file references pathnames (e.g. textures) that don't exist. Normally, this will be flagged as an error and the command aborted; with this option, an egg file will be generated anyway, referencing pathnames that do not exist.
.TP
.B \-ignore
Ignore non-fatal errors and generate an egg file anyway.
.TP
.BI "\-ui " "units"
Specify the units of the input DXF file. Normally, this can be inferred from the file itself.
.TP
.BI "\-uo " "units"
Specify the units of the resulting egg file. If this is specified, the vertices in the egg file will be scaled as necessary to make the appropriate units conversion; otherwise, the vertices will be left as they are.
.TP
.B \-no
Strip all normals.
.TP
.B \-np
Strip existing normals and redefine polygon normals.
.TP
.BI "\-nv " "threshold"
Strip existing normals and redefine vertex normals. Consider an edge between adjacent polygons to be smooth if the angle between them is less than threshold degrees.
.TP
.B \-nn
Preserve normals exactly as they are. This is the default.
.TP
.BI "\-tbn " "name"
Compute tangent and binormal for the named texture coordinate set(s). The name may include wildcard characters such as * and ?. The normal must already exist or have been computed via one of the above options. The tangent and binormal are used to implement bump mapping and related texture-based lighting effects. This option may be repeated as necessary to name multiple texture coordinate sets.
.TP
.B \-tbnall
Compute tangent and binormal for all texture coordinate sets. This is equivalent to -tbn "*".
.TP
.B \-tbnauto
Compute tangent and binormal for all normal maps.
.TP
.BI "\-TS " "sx[,sy,sz]"
Scale the model uniformly by the given factor (if only one number is given) or in each axis by sx, sy, sz (if three numbers are given).
.TP
.BI "\-TR " "x,y,z"
Rotate the model x degrees about the x axis, then y degrees about the y axis, and then z degrees about the z axis.
.TP
.BI "\-TA " "angle,x,y,z"
Rotate the model angle degrees counterclockwise about the given axis.
.TP
.BI "\-TT " "x,y,z"
Translate the model by the indicated amount.
All transformation options (-TS, -TR, -TA, -TT) are cumulative and are applied in the order they are encountered on the command line.
.TP
.BI "\-o " "filename"
Specify the filename to which the resulting egg file will be written. If this option is omitted, the last parameter name is taken to be the name of the output file, or standard output is used if there are no other parameters.
.TP
.BI "\-cs " "coordinate-system"
Specify the coordinate system of the input DXF file. Normally, this is z-up.
.TP
.B \-h
Display this help page.