glTexParameter: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
(→‎Hinweise)
()
Zeile 1: Zeile 1:
−
{{Unvollständig}}
 
 
= glTexParameter =
 
= glTexParameter =
  
Zeile 59: Zeile 58:
  
 
'''GL_TEXTURE_MIN_FILTER'''
 
'''GL_TEXTURE_MIN_FILTER'''
−
<b><i>
+
: Die Texturen-Verkleinerungsfunktion wird immer dann genutzt, wenn der zu texturierende Pixel auf eine Fläche gemappt wird, die größer als ein Texturenelement ist. Es gibt sechs definierte Verkleinerungsfunktionen, zwei davon nutzen den nächsten bzw. die nächsten vier Texturenelemente um den Texturenwert zu berechnen. Die anderen vier benutzen [[MipMaps]].
−
: The texture minifying function is used whenever the pixel being textured maps to an area greater than one texture element. There are six defined minifying functions. Two of them use the nearest one or nearest four texture elements to compute the texture value. The other four use mipmaps.
+
 
−
: A mipmap is an ordered set of arrays representing the same image at progressively lower resolutions. If the texture has dimensions 2^nx2^m there are max(n, m) + 1 mipmaps. The first mipmap is the original texture, with dimensions 2^nx2^m. Each subsequent mipmap has dimensions 2^k (-1) x2^l (-1) where 2^kx2^l are the dimensions of the previous mipmap, until either k = 0 or l = 0. At that point, subsequent mipmaps have dimension 1x2^l-1 or 2^k-1x1 until the final mipmap, which has dimension 1x1. Mipmaps are defined using glTexImage1D or glTexImage2D with the level-of-detail argument indicating the order of the mipmaps. Level 0 is the original texture; level bold max(n, m) is the final 1x1 mipmap.
+
: Eine [[MipMaps|MipMap]] ist ein sortierter Satz von Bildern, der das selbe Bild in progressiv kleineren Auflösungen darstellt. Wenn die Texturendimension 2^n * 2^n entsprocht, gibt es Maximum(n, m) + 1 [[MipMaps]]. Die erste [[MipMaps|MipMap]] ist die original Textur, deren Dimension 2^n * 2^n* beträgt. Jede folgende [[MipMaps|MipMap]] entspricht dann der Dimension 2^k(-1) * 2^l(-1), wobei 2^k * 2^l die Dimension der vorherigen [[MipMaps|MipMap]] darstellen. Dies wird solange vollzogen bis entweder k oder l gleich 0 ist. Ab dieem Punkt haben folgende [[MipMaps]] Dimensionen vom Format 1*2^l-1 oder 2^k-1*1, bis zur finalen Mipmap, die 1*1 Pixel groß ist. [[MipMaps]] werden über [[glTexImage1D]] oder [[glTexImage2D]] über den Detaillevel-Parameter spezifiziert. Level 0 ist die original Textur, Level Maximum(n, m) ist dann die finale 1*1 [[MipMaps|MipMap]]. Mittels der [[glu]]-Bibliothek lassen sich [[MipMaps]] übrigens direkt generieren, dazu gibt es die Befehle [[gluBuild1DMipMaps]] bzw. [[gluBuild2DMipMaps]].
−
</i></b>
 
  
 
:''params'' liefert folgende Funktionen zur Verkleinerung von Texturen. Dies wären:
 
:''params'' liefert folgende Funktionen zur Verkleinerung von Texturen. Dies wären:
Zeile 70: Zeile 68:
  
 
:'''GL_LINEAR'''
 
:'''GL_LINEAR'''
−
<b><i>
+
:: Liefert den gewichteten Mittelwert der vier Texturenelemente die dem Zentrum des zu texturierenden Pixels am nächsten liegen. Dies kann Randpixel-Elemente einschliessen, je nachdem wie '''GL_TEXTURE_WRAP_S''' und '''GL_TEXTURE_WRAP_T''' eingestellt sind.
−
:: Returns the weighted average of the four texture elements that are closest to the center of the pixel being textured. These can include border texture elements, depending on the values of GL_TEXTURE_WRAP_S and GL_TEXTURE_WRAP_T, and on the exact mapping.  
+
 
