Transitions Tab: Music Objects

The Transitions tab is where you define the transitions between music objects within either music playlist or Music Switch Containers. A transition is a musical behavior you can define to be used when switching from the music object currently playing to another. Each transition has a source and a destination. An additional segment, called a transition segment, can be used as a musical bridge between the source and destination.

The Transitions tab contains the Transition Matrix, which allows you to create a set of rules that define how each object transitions to every other object within the container. You can create explicit rules for each object, or more general rules that apply to more than one object. The default “Any to Any” transition rule applies to all remaining undefined transitions.

The list of transitions is displayed in the Transitions tab in descending order. When a transition is needed, Wwise begins searching at the bottom of the list until it finds one that applies to the situation at hand. If no matching transition is found, Wwise uses the default “Any to Any” transition.

To facilitate the definition of transitions, music objects which are children of Music Switch Containers can be organized into Virtual Folders. A Virtual Folder can then be chosen as the source or the target of a transition rule. When the transition system searches for a rule to apply, a source or destination folder will match if any of the music objects inside the folder are a match for the source or destination.

General

Interface Element

Description

[name]

The name of the object.

Displays the object's color. Clicking the icon opens the color selector.

Select a color to apply it to the object.

	Note
	Selecting the square at the far left of the color selector causes the object to inherit its parent's color. When a color has been explicitly chosen for an object, it is displayed with the palette icon and a yellow triangle in the lower-right corner, as shown.

Controls the Mute and Solo states for the object and shows the implicit mute and solo states for the object.

Muting an object silences this object for the current monitoring session. Soloing an object silences all the other objects in the project except this one.

A bold M or S indicates that the Mute or Solo state has been explicitly set for the object. A non-bold M or S with faded color indicates that the object's Mute or Solo state was implicitly set from another object's state.

Muting an object implicitly mutes the descendant objects.

Soloing an object implicitly mutes the sibling objects and implicitly solos the descendant and ancestor objects.

	Tip
	Hold the Ctrl key while clicking a solo button to exclusively solo the object for which the solo button is associated.

	Note
	Mute and Solo are designed to be used for monitoring purposes only and are not persisted in the project or stored in the SoundBanks.

Inclusion

Determines whether the element is included or excluded. When selected, the element is included. When unselected, the element is not included. By default, this applies across all platforms. Use the Link indicator (to the left of the check box) to determine or to set platform-specific customizations.

When this option is unselected, the property and behavior options in the editor become unavailable.

Default value: true

Indicates the number of elements in your project that contain direct references to the object. The icon is displayed in orange when references to the object exist, and in gray when no references exist.

Selecting the button opens the Reference View with the object's name in the References to: field.

Notes

Any additional information about the object properties.

Sets the display of the Property Editor's selected tabs. By default, there is one panel displaying only one selected tab. You can, however, click a splitter button to split the panel into two, either side by side or one on top of the other, for two different tabs. The currently selected option is highlighted with a background color.

	Note
	You cannot display the same tab in both panels. If you select the tab that is currently displayed in the other panel, then the other panel will automatically display another tab.

	Shortcuts for selecting tabs
	Press Ctrl and the number corresponding to the number of the Property Editor tab you want. For example, Ctrl+4 would select the RTPC tab if that were the fourth visible tab.

Transitions

Interface Element

Description

No.

The number assigned to the transition rule.

When a transition occurs during profiling, a transition monitoring message is displayed in the Capture Log. The transition is identified using this number.

Source

The source music object for the transition.

Click the Selector button to access the following options:

Any to create a transition for any unspecified source music object.
Nothing to create a transition where there is no source, that is, no music object is playing.
Browse to create a transition using a specific music object, or a Virtual Folder containing music objects as the source.

If a music object or folder is not specified in the Source column, Wwise will apply the first applicable transition that has the source “Any”.

Destination

The destination music object for the transition.

Click the Selector button to access the following options:

