alSourcePlay
Inhaltsverzeichnis
alSourcePlay, alSourcePlayv
Name
alSourcePlay - Spielt ein Source-Objekt ab.
Delphi-Spezifikation
procedure alSourcePlay(source: TALuint); procedure alSourcePlayv(n: TALsizei; sources: PALuint);
Parameter
Für die Funktion alSourcePlay, welche ein einzelnes Source-Objekt abspielt:
| source | Name des abzuspielenden Source-Objektes |
|---|
Für die Funktion alSourcePlayv, welche mehrere Source-Objekt abspielen kann:
| n | Anzahl der abzuspielenden Source-Objekte |
|---|---|
| sources | ein Zeiger auf einen Array von Source-Objekten, welche abgespielt werden sollen |
Beschreibung
Die Funktionen alSourcePlay bzw. alSourcePlayv spielen eines oder mehrere Source-Objekte ab. alSourcePlayv garantiert in dem Fall, dass mehrere Source-Objekte synchron abgespielt werden.
Hinweise
Falls eine der Funktionen auf einem Source-Objekt ausgeführt wird, welches sich schon im Abspielmodus (symbolisiert durch AL_PLAYING) befindet, wird das Source-Objekt noch einmal von vorn abgespielt. Ein Source-Objekt, welches über alSourcePlay bzw. alSourcePlayv abgespielt wird, ändert seinen Status auf AL_PLAYING. Sobald alle mit dem Source-Objekt verbundenen Audiopuffer verarbeitet und abgespielt sind, wechselt das Source-Objekt seinen Status nach AL_STOPPED. Wird eine der Funktionen auf ein Source-Objekt im Status AL_PAUSED angewendet, so wird die Verarbeitung und das Abspielen wieder an der Stelle aufgenommen, wo es zuvor durch einen Aufruf von alSourcePause angehalten wurde. Wird alSourcePlay bzw. alSourcePlayv auf einem Source-Objekt im Status AL_STOPPED ausgeführt, so ändert dieses Objekt seinen Status erst in AL_INITIAL und gleich danach in AL_PLAYING, um mit dem Abspielen zu beginnen.
Tritt bei der Ausführung der Funktion ein Fehler auf, so kann dieser mit alGetError abgefragt werden.
Fehlermeldungen
AL_INVALID_VALUE wird generiert, wenn der an Zeiger sources ungültig ist. (Nur bei alSourcePlayv.)
AL_INVALID_NAME wird generiert, sofern einer der angegebenen Namen für die Source-Objekte nicht gültig ist. (Um zu prüfen, ob ein TALuint-Wert ein gültiges Source-Objekt repräsentiert, siehe auch alIsSource.)
AL_INVALID_OPERATION wird generiert, falls es keinen aktuellen Kontext gibt.
Zugehörige Wertrückgaben
alGetSourcei mit Token AL_SOURCE_STATE