−
</i></b>
 
 
:'''GL_NEAREST_MIPMAP_NEAREST'''
 
:'''GL_NEAREST_MIPMAP_NEAREST'''
−
<b><i>
+
:: Wählt die [[MipMaps|MipMap]], die der Größe des zu texturierenden Pixels am besten entspricht, und nutzt die Kriterien von '''GL_NEAREST''' um den Texturenwert zu generieren.
−
:: Chooses the mipmap that most closely matches the size of the pixel being textured and uses the GL_NEAREST criterion (the texture element nearest to the center of the pixel) to produce a texture value.  
+
 
−
</i></b>
 
 
:'''GL_LINEAR_MIPMAP_NEAREST'''
 
:'''GL_LINEAR_MIPMAP_NEAREST'''
−
<b><i>
+
:: Wählt die [[MipMaps|MipMap]], die der Größe des zu texturierenden Pixels am besten entspricht, und nutzt die Kriterien von '''GL_LINEAR''' um den Texturenwert zu generieren.
−
:: Chooses the mipmap that most closely matches the size of the pixel being textured and uses the GL_LINEAR criterion (a weighted average of the four texture elements that are closest to the center of the pixel) to produce a texture value.  
+
 
−
</i></b>
 
 
:'''GL_NEAREST_MIPMAP_LINEAR'''
 
:'''GL_NEAREST_MIPMAP_LINEAR'''
−
<b><i>
+
:: Wählt die zwei [[MipMaps]], die der Größe des zu texturierenden Pixels am besten entsprechen, und nutzt die Kriterien von '''GL_NEAREST''' um Texturenwerte aus jeder [[MipMaps|MipMap]] zu generieren. Der endgültige Texturenwert ist das gewichtete Mittel aus diesen beiden Werten.
−
:: Chooses the two mipmaps that most closely match the size of the pixel being textured and uses the GL_NEAREST criterion (the texture element nearest to the center of the pixel) to produce a texture value from each mipmap. The final texture value is a weighted average of those two values.  
+
 
−
</i></b>
 
 
:'''GL_LINEAR_MIPMAP_LINEAR'''
 
:'''GL_LINEAR_MIPMAP_LINEAR'''
−
<b><i>
+
:: Wählt die zwei [[MipMaps]], die der Größe des zu texturierenden Pixels am besten entsprechen, und nutzt die Kriterien von '''GL_LINEAR''' um Texturenwerte aus jeder [[MipMaps|MipMap]] zu generieren. Der endgültige Texturenwert ist das gewichtete Mittel aus diesen beiden Werten.
−
:: Chooses the two mipmaps that most closely match the size of the pixel being textured and uses the GL_LINEAR criterion (a weighted average of the four texture elements that are closest to the center of the pixel) to produce a texture value from each mipmap. The final texture value is a weighted average of those two values.
+
 
−
</i></b>
+
: Je mehr Texturenelemente im Verkleinerungsprozess genutzt werden, desto weniger Kantenartifakte werden sichtbar. Während '''GL_NEAREST''' und '''GL_LINEAR'''-Verkleinerungsfunktionen schneller als die anderen sind, ermitteln sie nur einen bzw. vier Texturenwerte um den endgültigen Texturenwert des zu texturierenden Pixels zu ermitteln, wodurch eher Moiré-Muster oder rauhe Übergänge entstehen. Voreinstellung für '''GL_TEXTURE_MIN_FILTER''' ist '''GL_NEAREST_MIPMAP_LINEAR'''.
  
−
<b><i>
 
−
:As more texture elements are sampled in the minification process, fewer aliasing artifacts will be apparent. While the GL_NEAREST and GL_LINEAR minification functions can be faster than the other four, they sample only one or four texture elements to determine the texture value of the pixel being rendered and can produce moire patterns or ragged transitions. The default value of GL_TEXTURE_MIN_FILTER is GL_NEAREST_MIPMAP_LINEAR.
 
−
</i></b>
 
  
 
'''GL_TEXTURE_MAG_FILTER '''
 
'''GL_TEXTURE_MAG_FILTER '''
Zeile 99: Zeile 90:
  
 
: '''GL_NEAREST'''
 
