Função glRasterPos4iv

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

Sintaxe

void WINAPI glRasterPos4iv(
   const GLint *v
);

Parâmetros

V

Um ponteiro para uma matriz de quatro elementos, especificando coordenadas x, y, z e w para a posição atual do raster.

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. Consulte glBitmap, glDrawPixels e glCopyPixels.

A posição de raster 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 coordenadas de objeto x, y, z e w explicitamente. A função glRasterPos3 especifica 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 para zero e um.

As coordenadas de objeto apresentadas por glRasterPos são tratadas da mesma forma que as de um comando glVertex . Elas são transformadas pelas matrizes de modelagem e projeção atuais e passadas 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 de 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, como transformado apenas pela matriz de visão de modelo, 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 de índice de cores, a cor RGBA do raster atual sempre mantém seu valor inicial.

Observação

A posição de raster é modificada tanto por glRasterPos quanto 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
Gl.h
Biblioteca
Opengl32.lib
DLL
Opengl32.dll

Confira também

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex