glGetColorTable: Unterschied zwischen den Versionen
(→Name) |
DGLBot (Diskussion | Beiträge) K (GlGetColorTable wurde nach glGetColorTable verschoben) |
(kein Unterschied)
| |
Aktuelle Version vom 5. Dezember 2005, 20:27 Uhr
Inhaltsverzeichnis
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