: '''GL_NEAREST'''
−
<b><i>
 
 
:: Liefert den Wert des Texturelements, welches am nächsten (in [[Manhattendistanz]]) zum Zentrum des zu texturierenden Pixels liegt.
 
:: Liefert den Wert des Texturelements, welches am nächsten (in [[Manhattendistanz]]) zum Zentrum des zu texturierenden Pixels liegt.
−
</i></b>
+
 
 
: '''GL_LINEAR'''
 
: '''GL_LINEAR'''
−
<b><i>
+
:: Liefert den gewichteten Mittelwert der vier Teexturenelemente zurück, die dem Zentrum des zu texturierenden Pixels am nächsten sind. Dies kann Randpixel-Elemente einschliessen, je nachdem wie '''GL_TEXTURE_WRAP_S''' und '''GL_TEXTURE_WRAP_T''' eingestellt sind.
−
:: Returns the weighted average of the four texture elements that are closest to the center of the pixel being textured. These can include border texture elements, depending on the values of GL_TEXTURE_WRAP_S and GL_TEXTURE_WRAP_T, and on the exact mapping.
+
−
: GL_NEAREST is generally faster than GL_LINEAR, but it can produce textured images with sharper edges because the transition between texture elements is not as smooth. The default value of GL_TEXTURE_MAG_FILTER is GL_LINEAR.  
+
: '''GL_NEAREST''' ist im Normalfall schneller als '''GL_LINEAR''', aber produziert auch Bilder mit schärferen Kanten, da der Übergang zwischen den Texturelementen nicht so weich ist. Voreinstellung für '''GL_TEXTURE_MAG_FILTER''' ist '''GL_LINEAR'''.
−
</i></b>
+
 
  
 
'''GL_TEXTURE_WRAP_S '''
 
'''GL_TEXTURE_WRAP_S '''
−
<b><i>
+
: Setzt den Umwicklungsparameter für die Texturkoordiante s auf entweder '''GL_CLAMP'' oder '''GL_REPEAT'''. Mit '''GL_CLAMP''' wird die s-Koordinate auf die Reichweite [0,1] beschränkt, und ist nützlich wenn Umwicklungsartifakte beim Mapping eines einzelnen Bildes auf ein Objekt vermieden werden sollen. '''GL_REPEAT''' ignoriert den Ganzzahlanteil der s-Koordinate, genutzt wird also nur der Nachkommateil, wodurch ein Wiederholungsmuster entsteht. Randtexturenelemente werden nur dann genutzt, wenn Umwicklung auf '''GL_CLAMP''' gesetzt wird. Voreinstellung für '''GL_TEXTURE_WRAP_S''' ist '''GL_REPEAT'''.
−
: Sets the wrap parameter for texture coordinate s to either GL_CLAMP or GL_REPEAT. GL_CLAMP causes s coordinates to be clamped to the range [0,1] and is useful for preventing wrapping artifacts when mapping a single image onto an object. GL_REPEAT causes the integer part of the s coordinate to be ignored; the GL uses only the fractional part, thereby creating a repeating pattern. Border texture elements are accessed only if wrapping is set to GL_CLAMP. Initially, GL_TEXTURE_WRAP_S is set to GL_REPEAT.  
+
 
−
</i></b>
 
  
 
'''GL_TEXTURE_WRAP_T'''
 
'''GL_TEXTURE_WRAP_T'''
−
<b><i>
+
: Setzt den Umwicklungsparameter für die Texturkoordinate auf entweder '''GL_CLAMP'' oder '''GL_REPEAT'''. Siehe obiges Kapitel für eine genauere Erklärung. Voreinstellung für '''GL_TEXTURE_WRAP_T''' ist '''GL_REPEAT'''.
−
: Sets the wrap parameter for texture coordinate t to either GL_CLAMP or GL_REPEAT. See the discussion under GL_TEXTURE_WRAP_S. Initially, GL_TEXTURE_WRAP_T is set to GL_REPEAT.  
+
 
−
</i></b>
 
  
 
'''GL_TEXTURE_BORDER_COLOR '''
 
