Función glRasterPos2iv

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

Sintaxis

void WINAPI glRasterPos2dv(
   const GLint *v
);

Parámetros

v

Puntero a una matriz de dos elementos, especificando coordenadas x e y para la posición de trama 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 subpíxel. 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), una coordenada de clip w value, una distancia de coordenadas oculares, un bit válido y coordenadas de textura y datos de color asociados. La coordenada w es una coordenada de recorte, 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 que establece implícitamente z y w en cero y uno.

Las coordenadas de objeto presentadas por glRasterPos se tratan como las de un comando glVertex . Se transforman mediante la vista del modelo actual y las matrices de proyección y se pasan a la fase de recorte. Si el vértice no se selecciona, se proyecta y se escala a las coordenadas de ventana, que se convierten en la nueva posición de trama 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 en el GL_CURRENT_RASTER_INDEX, en modo de índice de color, se establece en el color generado por el cálculo de iluminación (vea 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 una función de GL_CURRENT_TEXTURE_COORDS, en función de la matriz de texturas y de las funciones de generación de texturas (consulte glTexGen). Por último, la distancia desde el origen del sistema de coordenadas oculares al vértice, tal y como se transforma únicamente 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, 1). En el modo RGBA, GL_CURRENT_RASTER_INDEX siempre es 1; en el modo de índice de color, el color RGBA de trama actual siempre mantiene su valor inicial.

Nota

La posición ráster se modifica tanto por glRasterPos como por glBitmap.

Nota

Cuando las coordenadas de posición ráster no son válidas, los comandos de dibujo basados en la posición de trama se omiten (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