glXGetFBConfigAttrib: Unterschied zwischen den Versionen
(Die Seite wurde neu angelegt: {{Unvollständig|Auswirkungen des Parameters ''attribute'' müssen noch ergänzt werden. Siehe dazu [http://www.opengl.org/sdk/docs/man/xhtml/glXGetFBConfigAttrib.xml O...) |
|||
Zeile 94: | Zeile 94: | ||
===GLX_X_RENDERABLE=== | ===GLX_X_RENDERABLE=== | ||
: Gibt '''True''' zurück, falls vom X-Server auf die mit der Framebufferkonfiguration erzeugten Zeichenflächen gerendert werden kann. | : Gibt '''True''' zurück, falls vom X-Server auf die mit der Framebufferkonfiguration erzeugten Zeichenflächen gerendert werden kann. | ||
+ | |||
+ | ===GLX_VISUAL_ID=== | ||
+ | : Gibt die XID des zugehörigen Visuals zurück, oder null, falls es kein zugehöriges Visual gibt (d.h. wenn '''GLX_X_RENDERABLE''' den Wert '''False''' hat oder wenn in '''GLX_DRAWABLE_TYPE''' das Bit '''GLX_WINDOW_BIT''' nicht gesetzt ist). | ||
+ | |||
+ | ===GLX_X_VISUAL_TYPE=== | ||
+ | : Gibt den Typ des zugehörigen Visuals zurück. Der Rückgabewert kann ist dabei einer der folgenden: '''GLX_TRUE_COLOR''', '''GLX_DIRECT_COLOR''', '''GLX_PSEUDO_COLOR''', '''GLX_STATIC_COLOR''', '''GLX_GRAY_SCALE''', '''GLX_STATIC_GRAY''' oder '''GLX_NONE''', falls es kein zugehöriges Visual gibt (d.h. wenn '''GLX_X_RENDERABLE''' den Wert '''False''' hat oder wenn in '''GLX_DRAWABLE_TYPE''' das Bit '''GLX_WINDOW_BIT''' nicht gesetzt ist). | ||
+ | |||
+ | ===GLX_CONFIG_CAVEAT=== | ||
+ | : Gibt einen der Werte '''GLX_NONE''', '''GLX_SLOW_CONFIG''' oder '''GLX_NON_CONFORMANT_CONFIG''' zurück, welcher angibt, dass die Framebufferkonfiguration entweder keine Nachteile (''caveats'') hat, oder dass ein Aspekt der Framebufferkonfiguration langsamer läuft als andere Framebufferkonfigurationen, oder das die Framebufferkonfiguration nicht konform geht, in dieser Reihenfolge. | ||
+ | |||
+ | ===GLX_TRANSPARENT_TYPE=== | ||
+ | : Gibt den Transparenztyp der Framebufferkonfiguration zurück, und kann einer der folgenden Werte sein: '''GLX_NONE''', '''GLX_TRANSPARENT_RGB''', '''GLX_TRANSPARENT_INDEX''', welche angeben, dass die Framebufferkonfiguration nicht transparent, transparent für bestimmte Rot-, Grün- und Blauwerte, oder transparent für bestimmte Indexwerte ist, in dieser Reihenfolge. | ||
+ | |||
+ | ===GLX_TRANSPARENT_INDEX_VALUE=== | ||
+ | : Gibt einen Ganzzahlwert zwischen 0 und dem maximalen Framebufferwert für Indices zurück, der den transparenten Indexwert der Framebufferkonfiguration angibt. Der Wert ist nicht definiert, falls '''GLX_TRANSPARENT_TYPE''' nicht den Wert '''GLX_TRANSPARENT_INDEX''' hat. | ||
+ | |||
+ | ===GLX_TRANSPARENT_RED_VALUE=== | ||
+ | : Gibt einen Ganzzahlwert zwischen 0 und dem maximalen Framebufferwert für Rot zurück, der den transparenten Rotwert der Framebufferkonfiguration angibt. Der Wert ist nicht definiert, falls '''GLX_TRANSPARENT_TYPE''' nicht den Wert '''GLX_TRANSPARENT_RGB''' hat. | ||
+ | |||
+ | ===GLX_TRANSPARENT_GREEN_VALUE=== | ||
+ | : Gibt einen Ganzzahlwert zwischen 0 und dem maximalen Framebufferwert für Grün zurück, der den transparenten Grünwert der Framebufferkonfiguration angibt. Der Wert ist nicht definiert, falls '''GLX_TRANSPARENT_TYPE''' nicht den Wert '''GLX_TRANSPARENT_RGB''' hat. | ||
+ | |||
+ | ===GLX_TRANSPARENT_BLUE_VALUE=== | ||
+ | : Gibt einen Ganzzahlwert zwischen 0 und dem maximalen Framebufferwert für Blau zurück, der den transparenten Blauwert der Framebufferkonfiguration angibt. Der Wert ist nicht definiert, falls '''GLX_TRANSPARENT_TYPE''' nicht den Wert '''GLX_TRANSPARENT_RGB''' hat. | ||
+ | |||
+ | ===GLX_TRANSPARENT_ALPHA_VALUE=== | ||
+ | : Gibt einen Ganzzahlwert zwischen 0 und dem maximalen Framebufferwert für Alpha zurück, der den transparenten Alphawert der Framebufferkonfiguration angibt. Der Wert ist nicht definiert, falls '''GLX_TRANSPARENT_TYPE''' nicht den Wert '''GLX_TRANSPARENT_RGB''' hat. | ||
+ | |||
+ | ===GLX_MAX_PBUFFER_WIDTH=== | ||
+ | : Gibt die maximale Breite zurück, welche bei [[glXCreatePbuffer]] angegeben werden kann. | ||
+ | |||
+ | ===GLX_MAX_PBUFFER_HEIGHT=== | ||
+ | : Gibt die maximale Höhe zurück, welche bei [[glXCreatePbuffer]] angegeben werden kann. | ||
+ | |||
+ | ===GLX_MAX_PBUFFER_PIXELS=== | ||
+ | : Gibt die maximale Pixelanzahl (Breite mal Höhe) für einen Pixelpuffer zurück. Zu beachten ist, dass dieser Wert geringer sein kann als '''GLX_MAX_PBUFFER_WIDTH''' mal '''GLX_MAX_PBUFFER_HEIGHT'''. Außerdem ist dieser Wert statisch und geht davon aus, dass keine anderen Pixelpuffer oder X-Ressourcen den Framebufferspeicher beanspruchen. Als Ergebnis davon kann es vorkommen, dass es nicht möglich ist, einen Pixelpuffer mit der von '''GLX_MAX_PBUFFER_PIXELS''' angegebenen Größe anzulegen. | ||
+ | |||
Version vom 15. Juli 2008, 22:15 Uhr
(Mehr Informationen/weitere Artikel) Auswirkungen des Parameters attribute müssen noch ergänzt werden. Siehe dazu OpenGL-Reference Pages. |
Inhaltsverzeichnis
- 1 glXGetFBConfigAttrib
- 1.1 Name
- 1.2 Delphi-Spezifikation
- 1.3 Parameter
- 1.4 Beschreibung
- 1.4.1 GLX_FBCONFIG_ID
- 1.4.2 GLX_BUFFER_SIZE
- 1.4.3 GLX_LEVEL
- 1.4.4 GLX_DOUBLEBUFFER
- 1.4.5 GLX_STEREO
- 1.4.6 GLX_AUX_BUFFERS
- 1.4.7 GLX_RED_SIZE
- 1.4.8 GLX_GREEN_SIZE
- 1.4.9 GLX_BLUE_SIZE
- 1.4.10 GLX_ALPHA_SIZE
- 1.4.11 GLX_DEPTH_SIZE
- 1.4.12 GLX_STENCIL_SIZE
- 1.4.13 GLX_ACCUM_RED_SIZE
- 1.4.14 GLX_ACCUM_GREEN_SIZE
- 1.4.15 GLX_ACCUM_BLUE_SIZE
- 1.4.16 GLX_ACCUM_ALPHA_SIZE
- 1.4.17 GLX_RENDER_TYPE
- 1.4.18 GLX_DRAWABLE_TYPE
- 1.4.19 GLX_X_RENDERABLE
- 1.4.20 GLX_VISUAL_ID
- 1.4.21 GLX_X_VISUAL_TYPE
- 1.4.22 GLX_CONFIG_CAVEAT
- 1.4.23 GLX_TRANSPARENT_TYPE
- 1.4.24 GLX_TRANSPARENT_INDEX_VALUE
- 1.4.25 GLX_TRANSPARENT_RED_VALUE
- 1.4.26 GLX_TRANSPARENT_GREEN_VALUE
- 1.4.27 GLX_TRANSPARENT_BLUE_VALUE
- 1.4.28 GLX_TRANSPARENT_ALPHA_VALUE
- 1.4.29 GLX_MAX_PBUFFER_WIDTH
- 1.4.30 GLX_MAX_PBUFFER_HEIGHT
- 1.4.31 GLX_MAX_PBUFFER_PIXELS
- 1.5 Hinweise
- 1.6 Fehlermeldungen
- 1.7 Siehe auch
glXGetFBConfigAttrib
Name
glXGetFBConfigAttrib - Gibt Informationen über eine GLX-Framebufferkonfiguration zurück.
Delphi-Spezifikation
function glXGetFBConfigAttrib(dpy: PDIsplay; config: GLXFBConfig; attribute: Integer; value: PGLint): Integer;
Parameter
dpy | Gibt die Verbindung zum X-Server an |
---|---|
config | Gibt die abzufragende GLX-Framebufferkonfiguration an |
attribute | Gibt das abzufragende Attribut an |
value | Gibt den abgefragtn Wert zurück |
Beschreibung
Die Funktion glXGetFBConfigAttrib setzt value auf den in attribute spezifizierten Attributswert der GLX-Zeichenflächen, welche mit config erstellt wurden. glXGetFBConfigAttrib gibt einen Fehlercode zurück, falls die Funktion aus irgendeinem Grund fehlschägt. Andernfalls wird Success zurückgegeben.
Anwendungen sollten die Framebufferkonfiguration wählen, die am nähesten an ihre Anforderungen herankommt. Das Erstellen von Fenstern, GLX_Pixmaps oder GLX-Pixelpuffern mit unnötigen Puffern kann eine verminderte Renderperformance als auch schlechte Ressourcenallokation zur Folge haben.
Der Parameter attribute kann folgende Werte haben:
GLX_FBCONFIG_ID
- XID der in config gegebenen GLXFBConfig wird zurückgegeben.
GLX_BUFFER_SIZE
- Gibt die Anzahl der Bits pro Farbpuffer zurück. Falls die Framebufferkonfiguration RGBA-Renderkontexte unterstützt, so ist GLX_BUFFER_SIZE die Summe aus GLX_RED_SIZE, GLX_GREEN_SIZE, GLX_BLUE_SIZE und GLX_ALPHA_SIZE. Falls die Framebufferkonfiguration nur Farbindex-Kontexte unterstützt, so liefert GLX_BUFFER_SIZE die Größe der Farbindices zurück.
GLX_LEVEL
- Gibt das Framebufferlevel der Konfiguration zurück. Level null ist der Standardframebuffer. Positive Level entsprechen den Framebuffern, die über dem Vorgabeframebuffer liegen, und negative Level entsprechen den Framebuffern, die unter dem Standardframebuffer liegen.
GLX_DOUBLEBUFFER
- Gibt True zurück, falls die Farbpuffer in Front-/Backbufferpaaren existieren und vertauscht werden können. Andernfalls wird False zurückgegeben.
GLX_STEREO
- Gibt True zurück, falls die Farbpuffer in Links-/Rechts-Paaren existieren. Andernfalls wird False zurückgegeben.
GLX_AUX_BUFFERS
- Gibt die Anzahl der verfügbaren Hilfsfarbpuffer zurück. Ein Wert von null gibt an, dass es keine Hilfspuffer gibt.
GLX_RED_SIZE
- Gibt die Anzahl der Rotbits an, die in jedem Farbpuffer bespeichert werden. Der Wert ist nicht definiert, falls RGBA-Kontexte von der Framebufferkonfiguration nicht unterstützt werden.
GLX_GREEN_SIZE
- Gibt die Anzahl der Grünbits an, die in jedem Farbpuffer bespeichert werden. Der Wert ist nicht definiert, falls RGBA-Kontexte von der Framebufferkonfiguration nicht unterstützt werden.
GLX_BLUE_SIZE
- Gibt die Anzahl der Blaubits an, die in jedem Farbpuffer bespeichert werden. Der Wert ist nicht definiert, falls RGBA-Kontexte von der Framebufferkonfiguration nicht unterstützt werden.
GLX_ALPHA_SIZE
- Gibt die Anzahl der Alphabits an, die in jedem Farbpuffer bespeichert werden. Der Wert ist nicht definiert, falls RGBA-Kontexte von der Framebufferkonfiguration nicht unterstützt werden.
GLX_DEPTH_SIZE
- Gibt die Anzahl der Bits im Tiefenpuffer zurück.
GLX_STENCIL_SIZE
- Gibt die Anzahl der Bits im Schablonenpuffer zurück.
GLX_ACCUM_RED_SIZE
- Gibt die Anzahl der im Akkumulationspuffer gespeicherten Rotbits zurück.
GLX_ACCUM_GREEN_SIZE
- Gibt die Anzahl der im Akkumulationspuffer gespeicherten Grünbits zurück.
GLX_ACCUM_BLUE_SIZE
- Gibt die Anzahl der im Akkumulationspuffer gespeicherten Blaubits zurück.
GLX_ACCUM_ALPHA_SIZE
- Gibt die Anzahl der im Akkumulationspuffer gespeicherten Alphabits zurück.
GLX_RENDER_TYPE
- Gibt eine Bitmaske zurück, die angibt, welche Typen von GLX-Renderkontexten mit der Framebufferkonfiguration als aktueller Renderkontext gesetzt werden können. Gültige Bits sind GLX_RGBA_BIT und GLX_COLOR_INDEX_BIT.
GLX_DRAWABLE_TYPE
- Gibt eine Bitmaske zurück, die angibt, welche Typen von Zeichenflächen die Framebufferkonfiguration unterstützt. Gültige Bits sind GLX_WINDOW_BIT, GLX_PIXMAP_BIT und GLX_PBUFFER_BIT.
GLX_X_RENDERABLE
- Gibt True zurück, falls vom X-Server auf die mit der Framebufferkonfiguration erzeugten Zeichenflächen gerendert werden kann.
GLX_VISUAL_ID
- Gibt die XID des zugehörigen Visuals zurück, oder null, falls es kein zugehöriges Visual gibt (d.h. wenn GLX_X_RENDERABLE den Wert False hat oder wenn in GLX_DRAWABLE_TYPE das Bit GLX_WINDOW_BIT nicht gesetzt ist).
GLX_X_VISUAL_TYPE
- Gibt den Typ des zugehörigen Visuals zurück. Der Rückgabewert kann ist dabei einer der folgenden: GLX_TRUE_COLOR, GLX_DIRECT_COLOR, GLX_PSEUDO_COLOR, GLX_STATIC_COLOR, GLX_GRAY_SCALE, GLX_STATIC_GRAY oder GLX_NONE, falls es kein zugehöriges Visual gibt (d.h. wenn GLX_X_RENDERABLE den Wert False hat oder wenn in GLX_DRAWABLE_TYPE das Bit GLX_WINDOW_BIT nicht gesetzt ist).
GLX_CONFIG_CAVEAT
- Gibt einen der Werte GLX_NONE, GLX_SLOW_CONFIG oder GLX_NON_CONFORMANT_CONFIG zurück, welcher angibt, dass die Framebufferkonfiguration entweder keine Nachteile (caveats) hat, oder dass ein Aspekt der Framebufferkonfiguration langsamer läuft als andere Framebufferkonfigurationen, oder das die Framebufferkonfiguration nicht konform geht, in dieser Reihenfolge.
GLX_TRANSPARENT_TYPE
- Gibt den Transparenztyp der Framebufferkonfiguration zurück, und kann einer der folgenden Werte sein: GLX_NONE, GLX_TRANSPARENT_RGB, GLX_TRANSPARENT_INDEX, welche angeben, dass die Framebufferkonfiguration nicht transparent, transparent für bestimmte Rot-, Grün- und Blauwerte, oder transparent für bestimmte Indexwerte ist, in dieser Reihenfolge.
GLX_TRANSPARENT_INDEX_VALUE
- Gibt einen Ganzzahlwert zwischen 0 und dem maximalen Framebufferwert für Indices zurück, der den transparenten Indexwert der Framebufferkonfiguration angibt. Der Wert ist nicht definiert, falls GLX_TRANSPARENT_TYPE nicht den Wert GLX_TRANSPARENT_INDEX hat.
GLX_TRANSPARENT_RED_VALUE
- Gibt einen Ganzzahlwert zwischen 0 und dem maximalen Framebufferwert für Rot zurück, der den transparenten Rotwert der Framebufferkonfiguration angibt. Der Wert ist nicht definiert, falls GLX_TRANSPARENT_TYPE nicht den Wert GLX_TRANSPARENT_RGB hat.
GLX_TRANSPARENT_GREEN_VALUE
- Gibt einen Ganzzahlwert zwischen 0 und dem maximalen Framebufferwert für Grün zurück, der den transparenten Grünwert der Framebufferkonfiguration angibt. Der Wert ist nicht definiert, falls GLX_TRANSPARENT_TYPE nicht den Wert GLX_TRANSPARENT_RGB hat.
GLX_TRANSPARENT_BLUE_VALUE
- Gibt einen Ganzzahlwert zwischen 0 und dem maximalen Framebufferwert für Blau zurück, der den transparenten Blauwert der Framebufferkonfiguration angibt. Der Wert ist nicht definiert, falls GLX_TRANSPARENT_TYPE nicht den Wert GLX_TRANSPARENT_RGB hat.
GLX_TRANSPARENT_ALPHA_VALUE
- Gibt einen Ganzzahlwert zwischen 0 und dem maximalen Framebufferwert für Alpha zurück, der den transparenten Alphawert der Framebufferkonfiguration angibt. Der Wert ist nicht definiert, falls GLX_TRANSPARENT_TYPE nicht den Wert GLX_TRANSPARENT_RGB hat.
GLX_MAX_PBUFFER_WIDTH
- Gibt die maximale Breite zurück, welche bei glXCreatePbuffer angegeben werden kann.
GLX_MAX_PBUFFER_HEIGHT
- Gibt die maximale Höhe zurück, welche bei glXCreatePbuffer angegeben werden kann.
GLX_MAX_PBUFFER_PIXELS
- Gibt die maximale Pixelanzahl (Breite mal Höhe) für einen Pixelpuffer zurück. Zu beachten ist, dass dieser Wert geringer sein kann als GLX_MAX_PBUFFER_WIDTH mal GLX_MAX_PBUFFER_HEIGHT. Außerdem ist dieser Wert statisch und geht davon aus, dass keine anderen Pixelpuffer oder X-Ressourcen den Framebufferspeicher beanspruchen. Als Ergebnis davon kann es vorkommen, dass es nicht möglich ist, einen Pixelpuffer mit der von GLX_MAX_PBUFFER_PIXELS angegebenen Größe anzulegen.
Hinweise
glXGetFBConfigAttrib ist nur verfügbar, wenn die GLX-Version 1.3 oder höher ist.
Falls die GLX-Version 1.1 oder 1.0 ist, so muss die GL-Version 1.0 sein. Falls die GLX-Version 1.2 ist, so muss die GL-Version 1.1 sein. Falls die GLX-Version 1.3 ist, so muss die GL-Version 1.2 sein.
Fehlermeldungen
GLX_NO_EXTENSION wird zurückgegeben, wenn dpy die GLX-Erweiterung nicht unterstützt.
GLX_BAD_ATTRIBUTE wird zurückgegeben, wenn attribute kein gültiges GLX-Attribut ist.
Siehe auch
glXChooseFBConfig, glXGetConfig, glXGetFBConfigs, glXGetVisualFromFBConfig