'''GL_TEXTURE_BORDER_COLOR '''
−
<b><i>
+
: Setzt die Randfarbe. Der Parameter ''params'' enthält vier Werte, die den RGBA-Farbwert für den Texturenrand darstellen. Ganzzahlfarbwerte werden linear interpretiert, so dass der höchste positive Ganzzahlwert auf 1.0 gemappt wird, und der negativste Wert auf -1.0. Die Werte werden dann auf den Bereich [0,1] beschränkt. Voreinstellung für die Randfarbe ist (0, 0, 0, 0).
−
: Sets a border color. The params parameter contains four values that comprise the RGBA color of the texture border. Integer color components are interpreted linearly such that the most positive integer maps to 1.0, and the most negative integer maps to -1.0. The values are clamped to the range [0,1] when they are specified. Initially, the border color is (0, 0, 0, 0).
 
−
</i></b>
 
  
 
<br>
 
<br>
−
 
 
== Hinweise ==
 
== Hinweise ==
 
Angenommen Texturen sind aktiviert (durch Aufruf von [[glEnable]] mit dem Argument '''GL_TEXTURE_1D, GL_TEXTURE_2D''' oder '''GL_TEXTURE_3D''') und GL_TEXTURE_MIN_FILTER ist auf eine der Funktionen gesetzt, die eine Mipmap benötigen. <br>
 
Angenommen Texturen sind aktiviert (durch Aufruf von [[glEnable]] mit dem Argument '''GL_TEXTURE_1D, GL_TEXTURE_2D''' oder '''GL_TEXTURE_3D''') und GL_TEXTURE_MIN_FILTER ist auf eine der Funktionen gesetzt, die eine Mipmap benötigen. <br>

Version vom 10. Dezember 2004, 12:24 Uhr

glTexParameter


Name

glTexParameter Funktionen - setzen Textureigenschaften.


Delphi-Spezifikation

procedure glTexParameterf(target: TGLenum; pname: TGLenum; param: TGLfloat);
procedure glTexParameteri(target: TGLenum; pname: TGLenum; param: TGLint);


Parameter

target Bestimmt die Zieltextur welche GL_TEXTURE_1D, GL_TEXTURE_2D oder GL_TEXTURE_3D sein kann.
pname Bestimmt den symbolischen Namen eines Parameters der einen Einzelwert enthält. Folgende Werte werden akzeptiert:
GL_TEXTURE_MIN_FILTER, GL_TEXTURE_MAG_FILTER, GL_TEXTURE_WRAP_S, oder GL_TEXTURE_WRAP_T.
param Enthält den Wert für pname.


Delphi-Spezifikation

procedure glTexParameterfv(target: TGLenum; pname: TGLenum; const params: PGLfloat);
procedure glTexParameteriv(target: TGLenum; pname: TGLenum; const params: PGLint);


Parameter

target Bestimmt die Zieltextur welche GL_TEXTURE_1D, GL_TEXTURE_2D oder GL_TEXTURE_3D sein kann.
pname Bestimmt den symbolischen Namen eines Parameters der einen Einzelwert enthält. Folgende Werte werden akzeptiert:
GL_TEXTURE_MIN_FILTER, GL_TEXTURE_MAG_FILTER, GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T oder GL_TEXTURE_BORDER_COLOR.
params Ist ein Zeiger auf ein Feld welches die oder den Wert für pname enthält.


Beschreibung

Texturmapping ist eine Technik die Bilder (oder Ausschnitte von Bildern) auf die Oberfläche von Objekten "aufklebt". Man kann sich dies tatsächlich so vorstellen wie das aufkleben von Tapeten an Wände. Das Bild wir im Texturenraum, welcher über ein (s,t) Koordinatensystem verfügt, erstellt. Eine Textur ist ein ein-, zwei- und mittlerweile auch dreidimensionales Bild inklusive einiger Parameter die bestimmen wie Texturen/Texturausschnitte aus dem Bild gewonnen werden sollen.

Mit der Funktion glTexParameter kann man den mit pname ausgewiesenen Parametern die Werte zuweisen, die man über params spezifiziert hat. target wiederum definiert den Typ der Zieltextur. Als Werte werden GL_TEXTURE_1D, GL_TEXTURE_2D oder GL_TEXTURE_3D akzeptiert. Die folgenden symbolischen Werte kann man dem Parameter pname zuweisen:

