glColorSubTable

Aus DGL Wiki
Wechseln zu: Navigation, Suche

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