alcCreateContext - Versionsgeschichte

Openglerf: /* Beschreibung */

2014-01-02T16:14:13Z

‎Beschreibung

Martok: Beschreibung der Flags erweitert

2012-10-09T14:08:57Z

Beschreibung der Flags erweitert

DGLBot: Der Ausdruck ''(.*?)'' wurde ersetzt mit ''$1''.

2009-03-10T18:17:26Z

Der Ausdruck ''<pascal>(.*?)</pascal>'' wurde ersetzt mit ''<source lang="pascal">$1</source>''.

Flash: Unvollständig entfernt

2008-06-06T08:30:20Z

Unvollständig entfernt

Thoronador: Einige Korrekturen und Ergänzungen; Codebeispiel eingefügt.

2008-06-04T19:31:35Z

Einige Korrekturen und Ergänzungen; Codebeispiel eingefügt.

Flash: Artikel begonnen. Bitte korrekturlesen und fertigstellen.

2008-06-04T14:08:49Z

Artikel begonnen. Bitte korrekturlesen und fertigstellen.

Neue Seite

{{Unvollständig|Muss noch fertig übersetzt werden.<br>Als Basis für die Übersetzung diente [http://www.openal.org/oalspecs-annote/x1489.html dieser Artikel]}}
= alcCreateContext =

== Name ==
'''alcCreateContext''' - Erzeugt einen neuen [[ALC Context]].

== Delphi-Spezifikation ==
function '''alcCreateContext'''(''pDevice'': PALCdevice; ''attrList'': PALCint): PALCcontext;

== Parameter ==

{| border="1" rules="all"
! ''pDevice''
| Zeiger auf das Gerät für das ein neuer ALC Context erstellt werden soll.
|-
! ''attrList''
| Zeiger auf eine Liste mit Attributen. Siehe Beschreibung.
|-
|}

== Beschreibung ==
'''alcCreateContext''' erstellt für das ALC Gerät ''pDevice'' einen neuen Kontext.

AL (bzw. ALC) ordnet jedem Kontext ein entsprechendes Gerät zu. Folglich kann ein Kontext erst (mit Hilfe der Funktion [[alcCreateContext]]) erstellt werden, wenn zuvor ein Gerät geöffnet wurde.

Beim Erstellen eines Kontextes können bestimmte Attribute gesetzt werden. Werden diese nicht gesetzt, werden implementationsabhängige Standardwerte benutzt.

Die Kontexterstellung schlägt fehl, wenn
*die Anwendung Attribute anfordert, welche nicht geliefert werden können oder
*eine ungültige Kombination von Attributen angefordert wurde oder
*der Wert eines spezifizierten Attributes bzw. eine Kombination von Attributen nicht mit den Standardwerten für unspezifizierte Attribute übereinstimmt.

Als Attribute kann {{INLINE_CODE|null}} oder eine 0-Terminierte Liste von Integer-Paaren verwendet werden. Jedes Paar besteht dabei aus einer der nachfolgenden Konstanten und dem zugehörigen Wert.

Folgende Konstanten können genutzt werden:
===ALC_FREQUENCY===
Erwartet als Wert die Frequenz in Herz für das Zusammenmischen von Ausgabepuffern.

===ALC_REFRESH===
Erwartet als Wert die Frequenz in Herz für das Refreshintervall.

===ALC_SYNC===
Erwartet ein Flag welches einen synchronen Kontext symbolisiert.

== Hinweise ==
'''''Applications might have a fixed, or bounded, schedule for state changes (e.g. synchronously with the GL framerate). In this case it is desirable to specify the mixahead interval (milliseconds), or refresh rate (Hz), for the mixing thread. This is especially important for a synchronous context, where the application has to specify the refresh interval it intends to keep.'''''

== Fehlermeldungen ==

== Siehe auch ==
[[alcGetCurrentContext]]

[[Kategorie:AL|GetContextsDevice]]
[[Kategorie:ALC|GetContextsDevice]]

@@ Zeile 37: / Zeile 37: @@
 *der Wert eines spezifizierten Attributes bzw. eine Kombination von Attributen nicht mit den Standardwerten für unspezifizierte Attribute übereinstimmt.
-Als Attribute kann '''nil''' oder eine AL_INVALID-terminierte Liste von Integer-Paaren verwendet werden. Jedes Paar besteht dabei aus einer der nachfolgenden Konstanten und dem zugehörigen Wert.
+Als Attribute kann '''nil''' oder eine ALC_INVALID-terminierte Liste von Integer-Paaren verwendet werden. Jedes Paar besteht dabei aus einer der nachfolgenden Konstanten und dem zugehörigen Wert.
 Folgende Konstanten können genutzt werden:

@@ Zeile 37: / Zeile 37: @@
 *der Wert eines spezifizierten Attributes bzw. eine Kombination von Attributen nicht mit den Standardwerten für unspezifizierte Attribute übereinstimmt.
-Als Attribute kann '''nil''' oder eine 0-terminierte Liste von Integer-Paaren verwendet werden. Jedes Paar besteht dabei aus einer der nachfolgenden Konstanten und dem zugehörigen Wert.
+Als Attribute kann '''nil''' oder eine AL_INVALID-terminierte Liste von Integer-Paaren verwendet werden. Jedes Paar besteht dabei aus einer der nachfolgenden Konstanten und dem zugehörigen Wert.
 Folgende Konstanten können genutzt werden:
 ===ALC_FREQUENCY===
-: Erwartet als Wert die Frequenz in Hertz für das Zusammenmischen von Ausgabepuffern.
+: Erwartet als Wert die interne Frequenz in Hertz für das Zusammenmischen von Ausgabepuffern.
 ===ALC_MONO_SOURCES===
@@ Zeile 47: / Zeile 47: @@
 ===ALC_REFRESH===
-: Erwartet als Wert die Frequenz in Hertz für das Refreshintervall.
+: Erwartet als Wert die Frequenz in Hertz für das Refreshintervall. Übliche Werte liegen bei 5..15 Hz.
 ===ALC_STEREO_SOURCES===
@@ Zeile 53: / Zeile 53: @@
 ===ALC_SYNC===
-: Erwartet ein Flag, welches einen synchronen Kontext symbolisiert.
+: Boolean, gibt an ob der Kontext einen eigenen Thread startet (AL_FALSE, Standard) oder manuell [[alcUpdateContext]] verwendet werden soll (AL_TRUE).
 == Hinweise ==

@@ Zeile 62: / Zeile 62: @@
 == Beispiel ==
 Folgender Code öffnet ein Gerät und erzeugt darin einen Kontext, der zum aktuellen Kontext gemacht wird.
-<pascal>var device: PALCdevice;
+<source lang="pascal">var device: PALCdevice;
      context: PALCcontext;
 ...
@@ Zeile 71: / Zeile 71: @@
    if context<>nil then
      alcMakeContextCurrent(context); //setzt den aktiven Kontext
-end;</pascal>
+end;</source>

← Nächstältere Version		Version vom 6. Juni 2008, 08:30 Uhr
Zeile 1:		Zeile 1:
−	~~{{Unvollständig\|Muss noch fertig übersetzt werden.<br>Als Basis für die Übersetzung diente [http://www.openal.org/oalspecs-annote/x1489.html dieser Artikel]}}~~
	= alcCreateContext =		= alcCreateContext =

@@ Zeile 5: / Zeile 5: @@
 == Name ==
-'''alcCreateContext''' - Erzeugt einen neuen [[ALC Context]].
+'''alcCreateContext''' - Erzeugt einen neuen [[ALC-Kontext]].
@@ Zeile 15: / Zeile 15: @@
 == Parameter ==
 {| border="1" rules="all"
 ! ''pDevice''
-| Zeiger auf das Gerät für das ein neuer ALC Context erstellt werden soll.
+| Zeiger auf das Gerät, für das ein neuer ALC Context erstellt werden soll.
 |-
 ! ''attrList''
@@ Zeile 28: / Zeile 27: @@
 == Beschreibung ==
-'''alcCreateContext''' erstellt für das ALC Gerät ''pDevice'' einen neuen Kontext.
+Die Funktion '''alcCreateContext''' erstellt für das ALC-Gerät ''pDevice'' einen neuen Kontext und gibt den Zeiger auf den neuen Kontext zurück. Bei Fehlschlag wird ein '''nil'''-Zeiger zurückgegeben.
-AL (bzw. ALC) ordnet jedem Kontext ein entsprechendes Gerät zu. Folglich kann ein Kontext erst (mit Hilfe der Funktion [[alcCreateContext]]) erstellt werden, wenn zuvor ein Gerät geöffnet wurde.
+AL (bzw. ALC) ordnet jedem Kontext ein entsprechendes Gerät zu. Folglich kann ein Kontext erst (mit Hilfe der Funktion '''alcCreateContext''') erstellt werden, wenn zuvor ein Gerät geöffnet wurde. Siehe dazu [[alcOpenDevice]].
 Beim Erstellen eines Kontextes können bestimmte Attribute gesetzt werden. Werden diese nicht gesetzt, werden implementationsabhängige Standardwerte benutzt.
@@ Zeile 39: / Zeile 38: @@
 *der Wert eines spezifizierten Attributes bzw. eine Kombination von Attributen nicht mit den Standardwerten für unspezifizierte Attribute übereinstimmt.
-Als Attribute kann {{INLINE_CODE|null}} oder eine 0-Terminierte Liste von Integer-Paaren verwendet werden. Jedes Paar besteht dabei aus einer der nachfolgenden Konstanten und dem zugehörigen Wert.
+Als Attribute kann '''nil''' oder eine 0-terminierte Liste von Integer-Paaren verwendet werden. Jedes Paar besteht dabei aus einer der nachfolgenden Konstanten und dem zugehörigen Wert.
 Folgende Konstanten können genutzt werden:
 ===ALC_FREQUENCY===
-Erwartet als Wert die Frequenz in Herz für das Zusammenmischen von Ausgabepuffern.
+: Erwartet als Wert die Frequenz in Hertz für das Zusammenmischen von Ausgabepuffern.
 ===ALC_REFRESH===
-Erwartet als Wert die Frequenz in Herz für das Refreshintervall.
+: Erwartet als Wert die Frequenz in Hertz für das Refreshintervall.
 ===ALC_SYNC===
-Erwartet ein Flag welches einen synchronen Kontext symbolisiert.
+: Erwartet ein Flag, welches einen synchronen Kontext symbolisiert.
 == Hinweise ==
-'''''Applications might have a fixed, or bounded, schedule for state changes (e.g. synchronously with the GL framerate). In this case it is desirable to specify the mixahead interval (milliseconds), or refresh rate (Hz), for the mixing thread. This is especially important for a synchronous context, where the application has to specify the refresh interval it intends to keep.'''''
+Awendungen haben möglicherweise einen festen oder beschränkten Rhythmus für Zustandsänderungen (z.B. synchron mit der OpenGL-Framerate). In diesem Fall ist es wünschenswert den '''''mixahead interval (milliseconds)''''' oder die Refreshrate (Hz) für den Thread anzugeben. Dies ist besonders für synchrone Kontexte wichtig, wo die Anwendung ein Refreshintervall, welches sie einhalten möchte, anzugeben hat.
 == Fehlermeldungen ==
 == Siehe auch ==
-[[alcGetCurrentContext]]
+[[alcDestroyContext]], [[alcGetCurrentContext]]
-[[Kategorie:AL|GetContextsDevice]]
+[[Kategorie:AL|CreateContext]]
-[[Kategorie:ALC|GetContextsDevice]]
+[[Kategorie:ALC|CreateContext]]