Skip to content
OpenTS Manual

Control

Added in 0.2.0
Specification
Applies to
Sounds
File
SOUND.INI / SOUND01.INI
Section
[<Sound ID>]
Value
string
When omitted
NORMAL

Flags that decide how each play is built from the samples in Sounds=. Separate the flags with spaces or commas; they combine. The flags follow Yuri’s Revenge, with SEQUENTIAL and QUEUE from Vinifera. A Control= line in a sound section replaces the flags from [Defaults] instead of adding to them.

  • NORMAL sets no flag. On its own, the sound plays its first body sample once.
  • LOOP repeats the body Loop= times, or until the game stops the sound when Loop=0. Delay= can put a silence between cycles.
  • RANDOM draws one body sample at random for each play and keeps it for every cycle of that play.
  • SEQUENTIAL gives each play the next body sample in list order, returning to the first after the last.
  • ALL plays every body sample in list order, and a loop repeats the whole run. ALL wins over RANDOM, and RANDOM wins over SEQUENTIAL.
  • PREDELAY makes each play wait one Delay= silence before its first sample. This applies to one-shots as well as loops, and a loop still waits between cycles.
  • INTERRUPT lets a new copy that reaches Limit= replace the quietest copy when the two are within one percent in loudness. Without it, that new copy is refused.
  • ATTACK makes the first sample an attack sample, and DECAY makes the last sample a decay sample. Attack= and Decay= set other counts.
  • QUEUE lets a play refused when it starts keep trying for up to two seconds before it is dropped, whether Limit= refused it or no voice was free. It does not cover a PREDELAY play refused when its silence ends, or a later cycle of a loop with a Delay=.
  • AMBIENT is accepted and has no effect.

A flag the engine does not recognize is ignored.

sound01.ini
[MYLOOP]
Sounds=LOOPIN LOOPBODY1 LOOPBODY2 LOOPOUT
Control=LOOP RANDOM ATTACK DECAY
Loop=4

Each play of MYLOOP plays LOOPIN, then one of LOOPBODY1 and LOOPBODY2 four times, then LOOPOUT.

See also — Sounds, Loop, Delay, Attack, Decay, Limit

History

  1. Added0.2.0In development

    Define sounds with the Yuri's Revenge SOUND.INI keys