Função glTexSubImage1D
A função glTexSubImage1D especifica uma parte de uma imagem de textura unidimensional existente. Não é possível definir uma nova textura com glTexSubImage1D.
Sintaxe
void WINAPI glTexSubImage1D(
GLenum target,
GLint level,
GLint xoffset,
GLsizei width,
GLenum format,
GLenum type,
const GLvoid *pixels
);
Parâmetros
-
destino
-
A textura de destino. Precisa ser GL_TEXTURE_1D.
-
level
-
O número do nível de detalhe. O nível 0 é a imagem base. O nível n é a enésima imagem de redução do mipmap.
-
xoffset
-
Um deslocamento texel na direção x dentro da matriz de textura.
-
width
-
A largura da subimagem de textura.
-
format
-
O formato dos dados de pixel. Esse parâmetro pode considerar um dos valores simbólicos a seguir.
Valor Significado - GL_COLOR_INDEX
Cada elemento é um valor individual, um índice de cores. Ele é convertido no formato de ponto fixo (com um número não especificado de 0 bits à direita do ponto binário), deslocado para a esquerda ou para a direita, dependendo do valor e do sinal de GL_INDEX_SHIFT, e adicionado a GL_INDEX_OFFSET (confira glPixelTransfer). O índice resultante é convertido em um conjunto de componentes de cor por meio das tabelas GL_PIXEL_MAP_I_TO_R, GL_PIXEL_MAP_I_TO_G, GL_PIXEL_MAP_I_TO_B e GL_PIXEL_MAP_I_TO_A e fixado ao intervalo [0,1]. - GL_RED
Cada elemento é um componente vermelho individual. Ele é convertido no formato de ponto flutuante e montado em um elemento RGBA pela anexação de 0,0 para verde e azul e 1,0 para alfa. Em seguida, cada componente é multiplicado pelo fator de escala com sinal GL_c_SCALE, adicionado ao desvio com sinal GL_c_BIAS e fixado ao intervalo [0,1] (confira glPixelTransfer). - GL_GREEN
Cada elemento é um componente verde individual. Ele é convertido no formato de ponto flutuante e montado em um elemento RGBA pela anexação de 0,0 para vermelho e azul e 1,0 para alfa. Em seguida, cada componente é multiplicado pelo fator de escala com sinal GL_c_SCALE, adicionado ao desvio com sinal GL_c_BIAS e fixado ao intervalo [0,1] (confira glPixelTransfer). - GL_BLUE
Cada elemento é um componente azul individual. Ele é convertido no formato de ponto flutuante e montado em um elemento RGBA pela anexação de 0,0 para vermelho e verde e 1,0 para alfa. Em seguida, cada componente é multiplicado pelo fator de escala com sinal GL_c_SCALE, adicionado ao desvio com sinal GL_c_BIAS e fixado ao intervalo [0,1] (confira glPixelTransfer). - GL_ALPHA
Cada elemento é um componente alfa individual. Ele é convertido no formato de ponto flutuante e montado em um elemento RGBA pela anexação de 0,0 para vermelho, verde e azul. Em seguida, cada componente é multiplicado pelo fator de escala com sinal GL_c_SCALE, adicionado ao desvio com sinal GL_c_BIAS e fixado ao intervalo [0,1] (confira glPixelTransfer). - GL_RGB
Cada elemento é um triplo RGB. Ele é convertido em ponto flutuante e montado em um elemento RGBA pela anexação de 1.0 para alfa. Em seguida, cada componente é multiplicado pelo fator de escala com sinal GL_c_SCALE, adicionado ao desvio com sinal GL_c_BIAS e fixado ao intervalo [0,1] (confira glPixelTransfer). - GL_RGBA
Cada elemento é um elemento RGBA completo. Ele é convertido no formato de ponto flutuante. Em seguida, cada componente é multiplicado pelo fator de escala com sinal GL_c_SCALE, adicionado ao desvio com sinal GL_c_BIAS e fixado ao intervalo [0,1] (confira glPixelTransfer). - GL_LUMINANCE
Cada elemento é um valor de luminância individual. Ele é convertido no formato de ponto flutuante e montado em um elemento RGBA pela replicação do valor de luminância três vezes para vermelho, verde e azul, e pela anexação de 1,0 para alfa. Em seguida, cada componente é multiplicado pelo fator de escala com sinal GL_c_SCALE, adicionado ao desvio com sinal GL_c_BIAS e fixado ao intervalo [0,1] (confira glPixelTransfer). - GL_LUMINANCE_ALPHA
Cada elemento é um par luminância/alfa. Ele é convertido no formato de ponto flutuante e montado em um elemento RGBA pela replicação do valor de luminância três vezes para vermelho, verde e azul. Em seguida, cada componente é multiplicado pelo fator de escala com sinal GL_c_SCALE, adicionado ao desvio com sinal GL_c_BIAS e fixado ao intervalo [0,1] (confira glPixelTransfer). -
tipo
-
O tipo de dados dos dados de pixel. São aceitos os seguintes valores simbólicos: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT e GL_FLOAT.
-
pixels
-
Um ponteiro para os dados da imagem na memória.
Retornar valor
Essa função não retorna um valor.
Códigos do Erro
Os códigos de erro a seguir podem ser recuperados pela função glGetError.
| Nome | Significado |
|---|---|
|
O target não era GL_TEXTURE_1D. |
|
O format não era uma constante aceita. |
|
O type não era uma constante aceita. |
|
O type era GL_BITMAP e o format não era GL_COLOR_INDEX. |
|
O level era menor que zero ou maior que log2 max, sendo max o valor retornado de GL_MAX_TEXTURE_SIZE. |
|
xoffset era menor que b ou xoffset + width era maior que w, sendo w a GL_TEXTURE_WIDTH e h é a largura da GL_TEXTURE_BORDER da imagem de textura que está sendo modificada. Observe que o w inclui o dobro da largura da borda. |
|
A width era menor que b, sendo b a borda da matriz de textura. |
|
A border não era zero ou 1. |
|
A matriz de textura não foi definida por uma operação glTexImage1D anterior. |
|
A função foi chamada entre uma chamada a glBegin e a chamada correspondente a glEnd. |
Comentários
A texturização unidimensional de uma primitiva é habilitada por meio de glEnable e glDisable com o argumento GL_TEXTURE_1D. Durante a texturização, parte de uma imagem de textura especificada é mapeada em cada primitiva habilitada. Use a função glTexSubImage1D para especificar uma subimagem contígua de uma imagem de textura unidimensional existente para texturização.
Os texels referenciados por pixels substituem uma região da matriz de textura existente por x índices de xoffset e xoffset + (width 1) inclusive. Essa região não pode incluir nenhum texel fora do intervalo da matriz de textura especificada originalmente.
A especificação de uma subimagem com uma width igual a zero não tem nenhum efeito e não gera um erro.
A texturização não tem nenhum efeito no modo de índice de cores.
Em geral, as imagens de textura podem ser representadas pelos mesmos formatos de dados que os pixels em um comando glDrawPixels, com a exceção de que GL_STENCIL_INDEX e GL_DEPTH_COMPONENT não podem ser usados. Os modos glPixelStore e glPixelTransfer afetam as imagens de textura exatamente da mesma forma que afetam glDrawPixels.
As seguintes funções recuperam informações relacionadas a glTexSubImage1D:
glIsEnabled com o argumento GL_TEXTURE_1D
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 |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de