Modeltool - Revision history

Zehra: clarified version differences

2025-11-02T18:55:31Z

clarified version differences

← Older revision		Revision as of 18:55, 2 November 2025
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.

Zehra: added wiki table

2017-02-06T01:10:43Z

added wiki table

← Older revision		Revision as of 01:10, 6 February 2017
Line 11:		Line 11:
	\| -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 48:
	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]]

Zehra: added wiki table

2017-02-03T21:33:59Z

added wiki table

← Older revision		Revision as of 21:33, 3 February 2017
Line 3:		Line 3:
	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.

	Modeltool Arguments		===Modeltool Arguments:===
	-g <name> : use group definition		{\|{{Prettytable}}
	-tx <dir> : set texture prefix		\|-
	-m : disable materials (matref)		\| {{Hl3}} \|'''Argument'''
	-sm : use the smoothbounce property		\| {{Hl3}} \|'''Description'''
	-yz : flip y and z coordinates		\|-
	-n : disable normals		\| -g <name> \|\| use group definition.
	-t : disable texture coordinates		\|-
	-a : disable ambient coloring		\| -tx <dir> \|\| set texture prefix.
	-d : disable diffuse coloring		\|-
	-s : disable specular coloring		\| -m \|\| disable materials (matref).
	-s : disable shininess		\|-
	-sf <val> : shine multiplier		\| -sm \|\| use the smoothbounce property.
	-e : disable emission coloring		\|-
	-gx <val> : scale the model by this factor		\| -yz \|\| flip y and z coordinates.
	-gsx <val> : shift the map by this value in X		\|-
	-gsy <val> : shift the map by this value in Y		\| -n \|\| disable normals.
	-gsz <val> : shift the map by this value in Z		\|-
	-bspskip <val> : skip faces with this material when importing a bsp		\| -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		In drawinfo mode, a third file, called a diconf is required. This is a plain text file, named with the extension .diconf

Optic Delusion at 01:34, 29 October 2008

2008-10-29T01:34:24Z

← Older revision		Revision as of 01:34, 29 October 2008
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]]

Optic Delusion: radians per second, not per minute.

2008-01-05T13:06:50Z

radians per second, not per minute.

← Older revision		Revision as of 13:06, 5 January 2008
Line 23:		Line 23:

	DIconf Arguments		DIconf Arguments
	-angvel <val> : Apply angular motion to the drawinfo. In radians per ~~minute~~.		-angvel <val> : Apply angular motion to the drawinfo. In radians per second.
	-nomats : do not write materials.		-nomats : do not write materials.
	-bounds : compute the bounds and sphere for draw info meshes and write them to the map		-bounds : compute the bounds and sphere for draw info meshes and write them to the map

Optic Delusion: had forgotten -angvel

2007-12-31T05:38:28Z

had forgotten -angvel

← Older revision		Revision as of 05:38, 31 December 2007
Line 23:		Line 23:

	DIconf Arguments		DIconf Arguments
			-angvel <val> : Apply angular motion to the drawinfo. In radians per minute.
	-nomats : do not write materials.		-nomats : do not write materials.
	-bounds : compute the bounds and sphere for draw info meshes and write them to the map		-bounds : compute the bounds and sphere for draw info meshes and write them to the map

Optic Delusion: differentiate arguments and diconf arguments

2007-12-31T05:19:27Z

differentiate arguments and diconf arguments

← Older revision		Revision as of 05:19, 31 December 2007
Line 2:		Line 2:


	Modeltool ~~options~~		Modeltool Arguments
	-g <name> : use group definition		-g <name> : use group definition
	-tx <dir> : set texture prefix		-tx <dir> : set texture prefix
	~~-nomats : do not write materials.~~
	-m : disable materials (matref)		-m : disable materials (matref)
	-sm : use the smoothbounce property		-sm : use the smoothbounce property
