wglGetPixelFormatAttribARB

Aus DGL Wiki
Version vom 13. September 2007, 16:01 Uhr von I0n0s (Diskussion | Beiträge) (Fehlermeldungen)

(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche

wglChoosePixelFormatARB

Name

wglGetPixelFormatAttribARB - Liefert Informationen über ein bestimmtes Pixel Format welches über einen Integer-Index (beginnend mit 1) identifiziert wird.


Delphi-Spezifikation

function wglGetPixelFormatAttribivARB (hdc: HDC; iPixelFormat: TGLint; iLayerPlane: TGLint; nAttributes: TGLuint;
                                       const piAttributes: PGLint; piValues: PGLint): Boolean;

function wglGetPixelFormatAttribfvARB (hdc: HDC; iPixelFormat: TGLint; iLayerPlane: TGLint; nAttributes: TGLuint;
                                       const piAttributes: PGLint; pfValues: PGLfloat): Boolean;



Parameter

hDC Der Device Context für den ein Pixel Format abgefragt werden soll.
iPixelFormat Gibt den Pixel Format Index (ID) an, für den die Eigenschaften abgefragt werden sollen.
iLayerPlane Gibt die Ebene an die abgefragt werden soll. Negative Werte für daruntergelegene Ebenen, positive Werte für darübergelegene Ebenen. 0 um die Haupt-Ebene abzufragen.
nAttributes Die Anzahl der Attribute die abgefragt werden sollen.
piAttributes Ein Integer-Array der mindestens nAttributes Elemente besitzt, welcher die Pixel Format Attribute die abgefragt werden sollen beinhaltet (siehe WGL_ARB_pixel_format#Neue Tokens für Attributtypen).
piValues Ein Zeiger auf einen (vom Aufrufer allokierten!) Integer-Array welcher mindestens nAttributes Elemente besitzt. Dieser Puffer erhält die Werte für die entsprechenden Attributtypen welche mit piAttributes angegeben wurden. Floating-Point Werte werden auf den nähesten Integer gerundet.
pfValues Ein Zeiger auf einen (vom Aufrufer allokierten!) Floating-Point-Array welcher mindestens nAttributes Elemente besitzt. Dieser Puffer erhält die Werte für die entsprechenden Attributtypen welche mit piAttributes angegeben wurden. Integer Werte werden in Floating-Point Werte konvertiert.



Beschreibung

Diese Funktionen können sowohl zur Abfrage von Informationen über die Haupt- als auch für die Layer-Ebenen eines Pixel Formats verwendet werden.

Wenn diese Funktion Erfolgreich war, so wird TRUE zurück gegeben.


Hinweise

wglGetPixelFormatAttribARB ist keine WGL Kernfunktion sondern Teil der Extension WGL_ARB_pixel_format.


Fehlermeldungen

Wenn die Funktion erfolgreich war, so wird True zurück gegeben. Anderenfalls ist der Rückgabewert False und nähere Informationen zum Fehler können mit GetLastError erhalten werden.
ERROR_DC_NOT_FOUND wird generiert wenn hDC kein gültiger Device Context ist.
ERROR_INVALID_PIXEL_FORMAT wird generiert wenn iPixelFormat kein gültiges Pixel Format identifiziert.

Siehe auch

WGL_ARB_pixel_format