alSourceRewind
Inhaltsverzeichnis
alSourceRewind, alSourceRewindv
Name
alSourceRewind - Stoppt Source-Objekte der AL und setzt deren Sample-Offset zurück auf den Anfang.
Delphi-Spezifikation
procedure alSourceRewind(source: TALuint); procedure alSourceRewindv(n: TALsizei; sources: PALuint);
Parameter
Für alSourceRewind gibt es folgende Parameter:
| source | Name des zurückzusetzenden Source-Objektes |
|---|
Für die Funktion alSourceRewindv, welche gleich mehrere Source-Objekte zurücksetzen kann:
| n | Anzahl der Source-Objekte |
|---|---|
| sources | Zeiger auf einen Array von Source-Objektnamen, welche die zurückzusetzenden Source-Objekte angeben |
Beschreibung
Die Funktion alSourceRewind bzw. alSourceRewindv stoppt eines oder mehrere der OpenAL-Source-Objekte und setzt deren Sample-Offset zurück zum Anfang. Außerdem wird der Status der betroffenen Source-Objekte auf AL_INITIAL gesetzt. Im Fall von alSourceRewindv garantiert die OpenAL-Spezifikation, dass die Operation synchron auf allen angegebenen Source-Objekten ausgeführt wird.
Hinweise
Wird die Funktion auf ein Source-Ojekt, welches sich bereits im Status AL_INITIAL befindet, angewendet, so ändert sich nichts am Zustand dieses Source-Objektes. Befindet sich Source-Objekt hingegen im Zustand AL_PLAYING, so wird der Status durch alSourceRewind(v) zunächst auf AL_STOPPED und anschließend auf AL_INITIAL geändert. Außerdem wird das Source-Objekt von der weiteren Verarbeitung durch die AL ausgenommen und das Sample-Offset wird auf den Anfang zurückgesetzt. Befindet sich das betroffene Source-Objekt im Zustand AL_PAUSED, so wird sein Zustand auf AL_INITIAL geändert, mit den gleichen Konsequenzn wie bei einem Objekt im Status AL_PLAYING. Sollte sich das Source-Objekt im Status AL_STOPPED befinden, dann ändert alSourceRewind(v) den Status auf AL_INITIAL und setzt das Sample-Offset zurück auf den Anfang.
Falls bei der Ausführung ein Fehler auftritt, kann dieser mit alGetError erfragt werden.
Fehlermeldungen
AL_INVALID_NAME wird generiert, sofern der Name eines angegebenen Source-Objektes unzulässig ist. (Namen von Source-Objekten können mit alIsSource auf Gültigkeit geprüft werden.)
AL_INVALID_OPERATION wird generiert, falls es keinen aktuellen Kontext gibt. (Siehe dazu alcMakeContextCurrent.)
AL_INVALID_VALUE wird generiert, wenn der Zeiger sources ungültig ist. (Diese Fehlermeldung kann nur bei alSourceRewindv jedoch nicht bei alSourceRewind generiert werden.)
Zugehörige Wertrückgaben
alGetSourcei mit Token AL_SOURCE_STATE