Line 22:		Line 21:
	-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
	-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		DIconf Arguments
	-comments : add comments to the resulting bzw file (will make it a lot larger		-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 to the resulting bzw file (will make it a lot larger
	-striplimit <val> : the longest triangle strip to use for LODs (16 recommended)		-striplimit <val> : the longest triangle strip to use for LODs (16 recommended)
	[[category:Map Making]]		[[category:Map Making]]
	[[category:Map Editors]]		[[category:Map Editors]]

Optic Delusion at 01:05, 27 December 2007

2007-12-27T01:05:55Z

Optic Delusion: make pretty

2007-12-27T00:57:01Z

make pretty

← Older revision		Revision as of 00:57, 27 December 2007
Line 4:		Line 4:
	Modeltool options		Modeltool options
	-g <name> : use group definition		-g <name> : use group definition
	-tx <dir> : set texture prefix		-tx <dir> : set texture prefix
	-nomats : no materials ~~are output in the .bzw~~.		-nomats : do not write materials.
	-sm : use the smoothbounce property		-m : disable materials (matref)
	-yz : flip y and z coordinates		-sm : use the smoothbounce property
	-n : disable normals		-yz : flip y and z coordinates
	-t : disable texture coordinates		-n : disable normals
	~~-m : disable materials~~		-t : disable texture coordinates
	-a : disable ambient coloring		-a : disable ambient coloring
	-d : disable diffuse coloring		-d : disable diffuse coloring
	-s : disable specular coloring		-s : disable specular coloring
	-sh : disable shininess		-sh : disable shininess
	-sf <val> : shine multiplier		-sf <val> : shine multiplier
	-e : disable emission coloring		-e : disable emission coloring
	-gx <val> : scale the model by this factor		-gx <val> : scale the model by this factor
	-gsx <val> : shift the map by this value in X		-gsx <val> : shift the map by this value in X
	-gsy <val> : shift the map by this value in Y		-gsy <val> : shift the map by this value in Y
	-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
	-bounds : compute the bounds and sphere for draw info meshes and write them to the map		-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		-bounding : generates invisible faces (and a material) to be used for collision detection
	-comments: add comments to the resulting bzw file (will make it a lot larger		-comments : add comments to the resulting bzw file (will make it a lot larger
	-striplimit <val>: the longest triangle strip to use for LODs		-striplimit <val>: the longest triangle strip to use for LODs (16 recommended)
	[[category:Map Making]]		[[category:Map Making]]
	[[category:Map Editors]]		[[category:Map Editors]]

Optic Delusion: added -bounding and -nomats. Is my -bounding drfinition correct?

2007-12-27T00:48:22Z

added -bounding and -nomats. Is my -bounding drfinition correct?

← Older revision		Revision as of 00:48, 27 December 2007
Line 5:		Line 5:
	-g <name> : use group definition		-g <name> : use group definition
	-tx <dir> : set texture prefix		-tx <dir> : set texture prefix
			-nomats : no materials are output in the .bzw.
	-sm : use the smoothbounce property		-sm : use the smoothbounce property
	-yz : flip y and z coordinates		-yz : flip y and z coordinates
Line 22:		Line 23:
	-bspskip <val> : skip faces with this material when importing a bsp		-bspskip <val> : skip faces with this material when importing a bsp
	-bounds : compute the bounds and sphere for draw info meshes and write them to the map		-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 to the resulting bzw file (will make it a lot larger		-comments: add comments to the resulting bzw file (will make it a lot larger
	-striplimit <val>: the longest triangle strip to use for LODs		-striplimit <val>: the longest triangle strip to use for LODs
	[[category:Map Making]]		[[category:Map Making]]
	[[category:Map Editors]]		[[category:Map Editors]]

← Older revision		Revision as of 01:05, 27 December 2007
Line 3:		Line 3:

	Modeltool options		Modeltool options
	-g <name> : use group definition		-g <name> : use group definition
	-tx <dir> : set texture prefix		-tx <dir> : set texture prefix
	-nomats : do not write materials.		-nomats : do not write materials.
	-m : disable materials (matref)		-m : disable materials (matref)
	-sm : use the smoothbounce property		-sm : use the smoothbounce property
	-yz : flip y and z coordinates		-yz : flip y and z coordinates
	-n : disable normals		-n : disable normals
	-t : disable texture coordinates		-t : disable texture coordinates
	-a : disable ambient coloring		-a : disable ambient coloring
	-d : disable diffuse coloring		-d : disable diffuse coloring
	-s : disable specular coloring		-s : disable specular coloring
	-sh : disable shininess		-s : disable shininess
	-sf <val> : shine multiplier		-sf <val> : shine multiplier
	-e : disable emission coloring		-e : disable emission coloring
	-gx <val> : scale the model by this factor		-gx <val> : scale the model by this factor
	-gsx <val> : shift the map by this value in X		-gsx <val> : shift the map by this value in X
	-gsy <val> : shift the map by this value in Y		-gsy <val> : shift the map by this value in Y
	-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
	-bounds : compute the bounds and sphere for draw info meshes and write them to the map		-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		-bounding : generates invisible faces (and a material) to be used for collision detection
	-comments : add comments to the resulting bzw file (will make it a lot larger		-comments : add comments to the resulting bzw file (will make it a lot larger
	-striplimit <val>: the longest triangle strip to use for LODs (16 recommended)		-striplimit <val> : the longest triangle strip to use for LODs (16 recommended)
	[[category:Map Making]]		[[category:Map Making]]
	[[category:Map Editors]]		[[category:Map Editors]]