GL_TEXTURE_MIN_FILTER

Die Texturen-Verkleinerungsfunktion wird immer dann genutzt, wenn der zu texturierende Pixel auf eine Fläche gemappt wird, die größer als ein Texturenelement ist. Es gibt sechs definierte Verkleinerungsfunktionen, zwei davon nutzen den nächsten bzw. die nächsten vier Texturenelemente um den Texturenwert zu berechnen. Die anderen vier benutzen MipMaps.
Eine MipMap ist ein sortierter Satz von Bildern, der das selbe Bild in progressiv kleineren Auflösungen darstellt. Wenn die Texturendimension 2^n * 2^n entsprocht, gibt es Maximum(n, m) + 1 MipMaps. Die erste MipMap ist die original Textur, deren Dimension 2^n * 2^n* beträgt. Jede folgende MipMap entspricht dann der Dimension 2^k(-1) * 2^l(-1), wobei 2^k * 2^l die Dimension der vorherigen MipMap darstellen. Dies wird solange vollzogen bis entweder k oder l gleich 0 ist. Ab dieem Punkt haben folgende MipMaps Dimensionen vom Format 1*2^l-1 oder 2^k-1*1, bis zur finalen Mipmap, die 1*1 Pixel groß ist. MipMaps werden über glTexImage1D oder glTexImage2D über den Detaillevel-Parameter spezifiziert. Level 0 ist die original Textur, Level Maximum(n, m) ist dann die finale 1*1 MipMap. Mittels der glu-Bibliothek lassen sich MipMaps übrigens direkt generieren, dazu gibt es die Befehle gluBuild1DMipMaps bzw. gluBuild2DMipMaps.
params liefert folgende Funktionen zur Verkleinerung von Texturen. Dies wären:
GL_NEAREST
Liefert den Wert des Texturelements, welches am nächsten (in Manhattendistanz) zum Zentrum des zu texturierenden Pixels liegt.
GL_LINEAR
Liefert den gewichteten Mittelwert der vier Texturenelemente die dem Zentrum des zu texturierenden Pixels am nächsten liegen. Dies kann Randpixel-Elemente einschliessen, je nachdem wie GL_TEXTURE_WRAP_S und GL_TEXTURE_WRAP_T eingestellt sind.
GL_NEAREST_MIPMAP_NEAREST
Wählt die MipMap, die der Größe des zu texturierenden Pixels am besten entspricht, und nutzt die Kriterien von GL_NEAREST um den Texturenwert zu generieren.
GL_LINEAR_MIPMAP_NEAREST
Wählt die MipMap, die der Größe des zu texturierenden Pixels am besten entspricht, und nutzt die Kriterien von GL_LINEAR um den Texturenwert zu generieren.
GL_NEAREST_MIPMAP_LINEAR
Wählt die zwei MipMaps, die der Größe des zu texturierenden Pixels am besten entsprechen, und nutzt die Kriterien von GL_NEAREST um Texturenwerte aus jeder MipMap zu generieren. Der endgültige Texturenwert ist das gewichtete Mittel aus diesen beiden Werten.
GL_LINEAR_MIPMAP_LINEAR
Wählt die zwei MipMaps, die der Größe des zu texturierenden Pixels am besten entsprechen, und nutzt die Kriterien von GL_LINEAR um Texturenwerte aus jeder MipMap zu generieren. Der endgültige Texturenwert ist das gewichtete Mittel aus diesen beiden Werten.
Je mehr Texturenelemente im Verkleinerungsprozess genutzt werden, desto weniger Kantenartifakte werden sichtbar. Während GL_NEAREST und GL_LINEAR-Verkleinerungsfunktionen schneller als die anderen sind, ermitteln sie nur einen bzw. vier Texturenwerte um den endgültigen Texturenwert des zu texturierenden Pixels zu ermitteln, wodurch eher Moiré-Muster oder rauhe Übergänge entstehen. Voreinstellung für GL_TEXTURE_MIN_FILTER ist GL_NEAREST_MIPMAP_LINEAR.


GL_TEXTURE_MAG_FILTER

