Bezeichnung
PlaySample -- spielt ein Sample (V1.5)
Übersicht
PlaySample(id[, table], ...)
Beschreibung
Beginnt das in 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:
Dieses Feld kann verwendet werden, um festzulegen, wie oft das Sample gespielt werden soll. Der Standardwert ist 1, was bedeutet, dass das Sample einmal abgespielt wird. Wenn Sie das Sample als Endlosschleife laufen lassen wollen, setzen Times auf 0.

Volume:
Setzen Sie dieses Feld auf die gewünschte Wiedergabelautstärke. Sie können Zahlen von 0 bis 64 übergeben. Wenn nichts angegeben wurde, wird die Standardlautstärke des Samples verwendet werden. (Sie können die Standardlautstärke eines Samples ändern, indem Sie den Befehl SetVolume() benutzen).

Pitch:
Damit setzen Sie die gewünschte Tonhöhe. Dieser Wert muss in Hertz übergeben werden. Wenn nichts angegeben wurde, wird die Standardtonhöhe des Samples verwendet werden (Sie können die Standardtonhöhe eines Samples ändern, indem Sie den Befehl SetPitch() verwenden).

Time:
Dieses Feld kann verwendet werden, um festzulegen, wie lange das Sample gespielt werden soll. Hollywood wird das Sample so lange abspielen, bis die Zeit in Time abgelaufen ist. Time muss in Millisekunden angegeben werden. Dieser und der Tag Times schließen sich gegenseitig aus.

Panning:
Mit diesem Feld können sie festlegen, wo ein Sample gespielt werden soll (Balance). Der Bereich geht von 0 bis 255, wobei 0 bedeutet, dass das Sample nur über die linke Box ausgegeben wird, bei 128 werden beide Lautsprecher gleichmäßig benutzt und 255 bedeutet, dass nur über die rechte Box ausgegeben wird. Wenn nichts angegeben wurde, werden die Standardeinstellungen des Samples verwendet werden (Sie können die Standardbalance des Samples ändern, indem Sie den Befehl SetPanning() aufrufen). (V4.5)

Channel:
Hier können Sie den Kanal für die Wiedergabe des Samples einstellen. In der Standardeinstellung wählt 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.

Eingaben
id
Identifikator des abzuspielenden Samples
table
eine Tabelle, die Wiedergabeparameter für das Sample enthält (V2.0)
...
Sie können die Argumentenliste so oft wiederholen, wie Sie wollen und können so viele Samples gleichzeitig abspielen, wie Sie möchten
Beispiel
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.

Navigation zeigen