wglChoosePixelFormatARB
Inhaltsverzeichnis
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 glGetError erhalten werden.
ERROR_DC_NOT_FOUND wird generiert wenn hDC kein gültiger Device Context ist.