glColorSubTable

glColorSubTable

Name

glColorSubTable - Verändert einen Teil einer Farbtabelle

Delphi-Spezifikation

procedure glColorSubTable(target : GLenum; start : GLsizei; count : GLsizei;
                          format : GLenum; type : GLenum; const data : PGLvoid)

Parameter

target	Muss eine der folgenden Konstanten sein: GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE oder GL_POST_COLOR_MATRIX_COLOR_TABLE.
start	Der Anfang des Teils der Farbtabelle, der ersetzt werden soll. (Ein Index.)
count	Die Anzahl der zu ersetzenden Tabelleneinträge.
format	Das Format der Pixeldaten in data. Zulässig sind 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 data. Zulässig sind GL_UNSIGNED_BYTE, GL_BYTE, 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.
data	Pointer auf ein eindimensionales Array mit Pixeldaten, die zum Ersetzen des angegebenen Bereichs verarbeitet werden.

Beschreibung

glColorSubTable wird verwendet, um einen Teil einer Tabelle zu ersetzen, die vorher mit glColorTable erstellt wurde. Die Pixel, auf die mit data verwiesen wird, ersetzen den von start bis start + count - 1 reichenden Teil der Tabelle. Dieser Bereich schließt keine Einträge außerhalb der ursprünglichen Größe der Farbtabelle ein.

Es wird kein Fehler erzeugt, wenn man count gleich 0 setzt, allerdings hätte ein solcher Aufruf keine Wirkung.

Hinweise

glColorSubTable 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 keinen der zulässigen Werte hat.

GL_INVALID_VALUE wird generiert, wenn start + count größer als width ist.

GL_INVALID_ENUM wird generiert, wenn format keinen der zulässigen Werte hat.

GL_INVALID_ENUM wird generiert, wenn type keinen der zulässigen Werte hat.

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

Zugehörige Wertrückgaben

glGetColorTable, glGetColorTableParameter

Siehe auch

glColorTable, glColorTableParameter, glCopyColorTable, glCopyColorSubTable, glGetColorTable