This wiki was in read-only mode for many years, but can now be edited again. A lot of information will need to be updated.

Modeltool: Difference between revisions

From BZFlagWiki
Jump to navigation Jump to search
Zehra (talk | contribs)
added wiki table
Zehra (talk | contribs)
m clarified version differences
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
Modeltool has two modes of operation: Normal and Drawinfo.
Modeltool is a converter utility for converting '''.obj''' into drawInfo or meshes. Early versions do not have drawInfo support and will simply  output meshes.
 
In versions of draw '''1.8.0''' and above, 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.
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.
Line 11: Line 13:
| -g <name> || use group definition.
| -g <name> || use group definition.
|-
|-
| -tx <dir> || set texture prefix.
| -tx <dir> || set texture prefix.
|-
|-
| -m || disable materials (matref).
| -m || disable materials (matref).
Line 48: Line 50:
In drawinfo mode, a third file, called a diconf is required. This is a plain text file, named with the extension .diconf
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:===
-lod 0 filename.obj :Specify a mesh to convert
{|{{Prettytable}}
-angvel <val>         : Apply angular motion to the drawinfo. In radians per second.
|-
  -nomats                   : do not write materials.
| {{Hl3}} |'''Argument'''
  -bounds                   : compute the bounds and sphere for draw info meshes and write them to the map
| {{Hl3}} |'''Description'''
  -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
| -lod 0 filename.obj || Specify a mesh to convert.
  -striplimit <val>   : the longest triangle strip to use for LODs  (16 recommended)
|-
| -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).
|}
 
[[category:Map Making]]
[[category:Map Making]]
[[category:Map Editors]]
[[category:Map Editors]]

Latest revision as of 18:55, 2 November 2025

Modeltool is a converter utility for converting .obj into drawInfo or meshes. Early versions do not have drawInfo support and will simply output meshes.

In versions of draw 1.8.0 and above, 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:

Argument Description
-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:

Argument Description
-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).