glGetColorTableParameter

glGetColorTableParameter

Name

glGetColorTableParameter - dient zur Abfrage der verschiedenen Farblookuptabellen-Parameter.

Delphi-Spezifikation

procedure glGetColorTableParameterfv(target: TGLenum; pname: TGLenum;
                                     params: PGLfloat);
procedure glGetColorTableParameteriv(target: TGLenum; pname: TGLenum;
                                     params: PGLint);

Parameter

target	Gibt den symbolischen Namen der Farbtabelle an, dessen Parameter abgefragt werden sollen. Erlaubte Werte sind GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE, GL_POST_COLOR_MATRIX_COLOR_TABLE, GL_PROXY_COLOR_TABLE, GL_PROXY_POST_CONVOLUTION_COLOR_TABLE oder GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE.
pname	Gibt den symbolischen Namen des Farbtabellen-Parameters an, der abgefragt werden soll. Akzeptierte Werte sind GL_COLOR_TABLE_SCALE, GL_COLOR_TABLE_BIAS, GL_COLOR_TABLE_FORMAT, GL_COLOR_TABLE_WIDTH, GL_COLOR_TABLE_RED_SIZE, GL_COLOR_TABLE_GREEN_SIZE, GL_COLOR_TABLE_BLUE_SIZE, GL_COLOR_TABLE_ALPHA_SIZE, GL_COLOR_TABLE_LUMINANCE_SIZE und GL_COLOR_TABLE_INTENSITY_SIZE.
params	Ein Zeiger auf ein Array, indem die Parameterwerte abgespeichert werden.

Beschreibung

Liefert die konkreten Parameter zur Farbtabelle target.

Wenn pname auf GL_COLOR_TABLE_SCALE oder GL_COLOR_TABLE_BIAS gesetzt ist, gibt glGetColorTableParameter die Skalierung- oder Bias-Parameter für die durch target definierte Farbtabelle zurück. Für diese Abfragen muss target auf GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE oder GL_POST_COLOR_MATRIX_COLOR_TABLE gesetzt sein und params auf ein Array von vier Elementen zeigen, welches die Skalierungs- und Biasfaktoren für Rot, Grün, Blau und Alpha in dieser Reihenfolge erhält.

glGetColorTableParameter kann auch benutzt werden um die Grössen- und Formatparameter einer Farbtabelle zu erhalten. Setze für diese Abfragen target entweder auf das Farbtabellenziel oder das Proxy-Farbtabellenziel. Die Grössen- und Formatparameter werden durch glColorTable gesetzt.

Die folgende Tabelle listet die Format- und Grössenparameter, die abgefragt werden können, auf. Für jede symbolische Konstante, die unten für pname aufgelistet ist, muss params auf ein Array der gegebenen Länge zeigen und die angegebenen Werte empfangen.

GL_COLOR_TABLE_FORMAT

Internes Format (z.B. GL_RGBA)

GL_COLOR_TABLE_WIDTH

Anzahl der Tabellenlemente.

GL_COLOR_TABLE_RED_SIZE

Grösse der roten Komponente, in Bits.

GL_COLOR_TABLE_GREEN_SIZE

Grösse der grünen Komponente.

GL_COLOR_TABLE_BLUE_SIZE

Grösse der blauen Komponente.

GL_COLOR_TABLE_ALPHA_SIZE

Grösse der Alpha-Komponente.

GL_COLOR_TABLE_LUMINANCE_SIZE

Grösse der Helligkeits-Komponente.

GL_COLOR_TABLE_INTENSITY_SIZE

Grösse der Intensitäts-Komponente.

Hinweise

Die Funktion glGetColorTableParameter ist erst ab OpenGL Version 1.2 verfügbar.

glGetColorTableParameter ist nur verfügbar, falls GL_ARB_imaging beim Aufruf der Funktion glGetString mit dem Argument GL_EXTENSIONS zurückgegeben wird.

Wenn ein Fehler durch die Funktion ausgelöst wird, werden keine Veränderungen am Inhalt von params durchgeführt.

Fehlermeldungen

GL_INVALID_ENUM wird generiert wenn target oder pname ungültige Werte übergeben werden.
GL_INVALID_OPERATION wird generiert wenn glGetColorTableParameter innerhalb eines glBegin-glEnd Blocks aufgerufen wird.

Siehe auch

glColorSubTable, glColorTable, glColorTableParameter, glCopyColorSubTable, glCopyColorTable, glGetColorTable