Función glTexParameteri

Establece parámetros de textura.

Sintaxis

void WINAPI glTexParameteri(
   GLenum target,
   GLenum pname,
   GLint  param
);

Parámetros

Destino

La textura de destino, que debe ser GL_TEXTURE_1D o GL_TEXTURE_2D.

pname

Nombre simbólico de un único parámetro de textura con valores. Los símbolos siguientes se aceptan en pname.

Value	Significado
GL_TEXTURE_MIN_FILTER	La función de minificación de textura se usa cada vez que el píxel que se está texturando se asigna a un área mayor que un elemento de textura. Hay seis funciones de minificación definidas. Dos de ellos usan los cuatro elementos de textura más cercanos para calcular el valor de textura. Los otros cuatro usan mapas MIP. Un mapa mip es un conjunto ordenado de matrices que representa la misma imagen en resoluciones progresivamente inferiores. Si la textura tiene dimensiones de 2nx2m , hay max(n, m) + 1 mipmaps. El primer mapa mip es la textura original, con dimensiones de 2nx2m. Cada mapa mip posterior tiene dimensiones de 2k1x2l1 donde 2kx2l son las dimensiones del mapa mip anterior, hasta k = 0 o l = 0. En ese momento, los mapas MIP posteriores tienen dimensión 1x2l1 o 2k1x1 hasta el mapa mip final, que tiene dimensión 1x1. Los mapas MIP se definen mediante glTexImage1D o glTexImage2D con el argumento level-of-detail que indica el orden de los mapas MIP. El nivel 0 es la textura original; level bold max(n, m) es el mapa mip final de 1x1.
GL_TEXTURE_MAG_FILTER	La función de ampliación de textura se usa cuando el píxel que se está texturando se asigna a un área menor o igual que un elemento de textura. Establece la función de ampliación de textura en GL_NEAREST o GL_LINEAR.
GL_TEXTURE_WRAP_S	Establece el parámetro de ajuste de las coordenadas de textura en GL_CLAMP o GL_REPEAT. GL_CLAMP hace que las coordenadas de se aprieten al intervalo [0,1] y resulta útil para evitar el ajuste de artefactos al asignar una sola imagen a un objeto. GL_REPEAT hace que se omita la parte entera de la coordenada s; OpenGL solo usa la parte fraccionarcional, lo que crea un patrón de repetición. Solo se tiene acceso a los elementos de textura de borde si el ajuste está establecido en GL_CLAMP. Inicialmente, GL_TEXTURE_WRAP_S se establece en GL_REPEAT.
GL_TEXTURE_WRAP_T	Establece el parámetro wrap para la coordenada de textura t en GL_CLAMP o GL_REPEAT. Consulte la discusión en GL_TEXTURE_WRAP_S. Inicialmente, GL_TEXTURE_WRAP_T se establece en GL_REPEAT

param

Valor de pname.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar los siguientes códigos de error.

Nombre	Significado
GL_INVALID_ENUM	target o pname no era uno de los valores definidos aceptados, o cuando el parámetro debe haber tenido un valor constante definido (basado en el valor de pname) y no lo hizo.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

La asignación de texturas es una técnica que aplica una imagen a la superficie de un objeto como si la imagen fuera un ajuste de reducción de calco o cellófano. La imagen se crea en el espacio de textura, con un sistema de coordenadas (s, t). Una textura es una imagen unidimensional y un conjunto de parámetros que determinan cómo se derivan las muestras de la imagen.

La función glTexParameter asigna el valor o los valores en parámetros al parámetro de textura especificado como pname. El parámetro de destino define la textura de destino, ya sea GL_TEXTURE_1D o GL_TEXTURE_2D.

A medida que se muestrea más elementos de textura en el proceso de minificación, se mostrarán menos artefactos de alias. Aunque las funciones de GL_NEAREST y GL_LINEAR minificación pueden ser más rápidas que las otras cuatro, muestrean solo uno o cuatro elementos de textura para determinar el valor de textura del píxel que se va a representar y pueden producir patrones moire o transiciones desiguales. El valor predeterminado de GL_TEXTURE_MIN_FILTER es GL_NEAREST_MIPMAP_LINEAR.

Supongamos que el texturing está habilitado (llamando a glEnable con el argumento GL_TEXTURE_1D o GL_TEXTURE_2D) y GL_TEXTURE_MIN_FILTER se establece en una de las funciones que requiere un mapa mip. Si las dimensiones de las imágenes de textura definidas actualmente (con llamadas anteriores a glTexImage1D o glTexImage2D) no siguen la secuencia adecuada para los mapas mip, o hay menos imágenes de textura definidas de las necesarias, o el conjunto de imágenes de textura tienen números diferentes de componentes de textura, es como si se deshabilitara la asignación de texturas. El filtrado lineal accede a los cuatro elementos de textura más cercanos solo en texturas 2D. En texturas 1D, el filtrado lineal accede a los dos elementos de textura más cercanos. La siguiente función recupera información relacionada con glTexParameterf, glTexParameteri, glTexParameterfv y glTexParameteriv:

glGetTexParameter

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glBindTexture

glCopyPixels

glCopyTexImage1D

glCopyTexImage2D

glCopyTexSubImage2D

glDrawPixels

glEnd

glGetTexParameter

glPixelStore

glPixelTransfer

glPrioritizeTextures

glTexEnv

glTexGen

glTexImage1D

glTexImage2D

glTexSubImage1D

glTexSubImage2D