Aktuelle Version vom 29. März 2008, 15:16 Uhr

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:

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

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