glCompressedTexImage - Versionsgeschichte

Openglerf: Ausserdem -> Außerdem

2012-03-21T14:56:44Z

Ausserdem -> Außerdem

Thoronador: Kategorisierung

2011-06-18T17:37:18Z

Kategorisierung

Shaijan: Kategorie GL3 hinzugefügt

2011-06-15T19:46:05Z

Kategorie GL3 hinzugefügt

Dj3hut1: Links auf glTexImage ausgetauscht

2009-04-29T10:12:09Z

Links auf glTexImage ausgetauscht

Flash: /* Siehe auch */

2007-04-15T23:37:14Z

‎Siehe auch

DGLBot: Bot: konvertiere/korrigiere

2006-04-22T18:18:51Z

Bot: konvertiere/korrigiere

Dj3hut1: Schreibweise eines Links korrigiert

2006-04-10T15:43:26Z

Schreibweise eines Links korrigiert

Dj3hut1: /* Hinweise */ -> kleine Ergänzung

2006-04-08T14:32:12Z

‎Hinweise: -> kleine Ergänzung

Dj3hut1: neu erstellt

2006-04-08T13:01:28Z

neu erstellt

Neue Seite

= glCompressedTexImage =

 
== Name ==
'''glCompressedTexImage''' - Lädt eine komprimierte Textur direkt.

 
== Spezifikation ==
procedure '''glCompressedTexImage1D'''(''target'': TGLenum; ''level'': TGLint;
''internalformat'': TGLenum; ''width'': TGLsizei;
''border'': TGLint; ''imageSize'': TGLsizei;
'''const''' ''data'': PGLvoid); 
procedure '''glCompressedTexImage2D'''(''target'': TGLenum; ''level'': TGLint;
''internalformat'': TGLenum; ''width'': TGLsizei;
''height'': TGLsizei; ''border'': TGLint;
''imageSize'': TGLsizei; '''const''' ''data'': PGLvoid); 
procedure '''glCompressedTexImage3D'''(''target'': TGLenum; ''level'': TGLint;
''internalformat'': TGLenum; ''width'': TGLsizei;
''height: TGLsizei; ''depth'': TGLsizei;
''border'': TGLint; ''imageSize'': TGLsizei;
'''const''' ''data'': PGLvoid); 

== Parameter ==
{| border="1" rules="all"
! ''target''
| Gibt die Zieltextur an. Muss für '''glCompressedTexImage1D''' '''GL_TEXTURE_1D''', für '''glCompressedTexImage2D''' '''GL_TEXTURE_2D''' und für '''glCompressedTexImage3D''' '''GL_TEXTURE_3D''' sein. Für [[Cubemap|Cubemaps]] sind ausserdem die symbolischen Konstanten '''GL_TEXTURE_CUBE_MAP_POSITIVE_X''', '''GL_TEXTURE_CUBE_MAP_NEGATIVE_X''', '''GL_TEXTURE_CUBE_MAP_POSITIVE_Y''', '''GL_TEXTURE_CUBE_MAP_NEGATIVE_Y''', '''GL_TEXTURE_CUBE_MAP_POSITIVE_Z''' und '''GL_TEXTURE_CUBE_MAP_NEGATIVE_Z''' erlaubt.
|-
! ''level''
| Gibt den Detailgrad für die gewünschte Textur an. 
''level'' '''0''' ist das Basisbild. Level n ist die n-te [[MipMaps|Mipmap]]-Reduzierung der Textur.
|-
! ''internalformat''
| Internes Format der komprimierten Texturdaten. Z.B. eine der symbolischen Konstanten '''GL_COMPRESSED_RGB_S3TC_DXT1''', '''GL_COMPRESSED_RGBA_S3TC_DXT1''', '''GL_COMPRESSED_RGBA_S3TC_DXT3''' oder '''GL_COMPRESSED_RGBA_S3TC_DXT5''' falls die [[OpenGL-Extensions|Extension]] [[GL_EXT_texture_compression_s3tc]] unterstützt wird.
|-
! ''width'',
| Breite = Anzahl der Pixel pro Zeile muss als Wert 2^n (+ 2 * (border) ) für n Integerwerte haben.
|-
! ''height'',
| Höhe = Anzahl der Zeilen muss als Wert 2^n (+ 2 * (border) ) für n Integerwerte haben
|-
! ''depth'',
| Tiefe = Anzahl der "Scheiben" muss als Wert 2^n (+ 2 * (border) ) für n Integerwerte haben
|-
! ''border'',
| Pixelbreite des Texturrahmens. (0 für keinen Rahmen)
|-
! ''imageSize''
| Anzahl der Bytes der komprimierten Daten.
|-
! ''_data''
| Die komprimierten Texturdaten.
|}

 

