glTexSubImage2D: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
K (Hinweise: Formatierungstippfehler korrigiert ('' vs. '''))
(Parameter: Falsche Beschreibung von pixels repariert)
 
Zeile 50: Zeile 50:
 
|-
 
|-
 
! ''pixels''
 
! ''pixels''
| Gibt den Pointer zu den Bilddaten im Speicher aus.
+
| Pointer zu den zu transferierenden Bilddaten im Speicher
 
|-
 
|-
 
|}
 
|}
 
 
 
  
 
== Beschreibung ==  
 
== Beschreibung ==  

Aktuelle Version vom 5. März 2013, 16:32 Uhr

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 Log 2 max.png ist, wobei max der Wert von GL_MAX_TEXTURE_SIZE ist.

GL_INVALID_VALUE wird generiert wenn einer der folgenden Fälle eintritt:

  • Xoffset b.png
  • Xoffset width.png
  • Yoffset b.png
  • Yoffset lheight.png
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