alSourceStop

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

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


Siehe auch

alSourcePause, alSourcePlay, alSourceRewind