alDopplerVelocity

Aus DGL Wiki
Wechseln zu: Navigation, Suche

alDopplerVelocity

Name

alDopplerVelocity - Legt die Dopplergeschwindigkeit für Berechnungen von OpenAL zum Dopplereffekt fest.

Info DGL.png Diese Funktion ist seit Version 1.1 nicht mehr Teil der OpenAL Spezifikation.

Delphi-Spezifikation

procedure alDopplerVelocity(value: TALfloat);


Parameter

value Wert, auf den die Geschwindigkeit gesetzt werden soll


Beschreibung

alDopplerVelocity legt die Ausbreitungsgeschwindigkeit fest, welche OpenAL in den Berechnungen zum Dopplereffekt benutzt.


Hinweise

Falls ein Fehler bei der Ausführung aufgetreten ist, kann dieser mit alGetError abgefragt werden.

Genaue Formeln dazu, wie OpenAL den Dopplereffekt berechnet, finden sich in der Beschreibung der Funktion alDopplerFactor.


Änderungen

Folgende Erweiterungen hat die Funktion erfahren:

Ab OpenAL-Version 1.1

Ab Version 1.1 ist alDopplerVelocity nicht mehr Bestandteil der OpenAL-Spezifikation.

Die Dopplerimplementierung von OpenAL 1.1 unterscheidet sich von jener von OpenAL 1.0, weil die alte teils verwirrend und nicht konsistent implementiert war. Die neue "speed of sound"-Eigenschaft macht die Version 1.1 intuitiver als die alte Implementierung. Jedoch bleibt der Einstiegspunkt für alDopplerVelocity auch in 1.1 erhalten, damit für Version 1.0 geschriebene Anwendungen auch gegen eine Bibliothek der Version 1.1 verlinken können.

OpenAL 1.1-Programmierer würden/sollten alDopplerVelocity nie benutzen.


Fehlermeldungen

AL_INVALID_VALUE wird generiert, falls der angegebene Wert ungültig ist. Dies trifft für alle negativen Werte und für den Wert null zu.


Zugehörige Wertrückgaben

alGet mit Token AL_DOPPLER_VELOCITY


Siehe auch

alDopplerFactor, alSpeedOfSound