Función glCopyTexSubImage1D
La función glCopyTexSubImage1D copia una sub-imagen de una imagen de textura unidimensional desde el búfer de fotogramas.
Sintaxis
void WINAPI glCopyTexSubImage1D(
GLenum target,
GLint level,
GLint xoffset,
GLint x,
GLint y,
GLsizei width
);
Parámetros
-
Destino
-
Destino al que se cambiarán los datos de la imagen. Debe tener el valor GL_TEXTURE_1D.
-
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.
-
xoffset
-
Desplazamiento de elementos de textura dentro de la matriz de texturas.
-
x
-
Coordenada del plano x de la ventana de la esquina inferior izquierda de la fila de píxeles que se va a copiar.
-
y
-
Coordenada del plano y de la ventana de la esquina inferior izquierda de la fila de píxeles que se va a copiar.
-
width
-
Ancho de la sub-imagen de la imagen de textura. La especificación de una sub-imagen de textura con ancho cero no tiene ningún efecto.
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 level es mayor que log2(max), donde max es el valor devuelto de GL_MAX_TEXTURE_SIZE. |
|
xoffset era menor que el borde o (anchoxoffset + )era mayor que (bordew + ), donde w es GL_TEXTURE_WIDTH y borde es GL_TEXTURE_BORDER. Tenga en cuenta que w incluye dos veces el ancho del borde . |
|
width era menor que border o y era menor que border, donde border es el ancho de borde de la matriz de texturas. |
|
La matriz de texturas no se definió mediante una operación glTexImage1D anterior. |
|
Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd. |
Comentarios
La función glCopyTexSubImage1D reemplaza una parte de una imagen de textura unidimensional mediante píxeles del búfer de fotogramas actual, en lugar de desde la memoria principal, como es el caso de glTexSubImage1D.
Fila de píxeles que comienza con las coordenadas de ventana especificadas por x e y y, con el ancho de longitud, reemplaza la parte de la matriz de texturas por los índices xoffset a través de xoffset + (ancho - 1). El destino de la matriz de texturas no puede incluir elementos de textura fuera de la matriz de texturas especificada originalmente.
La función glCopyTexSubImage1D procesa los píxeles de una fila de la misma manera que glCopyPixels , salvo que antes de la conversión final de los píxeles, todos los valores de componente 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 inferiores correspondientes a coordenadas de textura inferior. 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 realiza ningún cambio en el parámetro internalFormat, width o border de la matriz de texturas especificada o en valores de textura fuera de la sub-imagen de textura especificada.
No se pueden incluir llamadas a glCopyTexSubImage1D en las listas para mostrar.
Nota
La función glCopyTexSubImage1D 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 la forma en que se dibujan píxeles mediante glDrawPixels.
Las siguientes funciones recuperan información relacionada con glCopyTexSubImage1D:
glIsEnabled con GL_TEXTURE_1D 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 |
|