função glRasterPos4i

Especifica a posição da varredura para operações de pixel.

Sintaxe

void WINAPI glRasterPos4i(
   GLint x,
   GLint y,
   GLint z,
   GLint w
);

Parâmetros

x

Especifica a coordenada x para a posição de rasterização atual.

y

Especifica a coordenada y da posição de rasterização atual.

z

Especifica a coordenada z para a posição de rasterização atual.

w

A coordenada w para a posição de rasterização atual.

Retornar valor

Essa função não retorna um valor.

Comentários

O OpenGL mantém uma posição de 3D em coordenadas de janela. Essa posição, chamada de posição de rasterização, é mantida com precisão de subpixel. Ele é usado para posicionar operações de gravação de pixel e bitmap. Consulte glBitmap, glDrawPixelse glCopyPixels.

A posição de rasterização atual consiste em três coordenadas de janela (x, y, z), uma coordenada de clipe w , uma distância de coordenadas de olho, um bit válido e coordenadas de textura e de dados de cor associadas. A coordenada w é uma coordenada de clipe, porque w não é projetado para coordenadas de janelas. 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 é definido implicitamente como um. A função glRasterPos2 usa os valores de argumento para x e y enquanto configura 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 modelview e projeção atuais e passadas para o estágio de recorte. Se o vértice não for remarcado, ele será projetado e dimensionado para as coordenadas da janela, que se tornarão a nova posição de varredura atual e _ o _ sinalizador válido da posição de varredura atual do GL _ _ estiver definido. Se o vértice for removido, o bit válido será limpo e a posição atual da varredura e as coordenadas de cor e textura associadas serão indefinidas.

A posição de rasterização atual também inclui alguns dados de cor e coordenadas de textura associados. Se a iluminação estiver habilitada, _ _ a cor de rasterização atual do GL _ , no modo RGBA ou no _ índice de varredura atual GL _ _ , no modo de índice de cor, será definida como a cor produzida pelo cálculo de iluminação (consulte glLight, glLightModele glShadeModel). Se a iluminação estiver desabilitada, a cor atual (no modo RGBA, a cor atual do estado do GL _ _ ) ou o índice de cores (no modo de índice de cor, índice atual GL de variável de estado _ _ ) será usado para atualizar a cor de varredura atual.

Da mesma forma, GL _ _ CoOrds de textura de rasterização atual _ _ é atualizado como uma função de _ CoOrds de textura atual do GL _ _ , 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 de olho ao vértice, como transformado apenas pela matriz modelview, substitui a _ distância de varredura atual do GL _ _ .

Inicialmente, a posição de rasterização atual é (0, 0, 0, 1), a distância de varredura atual é 0, o bit válido é definido, a cor RGBA associada é (1, 1, 1, 1), o índice de cor associado é 1 e as coordenadas de textura associadas são (0, 0, 0, 1). No modo RGBA, _ _ o índice de varredura atual _ do GL é sempre 1; no modo de índice de cor, a cor RGBA atual sempre mantém seu valor inicial.

Observação

A posição da rasterização é modificada por glRasterPos e por glBitmap.

Observação

Quando as coordenadas de posição de rasterização são inválidas, os comandos de desenho baseados na posição de rasterização são ignorados (ou seja, eles não resultam em alterações no estado OpenGL).

As funções a seguir recuperam informações relacionadas ao glRasterPos:

glGet com o argumento _ GL _ posição de rasterização atual _
glGet com Argument GL _ _ posição de rasterização atual _ _ válida
glGet com o argumento GL a _ _ distância de rasterização atual _
glGet com o argumento _ GL _ cor de rasterização atual _
_ _ índice de varredura atual glGet com Argument GL _
glGet com Argument GL _ _ textura de rasterização atual _ _ CoOrds

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
GL. h
Biblioteca
Opengl32. lib
DLL
Opengl32.dll

Confira também

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex