glGetTexLevelParameter: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
K (Wird offline bearbeitet)
 
(Version Hochgeladen)
Zeile 1: Zeile 1:
−
{{Offline}}
+
{{Unvollständig}}
 +
= glGetTexLevelParameter =
 +
 
 +
<br>
 +
== Name ==
 +
'''glGetTexLevelParameter''' - liefert Eigenschaften von Texturen für bestimmte Detailstufen. (LOD = Level Of Detail)
 +
 
 +
<br>
 +
== Delphi-Spezifikation ==
 +
procedure '''glGetTexLevelParameterfv'''(''target'': TGLenum; ''level'': TGLint; ''pname'': TGLenum; ''params'': PGLfloat);
 +
procedure '''glGetTexLevelParameteriv'''(''target'': TGLenum; ''level'': TGLint; ''pname'': TGLenum; ''params'': PGLint);
 +
 
 +
<br>
 +
== Parameter ==
 +
<table border=1 rules=all>
 +
<tr>
 +
<td>''target''</td>
 +
<td>Bestimmt den symbolischen Namen für die Zieltextur. ''target'' kann '''GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, GL_PROXY_TEXTURE_1D, GL_PROXY_TEXTURE_2D,''' oder '''GL_PROXY_TEXTURE_3D''' sein.</td>
 +
</tr>
 +
<tr>
 +
<td>''level''</td>
 +
<td>Bestimmt den Detailgrad für das gewünschte Bild. Level 0 ist dabei das Ausgangsbild. Level n ist die n-te Mipmap Reduktion des Bildes.</td>
 +
</tr>
 +
<tr>
 +
<td>''pname''</td>
 +
<td>Ist der symbolische Name des abzufragenden Texturparameters. Akzeptiert werden:<br>
 +
'''GL_TEXTURE_WIDTH, GL_TEXTURE_HEIGHT, GL_TEXTURE_COMPONENTS,''' und '''GL_TEXTURE_BORDER'''.</td>
 +
</tr>
 +
<tr>
 +
<td>''params''</td>
 +
<td>Enthält die abgefragten Daten.</td>
 +
</tr>
 +
</table>
 +
 
 +
<br>
 +
 
 +
== Beschreibung ==
 +
'''glGetTexLevelParameter''' liefert über ''params'' die Werte der Textureigenschaften bei einem bestimmten Detailgrad der über ''level'' spezifiziert wurde.
 +
''target'' definiert welcher Texturtyp abgefragt werden soll. Dieser kann '''GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, GL_PROXY_TEXTURE_1D, GL_PROXY_TEXTURE_2D,''' oder '''GL_PROXY_TEXTURE_3D''' sein.
 +
''pname'' definiert schlußendlich die Eigenschaft der Textur deren Werte abgefragt werden sollen.
 +
 
 +
<b><i>GL_MAX_TEXTURE_SIZE is not really descriptive enough. It has to report the largest square texture image that can be accommodated with mipmaps and borders, but a long skinny texture, or a texture without mipmaps and borders, may easily fit in texture memory. The proxy targets allow the user to more accurately query whether the GL can accommodate a texture of a given configuration. If the texture cannot be accommodated, the texture state variables, which may be queried with glGetTexLevelParameter, are set to 0. If the texture can be accommodated, the texture state values will be set as they would be set for a non-proxy target.</i></b>
 +
 
 +
Folgedne Werte können dabei ''pname'' übergeben werden:
 +
 
 +
'''GL_TEXTURE_WIDTH'''
 +
: ''params'' liefert einen einzelnen Wert, der die Breite der Textur inklusive Rand repräsentiert.
 +
: Der Initialzustand ist 0.
 +
 
 +
'''GL_TEXTURE_HEIGHT'''
 +
: ''params'' liefert einen einzelnen Wert, der die Höhe der Textur inklusive Rand repräsentiert.
 +
: Der Initialzustand ist 0.
 +
 
 +
'''GL_TEXTURE_DEPTH'''
 +
