https://wiki.delphigl.com/index.php?action=history&feed=atom&title=alGet 2026-04-29T21:58:54Z Versionsgeschichte dieser Seite in DGL Wiki MediaWiki 1.27.4 https://wiki.delphigl.com/index.php?title=alGet&diff=21474&oldid=prev 2008-04-12T19:02:39Z

<p>Die Seite wurde neu angelegt: = alGet = == Name == &#039;&#039;&#039;alGet&#039;&#039;&#039; - Gibt einen globalen Zustand der OpenAL zurück. == Delphi-Spezifikation == function &#039;&#039;&#039;alGetBoolean&#039;&#039;&#039;(&#039;&#039;param&#039;&#039;: TALenum): TA...</p> <p><b>Neue Seite</b></p><div>= alGet =<br /> <br /> <br /> <br /> == Name ==<br /> '''alGet''' - Gibt einen globalen Zustand der OpenAL zurück.<br /> <br /> <br /> <br /> == Delphi-Spezifikation ==<br /> function '''alGetBoolean'''(''param'': TALenum): TALboolean;<br /> function '''alGetDouble'''(''param'': TALenum): TALdouble;<br /> function '''alGetFloat'''(''param'': TALenum): TALfloat;<br /> function '''alGetInteger'''(''param'': TALenum): TALint;<br /> procedure '''alGetBooleanv'''(''param'': TALenum; ''data'': PALboolean);<br /> procedure '''alGetDoublev'''(''param'': TALenum; ''data'': PALdouble);<br /> procedure '''alGetFloatv'''(''param'': TALenum; ''data'': PALfloat);<br /> procedure '''alGetIntegerv'''(''param'': TALenum; ''data'': PALint);<br /> <br /> <br /> <br /> == Parameter ==<br /> <br /> {| border=&quot;1&quot; rules=&quot;all&quot;<br /> ! ''param'' <br /> | Symbolische Konstante, welche den zurückzugebenden Wert festlegt<br /> |-<br /> ! ''data'' <br /> | Zeiger auf TALboolean-/ TALdouble-/ TALfloat-/ TALint-Werte, in denen der zurückgegebene Zustand abgespeichert wird (nur bei den Funktionsvarianten, die auf ''v'' enden)<br /> |}<br /> <br /> <br /> <br /> == Beschreibung == <br /> Die Funktion '''alGet''' bzw. ihre Varianten '''alGetBoolean''', '''alGetBooleanv''', '''alGetDouble''', '''alGetDoublev''', '''alGetFloat''', '''alGetFloatv''', '''alGetInteger''' und '''alGetIntegerv''' geben einen bestimmten Zustand/ Eigenschaft der AL zurück. Welcher Wert zurückgegeben wird, hängt dabei vom Parameter ''param'' ab.<br /> <br /> Folgende Werte sind für ''param'' zulässig:<br /> === AL_DISTANCE_MODEL ===<br /> : Gibt das aktuelle Distance Model zurück. (Siehe auch [[alDistanceModel]].)<br /> <br /> === AL_DOPPLER_FACTOR ===<br /> : ''(Ab OpenAL 1.1)'' Gibt den Dopplerfaktor zurück, welcher von der AL bei den Berechnungen des Dopplereffekts benutzt wird. (Siehe auch [[alDopplerFactor]].)<br /> <br /> === AL_DOPPLER_VELOCITY ===<br /> : ''(Nur für OpenAL 1.0)'' Gibt die Geschwindigkeit für den Dopplereffekt zurück. (Siehe dazu auch [[alDopplerVelocity]].)<br /> <br /> === AL_SPEED_OF_SOUND ===<br /> : Gibt die aktuelle Schallgeschwindigkeit (für Dopplerberechnungen u.ä.) zurück, welche man mit [[alSpeedOfSound]] setzen kann.<br /> <br /> <br /> <br /> <br /> == Hinweise ==<br /> Für den Fall, dass ''data'' der '''nil'''-Zeiger ist, wird der Aufruf der Funktion von der AL stillschweigend übergangen. (Das heißt im Besonderen auch, dass kein Fehler generiert wird.)<br /> <br /> Wird durch einen Aufruf von '''alGet''' ein Wert erfragt, dessen Typ nicht mit dem Typ des erfragten Wertes übereinstimmt, so wird eine Typumwandlung durchgeführt.&lt;br&gt;<br /> Falls '''alGetBoolean''' oder '''alGetBooleanv''' aufgerufen wird, wird ein Ganzzahl- oder Fließkommawert genau dann in '''AL_FALSE''' umgewandelt, wenn dieser null ist. Andernfalls wird der Wert in '''AL_TRUE''' umgewandelt. Im Fall von '''alGetInteger''' bzw. '''alGetIntegerv''' wird ein boolescher Wert entweder als 1 (entspricht '''AL_TRUE''') oder 0 (entspricht '''AL_FALSE''') interpretiert. Ein Fließkommawert wird auf den nächstgelegenen Ganzzahlwert gerundet. Beim Aufruf von '''alGetFloat''' bzw. '''alGetFloatv''' wird ein boolescher Wert entweder als 1.0 oder 0.0 interpretiert, ein Ganzzahlwert wird in den entsprechenden Fließkommawert umgewandelt. Ein Fließkommawert doppelter Genauigkeit wird in den entsprechenden Wert einfacher Genauigkeit umgewandelt. Analoge Umwandlungen finden für '''alGetDouble''' und '''alGetDoublev''' statt. Falls ein Wert so groß sein sollte, dass er in dem gefragten Datentyp nicht darstellbar ist, wird er in den nächstgelegenen darstellbaren Wert dieses Typs umgewandelt.<br /> <br /> <br /> Falls bei der Ausführung von '''alGet''' ein Fehler auftritt, kann dieser mit [[alGetError]] erfragt werden.<br /> <br /> <br /> <br /> == Änderungen ==<br /> Folgende Erweiterungen hat die Funktion erfahren:<br /> === Ab OpenAL-Version 1.1 ===<br /> <br /> Da mit OpenAL 1.1 das System zur Berechnung des geschwindigkeitsabhängigen Dopplereffektes geändert wurde und die Funktion [[alDopplerVelocity]] entfiel, sollte '''alGet''' nicht mehr mit dem Parameter '''AL_DOPPLER_VELOCITY''' benutzt werden. Stattdessen sollte man auf '''AL_DOPPLER_FACTOR''' zurückzugreifen.<br /> <br /> <br /> <br /> == Fehlermeldungen ==<br /> '''AL_INVALID_ENUM''' wird generiert, wenn der angegebene Parameter ''param'' einen unzulässigen Wert hat.<br /> <br /> '''AL_INVALID_OPERATION''' wird generiert, falls es keinen aktuellen Kontext gibt. (Siehe dazu auch [[alcMakeContextCurrent]].)<br /> <br /> '''AL_INVALID_VALUE''' wird generiert, falls der Zeiger ''data'' unzulässig ist. (Dies kann nur bei '''alGetBooleanv''', '''alGetDoublev''', '''alGetFloatv''' und '''alGetIntegerv''' auftreten.)<br /> <br /> <br /> <br /> == Siehe auch ==<br /> [[alGetString]]<br /> <br /> [[Kategorie:AL|Get]]</div>

Thoronador