Thoronador: Formatierungsfehler behoben.

2009-01-02T02:36:00Z

Formatierungsfehler behoben.

Thoronador: Die Seite wurde neu angelegt: = alSourceStopv, alSourceStopv = == Name == '''alSourceStop''' - Stoppt das Abspielen eines Source-Objektes. == Delphi-Spezifikation == procedure '''alSourceStop...

2008-03-29T05:02:44Z

Die Seite wurde neu angelegt: = alSourceStopv, alSourceStopv = == Name == '''alSourceStop''' - Stoppt das Abspielen eines Source-Objektes. == Delphi-Spezifikation == procedure '''alSourceStop...

Neue Seite

= 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:
{| border="1" rules="all"
! ''source''
| Name des zu stoppenden Source-Objektes
|}

Für die Funktion '''alSourceStopv''', welche mehrere Source-Objekte anhält:
{| border="1" rules="all"
! ''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 [[alGetSourcei#AL_SOURCE_STATE|AL_SOURCE_STATE]]

== Siehe auch ==
[[alSourcePause]], [[alSourcePlay]], [[alSourceRewind]]

[[Kategorie:AL|SourceStop]]

@@ 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.
-'''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]].
+'''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.
@@ Zeile 51: / Zeile 51: @@
 '''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'''.)

alSourceStop - Versionsgeschichte

Thoronador: Formatierungsfehler behoben.

Thoronador: Die Seite wurde neu angelegt: = alSourceStopv, alSourceStopv = == Name == '''alSourceStop''' - Stoppt das Abspielen eines Source-Objektes. == Delphi-Spezifikation == procedure '''alSourceStop...