FTEQW IQM Tool CommandFile Documentation

From Quake Wiki

Usage[edit]

Create an empty text file, add your commands. Compile as such:
iqm.exe commands.txt

Simple Example File[edit]

output output.iqm
scene reference_mesh.smd
scene animation1.smd fps 25


Advanced Example File[edit]

output view_tommygun.iqm
bone "Bone55" rename "Muzzleflash"
scene ref_tommygun.smd
rotate 0 -90 0
scene idle.smd fps 20
scene idle_fidget1.smd fps 20
scene idle_fidget2.smd fps 20
scene reload.smd fps 22
scene draw.smd fps 25
scene holster.smd fps 25
scene shoot.smd fps 34
scene shoot_last.smd fps 34
scene shoot_empty.smd fps 34


Header Data[edit]

output <FILENAME>
specified the output file name. you should only have one of these.

exec <FILENAME>
exec the specified command file, before parsing the rest of the current file.

hitbox <BODY NUM> <BONE NAME> <MIN POS VECTOR> <MAX POS VECTOR>
generates a hitmesh as a bbox centered around the bone in the base pose (the hitbox will rotate/move with animations). The bodynum will be visible to gamecode, and may merge with other hitboxes with the same group.

modelflags <NAME OR HEX>
enables the specified bit in the iqm header. supported names include q1_rocket, q1_grenade, q1_gib, q1_rotate, q1_tracer1, q1_zomgib, q1_tracer2, q1_tracer3

mesh <NAME> [MESH PROPERTIES LIST]
provides overrides for a single named mesh (properties used will be those as they're already defined, if not otherwise listed).

bone <SOURCENAME> [rename <NEWNAME>] [group <GROUPNUM>]
provides bone renaming and grouping. try to avoid renaming two bones to the same resulting name... groups may have limitations if a parent/child relationship cannot be honoured. lowest group numbers come before higher groups. by default bones will inherit their group from their parent.

import <FILENAME> [IMPORT PROPERTIES] [MESH PROPERTIES]
imports the meshes and animations from the specified file.


Shared Scene Import Properties[edit]

rotate <PITCH> <YAW> <ROLL>
rotates the model

scale <SCALER>
rescales the model

origin <X> <Y> <Z>
moves the thing

materialprefix <PREFIX/>
provides a text prefix on the material name, which should make it easier for editors while still honouring shader paths.

nomesh <1|0>
discards all meshed from the affected files.

noanim <1|0>
discards animations from the affected files, does not exclude the base pose.


Reference Mesh Properties (for the base mesh)[edit]

contents <NAMES OR 0xBITS>
'body' or 'empty' are the two that are most likely to be used. 'solid' may also be desired, or possibly also 'corpse'.

surfaceflags <NAMES OR 0xBITS>
'q3_nodraw/fte_nodraw'

body <NUMBER>
this is the 'body' value reported to gamecode when a trace hits this surface.

geomset <GEOMGROUP> <GEOMID>
by configuring this, you can have models display different body parts for different character models.

lodrange <MINDIST> <MAXDIST>
not yet implemented by the engine. 0 for both is the default.


Animation Properties[edit]

name <NAME>
the imported animations will be assigned this name. May be problematic if the imported file(s) share the same name, so try to avoid using this at global scope.

fps <RATE>
framerate for any imported animations.

loop
flags animations as looping.

clamp
disables looping.

unpack
seperates each pose of the animations into a seperate single-pose animation for compat with q1 or q2-style model animations.

pack
disables unpacking again.

start <FIRSTPOSE>
the fist pose to import.

end <LASTPOSE>
the last pose to import.

event [ANIM,]<POSE> <EVENTCODE> <"EVENTDATA">
embeds event info within the animation, for stuff like footsteps. How this is used depends on the engine... If used at global scope, can be reset with 'event reset' in order to not apply to later files.