alSourceStop
Inhaltsverzeichnis
alSourceStopv, alSourceStopv
Name
alSourceStop - Stoppt das Abspielen eines Source-Objektes.
Delphi-Spezifikation
procedure alSourceStop(source: TALuint); procedure alSourceStopv(n: TALsizei; sources: PALuint);
Parameter
Für die Funktion alSourceStop, welche ein einzelnes Source-Objekt stoppt:
| source | Name des zu stoppenden Source-Objektes |
|---|
Für die Funktion alSourceStopv, welche mehrere Source-Objekte anhält:
| n | Anzahl der zu stoppenden Source-Objekte |
|---|---|
| sources | Zeiger auf einen Array von TALunit-Werten, in welchem die zu stoppenden Source-Objekte angegeben sind |
Beschreibung
Die Funktion alSourceStop bzw. alSourceStopv hält eines oder mehrere Source-Objekte an und setzt den Status der Source-Objekte auf AL_STOPPED. Im Falle von alSourceStopv gewährleistet die OpenAL-Spezifikation, dass alle Source-Objekte synchron gestoppt werden.
Hinweise
Der Versuch, ein Source-Objekt zu stoppen, welches sich bereits im Zustand AL_STOPPED befindet, ist eine erlaubte Operation. In diesem Fall tut die Funktion einfach nichts mit dem entsprechenden Source-Objekt. Gleiches gilt für ein Source-Objekt mit dem AL_INITIAL-Status: auch hier ändert die Funktion nichts. Befindet sich das Source-Objekt, auf welches alSourceStop(v) angewendet wird im Zustand AL_PLAYING, so wird das Source-Objekt von der weiteren Verarbeitung durch die AL ausgenommen und ändert seinen Zustand auf AL_STOPPED, jedoch werden alle anderen Eigenschaften des Source-Objektes beibehalten. Sollte sich das Source-Objekt im Zustand AL_PAUSED befinden, wird der Status ebenfalls auf AL_STOPPED geändert, mit den gleichen Folgen wie AL_PLAYING-Source-Objekt.
alSourceStop und alSourceStopv löschen ein Source-Objekt nicht, was im speziellen auch bedeutet, dass ein Source-Objekt nach einem Aufruf von alSourceStop auch wieder mit alSourcePlay erneut abgespielt werden kann. Um Source-Objekte zu löschen, verwendet man alDeleteSources.
Sollte bei der Ausführung der Funktion ein Fehler auftreten, so kann dieser mit alGetError abgefragt werden.
Fehlermeldungen
AL_INVALID_NAME wird generiert, sofern eines oder mehrere der angegebenen Source-Objekte unzulässig ist.
AL_INVALID_OPERATION wird generiert, wenn es keinen aktuellen Kontext gibt.
AL_INVALID_VALUE wird generiert, wenn der Zeiger sources unzulässig ist. (Nur bei alSourceStopv.)
Zugehörige Wertrückgaben
alGetSource mit Token AL_SOURCE_STATE
