alSourcePause
Inhaltsverzeichnis
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
