glCopyColorSubTable

glCopyColorSubTable

Name

glCopyColorSubTable - Überschreibt einen Teil einer Farbtabelle.

Delphi-Spezifikation

procedure TglCopyColorSubTable(target: TGLenum; 
                               start: TGLsizei; 
                               x: TGLint; y: TGLint; 
                               width: TGLsizei);

Parameter

target	Muss einer der folgenden Werte sein: GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE oder GL_POST_COLOR_MATRIX_COLOR_TABLE
start	Der Index des Tabelleneintrages von dem ab die Tabelle überschrieben werden soll.
x, y	Die Fenstercoordinaten der linken Ecke der Pixelzeile welche in die Tabelle kopiert werden soll.
width	Die Anzahl der Tabelleneinträge die überschrieben werden sollen.

Beschreibung

glCopyColorSubTable wird benutzt um einen zusammenhängenden Teil einer Farbtabelle zu ersetzen. (Farbtabellen werden mittels glColorTable definiert.) Die Pixel welche aus dem Framebuffer kopiert werden ersetzen dabei die Tabelleneinträge mit den Indizes start bis start + x - 1. Dieser Abschnitt darf nicht größer sein, als die ursprünglich definierte Größe der Farbtabelle. Es ist kein Fehler einen Abschnitt der Breite 0 zu überschreiben, allerdings hat ein solches Vorgehen keinerlei Wirkung.

Hinweise

glCopyColorSubTable ist nur dann vorhanden, wenn GL_ARB_imaging in dem String enthalten ist, der von glGetString zurückgeliefert wird, wenn man diese Funktion mit dem Argument GL_EXTENSIONS aufruft.

Fehlermeldungen

GL_INVALID_VALUE wird generiert wenn target keine vorher definierte Farbtabelle ist.
GL_INVALID_VALUE wird generiert wenn target ein ungültiger Wert übergeben wurde.
GL_INVALID_VALUE wird generiert wenn start + x > width ist.
GL_INVALID_OPERATION wird generiert wenn glCopyColorSubTable innerhalb eines glBegin-glEnd Blocks aufgerufen wird.

Zugehörige Wertrückgaben

glGetColorTable
glGetColorTableParameter

Siehe auch

glColorSubTable, glColorTableParameter, glCopyColorTable, glGetColorTable