alSource - Versionsgeschichte

Igel457: /* AL_REFERENCE_DISTANCE */

2009-11-24T14:48:36Z

‎AL_REFERENCE_DISTANCE

Igel457: /* AL_REFERENCE_DISTANCE */

2009-11-24T14:47:37Z

‎AL_REFERENCE_DISTANCE

Igel457: /* AL_REFERENCE_DISTANCE */

2009-11-24T14:47:24Z

‎AL_REFERENCE_DISTANCE

Igel457: /* AL_REFERENCE_DISTANCE */

2009-11-24T14:47:05Z

‎AL_REFERENCE_DISTANCE

Thoronador: Beschreibung zu AL_DIRECTION ergänzt.

2008-06-07T15:17:59Z

Beschreibung zu AL_DIRECTION ergänzt.

Thoronador: Beschreibung zu AL_BYTE_OFFSET, AL_SAMPLE_OFFSET und AL_SEC_OFFSET ergänzt.

2008-06-07T15:03:59Z

Beschreibung zu AL_BYTE_OFFSET, AL_SAMPLE_OFFSET und AL_SEC_OFFSET ergänzt.

Thoronador: Hinweis zu "Unvollständig" ergänzt.

2008-06-06T13:17:54Z

Hinweis zu "Unvollständig" ergänzt.

Thoronador: Beschreibung zu AL_MAX_GAIN und AL_PITCH ergänzt

2008-05-14T18:38:04Z

Beschreibung zu AL_MAX_GAIN und AL_PITCH ergänzt

Thoronador: Beschreibung für AL_MIN_GAIN ergänzt.

2008-05-14T17:07:47Z

Beschreibung für AL_MIN_GAIN ergänzt.

Thoronador: Beschreibung zu AL_BUFFER ergänzt.

2008-05-14T16:47:34Z

Beschreibung zu AL_BUFFER ergänzt.

@@ Zeile 88: / Zeile 88: @@
 === AL_REFERENCE_DISTANCE ===
-   '''AL_REFERENCE_DISTANCE''' beschreibt den Abstand, bei dem der Verstärkungsfaktor der Audioquelle genau 1 beträgt.
+: '''AL_REFERENCE_DISTANCE''' beschreibt den Abstand, bei dem der Verstärkungsfaktor der Audioquelle genau 1 beträgt.
 === AL_ROLLOFF_FACTOR ===

@@ Zeile 88: / Zeile 88: @@
 === AL_REFERENCE_DISTANCE ===
-'''AL_REFERENCE_DISTANCE''' beschreibt den Abstand, bei dem der Verstärkungsfaktor der Audioquelle genau 1 beträgt.
+   '''AL_REFERENCE_DISTANCE''' beschreibt den Abstand, bei dem der Verstärkungsfaktor der Audioquelle genau 1 beträgt.
 === AL_ROLLOFF_FACTOR ===

@@ Zeile 88: / Zeile 88: @@
 === AL_REFERENCE_DISTANCE ===
-AL_REFERENCE_DISTANCE beschreibt den Abstand, bei dem der Verstärkungsfaktor der Audioquelle genau 1 beträgt.
+'''AL_REFERENCE_DISTANCE''' beschreibt den Abstand, bei dem der Verstärkungsfaktor der Audioquelle genau 1 beträgt.
 === AL_ROLLOFF_FACTOR ===

@@ Zeile 88: / Zeile 88: @@
 === AL_REFERENCE_DISTANCE ===
-: (unvollständig)
+AL_REFERENCE_DISTANCE beschreibt den Abstand, bei dem der Verstärkungsfaktor der Audioquelle genau 1 beträgt.
 === AL_ROLLOFF_FACTOR ===

@@ Zeile 64: / Zeile 64: @@
 === AL_DIRECTION ===
-: (unvollständig)
+: Legt die Ausrichtung eines Source-Objektes fest. Falls der '''AL_DIRECTION'''-Wert ungleich dem Nullvektor ist, so handelt es sich um ein gerichtetes Source-Objekt. Die Geräuschemission wird als symmetrisch um den Richtungsvektor herum angenommen (Zylindersymmetrie). Der Nullvektor ist der Vorgabewert, wodurch angegeben wird, dass das Source-Objekt nicht gerichtet ist. Das Setzen eines vom Nullvektor verschiedenen, dreidimensionalen Vektors macht aus dem Source-Objekt ein gerichtetes Objekt; das Setzen des Nullvektors für ein gerichtetes Source-Objekt macht es zu einem ungerichteten Source-Objekt. Zulässig sind alle Werte außer [[NaN]]. Der Parameter '''AL_DIRECTION''' ist nur für die Funktionsvarianten '''alSourcefv''', '''alSource3f''', '''alSourceiv''' und '''alSource3i''' zulässig.
 === AL_GAIN ===

