alSourcePause

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

alSourcePause, alSourcePausev

Name

alSourcePause - Pausiert Source-Objekte der AL.


Delphi-Spezifikation

procedure alSourcePause(source: TALuint);
procedure alSourcePausev(n: TALsizei; sources: PALuint);


Parameter

Für die Funktion alSourcePause, welche ein einzelnes Source-Objekt in den Pausenmodus versetzt, gibt es folgenden Parameter:

source Name des zu pausierenden Source-Objektes


Für die Funktion alSourcePausev, welche mehrere Source-Objekte pausiert:

n Anzahl der zu pausierenden Source-Objekte
sources Zeiger auf ein Array von Source-Namen, welche die zu pausierenden Source-Objekte angeben


Beschreibung

Die Funktion alSourcePause bzw. alSourcePausev pausiert eines oder mehrere der Source-Objekte der AL und setzt den Status der betroffenen Source-Objekte auf AL_PAUSED. Für die Funktion alSourcePausev garantiert die OpenAL-Spezifikation ein synchrones Pausieren aller angegebenen Objekte.


Hinweise

Wird alSourcePause oder alSourcePausev auf ein Source-Objekt angewendet, welches sich bereits im Zustand AL_PAUSED befindet, so wird an dem Source-Objekt keine Änderung vorgenommen. Gleiches gilt für ein Source-Objekt mit dem Status AL_INITIAL oder AL_STOPPED. Befindet sich das Source-Objekt hingegen im Zustand AL_PLAYING, so wird es pausiert und aus der weiteren Verarbeitung durch die AL ausgenommen. Außerdem ändert sich der Status des Source-Objektes auf AL_PAUSED.

Sollte bei der Ausführung von alSourcePause(v) ein Fehler auftreten, so kann dieser mit Hilfe der Funktion alGetError erfragt werden.


Fehlermeldungen

AL_INVALUD_NAME wird generiert, wenn ein angegebenes Source-Objekt nicht zulässig ist. (Namen von Source-Objekten können mit alIsSource auf Gültigkeit überprüft werden.)

AL_INVALID_OPERATION wird generiert, wenn es keinen aktuellen Kontext gibt. (Siehe dazu auch alcMakeContextCurrent.)

AL_INVALID_VALUE wird generiert, sofern der Zeiger sources ungültig ist. (Dies trifft nur auf alSourcePausev zu, nicht auf alSourcePause.)


Zugehörige Wertrückgaben

alGetSourcei mit Token AL_SOURCE_STATE


Siehe auch

alSourcePlay, alSourceRewind, alSourceStop