: ''params'' liefert einen einzelnen Wert, der die Höhe der Textur inklusive Rand repräsentiert.
 +
: Der Initialzustand ist 0.
 +
 
 +
'''GL_TEXTURE_INTERNAL_FORMAT'''
 +
: ''params'' liefert einen einzelnen Wert, der das interne Format der Textur repräsentiert.
 +
 
 +
'''GL_TEXTURE_BORDER'''
 +
: ''params'' liefert einen einzelnen Wert, der die Breite des Randes in Pixel repräsentiert.
 +
 
 +
'''GL_TEXTURE_RED_SIZE,
 +
GL_TEXTURE_GREEN_SIZE,
 +
GL_TEXTURE_BLUE_SIZE,
 +
GL_TEXTURE_ALPHA_SIZE,
 +
GL_TEXTURE_LUMINANCE_SIZE,
 +
GL_TEXTURE_INTENSITY_SIZE'''
 +
: <b><i>The internal storage resolution of an individual component. The resolution chosen by the GL will be a close match for the resolution requested by the user with the component argument of glTexImage1D, glTexImage2D, and glTexImage3DEXT. The initial value is 0.</i></b>
 +
: Der Initialzustand ist 0.
 +
 
 +
<br>
 +
== Hinweise ==
 +
Wenn während der Ausführung der Funktion ein Fehler auftritt, werden keine Veränderungen am Inhalt von ''params'' durchgeführt.
 +
 
 +
'''GL_TEXTURE_INTERNAL_FORMAT'' ist erst ab OpenGL 1.1 oder höher verfügbar. In der Version 1.0, können Sie '''GL_TEXTURE_COMPONENTS''' als Ersatz benutzen.
 +
 
 +
'''GL_PROXY_TEXTURE_1D''' and '''GL_PROXY_TEXTURE_2D'' sind erst ab OpenGL 1.1 oder höher verfügbar.
 +
 
 +
<br>
 +
== Fehlermeldungen ==
 +
'''GL_INVALID_ENUM''' wird generiert wenn ''target'' oder ''pname'' ein ungültiger Wert übergeben wird.<br>
 +
'''GL_INVALID_VALUE''' wird generiert wenn ''level'' kleiner 0 oder größer als ld(max) ist, wobei max der Rückgabewert von '''GL_MAX_TEXTURE_SIZE''' ist. (ld = Logarithmus Dualis = zur Basis 2)<br>
 +
'''GL_INVALID_OPERATION''' wird generiert wenn '''glGetTexLevelParameter''' inerhalb eines [[glBegin]]-[[glEnd]] Blocks aufgerufen wird.
 +
 
 +
<br>
 +
== Siehe auch ==
 +
[[glGetTexParameter]], [[glTexImage1D]], [[glTexImage2D]], [[glTexParameter]]
 +
 
 +
[[Kategorie:GL|GetTexLevelParameter]]

Version vom 8. September 2004, 23:49 Uhr

Hinweis: Dieser Artikel ist noch unvollständig.
(Mehr Informationen/weitere Artikel)

{{{1}}}
Incomplete.jpg

glGetTexLevelParameter


Name

glGetTexLevelParameter - liefert Eigenschaften von Texturen für bestimmte Detailstufen. (LOD = Level Of Detail)


Delphi-Spezifikation

procedure glGetTexLevelParameterfv(target: TGLenum; level: TGLint; pname: TGLenum; params: PGLfloat);
procedure glGetTexLevelParameteriv(target: TGLenum; level: TGLint; pname: TGLenum; params: PGLint);


Parameter

target Bestimmt den symbolischen Namen für die Zieltextur. target kann GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, GL_PROXY_TEXTURE_1D, GL_PROXY_TEXTURE_2D, oder GL_PROXY_TEXTURE_3D sein.
level Bestimmt den Detailgrad für das gewünschte Bild. Level 0 ist dabei das Ausgangsbild. Level n ist die n-te Mipmap Reduktion des Bildes.
pname Ist der symbolische Name des abzufragenden Texturparameters. Akzeptiert werden:
GL_TEXTURE_WIDTH, GL_TEXTURE_HEIGHT, GL_TEXTURE_COMPONENTS, und GL_TEXTURE_BORDER.
params Enthält die abgefragten Daten.


