glTexSubImage1D

Aus DGL Wiki
Wechseln zu: Navigation, Suche

glTexSubImage1D

Name

glTexSubImage1D - Legt ein eindimensionales Subimage fest.


Delphi-Spezifikation

procedure glTexSubImage1D(target : GLenum; 
                          level : GLint; 
                          xoffset : GLint;
                          width : GLsizei; 
                          format : GLenum; type : GLenum; 
                          pixels : const ^GLvoid)



Parameter

target Gibt die Zieltextur an. Muss GL_TEXTURE_1D 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.
width Gibt die Breite 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_LUMINANCE, GL_LUMINANCE_ALPHA, GL_RGB, GL_RGBA, GL_BGR_EXT, GL_BGRA_EXT, GL_ARGB_I3D, GL_422_EXT, GL_422_REV_EXT, GL_422_AVERAGE_EXT und GL_422_REV_AVERAGE_EXT.
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, rufe man glEnable bzw. glDisable mit dem Argument GL_TEXTURE_1D auf.

glTexSubImage1D 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 eingeschlossen. Dieser Bereich muss nicht alle Texel enthalten, die im ursprünglichen Texturarray lagen. Es ist nicht falschm wenn man eine Sub-Textur mit einer Breite von 0 festlegt, aber das hat keinen Effekt.


Hinweise

glTexSubImage1D 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.


Extensions

Einige Befehle und Konstanten dieser Funktion sind Teil einer Extension und nicht Teil des Standard-OpenGL-Befehlsangebots. Folgende Extension-Bezeichnungen müssen in dem String enthalten sein, den glGetString mit dem Argument GL_EXTENSION zurückliefert, um diese Befehle und Konstanten zu benutzen.

GL_EXT_422_pixels
L_422_EXT, GL_422_REV_EXT, GL_422_AVERAGE_EXT und GL_422_REV_AVERAGE_EXT sind Teil der EXT_422_pixels-Extension.
GL_I3D_argb
GL_ARGB_I3D ist Teil der GL_I3D_argb-Extension
GL_EXT_bgra
GL_BGR_EXT und GL_BGRA_EXT sind Teil der EXT_bgra-Extension.
GL_EXT_packed_pixels
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 sind Teil der EXT_packed_pixels-Extension.


Fehlermeldungen

GL_INVALID_ENUM wird generiert, wenn target nicht einen der erlaubten Werte hat.

GL_INVALID_OPERATION wird generiert, wenn das Textur-Array nicht durch eine vorhergehende glTexImage1D-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)
wobei gilt:
  • w ist GL_TEXTURE_WIDTH,
  • b ist die Randbreite (border width, GL_TEXTURE_BORDER) des Texturbildes was modifiziert wird,
  • w enthält die doppelte Randbreite.

GL_INVALID_VALUE wird generiert, wenn width 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 glTexSubImage innerhalb eines glBegin-glEnd-Blocks aufgerufen wird.


Zugehörige Wertrückgaben

glGetTexImage

glIsEnabled mit Token GL_TEXTURE_1D


Siehe auch

glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawPixels, glPixelStore, glPixelTransfer, glTexEnv, glTexGen, glTexImage1D, glTexImage2D, glTexImage3D, glTexParameter, glTexSubImage2D, glTexSubImage3D, glTexSubImage3D