This wiki is archived and useful information is being migrated to the main bzflag.org website

Difference between revisions of "Modeltool"

From BZFlagWiki
Jump to: navigation, search
m (radians per second, not per minute.)
Line 1: Line 1:
Modeltool can now convert .obj files to bzflag drawinfo. It can be downloaded with the source code through [[SVN]], and it is found in the bzflag/tools/ directory.
+
Modeltool has two modes of operation: Normal and Drawinfo.
 
+
  
 +
In normal operation it converts wavefront.obj files to .bzw mesh. The easiest way to do this is to place both the modeltool binary and an obj file in a directory, then open your terminal  and cd to that directory, and ./modeltool your_filename.obj.  A bzw format file will be created, with your mesh inside of it.
 +
 
 
Modeltool Arguments
 
Modeltool Arguments
 
  -g <name>      : use group definition
 
  -g <name>      : use group definition
Line 21: Line 22:
 
   -gsz <val>      : shift the map by this value in Z
 
   -gsz <val>      : shift the map by this value in Z
 
   -bspskip <val>  : skip faces with this material when importing a bsp
 
   -bspskip <val>  : skip faces with this material when importing a bsp
 +
 
    
 
    
 +
In drawinfo mode, a third file, called a diconf is required. This is a plain text file, named with the extension .diconf
 +
 
DIconf Arguments
 
DIconf Arguments
  -angvel <val>     : Apply angular motion to the drawinfo. In radians per second.
+
-lod 0 filename.obj  :Specify a mesh to convert
   -nomats               : do not write materials.
+
  -angvel <val>         : Apply angular motion to the drawinfo. In radians per second.
   -bounds               : compute the bounds and sphere for draw info meshes and write them to the map
+
   -nomats                   : do not write materials.
   -bounding           : generates invisible faces (and a material) to be used  for collision detection
+
   -bounds                   : compute the bounds and sphere for draw info meshes and write them to the map
   -comments         : add comments to the resulting bzw file (will make it a lot larger
+
   -bounding               : generates invisible faces (and a material) to be used  for collision detection
   -striplimit <val> : the longest triangle strip to use for LODs  (16 recommended)
+
   -comments             : add comments (line numbering) to the resulting bzw file (will make it a lot larger
 +
   -striplimit <val>   : the longest triangle strip to use for LODs  (16 recommended)
 
[[category:Map Making]]
 
[[category:Map Making]]
 
[[category:Map Editors]]
 
[[category:Map Editors]]

Revision as of 01:34, 29 October 2008

Modeltool has two modes of operation: Normal and Drawinfo.

In normal operation it converts wavefront.obj files to .bzw mesh. The easiest way to do this is to place both the modeltool binary and an obj file in a directory, then open your terminal and cd to that directory, and ./modeltool your_filename.obj. A bzw format file will be created, with your mesh inside of it.

Modeltool Arguments

-g <name>       : use group definition
 -tx <dir>       : set texture prefix
 -m	         : disable materials (matref)
 -sm	         : use the smoothbounce property
 -yz	         : flip y and z coordinates
 -n	         : disable normals
 -t	         : disable texture coordinates
 -a	         : disable ambient coloring
 -d	         : disable diffuse coloring
 -s              : disable specular coloring
 -s              : disable shininess
 -sf <val>       : shine multiplier
 -e              : disable emission coloring
 -gx <val>       : scale the model by this factor
 -gsx <val>      : shift the map by this value in X
 -gsy <val>      : shift the map by this value in Y
 -gsz <val>      : shift the map by this value in Z
 -bspskip <val>  : skip faces with this material when importing a bsp


In drawinfo mode, a third file, called a diconf is required. This is a plain text file, named with the extension .diconf

DIconf Arguments

-lod 0 filename.obj  :Specify a mesh to convert
-angvel <val>          : Apply angular motion to the drawinfo. In radians per second.
 -nomats                   : do not write materials.
 -bounds                   : compute the bounds and sphere for draw info meshes and write them to the map
 -bounding               : generates invisible faces (and a material) to be used  for collision detection
 -comments              : add comments (line numbering) to the resulting bzw file (will make it a lot larger
 -striplimit <val>    : the longest triangle strip to use for LODs  (16 recommended)