glGetColorTable

glGetColorTable

Name

glGetColorTable - Fragt Daten einer Farbtabelle ab

Delphi-Spezifikation

procedure glGetColorTable(target : GLenum; format : GLenum; type : GLenum;
                          const table : PGLvoid)

Parameter

target	Muss vom Typ GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE oder GL_POST_COLOR_MATRIX_COLOR_TABLE
format	Das Format der Pixeldaten in table. Zulässig sind die Werte GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_LUMINANCE, GL_LUMINANCE_ALPHA, GL_RGB, GL_BGR, GL_RGBA und GL_BGRA.
type	Der Typ der Pixeldaten in table. Die symbolischen Konstanten GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, GL_FLOAT, GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_BYTE_2_3_3_REV, GL_UNSIGNED_SHORT_5_6_5, GL_UNSIGNED_SHORT_5_6_5_REV, GL_UNSIGNED_SHORT_4_4_4_4, GL_UNSIGNED_SHORT_4_4_4_4_REV, GL_UNSIGNED_SHORT_5_5_5_1, GL_UNSIGNED_SHORT_1_5_5_5_REV, GL_UNSIGNED_INT_8_8_8_8, GL_UNSIGNED_INT_8_8_8_8_REV, GL_UNSIGNED_INT_10_10_10_2 und GL_UNSIGNED_INT_2_10_10_10_REV werden unterstützt.
table	Pointer auf ein eindimensionales Array mit Pixeldaten, das die Inhalte der Farbtabelle enthält.

Beschreibung

glGetColorTable gibt in table den Inhalt der Farbtabelle aus, die durch target angegeben wurde. Es werden keine Pixel-Transfer-Operationen durchgeführt, aber Pixelspeicher-Modi, die bei glReadPixels angewendet werden können, werden durchgefürht.

Farbkomponenten werden im angegebenen Format angefordert. Die Verknüpfungen zwischen den internen Farbkomponenten und den angeforderten Komponenten sind folgdendermaßen:

Interne Komponente	Resultierende Komponente
rot	rot
grün	grün
blau	blau
Alpha	Alpha
Beleuchtung	rot
Intensität	rot

Hinweise

glGetColorTable ist nur verfügbar, wenn GL_ARB_imaging von glGetString bei einem Aufruf mit dem Argmument GL_EXTENSIONS zurückgeliefert wird.

Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn target kein zulässiger Wert zugewiesen wurde.

GL_INVALID_ENUM wird generiert, wenn format kein zulässiger Wert zugewiesen wurde.

GL_INVALID_ENUM wird generiert, wenn type kein zulässiger Wert zugewiesen wurde.

GL_INVALID_OPERATION wird generiert, wenn type GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_BYTE_2_3_3_REV, GL_UNSIGNED_SHORT_5_6_5 oder GL_UNSIGNED_SHORT_5_6_5_REV und format gleichzeitig GL_RGB ist.

GL_INVALID_OPERATION wird generiert, wenn type GL_UNSIGNED_SHORT_4_4_4_4, GL_UNSIGNED_SHORT_4_4_4_4_REV, GL_UNSIGNED_SHORT_5_5_5_1, GL_UNSIGNED_SHORT_1_5_5_5_REV, GL_UNSIGNED_INT_8_8_8_8, GL_UNSIGNED_INT_8_8_8_8_REV, GL_UNSIGNED_INT_10_10_10_2 oder GL_UNSIGNED_INT_2_10_10_10_REV und format weder GL_RGBA noch GL_BGRA ist.

GL_INVALID_OPERATION wird generiert wenn glGetColorTable innerhalb eines glBegin-glEnd Blocks aufgerufen wird.

Siehe auch

glColorTable, glColorTableParameter, glGetColorTableParameter