Any to create a transition for any unspecified destination music object.
Nothing to create a transition where there is no destination, that is, no music object is playing.
Browse to create a transition using a specific music object, or a Virtual Folder containing music objects as the destination.

If a music object or a folder is not specified in the Destination column, then Wwise will apply the first applicable transition that has the destination “Any”.

Adds a transition to the Transition Matrix.

Removes a selected transition from the Transition Matrix.

Source

Exit source at

Indicates the point in the source at which the exit will be initiated. You can choose from the following options:

Immediate: The source stops playing immediately.
Next Grid: The source stops playing at the next grid interval. The grid is an arbitrary method by which music objects can be virtually partitioned.
Next Bar: The source stops playing at the next bar.
Next Beat: The source stops playing at the next beat.
Next Cue: The source stops playing at the next cue, whether it be a custom cue or the exit cue.
Next Custom Cue: The source stops playing at the next custom cue. If the current segment doesn’t contain a custom cue, Wwise continues to the next segment until it finds a custom cue.
Exit Cue: The source stops playing at the exit cue.

	Note
	When choosing ‘Next Cue’ or ‘Next Custom Cue’, you can define which custom cue name to match. The name must be an exact match. If no name is specified, any custom cue will match.

This option is available for Music Switch Containers only.

Default value: Exit Cue

Match (exit source at)

Specifies the name of the custom cue to match if the 'Exit source at' option is set to 'Next Cue' or 'Next Custom Cue'. If no name is specified, any custom cue will match.

The name must be an exact match to custom cue names present at the source. Name matching is case-insensitive.

Play post-exit

If selected, the post-exit of a source segment will play. The post-exit is defined as the area to the right of the exit cue.

The post-exit of a source will only play if that source exits at its exit cue, or fades out at or beyond its exit cue. Otherwise, the post-exit will never play during a transition.

Default value: true

Fade-out

If selected, determines whether a fade-out will be applied as the source segment reaches its end.

Default value: false

Displays the Music Fade Editor, where you can edit the fade-out from the source.

Destination

Jump To

Determines the point in the music object at which the destination will begin playing. You can choose from the following options:

Start of Playlist: Jumps to the first item in your playlist.
Specific Playlist Item: Jumps to the specified item from your playlist. To specify the playlist item to jump to, click the browse button. This option is only available if the destination object is a Music Playlist Container.
Last Played Segment: Jumps to the segment that was last played.
Next Segment: Jumps to the next item in the playlist, following the last played segment.

Default value: Start of Playlist

Displays the Project Explorer - Browser where you can select a destination playlist item.

Sync to

Determines the point in the music object at which the destination will begin playing. You can choose from the following options:

Entry cue: The destination will begin playing at its entry cue.
Same time as playing segment: The destination will begin playing at the same time mark as the source segment. For example, if the source segment has been playing for 15 seconds since its beginning, the destination will start playing 15 seconds in.
Random Cue: The destination will begin playing at a randomly chosen cue. When this option is selected, any cue can be chosen, including the entry cue or any custom cue that match the filtering criterion. See Match source cue name and Match (jump to destination).
Random Custom Cue: The destination will begin playing at a randomly chosen custom cue that match the filtering criterion. See Match source cue name and Match (specify cue name). If there are no custom cues in the segment, the entry cue will be used.
Last Exit Position: The destination will begin playing at a point offset by the amount of time elapsed in the last played segment of the destination. For example, if a point 15 seconds into the third segment of the destination was reached the last time it was played, the destination will start playing 15 seconds in.

	Note
	The option Last Exit Position only applies for transitions of the parent Music Container during the same playback instance.

Default value: Entry Cue

Match source cue name

Determines which custom cues are eligible as the start position in the destination segment. Only the custom cues whose name matches the name of the cue that was used in the transition’s source constitute potential start positions. For example, if the source exits at a custom cue named ‘A’, the destination will start at a custom cue named ‘A’.

