glTexSubImage3D

glTexSubImage3D

Name

glTexSubImage3D - Legt ein dreidimensionales Subimage fest.

Delphi-Spezifikation

procedure glTexSubImage3D(target : GLenum;
                          level : GLint;
                          xoffset : GLint; yoffset : GLint; zoffset : GLint;
                          width : GLsizei; height : GLsizei; depth : GLsizei;
                          format : GLenum;  type : GLenum;
                          pixels : const ^GLvoid)

Parameter

target	Gibt die Zieltextur an. Muss GL_TEXTURE_3D 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.
zoffset	Gibt den Texel-Offset-Wert innerhalb des Texturarrays in z-Richtung an.
width	Gibt die Breite des Subimages an.
height	Gibt die Höhe des Subimages an.
depth	Gibt die Tiefe 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	Gibt den Pointer zu den Bilddaten im Speicher aus.

Beschreibung

Die Funktion zeichnet festgelegte Teile einer angegebenen Textur auf alle Polygone, für die Texturierung aktiviert ist. Um eindimensionales Texturieren zu aktivieren bzw. zu deaktivieren, ruge man glEnable bzw. glDisable mit dem Argument GL_TEXTURE_3D auf.

glTexSubImage3D definiert einen Teil einer vorliegenden eindimensionalen 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, y bei yoffset bis yoffset + height - 1 und z bei zoffset bis zoffset + depth - 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 von 0 festlegt, aber das hat keinen Effekt.

Hinweise

glTexSubImage3D wird nur ab der OpenGL-Version 1.2 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 glTexSubImage3D eine dreidimensionale Subtextur für die aktuelle Textureinheit an - 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 glTexImage3D.

Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn target nicht vom Typ GL_TEXTURE_3D ist.

GL_INVALID_OPERATION wird generiert, wenn das Textur-Array nicht durch eine vorhergehende glTexImage3D-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,
• d ist GL_TEXTURE_DEPTH,
• b ist die Randbreite (border width, GL_TEXTURE_BORDER) des Texturbildes was modifiziert wird,
• l ist 2 wenn GL_INTERLACE_EXT aktiviert wurde.
• w, h und d 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 glTexSubImage3D 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_3D

Siehe auch

glActiveTextureARB, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glCopyTexSubImage3D, glDrawPixels, glPixelStore, glPixelTransfer, glTexEnv, glTexGen, glTexImage1D, glTexImage2D, glTexImage3D, glTexSubImage1D, glTexSubImage2D, glTexParameter