Beschreibung

glGetTexLevelParameter liefert über params die Werte der Textureigenschaften bei einem bestimmten Detailgrad der über level spezifiziert wurde. target definiert welcher Texturtyp abgefragt werden soll. Dieser kann GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, GL_PROXY_TEXTURE_1D, GL_PROXY_TEXTURE_2D, oder GL_PROXY_TEXTURE_3D sein. pname definiert schlußendlich die Eigenschaft der Textur deren Werte abgefragt werden sollen.

GL_MAX_TEXTURE_SIZE is not really descriptive enough. It has to report the largest square texture image that can be accommodated with mipmaps and borders, but a long skinny texture, or a texture without mipmaps and borders, may easily fit in texture memory. The proxy targets allow the user to more accurately query whether the GL can accommodate a texture of a given configuration. If the texture cannot be accommodated, the texture state variables, which may be queried with glGetTexLevelParameter, are set to 0. If the texture can be accommodated, the texture state values will be set as they would be set for a non-proxy target.

Folgedne Werte können dabei pname übergeben werden:

GL_TEXTURE_WIDTH

params liefert einen einzelnen Wert, der die Breite der Textur inklusive Rand repräsentiert.
Der Initialzustand ist 0.

GL_TEXTURE_HEIGHT

params liefert einen einzelnen Wert, der die Höhe der Textur inklusive Rand repräsentiert.
Der Initialzustand ist 0.

GL_TEXTURE_DEPTH

params liefert einen einzelnen Wert, der die Höhe der Textur inklusive Rand repräsentiert.
Der Initialzustand ist 0.

GL_TEXTURE_INTERNAL_FORMAT

params liefert einen einzelnen Wert, der das interne Format der Textur repräsentiert.

GL_TEXTURE_BORDER

params liefert einen einzelnen Wert, der die Breite des Randes in Pixel repräsentiert.

GL_TEXTURE_RED_SIZE, GL_TEXTURE_GREEN_SIZE, GL_TEXTURE_BLUE_SIZE, GL_TEXTURE_ALPHA_SIZE, GL_TEXTURE_LUMINANCE_SIZE, GL_TEXTURE_INTENSITY_SIZE

The internal storage resolution of an individual component. The resolution chosen by the GL will be a close match for the resolution requested by the user with the component argument of glTexImage1D, glTexImage2D, and glTexImage3DEXT. The initial value is 0.
Der Initialzustand ist 0.


Hinweise

Wenn während der Ausführung der Funktion ein Fehler auftritt, werden keine Veränderungen am Inhalt von params durchgeführt.

'GL_TEXTURE_INTERNAL_FORMAT ist erst ab OpenGL 1.1 oder höher verfügbar. In der Version 1.0, können Sie GL_TEXTURE_COMPONENTS als Ersatz benutzen.

'GL_PROXY_TEXTURE_1D and GL_PROXY_TEXTURE_2D sind erst ab OpenGL 1.1 oder höher verfügbar.


Fehlermeldungen

GL_INVALID_ENUM wird generiert wenn target oder pname ein ungültiger Wert übergeben wird.
GL_INVALID_VALUE wird generiert wenn level kleiner 0 oder größer als ld(max) ist, wobei max der Rückgabewert von GL_MAX_TEXTURE_SIZE ist. (ld = Logarithmus Dualis = zur Basis 2)
GL_INVALID_OPERATION wird generiert wenn glGetTexLevelParameter inerhalb eines glBegin-glEnd Blocks aufgerufen wird.


Siehe auch

glGetTexParameter, glTexImage1D, glTexImage2D, glTexParameter

Abgerufen von „https://wiki.delphigl.com/index.php?title=glGetTexLevelParameter&oldid=2473“