== Beschreibung ==
Die Befehle '''glCompressedTexImage*D''' werden benutzt, um Texturdaten direkt in komprimierter Form zu laden.
Diese Funktion wurde in OpenGL ab Version 1.3 eingeführt, um das Laden von Texturen zu verkürzen und um mehr Texturen auf der Grafikkarte abspeichern zu können.

Die Syntax der einzelnen Funktionen ist ähnlich wie bei den korrespondierenden Funktionen zu [[glTexImage]].

Mit den Parametern ''width'', ''height'' und ''depth'' kann die Breite, Höhe und Tiefe der Textur angegeben werden.

''internalFormat'' definiert das Format, mit dem die Texturdaten intern abgespeichert werden sollen, zur Zeit werden jedoch von OpenGL noch keine komprimierten Formate unterstützt.

Bisher ist es nur möglich über [[OpenGL-Extensions|Extensions]], wie z.B. [[GL_EXT_texture_compression_s3tc]], komprimierte Texturformate anzugeben :

'''GL_COMPRESSED_RGB_S3TC_DXT1'''
: RGB-Daten werden komprimiert, Alpha-Komponente ist immer 1.0.

'''GL_COMPRESSED_RGBA_S3TC_DXT1'''
: RGB-Daten werden komprimiert, Alpha-Komponente ist entweder 1.0 oder 0.0.

'''GL_COMPRESSED_RGBA_S3TC_DXT3'''
: RGB-Daten werden komprimiert, Alpha-Komponente wird mit 4 Bits gespeichert.

'''GL_COMPRESSED_RGBA_S3TC_DXT5'''
: RGB-Daten werden komprimiert, Alpha-Komponente ist gewichtetes Mittel von 8-Bit Werten.

Mit ''border'' wird die Breite des Rahmens der Textur in Pixel festgelegt.
Obwohl bei dem Befehl [[glTexImage]] die Rahmenbreiten 0, 1 und 2 Pixel auf jeden Fall unterstützt werden, muss dies bei komprimierten Texturformaten nicht unbedingt der Fall sein.

Über den Parameter ''imageSize'' gibt man die genaue Anzahl der Bytes an, die mit ''_data'' an die Funktion übergeben werden.

Um eine geladene Textur in OpenGL zu nutzen ist auf jeden Fall noch die entsprechende Aktivierung mit [[glEnable]]('''GL_TEXTURE_1D''', '''GL_TEXTURE_2D''' oder '''GL_TEXTURE_3D''') nötig.

 

== Hinweise ==
'''glCompressedTexImage''' ist erst ab OpenGL Version 1.3 oder höher nutzbar.

Mit [[glGetIntegerv]] und dem Parameter '''GL_COMPRESSED_TEXTURE_FORMATS''' kann ermittelt werden, welche komprimierten Texturformate von der OpenGL-Implementation unterstützt werden.

[[glPixelStore]] und [[glPixelTransfer]] beeinflussen nicht das Dekodieren einer komprimierten Textur.

Entsprechen die an die Funktion übergebenen Daten nicht dem Komprimierungformat, so verhält sich der Aufruf von '''glCompressedTexImage''' undefiniert.

Es ist darauf zu achten, das die Komprimierungsformate nicht für Zieltexturen unterstützt werden müssen (die meisten Komprimierungsformat unterstützen nur zweidimensionale Texturen).
Nähere Informationen findet man in der Spezifikation der jeweiligen Extension.

Texturierung hat im Farbindexmodus keinen Effekt.

Keine Fehlermeldungen werden generiert, wenn man beim Aufruf von '''glCompressedTexImage''' folgende Punkte beachtet :
* ''_data'' zeigt auf Daten, die man über die Funktion [[glGetCompressedTexImage]] bekommen hat.
* ''target'', ''level'' und ''internalformat'' stimmen mit den Parametern ''target'', ''level'' und ''format'' von [[glGetCompressedImage]] überein.
* ''width'', ''height'', ''depth'', ''border'', ''internalformat'' und ''imageSize'' stimmen mit den Werten überein die man über die Funktion [[glGetTexLevelParameter]] mit den Parametern '''GL_TEXTURE_WIDTH''', '''GL_TEXTURE_HEIGHT''', '''GL_TEXTURE_DEPTH''', '''GL_TEXTURE_BORDER''', '''GL_TEXTURE_INTERNAL_FORMAT''' und '''GL_TEXTURE_COMPRESSED_IMAGE_SIZE''' bekommt, nachdem [[glGetCompressedTexImage]] aufgerufen wurde.

 
== Fehlermeldungen ==

'''GL_INVALID_ENUM''' wird generiert, wenn ''target'' nicht '''GL_TEXTURE_1D, GL_TEXTURE_2D''' oder '''GL_TEXTURE_3D''' ist. (entsprechend der benutzten Funktion) 

'''GL_INVALID_ENUM''' wird generiert, wenn ''internalformat'' kein von der OpenGL-Implementierung unterstütztes komprimiertes Format ist. 

'''GL_INVALID_VALUE''' wird generiert, wenn ''level'' kleiner 0 oder größer ld(max) ist, wobei max der Rückgabewert von '''GL_MAX_TEXTURE_SIZE''' ist. (ld = Logarithmus Dualis = Basis 2). 

'''GL_INVALID_VALUE''' wird generiert, wenn ''width'', ''height'' bzw. ''depth'' (je nach Funktion) kleiner als 0 oder größer als 2 + '''GL_MAX_TEXTURE_SIZE''' ist, oder die Bedingung 2^k + 2 * (border) (k=Integerwerte) nicht erfüllt. 

'''GL_INVALID_VALUE''' wird generiert, wenn ''imageSize'' nicht der Anzahl der Bytes entspricht, die mit ''_data'' übergeben wurden.

'''GL_INVALID_VALUE''' wird generiert, wenn die übergebenen Daten nicht dem mit ''internalformat'' angegebenem Komprimierungsformat übereinstimmen.

'''GL_INVALID_VALUE''' wird generiert, wenn ''border'' keinen zulässigen Wert hat.

'''GL_INVALID_OPERATION''' wird generiert, wenn eine '''glCompressedTexImage'''-Funktion in einem [[glBegin]]- und [[glEnd]]-Block aufgerufen wird. 

'''GL_INVALID_OPERATION''' wird generiert, wenn das Komprimierungsformat nicht für die mit ''target'' angegebene Zieltextur unterstützt wird.

'''GL_INVALID_OPERATION''' wird generiert, wenn ''border'' > 0 und keine Texturränder vom Komprimierungsformat unterstützt werden.

== Zugehörige Wertrückgaben ==
[[glGetCompressedTexImage]] 
[[glGetTexLevelParameter]] 
[[glIsEnabled]] mit dem Token '''GL_TEXTURE_1D''', '''GL_TEXTURE_2D''' bzw. '''GL_TEXTURE_3D'''.

 

== Siehe auch ==
[[glCompressedTexSubImage1D]], [[glCompressedTexSubImage2D]], [[glCompressedTexSubImage3D]], [[glGetCompressedTexImage]], [[glTexCoord]], [[glTexEnv]], [[glTexGen]], [[glTexImage1D]], [[glTexImage2D]], [[glTexImage3D]], [[glTexParameter]]

[[Kategorie:GL|CompressedTexImage]]

@@ Zeile 136: / Zeile 136: @@
 == Zugehörige Wertrückgaben ==
-[[glGetCompressedTexImage]] <br>
+[[glGetCompressedTexImage]]
-[[glGetTexLevelParameter]] <br>
-[[glIsEnabled]] mit dem Token '''GL_TEXTURE_1D''', '''GL_TEXTURE_2D''' bzw. '''GL_TEXTURE_3D'''.
+[[glGetTexLevelParameter]]
@@ Zeile 147: / Zeile 149: @@
 [[Kategorie:GL|CompressedTexImage]]
