Función glRasterPos4iv

Especifica la posición ráster para las operaciones de píxeles.

Sintaxis

void WINAPI glRasterPos4iv(
   const GLint *v
);

Parámetros

V

Puntero a una matriz de cuatro elementos, especificando coordenadas x, y, z y w, para la posición del ráster actual.

Valor devuelto

Esta función no devuelve ningún valor.

Observaciones

OpenGL mantiene una posición 3D en coordenadas de ventana. Esta posición, denominada posición ráster, se mantiene con precisión de subpixel. Se usa para colocar operaciones de escritura de píxeles y mapas de bits. Consulte glBitmap, glDrawPixels y glCopyPixels.

La posición del ráster actual consta de tres coordenadas de ventana (x, y, z), un valor de coordenada de clip w , una distancia de coordenada del ojo, un bit válido y 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 explícitamente las coordenadas de objeto x, y y z , mientras que w se establece implícitamente en uno. La función glRasterPos2 usa los valores de argumento para x e y mientras establece implícitamente z y w en cero y uno.

Las coordenadas del objeto presentadas por glRasterPos se tratan como las de un comando glVertex . Se transforman mediante las matrices de proyección y la vista del modelo actual y se pasan a la fase de recorte. Si el vértice no se selecciona, se proyecta y se escala a coordenadas de ventana, que se convierten en la nueva posición del ráster actual y se establece la marca GL_CURRENT_RASTER_POSITION_VALID. Si se selecciona el vértice, el bit válido se borra y la posición del ráster actual y las coordenadas de color y textura asociadas no están definidas.

La posición del ráster actual también incluye algunos datos de color asociados y coordenadas de textura. Si la iluminación está habilitada, GL_CURRENT_RASTER_COLOR, en modo RGBA o el GL_CURRENT_RASTER_INDEX, en modo de índice de color, se establece en el color generado por el cálculo de iluminación (consulte glLight, glLightModel y glShadeModel). Si la iluminación está deshabilitada, el color actual (en modo RGBA, la variable de estado GL_CURRENT_COLOR) o el índice de color (en modo de índice de color, la variable de estado GL_CURRENT_INDEX) se usa para actualizar el color del ráster actual.

Del mismo modo, GL_CURRENT_RASTER_TEXTURE_COORDS se actualiza como función de GL_CURRENT_TEXTURE_COORDS, en función de la matriz de texturas y las funciones de generación de texturas (consulte glTexGen). Por último, la distancia desde el origen del sistema de coordenadas oculares al vértice, como se transforma solo por la matriz modelview, reemplaza GL_CURRENT_RASTER_DISTANCE.

Inicialmente, la posición del ráster actual es (0,0,0,1), la distancia del ráster actual es 0, el bit válido se establece, 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, 0, 1). En el modo RGBA, GL_CURRENT_RASTER_INDEX siempre es 1; en modo de índice de color, el color RGBA del ráster actual siempre mantiene su valor inicial.

Nota

GlRasterPos y glBitmap modifican la posición del ráster.

Nota

Cuando las coordenadas de posición ráster no son válidas, se omiten los comandos de dibujo basados en la posición del ráster (es decir, no producen cambios en el estado openGL).

Las siguientes funciones recuperan información relacionada con glRasterPos:

glGet con GL_CURRENT_RASTER_POSITION de argumentos
glGet con GL_CURRENT_RASTER_POSITION_VALID de argumentos
glGet con GL_CURRENT_RASTER_DISTANCE de argumentos
glGet con GL_CURRENT_RASTER_COLOR de argumentos
glGet con GL_CURRENT_RASTER_INDEX de argumentos
glGet con GL_CURRENT_RASTER_TEXTURE_COORDS de argumentos

Requisitos

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

Consulte también

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex