wglChoosePixelFormatARB

Aus DGL Wiki
Wechseln zu: Navigation, Suche

wglChoosePixelFormatARB

Name

wglChoosePixelFormatARB - Liefert eine Liste aller Pixel Formate welche für gegebene Anforderungen verfügbar sind.


Delphi-Spezifikation

function wglChoosePixelFormatARB(hdc: HDC; const piAttribIList: PGLint; const pfAttribFList: PGLfloat; nMaxFormats: TGLuint;
                                 piFormats: PGLint; nNumFormats: PGLuint): BOOL;



Parameter

hDC Der Device Context für den Pixel Formate gesucht werden sollen.
piAttribIList Eine Liste von Integer Attributen welche Paarweise (Attributtyp, Wert) angegeben werden müssen (siehe WGL_ARB_pixel_format-Neue Tokens für Attributtypen). Die Liste wird durch den Typ 0 terminiert. Wenn dieser Wert NIL ist entspricht dies einer leeren Integer-Liste.
pfAttribFList Eine Liste von Floating-Point Attributen welche Paarweise (Attributtyp, Wert) angegeben werden müssen (siehe WGL_ARB_pixel_format-Neue Tokens für Attributtypen). Die Liste wird durch den Typ 0.0 terminiert. Wenn dieser Wert NIL ist entspricht dies einer leeren Floating-Point-Liste.
nMaxFormats Gibt an wie viele Pixel Formate in piFormats maximal zurück gegeben werden soll.
piFormats Ein Zeiger auf einen (vom Aufrufer allokierten!) Integer-Array welcher mindestens nMaxFormats Elemente hat. Dieser erhält die zu den Anforderungen passenden Pixel Formate, wobei das am besten passendste Pixel Format am Anfang des Arrays zu finden ist.
nNumFormats Ein Zeiger auf einen unsigned Integer, welcher die Anzahl der verfügbaren Pixel Formate zu diesen Anforderungen enthält. Dieser Wert kann größer sein als nMaxFormats



Beschreibung

Wenn diese Funktion Erfolgreich war, so wird TRUE zurück gegeben. Wenn kein entsprechendes Pixels Format gefunden wurde, so kann der Rückgabewert dennoch TRUE sein, aber nNumFormats wird auf 0 gesetzt.

Die Attribute die weder in pfAttribFList noch in piAttribIList angegeben werden, werden beim Suchprozess nach Pixel-Formaten ignoriert.

Wenn sowohl pfAttribFList als auch piAttribIList entweder NIL oder leer sind, so werden alle vorhandenen Pixel Formate für diesen Device Context zurück gegeben.


Hinweise

wglChoosePixelFormatARB 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.

Siehe auch

WGL_ARB_pixel_format