Descr effects torch fire.txt

Descr_effects_torch_fire.txt is used in BI to determine the effects used for torches in night battles. M2TW has a similarly structured file called descr_torch_fire.txt.

soldier_torch_fire

This section is an examination of what changes to one particular section do, other sections are similar in many respects so the information should be useful for other parts. Vanilla section:

effect soldier_torch_fire
{
	 type particle
	{
		texture				battlefield/fire/#flame_wheel.tga		
;		texture				models_effects/textures/checker_board.tga
		sprite_origin		0.0, 0.0
		sprite_size			1.0, 1.0

 		size_range       	0.1, 0.1
		age_range        	0.3, 0.3
	    grow_range		 	1.0, 1.0
		vel_range  			0.6, .6
		
		keyframe_colour
		{
;				0.0		255, 255, 255, 255
				0.0, 	0,   236, 242,     0
				0.1, 	255, 236,  242,   0
				0.5, 	255, 236,   149,   22
	 			1.0, 	0,   255,   149,   22
		}
		
		alpha_max	   		255			 ; maximum alpha value
		initial_size		0.2, 0.5
		blend_type			additive
		offset				0.0, 0.0, 0.2
		max_particles       3000

		emitter distance_time
		{
			density			        200 	   	; how many particels per second
			emitter_falloff_dist	100			; distance in meters to reduce emission over
			emitter_falloff_bias	0.5			
			distance_scale  		1
			max_distance			0.2	
			age_scale				0.45		
		}

		random_emit_radius		0, 0.1
		system_radius			2.0			    ; radius used for culling
		batched
	}
}

Above screenshot shows the torch flame effect created by the vanilla file (units shown are by Halie Satanus for the Lycan Rising mod). The tendency for the fire effect to intersect with curved shields can be seen on the unit in the background.

sprite_origin

Messing with sprite origin doesn't do anything useful, leave as 0,0

sprite_size

Normal setting is 1.0, 1.0 (for BI) - changing this can produce some strange effects especially using non-equal values, reducing to 0.1, 0.1 makes the sprite more or less disappear, see below:

incidentally you can see in that picture that with the fire effect removed you still have a glow from the torch model, that actually seems to account for the lighting cast onto the units and not the fire effect.

size_range

Normal setting is 0.1, 0.1 - making either number a lot larger increases the flame size appreciably, its not clear from experimentation quite what each individual number does. Making both numbers a lot smaller, eg 0.003, 0.003 doesn't seem to have any effect.

age_range

Normal setting is 0.3, 0.3, increasing these settings makes the fire starting at the torch travel further before disappearing, it can also mean that the fire forms as a sort of bubble at the torch and then floats away from it! Higher values for this line are used for the smoke effects, where they clearly make more sense. Changing them for the fire effect doesn't seem helpful.

grow_range

Initial values are 1.0, 1.0 - increasing to 5.0, 5.0 produces a much larger flame with white center when the unit is moving (not recommended). Reducing the values to 0.1 etc doesn't have much apparent effect.

vel_range

Initial values are 0.6, .6, much smaller values center the fire effect lower on the torch and 'burn' the holders hand. High values produce a much higher and faster moving flame, of little practical benefit except it does allow you to see how the constituent colours of the flame are working see keyframe-colour section below.

keyframe_colour

Using higher vel_range values and making the colours more extreme shows how the different colour components go together:

confusingly there appear to be four colours against each line and not the normal three for RGB values.

alpha_max

255 ; maximum alpha value

initial_size

0.2, 0.5

blend_type

additive

offset

0.0, 0.0, 0.2

max_particles

      3000

random_emit_radius

            0, 0.1

system_radius

                 2.0                         ; radius used for culling
               batched