wglGetPixelFormatAttribARB
Inhaltsverzeichnis
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.
