XACT Events

An Microsoft Cross-Platform Audio Creation Tool (XACT) sound is composed of one or more tracks, which are in turn defined by a collection of events. An event can be a "Play Wave" event, which plays a wave file, or a type of event that controls the playback of the wave, such as markers or level settings.

These events are available to the XACT audio designer.

Icon Event Type
Play Wave
Stop
Marker
Set Volume
Set Pitch

Common Event Properties

All events, no matter what type, are provided a core set of properties. If any of the properties are not applicable to an event, they are either not presented or disabled.

Event Properties

The event properties specify the fundamental information for all events, such as its "friendly name" and comments.

Property Name Description
EventType Displays the type of event. Display only.
Name The default name of an event is its event type (for example, Play Wave). You can rename the event by changing this selection, or by selecting the name displayed in the sound bank window.
Comment Comments from the designer.

Timing Properties

The timing properties hold the relative time information that the event may use to execute its playback, repeats, or notifications.

Property Name Description
TimeStamp Time, relative to when the sound is played, when the event is to occur.
RandomOffset Random time, relative to when the sound is played, when the event is to occur. Random time takes into account the TimeStamp property. If TimeStamp is set to three seconds, and RandomOffset is set to four, the event will occur at some random interval between three and seven seconds.
RelativeToStartEnd Currently unsupported.

Repeat Properties

The repeat properties specify how often and in what manner the event is to automatically repeat itself.

Property Name Description
RepeatEvent

The following options are available:

  • None
  • Finite
  • Infinite

Sub-properties are made available depending on this setting.

NumberOfRepeats

The number of additional times the event should repeat. A value of 1 will cause the event to occur two times.

If RepeatEvent is set to Infinite, this property does not appear.

RepeatFrequency The amount of time, in FrequencyUnits, to pause between event repeats.
FrequencyUnits

The units for RepeatFrequency. Options are:

Seconds
Default.
Beats Per Minute
Provided as a shortcut for rhythmic event repeats.
LastRepeat If an event is recurring, this property shows the last time the event will occur.

See Also

XACT Audio Authoring, XACT Overviews, XACT Reference