https://wiki.delphigl.com/index.php?action=history&feed=atom&title=alSourceRewind 2026-04-29T21:58:13Z Versionsgeschichte dieser Seite in DGL Wiki MediaWiki 1.27.4 https://wiki.delphigl.com/index.php?title=alSourceRewind&diff=21295&oldid=prev 2008-03-29T15:17:34Z

<p>Die Seite wurde neu angelegt: = alSourceRewind, alSourceRewindv = == Name == &#039;&#039;&#039;alSourceRewind&#039;&#039;&#039; - Stoppt Source-Objekte der AL und setzt deren Sample-Offset zurück auf den Anfang. == Delphi...</p> <p><b>Neue Seite</b></p><div>= alSourceRewind, alSourceRewindv =<br /> <br /> <br /> <br /> == Name ==<br /> '''alSourceRewind''' - Stoppt Source-Objekte der AL und setzt deren Sample-Offset zurück auf den Anfang.<br /> <br /> <br /> <br /> == Delphi-Spezifikation ==<br /> procedure '''alSourceRewind'''(''source'': TALuint);<br /> procedure '''alSourceRewindv'''(''n'': TALsizei; ''sources'': PALuint);<br /> <br /> <br /> <br /> == Parameter ==<br /> Für '''alSourceRewind''' gibt es folgende Parameter:<br /> {| border=&quot;1&quot; rules=&quot;all&quot;<br /> ! ''source'' <br /> | Name des zurückzusetzenden Source-Objektes<br /> |}<br /> <br /> <br /> Für die Funktion '''alSourceRewindv''', welche gleich mehrere Source-Objekte zurücksetzen kann:<br /> {| border=&quot;1&quot; rules=&quot;all&quot;<br /> ! ''n'' <br /> | Anzahl der Source-Objekte<br /> |-<br /> ! ''sources'' <br /> | Zeiger auf einen Array von Source-Objektnamen, welche die zurückzusetzenden Source-Objekte angeben<br /> |}<br /> <br /> <br /> <br /> == Beschreibung == <br /> 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.<br /> <br /> <br /> <br /> == Hinweise ==<br /> 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.<br /> <br /> Falls bei der Ausführung ein Fehler auftritt, kann dieser mit [[alGetError]] erfragt werden.<br /> <br /> <br /> <br /> == Fehlermeldungen ==<br /> '''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.)<br /> <br /> '''AL_INVALID_OPERATION''' wird generiert, falls es keinen aktuellen Kontext gibt. (Siehe dazu [[alcMakeContextCurrent]].)<br /> <br /> '''AL_INVALID_VALUE''' wird generiert, wenn der Zeiger ''sources'' ungültig ist. (Diese Fehlermeldung kann nur bei '''alSourceRewindv''' jedoch nicht bei '''alSourceRewind''' generiert werden.)<br /> <br /> <br /> <br /> == Zugehörige Wertrückgaben ==<br /> [[alGetSourcei]] mit Token [[alGetSourcei#AL_SOURCE_STATE|AL_SOURCE_STATE]]<br /> <br /> <br /> <br /> == Siehe auch ==<br /> [[alSourcePause]], [[alSourcePlay]], [[alSourceStop]]<br /> <br /> [[Kategorie:AL|SourceRewind]]</div>

Thoronador