glRasterPos4iv función)

Especifica la posición de la trama para las operaciones de píxel.

Sintaxis

void WINAPI glRasterPos4iv(
   const GLint *v
);

Parámetros

v

Puntero a una matriz de cuatro elementos, que especifica las coordenadas x, y, z y w para la posición de la trama actual.

Valor devuelto

Esta función no devuelve ningún valor.

Observaciones

OpenGL mantiene una posición 3D en las coordenadas de la ventana. Esta posición, denominada posición de la trama, se mantiene con una precisión de subpíxeles. Se utiliza para colocar las operaciones de escritura de píxeles y de mapas de bits. Vea glBitmap, glDrawPixelsy glCopyPixels.

La posición de rasterización actual consta de tres coordenadas de ventana (x, y, z), un valor de coordenada de clip w , una distancia de coordenadas ocular, un bit válido y las coordenadas de textura y datos de color asociados. La coordenada w es una coordenada de clip, porque w no se proyecta en coordenadas de ventana. La función glRasterPos4 especifica las coordenadas de objeto x, y, z y w explícitamente. La función glRasterPos3 especifica las coordenadas de objeto x, y y z explícitamente, mientras que w se establece implícitamente en una. La función glRasterPos2 usa los valores de argumento para x e y mientras establece implícitamente z y w en cero y en uno.

Las coordenadas de objeto presentadas por glRasterPos se tratan igual que las de un comando glVertex . Los transforman las matrices de proyección y MODELVIEW actuales y se pasan a la fase de recorte. Si no se selecciona el vértice, se proyecta y se escala a las coordenadas de la ventana, que se convierten en la nueva posición de la trama actual y _ _ _ _ se establece la marca válida de la posición de rasterización actual de GL. Si se selecciona el vértice, se borra el bit válido y la posición de la trama actual y las coordenadas de textura y color asociadas no están definidas.

La posición de la trama actual también incluye algunos datos de color y coordenadas de textura asociados. Si está habilitada la iluminación, _ _ el color de rasterizado actual _ de GL, en el modo RGBA o el _ Índice de _ rasterización actual de GL _ , en modo de índice de color, se establece en el color producido por el cálculo de iluminación (vea glLight, glLightModely glShadeModel). Si la iluminación está deshabilitada, se usa el color actual (en modo RGBA, la variable de estado GL _ Current _ color) o el índice de color (en modo de índice de color, variable de estado, _ índice actual de contabilidad _ ) para actualizar el color de la trama actual.

Del mismo modo, las _ _ coordenadas de textura de rasterizado actual _ de GL _ se actualizan como una función de las _ coordenadas de textura actual de GL _ _ , en función de la matriz de textura y las funciones de generación de textura (vea glTexGen). Por último, la distancia desde el origen del sistema de coordenadas del ojo hasta el vértice, tal y como se transforma solo en la matriz MODELVIEW, reemplaza a la distancia de la _ trama actual de contabilidad _ _ .

Inicialmente, la posición de la trama actual es (0, 0, 0, 1), la distancia de la trama actual es 0, se establece el bit válido, el color RGBA asociado es (1, 1, 1, 1), el índice de color asociado es 1 y las coordenadas de textura asociadas son (0, 0, 0, 1). En el modo RGBA, _ el índice de rasterizado actual de GL siempre _ _ es 1; en el modo de índice de color, el color RGBA de trama actual siempre mantiene su valor inicial.

Nota

GlRasterPos y glBitmapmodifican la posición de la trama.

Nota

Cuando las coordenadas de posición de trama no son válidas, los comandos de dibujo que se basan en la posición de la trama se omiten (es decir, no producen cambios en el estado de OpenGL).

Las siguientes funciones recuperan información relacionada con glRasterPos:

glGet con el argumento _ _ posición de RASTERIZAción actual de GL _
glGet con argumento de _ posición de rasterizado actual de GL _ _ _ válido
glGet con el argumento _ _ distancia de trama actual de GL _
glGet con el argumento _ _ color de RASTERIZAdo actual de GL _
glGet con el argumento _ _ Índice de trama actual de GL _
glGet con argumento de _ _ textura de RASTERIZAdo actual _ de GL _

Requisitos

Requisito Value
Cliente mínimo compatible
[Solo aplicaciones de escritorio] de Windows 2000 Professional
Servidor mínimo compatible
[Solo aplicaciones de escritorio] de Windows 2000 Server
Encabezado
GL. h
Biblioteca
Opengl32. lib
Archivo DLL
Opengl32.dll

Vea también

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex