Função glCopyTexImage2D
A função glCopyTexImage2D copia pixels do framebuffer em uma imagem de textura bidimensional.
Sintaxe
void WINAPI glCopyTexImage2D(
GLenum target,
GLint level,
GLenum internalFormat,
GLint x,
GLint y,
GLsizei width,
GLsizei height,
GLint border
);
Parâmetros
-
destino
-
O destino para o qual os dados da imagem serão alterados. Deve ter o valor GL_TEXTURE_2D.
-
level
-
O número de nível de detalhes. O nível 0 é a imagem base. O nível n é a nª imagem de redução de mipmap.
-
internalFormat
-
O formato interno e a resolução dos dados de textura. Os valores 1, 2, 3 e 4 não são aceitos para internalFormat. O parâmetro pode assumir um dos seguintes 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
-
A coordenada x-plane da janela do canto inferior esquerdo da região retangular dos pixels a serem copiados.
-
y
-
A coordenada do plano y da janela do canto inferior esquerdo da região retangular dos pixels a serem copiados.
-
width
-
A largura da imagem de textura. Deve ser 2n + 2 * borda para algum número inteiro n.
-
altura
-
A altura da imagem de textura. Deve ser 2n + 2 * borda para algum número inteiro n.
-
Fronteira
-
A largura da borda. Deve ser zero ou 1.
Retornar valor
Essa função não retorna um valor.
Códigos de erro
Os códigos de erro a seguir podem ser recuperados pela função glGetError .
| Nome | Significado |
|---|---|
|
target não era um valor aceito. |
|
o nível foi menor que zero ou maior que o máximo de log2, em que max é o valor retornado de GL_MAX_TEXTURE_SIZE. |
|
borda não era zero ou 1. |
|
width foi menor que zero, maior que 2 + GL_MAX_TEXTURE_SIZE ou largura não pode ser representada como 2n + 2 * borda para algum inteiro n. |
|
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd. |
Comentários
A função glCopyTexImage2D define uma imagem de textura bidimensional usando pixels do quadro atual, em vez de main memória, como é o caso de glTexImage2D.
Usando o nível de mipmap especificado com nível, as matrizes de textura são definidas como um retângulo de pixels com o canto inferior esquerdo localizado nas coordenadas x e y, largura igual a largura + (borda de 2 * ) e uma altura igual à altura + ( borda 2 * ). O formato interno da matriz de textura é especificado com o parâmetro internalFormat .
A função glCopyTexImage2D processa os pixels em uma linha da mesma forma que glCopyPixels , exceto que antes da conversão final dos pixels, todos os valores de componente de pixel são fixados no intervalo [0,1] e convertidos no formato interno da textura para armazenamento na matriz de textura. A ordenação de pixels é determinada com coordenadas x e y inferiores correspondentes a coordenadas de textura s e t inferiores. Se qualquer um dos pixels dentro de uma linha especificada do quadro atual estiver fora da janela associada ao contexto de renderização atual, seus valores serão indefinidos.
Você não pode incluir chamadas para glCopyTexImage2D em listas de exibição.
Observação
A função glCopyTexImage2D só está disponível no OpenGL versão 1.1 ou posterior.
A texturização não tem efeito no modo de índice de cores. As funções glPixelStore e glPixelTransfer afetam exatamente as imagens de textura da maneira como afetam glDrawPixels.
A função a seguir recupera informações relacionadas a glCopyTexImage2D:
glIsEnabled com GL_TEXTURE_2D de argumento
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|