glGetColorTableParameterfvEXT-Funktion

Die Funktionen glGetColorTableParameterfvEXT und glGetColorTableParameterivEXT erhalten Palettenparameter aus Farbtabellen.

Syntax

void WINAPI glGetColorTableParameterfvEXT(
   GLenum  target,
   GLenum  pname,
   GLfloat *params
);

Parameter

Ziel

Die Zieltextur der Palette, für die Parameterdaten benötigt werden sollen. 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 durch Params verwiesen wird.

Nachfolgend sind die akzeptierten symbolischen Konstanten und ihre Bedeutungen aufgeführt.

Wert Bedeutung
GL_COLOR_TABLE_FORMAT_EXT
Gibt das interne Format zurück, das vom letzten Aufruf von glColorTableEXT oder dem Standardwert angegeben wird.
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 verwendet wird, um die rote Komponente der Palettendaten zu speichern.
GL_COLOR_TABLE_GREEN_SIZE_EXT
Gibt die tatsächliche Größe zurück, die intern verwendet wird, um die grüne Komponente der Palettendaten zu speichern.
GL_COLOR_TABLE_BLUE_SIZE_EXT
Gibt die tatsächliche Größe zurück, die intern verwendet wird, um die blaue Komponente der Palettendaten zu speichern.
GL_COLOR_TABLE_ALPHA_SIZE_EXT
Gibt die tatsächliche Größe zurück, die intern verwendet wird, um die Alphakomponente der Palettendaten zu speichern.

params

Verweist auf die durch den pname-Parameter angegebenen Farbtabellenparameterdaten.

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 gezielte Texturpaletten festgelegt sind. Außerdem können Sie diese Funktionen 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 das Format oder die 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 null. 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 Breitesparameter mit glColorTableEXT übereinstimmt. Wenn die abgerufene Breite null ist, ist die Farbtabellenanforderung von glColorTable fehlgeschlagen. Wenn die abgerufene Breite nicht null 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 Standardmäßigen OpenGL-Bibliothek sind, aber Teil der GL_EXT_paletted_texture Erweiterung sind. Um zu überprüfen, ob Ihre Implementierung von OpenGL glGetColorTableParameterivEXT und glGetColorTableParameterfvEXT unterstützt, rufen Sie glGetString(GL_EXTENSIONS) auf. Wenn es GL_EXT_paletted_texture zurückgibt, werden glGetColorTableParameterivEXT und glGetColorTableParameterfvEXT unterstützt. Rufen Sie wglGetProcAddress auf, um die Funktionsadresse einer Erweiterungsfunktion abzurufen.

Requirements (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

Siehe auch

glColorSubTableEXT

glColorTableEXT

glGetColorTableEXT

glGetColorTableParameterivEXT

wglGetProcAddress