glGetColorTableParameterivEXT-Funktion

Die Funktionen glGetColorTableParameterfvEXT und glGetColorTableParameterivEXT rufen Palettenparameter aus Farbtabellen ab.

Syntax

void WINAPI glGetColorTableParameterivEXT(
   GLenum target,
   GLenum pname,
   GLint  *params
);

Parameter

Ziel

Die Zieltextur der Palette, für die Sie Parameterdaten benötigen. Muss TEXTURE_1D, TEXTURE_2D, PROXY_TEXTURE_1D oder PROXY_TEXTURE_2D sein.

pname

Eine symbolische Konstante für den Typ der Palettenparameterdaten, auf die von Params verwiesen wird.

Im Folgenden werden die akzeptierten symbolischen Konstanten und ihre Bedeutungen aufgeführt.

Wert	Bedeutung
GL_COLOR_TABLE_FORMAT_EXT	Gibt das interne Format zurück, das durch den letzten Aufruf von glColorTableEXT oder den Standardwert angegeben wurde.
GL_COLOR_TABLE_WIDTH_EXT	Gibt die Breite der aktuellen Palette zurück.
GL_COLOR_TABLE_RED_SIZE_EXT	Gibt die tatsächliche Größe zurück, die intern zum Speichern der roten Komponente der Palettendaten verwendet wird.
GL_COLOR_TABLE_GREEN_SIZE_EXT	Gibt die tatsächliche Größe zurück, die intern zum Speichern der grünen Komponente der Palettendaten verwendet wird.
GL_COLOR_TABLE_BLUE_SIZE_EXT	Gibt die tatsächliche Größe zurück, die intern zum Speichern der blauen Komponente der Palettendaten verwendet wird.
GL_COLOR_TABLE_ALPHA_SIZE_EXT	Gibt die tatsächliche Größe zurück, die intern zum Speichern der Alphakomponente der Palettendaten verwendet wird.

params

Zeigt auf die Farbtabellenparameterdaten, die durch den pname-Parameter angegeben werden.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

Sie verwenden die Funktionen glGetColorTableParameterivEXT und glGetColorTableParameterfvEXT , um bestimmte Parameterdaten aus Farbtabellen abzurufen, die mit glColorTableEXT für zielorientierte Texturpaletten festgelegt sind. Sie können diese Funktionen auch verwenden, um die Anzahl der Farbtabelleneinträge zu bestimmen, die glGetColorTableEXT zurückgibt.

Wenn der Zielparameter GL_PROXY_TEXTURE_1D oder GL_PROXY_TEXTURE_2D ist und die Implementierung die für Format oder Breite angegebenen Werte nicht unterstützt, kann glColorTableEXT die angeforderte Farbtabelle nicht erstellen. In diesem Fall ist die Farbtabelle leer, und alle abgerufenen Parameter sind 0. Sie können bestimmen, ob OpenGL ein bestimmtes Farbtabellenformat und eine bestimmte Größe unterstützt, indem Sie glColorTableEXT mit einem Proxyziel aufrufen und dann glGetColorTableParameterivEXT oder glGetColorTableParameterfvEXT aufrufen, um zu bestimmen, ob der width-Parameter mit dem von glColorTableEXT festgelegten Parameter übereinstimmt. Wenn die abgerufene Breite 0 ist, ist bei der Farbtabellenanforderung von glColorTable ein Fehler aufgetreten. Wenn die abgerufene Breite nicht 0 ist, können Sie glColorTable mit dem realen Ziel mit TEXTURE_1D oder TEXTURE_2D aufrufen, um die Farbtabelle festzulegen.

Die Funktionen glGetColorTableParameterivEXT und glGetColorTableParameterfvEXT sind Erweiterungsfunktionen, die nicht Teil der OpenGL-Standardbibliothek sind, sondern Teil der GL_EXT_paletted_texture-Erweiterung sind. Rufen Sie glGetString(GL_EXTENSIONS) auf, um zu überprüfen, ob Ihre Implementierung von OpenGL glGetColorTableParameterivEXT und glGetColorTableParameterfvEXT unterstützt. Wenn GL_EXT_paletted_texture zurückgegeben wird, werden glGetColorTableParameterivEXT und glGetColorTableParameterfvEXT unterstützt. Um die Funktionsadresse einer Erweiterungsfunktion abzurufen, rufen Sie wglGetProcAddress auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Gl.h

Weitere Informationen

glColorSubTableEXT

glColorTableEXT

glGetColorTableEXT

glGetColorTableParameterfvEXT

wglGetProcAddress