glCopyColorSubTable: Unterschied zwischen den Versionen
Aus DGL Wiki
Flash (Diskussion | Beiträge) (Bitte korrekturlesen (Die Indexberechnung ist total seltsam)) |
Flo (Diskussion | Beiträge) (Ueberarbeitet unter benutzung der Orginal Spezifikationen) |
||
| Zeile 1: | Zeile 1: | ||
= glCopyColorSubTable = | = glCopyColorSubTable = | ||
| − | + | ||
| + | |||
== Name == | == Name == | ||
'''glCopyColorSubTable''' - Überschreibt einen Teil einer Farbtabelle. | '''glCopyColorSubTable''' - Überschreibt einen Teil einer Farbtabelle. | ||
| − | + | ||
| + | |||
== Delphi-Spezifikation == | == Delphi-Spezifikation == | ||
| − | procedure ''' | + | procedure '''glCopyColorSubTable'''(''target'': TGLenum; |
''start'': TGLsizei; | ''start'': TGLsizei; | ||
''x'': TGLint; ''y'': TGLint; | ''x'': TGLint; ''y'': TGLint; | ||
| − | '' | + | ''count'': TGLsizei); |
| − | + | == Orginal-Spezifikation == | |
| + | void '''CopyColorSubTable''' (enum ''target'', | ||
| + | sizei ''start'', | ||
| + | int ''x'', | ||
| + | int ''y'', | ||
| + | sizei ''count''); | ||
== Parameter == | == Parameter == | ||
| Zeile 22: | Zeile 29: | ||
|- | |- | ||
! ''start'' | ! ''start'' | ||
| − | | Der Index des Tabelleneintrages von dem ab die Tabelle überschrieben werden soll. | + | | Der Index des Tabelleneintrages von dem ab die Tabelle überschrieben werden soll. (der erste Index ist 0) |
|- | |- | ||
! ''x, y'' | ! ''x, y'' | ||
| Die Fenstercoordinaten der linken Ecke der Pixelzeile welche in die Tabelle kopiert werden soll. | | Die Fenstercoordinaten der linken Ecke der Pixelzeile welche in die Tabelle kopiert werden soll. | ||
|- | |- | ||
| − | ! '' | + | ! ''count'' |
| Die Anzahl der Tabelleneinträge die überschrieben werden sollen. | | Die Anzahl der Tabelleneinträge die überschrieben werden sollen. | ||
|} | |} | ||
| − | + | ||
== Beschreibung == | == 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 + | + | '''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 + count - 1''. Dieser Abschnitt darf nicht größer sein, als die ursprünglich definierte Größe der Farbtabelle. Es ist kein Fehler einen Abschnitt der Länge 0 zu überschreiben, allerdings hat ein solches Vorgehen keinerlei Wirkung. |
| + | |||
| + | |||
| − | |||
== Hinweise == | == 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. | '''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 == | == Fehlermeldungen == | ||
| − | '''GL_INVALID_VALUE''' wird generiert wenn ''target'' keine vorher definierte Farbtabelle ist. | + | * '''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 ''target'' ein ungültiger Wert übergeben wurde. |
| − | '''GL_INVALID_VALUE''' wird generiert wenn ''start'' + '' | + | * '''GL_INVALID_VALUE''' wird generiert wenn ''start'' + ''count'' > ''width'' ist. |
| − | '''GL_INVALID_OPERATION''' wird generiert wenn '''glCopyColorSubTable''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird. | + | * '''GL_INVALID_OPERATION''' wird generiert wenn '''glCopyColorSubTable''' innerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird. |
| + | |||
| − | |||
== Zugehörige Wertrückgaben == | == Zugehörige Wertrückgaben == | ||
| Zeile 54: | Zeile 62: | ||
[[glGetColorTableParameter]] | [[glGetColorTableParameter]] | ||
| − | + | ||
| + | |||
== Siehe auch == | == Siehe auch == | ||
Version vom 8. Januar 2006, 11:22 Uhr
Inhaltsverzeichnis
glCopyColorSubTable
Name
glCopyColorSubTable - Überschreibt einen Teil einer Farbtabelle.
Delphi-Spezifikation
procedure glCopyColorSubTable(target: TGLenum;
start: TGLsizei;
x: TGLint; y: TGLint;
count: TGLsizei);
Orginal-Spezifikation
void CopyColorSubTable (enum target,
sizei start,
int x,
int y,
sizei count);
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. (der erste Index ist 0) |
| x, y | Die Fenstercoordinaten der linken Ecke der Pixelzeile welche in die Tabelle kopiert werden soll. |
| count | 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 + count - 1. Dieser Abschnitt darf nicht größer sein, als die ursprünglich definierte Größe der Farbtabelle. Es ist kein Fehler einen Abschnitt der Länge 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 + count > 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
