Selector

Selectors and selector labels are used to switch the material to be played depending on the situation.
Selectors are managed in the Selectors folder in the global settings under the project tree. Labels can be created as child elements of selectors.

For example, you can create a selector (type of floor) and the associated labels (dirt, grass, concrete, wood and gravel) to play different footstep sounds based on the type of surface the player is walking on.

criatom_tools_atomcraft_switch_track_by_selector00.png

How to specify selector label

In ADX, if you set a cue to a player and start it, a sound will be played.
If you set a selector label to a player and start it, the way the cues affected by the selector label sound will change.
In the tool, you will design this change in sound.

How to specify a selector label

The selector label can be specified from the set selector label of a program or action.

See also
Action function

Influence range control by difference of selector label specification method

If you do not set a selector label for the player, the track will be played according to the default selector label setting in the data.

The selector label used to determine the track to play when playing a cue is checked in the following order and used as the specified value.

(1) The selector label setting value set for the player that played the cue that requires a selector label. (Track transition by switch, polyphonic, selector)
(2) The selector label setting value set using the Set Selector Label action with the cue that requires a selector label as the target. (Track transition by polyphonic, selector)
(3) The cue's "default selector label" setting value. (Track transition by switch, polyphonic, selector)
(4) The selector's "global label" setting value. (Track transition by switch, selector)

The strength of the effect of the selector label at runtime

Strong Weak
Player -> Action -> Default selector label for the cue -> Global selector label

Example of setting the selector label at runtime

Set the selector label on the player and play

Player Action Default selector label for the cue Global selector label
(Label_A) (Label_B) (Label_C) (Label_D)
  • Label_A set on the player by set selector label from the program is applied.

Play cue with set selector label action

Player Action Cue default selector label Selector global label
(Not set) (Label_B) (Label_C) (Label_D)
  • Play cue applies set selector label Label_B from cue action.

Play cue without player selector label set

Player Action Cue default selector label Selector global label
(Not set) (Not set) (Label_C) (Label_D)
  • Play cue applies cue default selector label Label_C.

Play without player selector label set

Player Action Cue default selector label Selector global label
(Not set) (Not set) (Not set) (Label_D)
  • Playing a cue applies the selector label Label_D on the tool.
  • Set selector label from a program applies the global selector label Label_D.

Small range control

By specifying selector labels in units of cues or players, control with a smaller impact range can be performed.

Large range control

The selector's "Global Reference Selector Label" setting can also be changed programmatically.
If global environment switching is required in the game, such as weather or game level, you can control the whole selector by specifying the label to be applied to it.

Cue default or control via action

If you want to set the selector label in the settings of the cue, specify this in the "Default reference selector label" of the cue.
This setting is used for polyphonic type cues or when you want to prepare a unique initial selector label for each cue.

Cue type for which selector setting is required

You then assign the selector to a Cue, and its labels to different Tracks.
Selectors and labels are only valid for the following sequence types:

  • Polyphonic type
  • Switch type
  • Track transition type by selector

Even if it is set to any other type, it will be ignored.
Cues of type Switch require a selector or a game variable. When a selector is set to a Cue, a label must be assigned to its Track(s).

criatom_tools_atomcraft_switch_track_by_selector04.png

Runtime behavior when selector label is changed

Synth type Timing of application when selector label is changed Notes
Polyphonic Switches when waveform region starts playing Waveform regions already playing are not affected
Switch Switches when cue starts playing Waveform regions already playing are not affected
Track transition by selector Switches immediately while waveform region is playing Affects waveform regions already playing

For polyphonic type

When a selector label is set for a track, a comparison process is performed with the selector label specified by the program when the waveform region in the track is played.

criatom_tools_atomcraft_switch_track_by_selector02.png


For the Cues of type Switch

The selector label is checked when track playback begins.
When the sequence is played, if the selector label specified in the program matches the selector label set for the track, the track will be played.
If the selector label information does not match or the selector label cannot be found, the cue will not sound.

criatom_tools_atomcraft_switch_track_by_selector01.png


For the Cue is of type Track Transition by Selector

A selector label is compared by the program even during Waveform Region playback on a track.
It is also possible to transition tracks in sync with a beat, making it suitable for music.

criatom_tools_atomcraft_switch_track_by_selector03.png


Note
The selector label specification during playback is done by the program, so if you set a selector label for a cue, please communicate that information to the programmer
so that the appropriate selector label can be set for the player during playback.