@@ Zeile 50: / Zeile 50: @@
 : '''AL_NONE''' ('''nil''' oder 0) ist ein gültiger Puffername. Der Aufruf alSourcei(sourceName, AL_BUFFER, AL_NONE) ist eine zulässige Möglichkeit, die aktuelle Pufferwarteschlange eines Source-Objektes freizugeben, egal ob die Pufferwarteschlange nur einen Eintrag (den aktuellen Puffer) oder mehrer hat. Jedoch verursacht der Funktionsaufruf alSourcei(sourceName, AL_BUFFER, AL_NONE) immer noch einen '''AL_INVALID_OPERATION'''-Fehlerstatus für ein im Zustand '''AL_PLAYING''' oder '''AL_PAUSED''' befindliches Source-Objekt und kann folgerichtig nicht genutzt werden, um ein Source-Objekt anzuhalten (siehe dazu [[alSourceStop]]) oder stummzuschalten. Der Paramater '''AL_BUFFER''' ist nur für die Funktionsvarianten '''alSourcei''' und '''alSourceiv''' zugelassen.
 === AL_CONE_INNER_ANGLE ===
@@ Zeile 89: / Zeile 92: @@
 === AL_ROLLOFF_FACTOR ===
 : (unvollständig)
 === AL_SOURCE_RELATIVE ===
@@ Zeile 111: / Zeile 120: @@
 Seit OpenAL-Version 1.1 existieren auch die Funktionen für mehrere Ganzzahlwerte, '''alSource3i''' und '''alSourceiv'''.

