Função glRasterPos3i
Especifica a posição de varredura para operações de pixel.
Sintaxe
void WINAPI glRasterPos3i(
GLint x,
GLint y,
GLint z
);
Parâmetros
-
x
-
Especifica a coordenada x para a posição de varredura atual.
-
y
-
Especifica a coordenada y para a posição de varredura atual.
-
z
-
Especifica a coordenada z para a posição de varredura atual.
Retornar valor
Essa função não retorna um valor.
Comentários
O OpenGL mantém uma posição 3D nas coordenadas da janela. Essa posição, chamada de posição de varredura, é mantida com precisão de subpixel. Ele é usado para posicionar operações de gravação de pixel e bitmap. Confira glBitmap, glDrawPixels e glCopyPixels.
A posição de varredura atual consiste em três coordenadas de janela (x, y, z), um valor de coordenada de clipe w , uma distância de coordenadas oculares, um bit válido e dados de cor associados e coordenadas de textura. A coordenada w é uma coordenada de clipe, porque w não é projetado para coordenadas de janela. A função glRasterPos4 especifica as coordenadas de objeto x, y, z e w explicitamente. A função glRasterPos3 especifica as coordenadas de objeto x, y e z explicitamente, enquanto w é implicitamente definido como um. A função glRasterPos2 usa os valores de argumento para x e y ao definir implicitamente z e w como zero e um.
As coordenadas de objeto apresentadas por glRasterPos são tratadas exatamente como as de um comando glVertex . Elas são transformadas pelas matrizes de projeção e visão de modelo atuais e passadas para o estágio de recorte. Se o vértice não for descartado, ele será projetado e dimensionado para coordenadas de janela, que se tornam a nova posição de varredura atual e o sinalizador GL_CURRENT_RASTER_POSITION_VALID será definido. Se o vértice for eliminado, o bit válido será limpo e a posição de varredura atual e as coordenadas de cor e textura associadas serão indefinidas.
A posição atual do varredura também inclui alguns dados de cor associados e coordenadas de textura. Se a iluminação estiver habilitada, GL_CURRENT_RASTER_COLOR, no modo RGBA ou o GL_CURRENT_RASTER_INDEX, no modo de índice de cores, será definido como a cor produzida pelo cálculo de iluminação (consulte glLight, glLightModel e glShadeModel). Se a iluminação estiver desabilitada, a cor atual (no modo RGBA, variável de estado GL_CURRENT_COLOR) ou o índice de cores (no modo de índice de cores, variável de estado GL_CURRENT_INDEX) será usado para atualizar a cor de varredura atual.
Da mesma forma, GL_CURRENT_RASTER_TEXTURE_COORDS é atualizado como uma função de GL_CURRENT_TEXTURE_COORDS, com base na matriz de textura e nas funções de geração de textura (consulte glTexGen). Por fim, a distância da origem do sistema de coordenadas oculares até o vértice, como transformado apenas pela matriz de modelview, substitui GL_CURRENT_RASTER_DISTANCE.
Inicialmente, a posição atual do varredura é (0,0,0,1), a distância do varredura atual é 0, o bit válido é definido, a cor RGBA associada é (1,1,1,1), o índice de cores associado é 1 e as coordenadas de textura associadas são (0, 0, 0, 1). No modo RGBA, GL_CURRENT_RASTER_INDEX é sempre 1; no modo de índice de cores, a cor RGBA de varredura atual sempre mantém seu valor inicial.
Observação
A posição do varredura é modificada por glRasterPos e por glBitmap.
Observação
Quando as coordenadas de posição do varredura são inválidas, os comandos de desenho baseados na posição de varredura são ignorados (ou seja, não resultam em alterações no estado OpenGL).
As seguintes funções recuperam informações relacionadas a glRasterPos:
glGet com GL_CURRENT_RASTER_POSITION de argumento
glGet com GL_CURRENT_RASTER_POSITION_VALID de argumento
glGet com GL_CURRENT_RASTER_DISTANCE de argumento
glGet com GL_CURRENT_RASTER_COLOR de argumento
glGet com GL_CURRENT_RASTER_INDEX de argumento
glGet com GL_CURRENT_RASTER_TEXTURE_COORDS 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 |
|