glColorSubTable: Unterschied zwischen den Versionen
Flo (Diskussion | Beiträge) K (→Siehe auch) |
Flash (Diskussion | Beiträge) K (leichte umformulierung ;)) |
||
| Zeile 36: | Zeile 36: | ||
== Beschreibung == | == 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 Farb-Tabelle ein. Es wird kein Fehler erzeugt, wenn man ''count'' gleich 0 setzt, | + | '''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 Farb-Tabelle ein. |
| + | |||
| + | Es wird kein Fehler erzeugt, wenn man ''count'' gleich 0 setzt, allerdings hätte ein solcher Aufruf keine Wirkung. | ||
== Hinweise == | == Hinweise == | ||
| − | '''glColorSubTable''' ist nur verfügbar, wenn '''GL_ARB_imaging''' von [[glGetString]] mit dem Argmument '''GL_EXTENSIONS''' zurückgeliefert wird. | + | '''glColorSubTable''' ist nur verfügbar, wenn '''GL_ARB_imaging''' von [[glGetString]] bei einem Aufruf mit dem Argmument '''GL_EXTENSIONS''' zurückgeliefert wird. |
Version vom 23. November 2005, 06:19 Uhr
Inhaltsverzeichnis
glColorSubTable
Name
glColorSubTable - Verändert einen Teil einer Farb-Tabelle
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 Farb-Tabelle, 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 Farb-Tabelle 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