String comparison is not case-sensitive, but it must be exact (there is no wildcard).

This option can only be used when ‘Sync to’ is set to ‘Random Cue’ or ‘Random Custom Cue’.

If no match is found, the entry cue will be used.

This option will only work correctly when:

The ‘Exit Source At’ setting is set to ‘Next Cue’ or ‘Next Custom Cue’.
The ‘Source’ object is different from ‘nothing’.

Name matching affects the selection of custom cues only; it has no effect on the eligibility of the entry cue. If you use ‘Random Cue’ as the ‘Sync to’ property, the selected destination cue will be either a custom cue whose name matches that of the cue where the source exited, or the entry cue. Use ‘Random Custom Cue’ as the ‘Sync to’ property to remove the entry cue from the possible destinations.

Match (specify cue name) Determines which custom cues are eligible as the start position in the destination segment. Among the custom cues, only those whose name matches the string in the edit box constitute potential start positions. If no name is specified, any custom cue will match.

String comparison is not case-sensitive, but it must be exact (there is no wildcard).

This option can only be used when ‘Sync to’ is set to ‘Random Cue’ or ‘Random Custom Cue’.

If no match is found, the entry cue will be used.

Name matching affects the selection of custom cues only; it has no effect on the eligibility of the entry cue. If you use ‘Random Cue’ as the ‘Sync to’ property, the selected destination cue will be either a custom cue whose name corresponds to the string entered in the ‘Match’ text field, or the entry cue. Use ‘Random Custom Cue’ as the ‘Sync to’ property to remove the entry cue from the possible destinations.

Default value: Match specific name

Match (specify cue name)

Determines which custom cues are eligible as the start position in the destination segment. Among the custom cues, only those whose name matches the string in the edit box constitute potential start positions. If no name is specified, any custom cue will match.

String comparison is not case-sensitive, but it must be exact (there is no wildcard).

This option can only be used when ‘Sync to’ is set to ‘Random Cue’ or ‘Random Custom Cue’.

If no match is found, the entry cue will be used.

Name matching affects the selection of custom cues only; it has no effect on the eligibility of the entry cue. If you use ‘Random Cue’ as the ‘Sync to’ property, the selected destination cue will be either a custom cue whose name corresponds to the string entered in the ‘Match’ text field, or the entry cue. Use ‘Random Custom Cue’ as the ‘Sync to’ property to remove the entry cue from the possible destinations.

Play pre-entry

If selected, the pre-entry of a destination segment will play. The pre-entry is defined as the area to the left of the entry cue.

The pre-entry of a destination will only play if the destination begins at its entry cue. Otherwise, the pre-entry will never play during a transition.

Default value: true

Fade-in

If selected, determines whether a fade-in will be applied as the destination segment begins to play.

Default value: false

Displays the Music Fade Editor, where you can edit the fade-in for a transition destination.

Transition Segment

Use transition segment

If selected, a transition segment will play during the transition. A transition segment is a short piece of music that musically bridges the source and destination objects.

Default value: false

Displays the Project Explorer Browser where you can select a transition segment.

Play transition pre-entry

If selected, the pre-entry of the transition segment will play. The pre-entry is defined as the area to the left of the entry cue.

Default value: true

Fade-In

If selected, a fade-in will be applied as the transition segment begins to play.

Default value: false

Displays the Music Fade Editor, where you can edit the fade-in of the transition segment.

Play transition post-exit

If selected, the post-exit of the transition segment will play. The post-exit is defined as the area to the right of the exit cue.

Default value: true

Fade-out

If selected, a fade-out will be applied to the transition segment as it reaches its end.

Default value: false

Displays the Music Fade Editor, where you can edit the fade-out of the transition segment.

Related Topics

Was this page helpful?

Need Support?

Questions? Problems? Need more info? Contact us, and we can help!

Visit our Support page

Tell us about your project. We're here to help.

Get started with Wwise

Wwise Help