Hosting and domain costs until October 2024 have been generously sponsored by dumptruck_ds. Thank you!

Difference between revisions of "FTEQW IQM Tool Documentation"

From Quake Wiki

(No difference)

Revision as of 22:40, 14 June 2020

The FTEQW IQM TOOL

This is a compiler to generate IQM models. It's a fork of Lee Salzman's exporter and has additional features:

  • compile options can be specified in command files
  • additional mesh properties
  • multiple mesh files
  • hitmesh support
  • some other things
  • more verbose text output
  • additional shader prefixes
  • bone renaming and regrouping
  • animation unpacking

Supported import formats:

.md5mesh .md5anim .iqe .smd .fbx .obj

Usage

You can supply either a mesh file, animation files, or both. Note that if an input mesh file is supplied, it must come before the animation files in the file list. The output IQM file will contain the supplied mesh and any supplied animations. If no mesh is provided,the IQM file will simply contain the supplied animations.

iqm.exe cmdfile.cmd
iqm.exe [options] output.iqm mesh.iqe anim1.iqe ... animN.iqe
iqm.exe [options] output.iqm mesh.md5mesh anim1.md5anim ... animN.md5anim
iqm.exe [options] output.iqm mesh.smd anim1.smd ... animN.smd
iqm.exe [options] output.iqm mesh.fbx anim1.fbx ... animN.fbx
iqm.exe [options] output.iqm mesh.obj

For certain formats, IQE, OBJ, and FBX, it is possible to combine multiple mesh files of the exact same vertex layout and skeleton by supplying them as "mesh1.iqe,mesh2.iqe,mesh3.iqe", that is, a comma-separated list of the mesh files (with no spaces) in place of the usual mesh filename.


Options

Options can be any of the following command-line switches:

Option Description
-s N Sets the output scale to N (float).
--scale N Sets the output scale to N (float).
--meshtrans Z Translates a mesh by Z (float). This does not affect the skeleton.
--meshtrans X,Y,Z Translates a mesh by X,Y,Z (floats). This does not affect the skeleton.
-j Forces the exporting of joint information in animation files without meshes.
--forcejoints Forces the exporting of joint information in animation files without meshes.
-q Quiet. Only display warnings or errors.
-v Verbose. Print lots of extra info.
-n No Extensions. Disables the use of fte-specific iqm extensions.


Options for animations

Each animation file can be preceded by any combination of the following commandline switches:

Option Description
--name A Sets the name of the animation to A.
--fps N Sets the FPS of the animation to N (float).
--loop Sets the loop flag for the animation.
--start N Sets the first frame of the animation to N (integer).
--end N Sets the last frame of the animation to N (integer).