Función glCopyTexImage2D
La función glCopyTexImage2D copia píxeles del búfer de fotogramas en una imagen de textura bidimensional.
Sintaxis
void WINAPI glCopyTexImage2D(
GLenum target,
GLint level,
GLenum internalFormat,
GLint x,
GLint y,
GLsizei width,
GLsizei height,
GLint border
);
Parámetros
-
Destino
-
Destino al que se cambiarán los datos de la imagen. Debe tener el valor GL_TEXTURE_2D.
-
level
-
Número de nivel de detalle. El nivel 0 es la imagen base. El nivel n es la nªimagen de reducción de mapa mip.
-
internalFormat
-
Formato interno y resolución de los datos de textura. Los valores 1, 2, 3 y 4 no se aceptan para internalFormat. El parámetro puede suponer uno de los siguientes valores simbólicos.
Constante R Bits G Bits B Bits A Bits L Bits I Bits GL_ALPHA GL_ALPHA4 4 GL_ALPHA8 8 GL_ALPHA12 12 GL_ALPHA16 16 GL_LUMINANCE GL_LUMINANCE4 4 GL_LUMINANCE8 8 GL_LUMINANCE12 12 GL_LUMINANCE16 16 GL_LUMINANCE_ALPHA GL_LUMINANCE4_ALPHA4 4 4 GL_LUMINANCE6_ALPHA2 2 6 GL_LUMINANCE8_ALPHA8 8 8 GL_LUMINANCE12_ALPHA4 4 12 GL_LUMINANCE12_ALPHA12 12 12 GL_LUMINANCE16_ALPHA16 16 16 GL_INTENSITY GL_INTENSITY4 4 GL_INTENSITY8 8 GL_INTENSITY12 12 GL_INTENSITY16 16 GL_RGB GL_R3_G3_B2 3 3 2 GL_RGB4 4 4 4 GL_RGB5 5 5 5 GL_RGB8 8 8 8 GL_RGB10 10 10 10 GL_RGB12 12 12 12 GL_RGB16 16 16 16 GL_RGBA GL_RGBA2 2 2 2 2 GL_RGBA4 4 4 4 4 GL_RGB5_A1 5 5 5 1 GL_RGBA8 8 8 8 8 GL_RGB10_A2 10 10 10 2 GL_RGBA12 12 12 12 12 GL_RGBA16 16 16 16 16 -
x
-
Coordenada x plano de la ventana de la esquina inferior izquierda de la región rectangular de píxeles que se va a copiar.
-
y
-
Coordenada del plano y de la ventana de la esquina inferior izquierda de la región rectangular de píxeles que se va a copiar.
-
width
-
Ancho de la imagen de textura. Debe ser 2n + 2 * borde para un número entero n.
-
height
-
Alto de la imagen de textura. Debe ser 2n + 2 * borde para un número entero n.
-
Frontera
-
Ancho del borde. Debe ser cero o 1.
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 |
|---|---|
|
target no era un valor aceptado. |
|
level era menor que cero o mayor que log2 max, donde max es el valor devuelto de GL_MAX_TEXTURE_SIZE. |
|
border no era cero o 1. |
|
width era menor que cero, mayor que 2 + GL_MAX_TEXTURE_SIZE, o el ancho no se puede representar como 2n + 2 * borde para algunos enteros n. |
|
Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd. |
Comentarios
La función glCopyTexImage2D define una imagen de textura bidimensional mediante píxeles del búfer de fotogramas actual, en lugar de desde la memoria principal, como es el caso de glTexImage2D.
Con el nivel de mapa mip especificado con el nivel , las matrices de texturas se definen como un rectángulo de píxeles con la esquina inferior izquierda situada en las coordenadas x e y, ancho igual al ancho + (2 * borde) y un alto igual a alto + (2 * borde). El formato interno de la matriz de texturas se especifica con el parámetro internalFormat .
La función glCopyTexImage2D procesa los píxeles de una fila de la misma manera que glCopyPixels , excepto que antes de la conversión final de los píxeles, todos los valores de componentes de píxeles se sujetan al intervalo [0,1] y se convierten en el formato interno de la textura para el almacenamiento en la matriz de texturas. El orden de píxeles se determina con coordenadas x e y inferiores correspondientes a las coordenadas de textura s y t inferiores. Si alguno de los píxeles de una fila especificada del búfer de fotogramas actual está fuera de la ventana asociada al contexto de representación actual, sus valores no están definidos.
No se pueden incluir llamadas a glCopyTexImage2D en las listas para mostrar.
Nota
La función glCopyTexImage2D solo está disponible en OpenGL versión 1.1 o posterior.
La texturización no tiene ningún efecto en el modo de índice de color. Las funciones glPixelStore y glPixelTransfer afectan exactamente a las imágenes de textura de la manera en que afectan a glDrawPixels.
La siguiente función recupera información relacionada con glCopyTexImage2D:
glIsEnabled con GL_TEXTURE_2D de argumentos
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 |
|
| Biblioteca |
|
| Archivo DLL |
|