CCG/Modelling: Animation Events - Revision history

Pev at 03:25, 15 June 2011

2011-06-15T03:25:45Z

← Older revision		Revision as of 03:25, 15 June 2011
Line 90:		Line 90:


	[[Modelling: Tenders\|Previous Page]] . . . . [[Modelling: Level of Detail Mesh Reduction\|Next Page]]		[[CCG/Modelling: Tenders\|Previous Page]] . . . . [[CCG/Modelling: Level of Detail Mesh Reduction\|Next Page]]

	==Return to CCG Index==		==Return to CCG Index==
	[[Content Creator's Guide]]		[[Content Creator's Guide]]

Pev: Modelling: Animation Events moved to CCG/Modelling: Animation Events

2011-06-15T03:08:37Z

Modelling: Animation Events moved to CCG/Modelling: Animation Events

← Older revision	Revision as of 03:08, 15 June 2011
(No difference)

Pev at 02:24, 15 June 2011

2011-06-15T02:24:50Z

← Older revision		Revision as of 02:24, 15 June 2011
Line 2:		Line 2:
	Sounds events and generic events can be linked to an animation key-frame to give great control over sound and script timing for industry and scenery assets.		Sounds events and generic events can be linked to an animation key-frame to give great control over sound and script timing for industry and scenery assets.

	When an animation file (.kin file) is exported from 3DSMmax (or GMax), the exporter will make a query for an event file. Tick the box and you will be asked to browse to the event file. ~~See Figure 1~~. The event information is added to the contents of the new animation file.		When an animation file (.kin file) is exported from 3DSMmax (or GMax), the exporter will make a query for an event file. Tick the box and you will be asked to browse to the event file.

			[[Image:CCG_exporter_animation_window.jpg]]

			The event information is added to the contents of the new animation file.

	===The Event File===		===The Event File===
Line 24:		Line 28:
	We want a single sound to play on frame 760 as a log runs through the mill on the conveyor. When exporting the kin animation we are queried for an event file.		We want a single sound to play on frame 760 as a log runs through the mill on the conveyor. When exporting the kin animation we are queried for an event file.

	~~[[Image:CCG_exporter_animation_window.jpg]]~~		Check the ''Query for Event File'' box and browse for the ''lumbermill.evt'' file. This file has been prepared earlier and is as follows.

	Check the ''Query ~~fro~~ Event File'' box and browse for the ''lumbermill.evt'' file. This file has been prepared earlier and is as follows.

	'''lumbermill.evt'''		'''lumbermill.evt'''

Pev at 02:21, 15 June 2011

2011-06-15T02:21:47Z

← Older revision		Revision as of 02:21, 15 June 2011
Line 49:		Line 49:
	}		}

			'''Note:''' For script reference please refer to [[Scripting]]
	:'''Note:''' For script reference please refer to [[Scripting]]



Line 85:		Line 83:
	:One thing to note is that although the Max file states the frames are from 0 - 1000 frames, we must remember that frame 999 is the last one. On a looping time scale, frame 1000 is the same time as frame 1.		:One thing to note is that although the Max file states the frames are from 0 - 1000 frames, we must remember that frame 999 is the last one. On a looping time scale, frame 1000 is the same time as frame 1.

	Therefore, the Generic-Event at the end of the animation is thus:		:Therefore, the Generic-Event at the end of the animation is thus:
	999 Generic_Event animstop		999 Generic_Event animstop



			[[Modelling: Tenders\|Previous Page]] . . . . [[Modelling: Level of Detail Mesh Reduction\|Next Page]]

			==Return to CCG Index==
			[[Content Creator's Guide]]

Pev: New page: ==Animation Events== Sounds events and generic events can be linked to an animation key-frame to give great control over sound and script timing for industry and scenery assets. When an a...

2011-06-15T02:16:55Z

New page: ==Animation Events== Sounds events and generic events can be linked to an animation key-frame to give great control over sound and script timing for industry and scenery assets. When an a...

New page

==Animation Events==
Sounds events and generic events can be linked to an animation key-frame to give great control over sound and script timing for industry and scenery assets.

When an animation file (.kin file) is exported from 3DSMmax (or GMax), the exporter will make a query for an event file. Tick the box and you will be asked to browse to the event file. See Figure 1. The event information is added to the contents of the new animation file.

===The Event File===
(''filename''.'''evt''')

'''Format:''' FrameNum EventType EventName.

The event file consists of a list of events and is set up as a simple text file. Each event consists of the frame number, followed by the event type (Sound_Event or Generic_Event), then the event name.
Sound events are generally referenced as a trigger within the asset's config.txt file (or through script). All events start on a new line (should there be more than one)

====Sound and Generic Events:====
:A '''Sound_Event''' tells Trainz when to play a sound, relative to an animation keyframe.

:A '''Generic_Event''' is an animation keyframe reference for script timing and control.

====Example 1: Lumbermill====
The animation in the max file is set up over 1000 frames.

We want a single sound to play on frame 760 as a log runs through the mill on the conveyor. When exporting the kin animation we are queried for an event file.

[[Image:CCG_exporter_animation_window.jpg]]

Check the ''Query fro Event File'' box and browse for the ''lumbermill.evt'' file. This file has been prepared earlier and is as follows.

'''lumbermill.evt'''
760 Sound_Event logcut
999 Generic_Event animstop

An excerpt from the Lumbermill config.txt file (note the trigger) :
soundscript
{
log_cut
{
trigger logcut
attachment a.sawsound
nostartdelay 1
repeat-delay 1
distance 10,400
sound
{
0 log_cutting.wav
}
}
}

:'''Note:''' For script reference please refer to [[Scripting]]

====Example 2: Looping sounds:====
Not only can we control when a single sound plays but we can also control the start and the stop of a looping sound by adding another Sound_Event with a / before the relevant name. In the example below the sound starts on frame 370 and ends on 589.

'''looping.evt'''
370 Sound_Event reverse
589 Sound_Event /reverse

''config.txt entries :-''
soundscript
{
backup
{
attachment a.sound
trigger reverse
repeat-delay 0
distance 5,100
sound
{
0 warning.wav
}
}
}

Important Note:
The Max file in Example 1 has 1000 frames:
:One thing to note is that although the Max file states the frames are from 0 - 1000 frames, we must remember that frame 999 is the last one. On a looping time scale, frame 1000 is the same time as frame 1.

Therefore, the Generic-Event at the end of the animation is thus:
999 Generic_Event animstop