Editing FTEQW IQM Tool CommandFile Documentation

== Usage ==
Create an empty text file, add your commands. Compile as such:<br />
<code>iqm.exe commands.txt</code><br /><br />

== Simple Example File ==
<code>
output output.iqm<br />
scene reference_mesh.smd<br />
scene animation1.smd fps 25<br />
</code>



== Advanced Example File ==
<code>
output view_tommygun.iqm<br />
bone "Bone55" rename "Muzzleflash"<br />
scene ref_tommygun.smd<br />
rotate 0 -90 0<br />
scene idle.smd fps 20<br />
scene idle_fidget1.smd fps 20<br />
scene idle_fidget2.smd fps 20<br />
scene reload.smd fps 22<br />
scene draw.smd fps 25<br />
scene holster.smd fps 25<br />
scene shoot.smd fps 34<br />
scene shoot_last.smd fps 34<br />
scene shoot_empty.smd fps 34<br />
</code>



== Header Data ==
<code>output <FILENAME></code><br />
specified the output file name. you should only have one of these.<br /><br />

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

<code>hitbox <BODY NUM> <BONE NAME> <MIN POS VECTOR> <MAX POS VECTOR></code><br />
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.<br /><br />
	
<code>modelflags <NAME OR HEX></code><br />
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<br /><br />
	
<code>mesh <NAME> [MESH PROPERTIES LIST]</code><br />
provides overrides for a single named mesh (properties used will be those as they're already defined, if not otherwise listed).<br /><br />
	
<code>bone <SOURCENAME> [rename <NEWNAME>] [group <GROUPNUM>]</code><br />
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.<br /><br />
	
<code>import <FILENAME> [IMPORT PROPERTIES] [MESH PROPERTIES]</code><br />
imports the meshes and animations from the specified file.<br /><br />

== Shared Properties ==
<code>rotate <PITCH> <YAW> <ROLL></code><br />
rotates the model<br /><br />
	
<code>scale <SCALER></code><br />
rescales the model<br /><br />
	
<code>origin <X> <Y> <Z></code><br />
moves the thing<br /><br />
	
<code>materialprefix <PREFIX/></code><br />
provides a text prefix on the material name, which should make it easier for editors while still honouring shader paths.<br /><br />
	
<code>nomesh <1|0></code><br />
discards all meshed from the affected files.<br /><br />
	
<code>noanim <1|0></code><br />
discards animations from the affected files, does not exclude the base pose.<br /><br />

== Mesh Properties ==
<code>contents <NAMES OR 0xBITS></code><br />
'body' or 'empty' are the two that are most likely to be used. 'solid' may also be desired, or possibly also 'corpse'.<br /><br />
	
<code>surfaceflags <NAMES OR 0xBITS></code><br />
'q3_nodraw/fte_nodraw'<br /><br />
	
<code>body <NUMBER></code><br />
this is the 'body' value reported to gamecode when a trace hits this surface.<br /><br />
	
<code>geomset <GEOMGROUP> <GEOMID></code><br />
by configuring this, you can have models display different body parts for different character models.<br /><br />
	
<code>lodrange <MINDIST> <MAXDIST></code><br />
not yet implemented by the engine. 0 for both is the default.<br /><br />

== Anim/Import Properties ==
<code>name <NAME></code><br />
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.<br /><br />
	
<code>fps <RATE></code><br />
framerate for any imported animations.<br /><br />
	
<code>loop</code><br />
flags animations as looping.<br /><br />
	
<code>clamp</code><br />
disables looping.<br /><br />
	
<code>unpack</code><br />
seperates each pose of the animations into a seperate single-pose animation for compat with q1 or q2-style model animations.<br /><br />
	
<code>pack</code><br />
disables unpacking again.<br /><br />
	
<code>nomesh <1|0></code><br />
discards all meshed from the affected files.<br /><br />
	
<code>noanim <1|0></code><br />
discards animations from the affected files, does not disclude the base pose.<br /><br />

<code>materialprefix <PREFIX/></code><br />
provides a text prefix on the material name, which should make it easier for editors while still honouring shader paths.<br /><br />
	
<code>start <FIRSTPOSE></code><br />
the fist pose to import.<br /><br />
	
<code>end <LASTPOSE></code><br />
the last pose to import.<br /><br />
	
<code>rotate <PITCH> <YAW> <ROLL></code><br />
rotates the model<br /><br />
	
<code>scale <SCALER></code><br />
rescales the model<br /><br />
	
<code>origin <X> <Y> <Z></code><br />
moves the thing<br /><br />
	
<code>event [ANIM,]<POSE> <EVENTCODE> <"EVENTDATA"></code><br />
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.<br /><br />