glColorSubTable: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
K (Siehe auch)
K (GlColorSubTable wurde nach glColorSubTable verschoben)
 
(2 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 3: Zeile 3:
  
 
== Name ==
 
== Name ==
'''glColorSubTable''' - Verändert einen Teil einer Farb-Tabelle
+
'''glColorSubTable''' - Verändert einen Teil einer Farbtabelle
  
  
Zeile 19: Zeile 19:
 
|-
 
|-
 
! ''start''  
 
! ''start''  
| Der Anfang des Teils der Farb-Tabelle, der ersetzt werden soll. (Ein Index.)
+
| Der Anfang des Teils der Farbtabelle, der ersetzt werden soll. (Ein Index.)
 
|-
 
|-
 
! ''count''
 
! ''count''
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, aber das macht keinen Sinn.
+
'''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 ==
 
== 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.
  
  

Aktuelle Version vom 5. Dezember 2005, 21:43 Uhr

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