PlaySample(id[, table], ...)
id
angegebene Sample abzuspielen. Sie können
Samples entweder mit dem Befehl LoadSample() laden oder mit der
Präprozessor-Anweisung @SAMPLE vorladen.
Ab Hollywood 2.0 können Sie auch die Tabelle table
als zweites
Argument übergeben, die Parameter für die Wiedergabe des Samples
definiert. Die Tabelle kann folgende Felder enthalten:
Times:
Times
auf 0.
Volume:
Pitch:
Time:
Time
abgelaufen ist.
Time
muss in Millisekunden angegeben werden. Dieser und
der Tag Times
schließen sich gegenseitig aus.
Panning:
Channel:
PlaySample()
automatisch
einen freien Kanal und wird fehlschlagen, wenn es keinen freien
Kanal mehr hat. Um dieses Verhalten zu ändern, können Sie dieses
Feld verwenden. Wenn ein Kanal angegeben wurde, wird es immer
die Wiedergabe auf dem hier angegebenen Kanal erzwingen. Wenn
der Kanal bereits abgespielt wird, wird er zunächst gestoppt werden. (V6.1)
Ebenfalls neu ab Hollywood 2.0 ist die Möglichkeit, mehrere
Samples auf einmal, mit dem Aufruf PlaySample()
abzuspielen.
Wiederholen Sie einfach die Argumentenliste so oft, wie Sie
möchten und PlaySample()
wird alle angegebenen Samples zusammen
spielen - perfekt synchronisiert. Bitte beachten Sie, dass
für jedes weitere Sample dort auch ein zusätzliches optionales
Argument zur Verfügung steht, dass entweder die Anzahl der Male
für das Abspielen des Samples angibt oder es ist eine Tabelle,
die weitere Attribute für die Samplewiedergabe enthält. Siehe
oben, für alle Möglichkeiten.
PlaySample(1)Der obige Code beginnt mit der Wiedergabe des Samples 1. Das Sample wird nicht als Schleife abgespielt.
PlaySample(1, {Time = 10000})Der obige Code spielt das Sample 1 für genau 10 Sekunden (= 10000 Millisekunden).
PlaySample(1, {Times = 2}, 2, {Times = 4}, 3, {Time=5000})Der obige Code spielt Sample 1 zweimal, Sample 2 viermal und Sample 3 wird für 5 Sekunden gespielt. Alle drei Samples werden sofort gestartet.