Die Textur-Vergrößerungsfunktion wird benutzt wenn das zu texturierenden Pixel durch eine Fläche, die größer oder gleich einem Texturelement ist, texturiert werden soll.
Die Funktion kann dabei auf einen der folgenden Werte gesetzt werden:
GL_NEAREST
Liefert den Wert des Texturelements, welches am nächsten (in Manhattendistanz) zum Zentrum des zu texturierenden Pixels liegt.
GL_LINEAR
Liefert den gewichteten Mittelwert der vier Teexturenelemente zurück, die dem Zentrum des zu texturierenden Pixels am nächsten sind. Dies kann Randpixel-Elemente einschliessen, je nachdem wie GL_TEXTURE_WRAP_S und GL_TEXTURE_WRAP_T eingestellt sind.
GL_NEAREST ist im Normalfall schneller als GL_LINEAR, aber produziert auch Bilder mit schärferen Kanten, da der Übergang zwischen den Texturelementen nicht so weich ist. Voreinstellung für GL_TEXTURE_MAG_FILTER ist GL_LINEAR.


GL_TEXTURE_WRAP_S

Setzt den Umwicklungsparameter für die Texturkoordiante s auf entweder GL_CLAMP oder GL_REPEAT'. Mit GL_CLAMP wird die s-Koordinate auf die Reichweite [0,1] beschränkt, und ist nützlich wenn Umwicklungsartifakte beim Mapping eines einzelnen Bildes auf ein Objekt vermieden werden sollen. GL_REPEAT ignoriert den Ganzzahlanteil der s-Koordinate, genutzt wird also nur der Nachkommateil, wodurch ein Wiederholungsmuster entsteht. Randtexturenelemente werden nur dann genutzt, wenn Umwicklung auf GL_CLAMP gesetzt wird. Voreinstellung für GL_TEXTURE_WRAP_S ist GL_REPEAT.


GL_TEXTURE_WRAP_T

Setzt den Umwicklungsparameter für die Texturkoordinate auf entweder GL_CLAMP oder GL_REPEAT'. Siehe obiges Kapitel für eine genauere Erklärung. Voreinstellung für GL_TEXTURE_WRAP_T ist GL_REPEAT.


GL_TEXTURE_BORDER_COLOR

Setzt die Randfarbe. Der Parameter params enthält vier Werte, die den RGBA-Farbwert für den Texturenrand darstellen. Ganzzahlfarbwerte werden linear interpretiert, so dass der höchste positive Ganzzahlwert auf 1.0 gemappt wird, und der negativste Wert auf -1.0. Die Werte werden dann auf den Bereich [0,1] beschränkt. Voreinstellung für die Randfarbe ist (0, 0, 0, 0).


Hinweise

Angenommen Texturen sind aktiviert (durch Aufruf von glEnable mit dem Argument GL_TEXTURE_1D, GL_TEXTURE_2D oder GL_TEXTURE_3D) und GL_TEXTURE_MIN_FILTER ist auf eine der Funktionen gesetzt, die eine Mipmap benötigen.
Wenn entweder die Ausmaße des aktuellen Texturbildes (zuvor gesetzt durch Aufruf von glTexImage1D oder glTexImage2D) nicht den Anforderungen für Mipmaps genügen oder weniger Texturbilder als nötig definiert sind oder das Texturenset abweichende Anzahlen von Texturkomponenten hat, wirkt sich das aus, als ob Texturmapping deaktiviert wäre.

Lineare Filterung greift nur in 2D-Texturen auf die vier nächsten Texturelemente zu. Bei 1D-Texturen greift Lineare Filterung auf die zwei nächsten Texturelemente zu.

Fehlermeldungen

GL_INVALID_Enum wird generiert wenn target oder pname kein gültiger Wert übergeben wurde, oder wenn params einen definierten, konstanten Wert (basierend auf den Wert von pname) erwartet und diesen nicht bekommt.
GL_INVALID_OPERATION wird generiert wenn glTexParameter innerhalb eines glBegin-glEnd Blocks aufgerufen wird.


Zugehörige Wertrückgaben

glGetTexParameter
glGetTexLevelParameter


Siehe auch

glTexEnv, glTexImage1D, glTexImage2D, glTexGen

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