-[[Kategorie:GL1.3]]
+[[Kategorie:GL1.3|CompressedTexImage]]
-[[Kategorie:GL3]]
+[[Kategorie:GL3|CompressedTexImage]]

← Nächstältere Version		Version vom 15. Juni 2011, 19:46 Uhr
Zeile 148:		Zeile 148:
	[[Kategorie:GL\|CompressedTexImage]]		[[Kategorie:GL\|CompressedTexImage]]
	[[Kategorie:GL1.3]]		[[Kategorie:GL1.3]]
		+	[[Kategorie:GL3]]

← Nächstältere Version		Version vom 15. April 2007, 23:37 Uhr
Zeile 147:		Zeile 147:

	[[Kategorie:GL\|CompressedTexImage]]		[[Kategorie:GL\|CompressedTexImage]]
		+	[[Kategorie:GL1.3]]

@@ Zeile 26: / Zeile 26: @@
 {| border="1" rules="all"
 ! ''target''
-| Gibt die Zieltextur an. Muss für '''glCompressedTexImage1D''' '''GL_TEXTURE_1D''', für '''glCompressedTexImage2D''' '''GL_TEXTURE_2D''' und für '''glCompressedTexImage3D''' '''GL_TEXTURE_3D''' sein. Für [[Cubemap|Cubemaps]] sind ausserdem die symbolischen Konstanten '''GL_TEXTURE_CUBE_MAP_POSITIVE_X''', '''GL_TEXTURE_CUBE_MAP_NEGATIVE_X''', '''GL_TEXTURE_CUBE_MAP_POSITIVE_Y''', '''GL_TEXTURE_CUBE_MAP_NEGATIVE_Y''', '''GL_TEXTURE_CUBE_MAP_POSITIVE_Z''' und '''GL_TEXTURE_CUBE_MAP_NEGATIVE_Z''' erlaubt.
+| Gibt die Zieltextur an. Muss für '''glCompressedTexImage1D''' '''GL_TEXTURE_1D''', für '''glCompressedTexImage2D''' '''GL_TEXTURE_2D''' und für '''glCompressedTexImage3D''' '''GL_TEXTURE_3D''' sein. Für [[Cubemap|Cubemaps]] sind außerdem die symbolischen Konstanten '''GL_TEXTURE_CUBE_MAP_POSITIVE_X''', '''GL_TEXTURE_CUBE_MAP_NEGATIVE_X''', '''GL_TEXTURE_CUBE_MAP_POSITIVE_Y''', '''GL_TEXTURE_CUBE_MAP_NEGATIVE_Y''', '''GL_TEXTURE_CUBE_MAP_POSITIVE_Z''' und '''GL_TEXTURE_CUBE_MAP_NEGATIVE_Z''' erlaubt.
 |-
 ! ''level''

@@ Zeile 61: / Zeile 61: @@
 Diese Funktion wurde in OpenGL ab Version 1.3 eingeführt, um das Laden von Texturen zu verkürzen und um mehr Texturen auf der Grafikkarte abspeichern zu können.
-Die Syntax der einzelnen Funktionen ist ähnlich wie bei den korrespondierenden Funktionen zu [[glTexImage]].
+Die Syntax der einzelnen Funktionen ist ähnlich wie bei den korrespondierenden Funktionen zu [[glTexImage1D]], [[glTexImage2D]] bzw. [[glTexImage3D]].
 Mit den Parametern ''width'', ''height'' und ''depth'' kann die Breite, Höhe und Tiefe der Textur angegeben werden.
@@ Zeile 82: / Zeile 82: @@
 Mit ''border'' wird die Breite des Rahmens der Textur in Pixel festgelegt.
-Obwohl bei dem Befehl [[glTexImage]] die Rahmenbreiten 0, 1 und 2 Pixel auf jeden Fall unterstützt werden, muss dies bei komprimierten Texturformaten nicht unbedingt der Fall sein.
+Obwohl bei den Befehlen [[glTexImage1D]], [[glTexImage2D]] bzw. [[glTexImage3D]] die Rahmenbreiten 0, 1 und 2 Pixel auf jeden Fall unterstützt werden, muss dies bei komprimierten Texturformaten nicht unbedingt der Fall sein.
 Über den Parameter ''imageSize'' gibt man die genaue Anzahl der Bytes an, die mit ''_data'' an die Funktion übergeben werden.

@@ Zeile 1: / Zeile 1: @@
 = glCompressedTexImage =
-<br>
 == Name ==
 '''glCompressedTexImage''' - Lädt eine komprimierte Textur direkt.
-<br>
 == Spezifikation ==
   procedure '''glCompressedTexImage1D'''(''target'': TGLenum; ''level'': TGLint;
@@ Zeile 52: / Zeile 54: @@
 |}
-<br>
 == Beschreibung ==
@@ Zeile 85: / Zeile 88: @@
 Um eine geladene Textur in OpenGL zu nutzen ist auf jeden Fall noch die entsprechende Aktivierung mit [[glEnable]]('''GL_TEXTURE_1D''', '''GL_TEXTURE_2D''' oder '''GL_TEXTURE_3D''') nötig.
-<br>
 == Hinweise ==
@@ Zeile 106: / Zeile 110: @@
 * ''width'', ''height'', ''depth'', ''border'', ''internalformat'' und ''imageSize'' stimmen mit den Werten überein die man über die Funktion [[glGetTexLevelParameter]] mit den Parametern '''GL_TEXTURE_WIDTH''', '''GL_TEXTURE_HEIGHT''', '''GL_TEXTURE_DEPTH''', '''GL_TEXTURE_BORDER''', '''GL_TEXTURE_INTERNAL_FORMAT''' und '''GL_TEXTURE_COMPRESSED_IMAGE_SIZE''' bekommt, nachdem [[glGetCompressedTexImage]] aufgerufen wurde.
-<br>
 == Fehlermeldungen ==
@@ Zeile 135: / Zeile 140: @@
 [[glIsEnabled]] mit dem Token '''GL_TEXTURE_1D''', '''GL_TEXTURE_2D''' bzw. '''GL_TEXTURE_3D'''.
-<br>
 == Siehe auch ==

@@ Zeile 103: / Zeile 103: @@
 Keine Fehlermeldungen werden generiert, wenn man beim Aufruf von '''glCompressedTexImage''' folgende Punkte beachtet :
 * ''_data'' zeigt auf Daten, die man über die Funktion [[glGetCompressedTexImage]] bekommen hat.
-* ''target'', ''level'' und ''internalformat'' stimmen mit den Parametern ''target'', ''level'' und ''format'' von [[glGetCompressedImage]] überein.
+* ''target'', ''level'' und ''internalformat'' stimmen mit den Parametern ''target'', ''level'' und ''format'' von [[glGetCompressedTexImage]] überein.
 * ''width'', ''height'', ''depth'', ''border'', ''internalformat'' und ''imageSize'' stimmen mit den Werten überein die man über die Funktion [[glGetTexLevelParameter]] mit den Parametern '''GL_TEXTURE_WIDTH''', '''GL_TEXTURE_HEIGHT''', '''GL_TEXTURE_DEPTH''', '''GL_TEXTURE_BORDER''', '''GL_TEXTURE_INTERNAL_FORMAT''' und '''GL_TEXTURE_COMPRESSED_IMAGE_SIZE''' bekommt, nachdem [[glGetCompressedTexImage]] aufgerufen wurde.

@@ Zeile 96: / Zeile 96: @@
 Entsprechen die an die Funktion übergebenen Daten nicht dem Komprimierungformat, so verhält sich der Aufruf von '''glCompressedTexImage''' undefiniert.
-Es ist darauf zu achten, das die Komprimierungsformate nicht für Zieltexturen unterstützt werden müssen (die meisten Komprimierungsformat unterstützen nur zweidimensionale Texturen).
+Es ist darauf zu achten, das die Komprimierungsformate nicht für alle Zieltexturen unterstützt werden müssen (die meisten Komprimierungsformat unterstützen nur zweidimensionale Texturen).
 Nähere Informationen findet man in der Spezifikation der jeweiligen Extension.
@@ Zeile 107: / Zeile 107: @@
 <br>
 == Fehlermeldungen ==