glTexSubImage3D - Versionsgeschichte

DGLBot: Bot: konvertiere/korrigiere

2006-04-22T18:24:53Z

Bot: konvertiere/korrigiere

DGLBot: Bot: repariere tote Links zu Bildern

2005-12-08T21:22:02Z

Bot: repariere tote Links zu Bildern

DGLBot: GlTexSubImage3D wurde nach glTexSubImage3D verschoben

2005-12-05T19:31:37Z

GlTexSubImage3D wurde nach glTexSubImage3D verschoben

Flash: /* Fehlermeldungen */

2005-10-18T13:50:34Z

‎Fehlermeldungen

2005-10-18T13:48:50Z

La Boda: /* Beschreibung */

2005-09-30T18:39:00Z

‎Beschreibung

Flash: /* Delphi-Spezifikation */

2005-09-30T13:04:45Z

‎Delphi-Spezifikation

2005-09-30T13:01:23Z

La Boda am 30. September 2005 um 13:01 Uhr

2005-09-30T13:01:11Z

Neue Seite

= 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 ==

{| border="1" rules="all"
! ''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 falschm 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 log2(max) (max = '''GL_MAX_TEXTURE_SIZE''') ist. 

'''GL_INVALID_VALUE''' wird generiert, wenn ''xoffset'' kleiner als -b ist oder wenn ''(xoffset + width)'' kleiner ist als ''(w - b)'' (w = '''GL_TEXTURE_WIDTH''', b = '''GL_TEXTURE_BORDER'''). Man beachte, dass w zweimal so groß ist wie b. 

'''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 [[glIsEnabledt#GL_TEXTURE_3D|GL_TEXTURE_3D]]

 

== Siehe auch ==
[[glActiveTextureARB]], [[glCopyTexImage1D]], [[glCopyTexImage2D]], [[glCopyTexSubImage1D]], [[glCopyTexSubImage2D]], [[glCopyTexSubImage3D]], [[glDrawPixels]], [[glPixelStore]], [[glPixelTransfer]], [[glTexEnv]], [[glTexGen]], [[glTexImage1D]], [[glTexImage2D]], [[glTexImage3D]], [[glTexSubImage1D]], [[glTexSubImage2D]], [[glTexParameter]]

 
[[Kategorie:GL|TexSubImage3D]]

@@ Zeile 91: / Zeile 91: @@
 '''GL_INVALID_VALUE''' wird generiert wenn einer der folgenden Fälle eintritt:
-:*[[Bild:xoffset_b.png]]
+:*[[Bild:Xoffset_b.png]]
-:*[[Bild:xoffset_width.png]]
+:*[[Bild:Xoffset_width.png]]
-:*[[Bild:yoffset_b.png]]
+:*[[Bild:Yoffset_b.png]]
-:*[[Bild:yoffset_lheight.png]]
+:*[[Bild:Yoffset_lheight.png]]
-:*[[Bild:zoffset_b.png]]
+:*[[Bild:Zoffset_b.png]]
-:*[[Bild:zoffset_depth.png]]
+:*[[Bild:Zoffset_depth.png]]
 wobei gilt:

@@ Zeile 88: / Zeile 88: @@
 '''GL_INVALID_VALUE''' wird generiert, wenn ''level'' kleiner 0 ist.<br>
-'''GL_INVALID_VALUE''' könnte generiert werden, wenn ''level'' größer als log2(max) (max = '''GL_MAX_TEXTURE_SIZE''') ist.<br>
+'''GL_INVALID_VALUE''' könnte generiert werden wenn ''level'' größer als [[Bild:Log_2_max.png]] ist, wobei ''max'' der Wert von '''GL_MAX_TEXTURE_SIZE''' ist. <br>
-'''GL_INVALID_VALUE'''  wird generiert, wenn ''xoffset'' kleiner als -b ist oder wenn ''(xoffset + width)'' kleiner ist als ''(w - b)'' (w = '''GL_TEXTURE_WIDTH''', b = '''GL_TEXTURE_BORDER'''). Man beachte, dass w zweimal so groß ist wie b.<br>
+'''GL_INVALID_VALUE''' wird generiert wenn einer der folgenden Fälle eintritt:
 '''GL_INVALID_VALUE''' wird generiert, wenn ''width'' oder ''height'' kleiner als 0 ist.<br>

@@ Zeile 110: / Zeile 110: @@
 ==  Zugehörige Wertrückgaben ==
 [[glGetTexImage]]<br>
-[[glIsEnabled]] mit Token [[glIsEnabledt#GL_TEXTURE_3D|GL_TEXTURE_3D]]
+[[glIsEnabled]] mit Token [[glIsEnabled#GL_TEXTURE_3D|GL_TEXTURE_3D]]
 <br>

@@ Zeile 62: / Zeile 62: @@
 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.<br>
 <br>
-[[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 falschm wenn man eine Sub-Textur mit einer Breite von 0 festlegt, aber das hat keinen Effekt.<br>
+[[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.<br>
 <br>
 == Hinweise ==
 [[glTexSubImage3D]] wird nur ab der OpenGL-Version 1.2 oder höher unterstützt.<br>

@@ Zeile 1: / Zeile 1: @@
 = glTexSubImage3D =
-<br>
 == Name ==
 '''glTexSubImage3D''' - Legt ein dreidimensionales Subimage fest.
-<br>
 == Delphi-Spezifikation ==
@@ Zeile 15: / Zeile 17: @@
                             ''pixels'' : '''const''' ^GLvoid)
-<br>
 == Parameter ==
@@ Zeile 57: / Zeile 60: @@
 |}
-<br>
 == Beschreibung ==
@@ Zeile 64: / Zeile 68: @@
 [[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.<br>
-<br>
 == Hinweise ==
@@ Zeile 79: / Zeile 84: @@
 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]].<br>
-<br>
 == Fehlermeldungen ==
 '''GL_INVALID_ENUM''' wird generiert, wenn ''target'' nicht vom Typ '''GL_TEXTURE_3D''' ist.
@@ Zeile 120: / Zeile 126: @@
 '''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.
-<br>
 ==  Zugehörige Wertrückgaben ==
@@ Zeile 126: / Zeile 133: @@
 [[glIsEnabled]] mit Token [[glIsEnabled#GL_TEXTURE_3D|GL_TEXTURE_3D]]
-<br>
 == Siehe auch ==
 [[glActiveTextureARB]], [[glCopyTexImage1D]], [[glCopyTexImage2D]], [[glCopyTexSubImage1D]],    [[glCopyTexSubImage2D]], [[glCopyTexSubImage3D]], [[glDrawPixels]], [[glPixelStore]], [[glPixelTransfer]],   [[glTexEnv]], [[glTexGen]], [[glTexImage1D]], [[glTexImage2D]], [[glTexImage3D]], [[glTexSubImage1D]], [[glTexSubImage2D]], [[glTexParameter]]
-<br>
 [[Kategorie:GL|TexSubImage3D]]

← Nächstältere Version	Version vom 5. Dezember 2005, 19:31 Uhr
(kein Unterschied)

@@ Zeile 8: / Zeile 8: @@
 == Delphi-Spezifikation ==
-  procedure '''glTexSubImage3D'''(
+  procedure '''glTexSubImage3D'''(''target'' : GLenum;
- ''target'' : GLenum;
+                           ''level'' : GLint;
- ''level'' : GLint;
+                           ''xoffset'' : GLint; ''yoffset'' : GLint; ''zoffset'' : GLint;
- ''xoffset'' : GLint;
+                           ''width'' : GLsizei; ''height'' : GLsizei; ''depth'' : GLsizei;
- ''yoffset'' : GLint;
+                           ''format'' : GLenum;  ''type'' : GLenum;
- ''zoffset'' : GLint;
+                           ''pixels'' : '''const''' ^GLvoid)
 <br>