Bezeichnung
SAMPLE -- lädt ein Sample vor (V2.0)
Übersicht
@SAMPLE id, filename$[, table]
Beschreibung
Verwenden Sie diese Präprozessor-Anweisung, um ein Sample vorzuladen, den Sie später mit PlaySample() abspielen wollen.

Das dritte Argument table ist optional. Es ist eine Tabelle, die weitere Möglichkeiten für den Ladevorgang zur Verfügung stellt. Die folgenden Felder können verwendet werden:

Link:
Setzen Sie dieses Feld auf False, wenn Sie dieses Sample nicht in die ausführbare Datei/das Applet einbinden wollen, wenn Sie Ihr Skript kompilieren. Dieses Feld ist standardmäßig auf True gesetzt, was bedeutet, dass das Sample mit der ausführbaren Datei/dem Applet beim Kompilieren verknüpft wird.

Loader:
Mit diesem Tag können Sie einen oder mehrere Formatlademodule angeben, die die Datei laden soll. Dies muss mit einer Zeichenkette festgelegt werden, die den/die Namen eines oder mehreren Lademodulen beinhaltet. Standardmäßig wird der mit SetDefaultLoader() eingestellte Lader verwendet. Siehe Lade- und Adaptermodule für Details. (V6.0)

Adapter:
Mit diesem Tag können Sie ein oder mehrere Dateiadapter angeben, die die angegebene Datei öffnen sollen. Dies muss als eine Zeichenfolge festgelegt werden, die den/die Namen eines oder mehreren Adaptermodulen enthält. Standardmäßig wird der mit SetDefaultAdapter() eingestellte Adapter verwendet. Siehe Lade- und Adaptermodule für Details. (V6.0)

UserTags:
Dieser Tag kann verwendet werden, um zusätzliche Daten anzugeben, die an Lader und Adapter übergeben werden sollen. Wenn Sie diesen Tag verwenden, müssen Sie ihn auf eine Tabelle mit Schlüssel-Wert-Paaren setzen, die die zusätzlichen Daten enthalten, die an Plugins übergeben werden sollen. Siehe Benutzer-Tags für Details. (V10.0)

Beispielformate, die auf allen Plattformen unterstützt werden, sind RIFF WAVE, IFF 8SVX, IFF 16SV und Sampleformate, für die Sie ein Plugin haben. Je nach Plattform, auf der Hollywood ausgeführt wird, können mehr Sampleformate unterstützt werden. Zum Beispiel auf Amigakompatiblen Systemen wird Hollywood in der Lage sein, alle Sampleformate über entsprechende Datatypes zu öffnen.

Wenn Sie ein Sample manuell laden möchten, nutzen Sie bitte den Befehl LoadSample().

Eingaben
id
ein Wert, der dieses Sample später im Code identifiziert
filename$
die Sampledatei, welche sie vorladen möchten
table
optional: eine Tabelle mit weiteren Optionen (seihe oben)
Beispiel
@SAMPLE 1, "Gunshot.8svx"
Der obige Code weist die Samplenummer 1 dem Sample "Gunshot.8svx" zu.


@SAMPLE 1, "Sound/Samples/Gunshot.wav", {Link=False}
Macht das gleiche wie der Code vorher, aber das Sample wird beim kompilieren nicht eingebunden werden.

Navigation zeigen