Theme Property Panel

Parent Previous Next

id

This id is passed to the TriggerMusicTheme() function to trigger this Theme in your game code. Theme ids within a soundtrack must be unique.


Name

An arbitrary name of the Theme.


Type

The Theme Type of this Theme.


Rest Time min

The minimum number of seconds the music will remain silent after the Intensity for this Theme has dropped to zero.

See state "musical rest" in section psai States.


Rest Time max

The maximum number of seconds the music will remain silent after the Intensity for this Theme has dropped to zero.

See state "musical rest" in section psai States.


Theme duration

The timespan (in seconds) a Theme will keep playing after a single call to TriggerMusicTheme(). The musical intensity will fall off during this period and eventually reach zero. To keep the intensity up and extend the playtime, either keep triggering the Theme with new intensity values, or use the hold intensity function.


Theme duration after Rest

The timespan (in seconds) a Theme will keep playing after waking up from a state of musical rest.


Intensity after Rest

The musical intensity a Theme will start with after waking up from a state of musical rest.



Weightings

These sliders affect the importance of the related factors when it comes to selecting the next Segment to play on-the-fly.


Jump between Groups

This slider to controls how important it will be for psai to stay within the same Group while playing this Theme.

"Never" means that psai will never change a group while a Theme is playing. You will have to switch the Theme completely to ever hear some other Group of this Theme.

"Often" means that the Groups are practically ignored, so that the Segments of this Theme are treated as if they all belonged to the same Group.


Importance of Intensity

This slider controls the importance of a best-matching Intensity when the next Segment is evaluated for playback. Setting this to "exact match of intensity" means maximum priority, even if this means that the same Segment is repeated over and over again. The opposite choice is maximum "variety". This means that repetition avoidance is preferred over matching intensity.


Variety

This slider only affects the percentage of variety, as defined by the "Importance of Intenstiy" slider above. Setting this to "maximum repetition avoidance" means, that it is most important to always play the Segment with the least repetition (playcount). Practically this setting has the effect that the Segments will be played in the order of their appearance in the Tree views. Using this setting is especially useful If you have a melodic Theme that reaches over multiple Segments. This way you can break out of the Theme quickly, but the replay order is generally maintained.

Moving this slider to the right will add a random factor to the choice, that gets more and more weighting. Choose a maximum random factor if your Theme consists of atmospheric sound textures that can be played in arbitrary order and don't make use of varying intensity levels. Maintaining a strict Segment order here would tend to sound predictable, as this would have the same effect as if your Theme consisted of a long single audio track.