← Nächstältere Version		Version vom 6. Juni 2008, 13:17 Uhr
Zeile 1:		Zeile 1:
−	{{Unvollständig}}	+	{{Unvollständig\|Die Beschreibung zu den Auswirkungen des Funktionsparameters ''param'' muss noch ergänzt werden. Als Grundlage kann die [http://www.openal.org/documentation.html Open AL-Dokumentation] dienen.}}
	= alSource =		= alSource =

@@ Zeile 73: / Zeile 73: @@
 === AL_MAX_GAIN ===
-: (unvollständig)
+: Setzt den maximalen, erlaubten '''AL_GAIN'''-Wert für das Source-Objekt. Der Vorgabewert ist 1.0, zulässig sind alle Gleitkommawerte aus dem Intervall von 0,0 bis 1,0. Am Ende der Varabrebitung verschiedener Abschwächungs- oder Verstärkungsfaktoren wie der entfernungsbasierten Abschwächung und dem '''AL_GAIN'''-Wert des Source-Objektes wird der berechnete Effektivwert mit dem '''AL_MAX_GAIN'''-Wert verglichen. Falls der berechnete Wert größer ist als der '''AL_MAX_GAIN'''-Wert, dann wird der '''AL_MAX_GAIN'''-Wert angewendet. Dies geschieht jedoch, bevor der '''AL_GAIN'''-Wert des Listener-Objektes in Betracht gezogen wird. Wenn das Produkt aus '''AL_MAX_GAIN''' und dem '''AL_GAIN'''-Wert des Listener-Objektes immer noch den maximalen Wert, welchen die Implementierung handhaben kann, überschreitet, so steht es der Implementierung frei, den Wert zu reduzieren. Falls für '''AL_MAX_GAIN''' der Wert null gesetzt wird, so ist das Source-Objekt quasi stummgeschalten. Die vorgesehene Art, ein Source-Objekt stummzuschalten, ist jedoch, den '''AL_GAIN'''-Wert auf null zu setzen. Der Parameter '''AL_MAX_GAIN''' ist nur für die Funktionsvarianten '''alSourcef''' und '''alSourcefv''' zulässig.
 === AL_MIN_GAIN ===
@@ Zeile 79: / Zeile 79: @@
 === AL_PITCH ===
-: (unvollständig)
+: Setzt die Verschiebung der Tonhöhe/ Frequenz des Source-Objektes. Ein Wert von 1,0 entspricht der Identität (d.h. keine Verschiebung), dies ist auch der Vorgabewert. Jede Reduzierung des Wertes um 50% entspricht einer Verschiebung um 12 Halbtöne bzw. eine Oktave nach unten. Jede Verdopplung des Wertes entspricht einer Verschiebung von 12 Halbtönen bzw. einer Oktave nach oben. Null ist kein zulässiger Wert, alle Gleitkommawerte größer als null sind erlaubt. Jede Implementierung kann die '''AL_PITCH'''-Werte aber entsprechend ihrer eigenen Limitationen beschränken. '''AL_PITCH''' ist nur für die Funktionsvarianten '''alSourcef''' und '''alSourcefv''' als Parameter zugelassen.
 === AL_POSITION ===

@@ Zeile 45: / Zeile 45: @@
 Folgende Werte sind für ''param'' zulässig:
 === AL_BUFFER ===
-: Legt das aktuelle Puffer fest und macht ihn zum ersten Eintrag in der Pufferwarteschlange des Source-Objektes. Der Vorgabewert ist '''AL_NONE''', zulässige Werte sind alle gültigen Puffernamen (siehe dazu auch [[alIsBuffer]]). Wird '''alSource''' mit dem Parameter '''AL_BUFFER''' auf ein Source-Objekt im Zustand '''AL_INITIAL''' oder '''AL_STOPPED''' angewendet, so wird die gesamte Pufferwarteschlange geleert und der angegebene Puffer an das Source-Objekt angehangen.
+: Legt den aktuellen Puffer fest und macht ihn zum ersten Eintrag in der Pufferwarteschlange des Source-Objektes. Der Vorgabewert ist '''AL_NONE''', zulässige Werte sind alle gültigen Puffernamen (siehe dazu auch [[alIsBuffer]]). Wird '''alSource''' mit dem Parameter '''AL_BUFFER''' auf ein Source-Objekt im Zustand '''AL_INITIAL''' oder '''AL_STOPPED''' angewendet, so wird die gesamte Pufferwarteschlange geleert und der angegebene Puffer an das Source-Objekt angehangen.
 : Für ein Source-Objekt im Zustand '''AL_PLAYING''' oder '''AL_PAUSED''' wird der Versuch, mit '''AL_BUFFER''' einen Wert zu setzen, den Fehlerstatus '''AL_INVALID_OPERATION''' setzen. '''AL_BUFFER''' kann nur auf Source-Objekte im Zustand '''AL_STOPPED''' oder '''AL_INITIAL''' angewendet werden. Die Angabe eines ungültigen Puffernamens, sei es weil dieser Puffer nicht existiert oder nicht an das Source-Objekt angehängt werden kann, setzt den Fehlerstatus '''AL_INVALID_VALUE''', während die Angabe eines ungültigen Source-Objektes den Fehlerstatus '''AL_INVALID_NAME''' zur Folge hat.
@@ Zeile 76: / Zeile 76: @@
 === AL_MIN_GAIN ===
-: (unvollständig)
+: Legt den minimalen '''AL_GAIN'''-Wert fest, welcher für das Source-Objekt immer gewährleistet sein soll. Der Vorgabewert ist 0.0, zulässig sind alle Werte aus dem Intervall von 0,0 bis 1,0. Am Ende der Verarbeitung verschiedener Abschwächungsfaktoren wie der entfernungsbasierten Abschwächung und dem '''AL_GAIN'''-Wertes des Source-Objektes wird der berechnete Effektivwert mit dem '''AL_MIN_GAIN'''-Wert verglichen. Falls der berechnete Wert kleiner ist als '''AL_MIN_GAIN''', so wird der Wert von '''AL_MIN_GAIN''' angewendet. Dies passiert jedoch, bevor der '''AL_GAIN'''-Wert des Listener-Objektes angewendet wird. Wenn der für '''AL_MIN_GAIN''' gesetzte Wert null ist, so wird keine Korrektur vorgenommen. Der Parameter '''AL_MIN_GAIN''' ist nur für die Funktionsvarianten '''alSourcef''' und '''alSourcefv''' zugelassen.
 === AL_PITCH ===