glTexSubImage2D
Inhaltsverzeichnis
glTexSubImage2D
Name
glTexSubImage2D - Legt ein zweidimensionales Subimage fest.
Delphi-Spezifikation
procedure glTexSubImage2D(target : GLenum;
level : GLint;
xoffset : GLint; yoffset : GLint;
width : GLsizei; height : GLsizei;
format : GLenum; type : GLenum;
pixels : const ^GLvoid)
Parameter
| target | Gibt die Zieltextur an. Muss GL_TEXTURE_2D sein. |
|---|---|
| level | Gibt die LOD-Nummer an. Level 0 ist die Standardtextur. Level n ist die n-te Mipmap-Textur. |
| xoffset | Gibt den Texel-Offset-Wert innerhalb des Texturarrays in x-Richtung an. |
| yoffset | Gibt den Texel-Offset-Wert innerhalb des Texturarrays in y-Richtung an. |
| width | Gibt die Breite des Subimages an. |
| height | Gibt die Höhe des Subimages an. |
| format | Gibt das Format der Pixeldaten an. Die folgenden Werte sind erlaubt:
GL_COLOR_INDEX, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_BGR, GL_RGBA, GL_BGRA, GL_LUMINANCE und GL_LUMINANCE_ALPHA. |
| type | Gibt den Datentyp der Pixeldaten an. Die folgenden Werte sind erlaubt:
GL_BITMAP, GL_UNSIGNED_BYTE, GL_BYTE, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, GL_FLOAT, GL_UNSIGNED_BYTE_3_3_2_EXT, GL_UNSIGNED_BYTE_2_3_3_REV_EXT, GL_UNSIGNED_SHORT_5_6_5_EXT, GL_UNSIGNED_SHORT_5_6_5_REV_EXT, GL_UNSIGNED_SHORT_4_4_4_4_EXT, GL_UNSIGNED_SHORT_4_4_4_4_REV_EXT, GL_UNSIGNED_SHORT_5_5_5_1_EXT, GL_UNSIGNED_SHORT_1_5_5_5_REV_EXT, GL_UNSIGNED_INT_8_8_8_8_EXT, GL_UNSIGNED_INT_8_8_8_8_REV_EXT, GL_UNSIGNED_INT_10_10_10_2_EXT und GL_UNSIGNED_INT_2_10_10_10_REV_EXT. |
| pixels | Pointer zu den zu transferierenden Bilddaten im Speicher |
Beschreibung
Texturierung mapt festgelegte Teile einer angegebenen Textur auf jedes graphische Primitiv für das Texturierung aktiviert ist. Um zweidimensionales Texturieren zu aktivieren bzw. zu deaktivieren, rufe man glEnable bzw. glDisable mit dem Argument GL_TEXTURE_2D auf.
glTexSubImage2D definiert einen Teil einer vorliegenden zweidimensionalen Textur neu.
Die Texel, die durch pixels angegeben werden, ersetzen den Teil des vorliegenden Textur-Arrays mit den Positionen x bei xoffset bis xoffset + width - 1 und y bei yoffset bis yoffset + height - 1. Dieser Bereich muss nicht alle Texel enthalten, die im ursprünglichen Texturarray lagen. Es ist nicht falsch wenn man eine Sub-Textur mit einer Breite (oder Höhe) von 0 festlegt, aber das hat keinen Effekt.
Hinweise
glTexSubImage2D wird nur ab der OpenGL-Version 1.1 oder höher unterstützt.
Texturierung hat keinen Effekt, wenn man sich im Colorindex-Modus befindet.
glPixelStore und glPixelTransfer beeinflussen die Texturen genauso, wie sie es bei glDrawPixels tun.
Die Formate GL_BGR und GL_BGRA und die Typen 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 sind nur verfügbar, wenn die OpenGL-Version 1.2 oder höher ist.
Wenn die GL_ARB_multitexture-Extension unterstützt wird, dann legt glTexSubImage2D eine zweidimensionale Subtextur für die aktuelle Textureinheit - angegeben mit glActiveMultiTextureARB - fest.
Wenn die GL_ARB_imaging'-Extension unterstützt wird, dann müssen die RGBA-Pixel, die in pixels angesteuert werden, durch die Imaging-Pipeline verarbeitetet werden. Siehe dazu glTexImage2D.
Fehlermeldungen
GL_INVALID_ENUM wird generiert, wenn target nicht vom Typ GL_TEXTURE_2D ist.
GL_INVALID_OPERATION wird generiert, wenn das Textur-Array nicht durch eine vorhergehende glTexImage2D-Ausführung erzeugt wurde.
GL_INVALID_VALUE wird generiert, wenn level kleiner 0 ist.
GL_INVALID_VALUE könnte generiert werden wenn level größer als 
ist, wobei max der Wert von GL_MAX_TEXTURE_SIZE ist.
GL_INVALID_VALUE wird generiert wenn einer der folgenden Fälle eintritt:
- wobei gilt:
- w ist GL_TEXTURE_WIDTH,
- h ist GL_TEXTURE_HEIGHT,
- b ist die Randbreite (border width, GL_TEXTURE_BORDER) des Texturbildes was modifiziert wird,
- l ist 2 wenn GL_INTERLACE_EXT aktiviert wurde.
- w und h enthalten die doppelte Randbreite.
GL_INVALID_VALUE wird generiert, wenn width oder height kleiner als 0 ist.
GL_INVALID_ENUM wird generiert, wenn format keine akzeptable Konstante zugewiesen ist.
GL_INVALID_ENUM wird generiert, wenn type keine akzeptable Konstante zugewiesen ist.
GL_INVALID_ENUM wird generiert, wenn type GL_BITMAP und format nicht GL_COLOR_INDEX ist.
GL_INVALID_OPERATION wird generiert, wenn glTexSubImage2D innerhalb eines glBegin-glEnd Blocks aufgerufen wird.
GL_INVALID_OPERATION wird generiert, wenn type nicht GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_BYTE_2_3_3_REV, GL_UNSIGNED_SHORT_5_6_5 oder GL_UNSIGNED_SHORT_5_6_5_REV und format nicht GL_RGB ist.
GL_INVALID_OPERATION wird generiert, wenn type 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 oder GL_UNSIGNED_INT_2_10_10_10_REV und format weder GL_RGBA noch GL_BGRA ist.
Zugehörige Wertrückgaben
glGetTexImage
glIsEnabled mit Token GL_TEXTURE_1D
Siehe auch
glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawPixels, glEnable, glFog, glGetTexImage, glIsEnabled, glPixelStore, glPixelTransfer, glTexEnv, glTexGen, glTexImage1D, glTexImage2D, glTexSubImage1D, glTexSubImage3D, glTexImage2D, glTexParameter
