alSourceStop: Unterschied zwischen den Versionen
(Die Seite wurde neu angelegt: = alSourceStopv, alSourceStopv = == Name == '''alSourceStop''' - Stoppt das Abspielen eines Source-Objektes. == Delphi-Spezifikation == procedure '''alSourceStop...) |
K (Formatierungsfehler behoben.) |
||
| Zeile 40: | Zeile 40: | ||
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. | 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 | + | '''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. | Sollte bei der Ausführung der Funktion ein Fehler auftreten, so kann dieser mit [[alGetError]] abgefragt werden. | ||
| Zeile 51: | Zeile 51: | ||
'''AL_INVALID_OPERATION''' wird generiert, wenn es keinen aktuellen Kontext gibt. | '''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'''.) | + | '''AL_INVALID_VALUE''' wird generiert, wenn der Zeiger ''sources'' unzulässig ist. (Nur bei '''alSourceStopv'''.) |
Aktuelle Version vom 2. Januar 2009, 04:36 Uhr
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
