Função glRasterPos4f

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

Sintaxe

void WINAPI glRasterPos4f(
   GLfloat x,
   GLfloat y,
   GLfloat z,
   GLfloat w
);

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.

w

A coordenada w 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.

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

Confira também

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex