alSourcePlay

Aus DGL Wiki
(Weitergeleitet von alSourcePlayv)
Wechseln zu: Navigation, Suche

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


Siehe auch

alSourcePause, alSourceRewind, alSourceStop