Função glRasterPos3f
Especifica a posição de raster para operações de pixel.
Sintaxe
void WINAPI glRasterPos3f(
GLfloat x,
GLfloat y,
GLfloat z
);
Parâmetros
-
x
-
Especifica a coordenada x para a posição atual do raster.
-
y
-
Especifica a coordenada y para a posição de raster atual.
-
z
-
Especifica a coordenada z para a posição de raster 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 raster, é 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 atual do raster consiste em três coordenadas de janela (x, y, z), um valor w de coordenada de clipe, uma distância de coordenadas oculares, um bit válido e coordenadas de textura e dados de cor associados. 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 . Eles são transformados pelas matrizes de projeção e visão de modelo atuais e passados para o estágio de recorte. Se o vértice não for abatido, ele será projetado e dimensionado para as coordenadas da janela, que se tornam a nova posição de raster atual e o sinalizador GL_CURRENT_RASTER_POSITION_VALID será definido. Se o vértice for abatido, o bit válido será limpo e a posição do raster atual e as coordenadas de cor e textura associadas serão indefinidas.
A posição atual do raster 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 índice de cores (no modo de índice de cores, variável de estado GL_CURRENT_INDEX) será usada para atualizar a cor do raster 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 para o vértice, conforme transformado apenas pela matriz de modelview, substitui GL_CURRENT_RASTER_DISTANCE.
Inicialmente, a posição do raster atual é (0,0,0,1), a distância de raster 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 color-index, a cor RGBA do raster atual sempre mantém seu valor inicial.
Observação
A posição do raster é modificada por glRasterPos e por glBitmap.
Observação
Quando as coordenadas de posição do raster são inválidas, os comandos de desenho baseados na posição de raster 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 |
|