función glPointSize

La función glPointSize especifica el diámetro de los puntos rasterizados.

Sintaxis

void WINAPI glPointSize(
   GLfloat size
);

Parámetros

size

Diámetro de puntos rasterizados. El valor predeterminado es 1.0.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar los siguientes códigos de error.

Nombre	Significado
GL_INVALID_VALUE	size era menor o igual que cero.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

La función glPointSize especifica el diámetro rasterizado de los puntos con alias y antialiased. El uso de un tamaño de punto distinto de 1,0 tiene efectos diferentes, dependiendo de si el suavizado de puntos está habilitado. El suavizado de puntos se controla llamando a glEnable y glDisable con el argumento GL_POINT_SMOOTH.

Si el suavizado de contorno de puntos está deshabilitado, el tamaño real se determina redondeando el tamaño proporcionado al entero más cercano. (Si el redondeo da como resultado el valor 0, es como si el tamaño del punto fuera 1). Si el tamaño redondeado es impar, el punto central (x,y) del fragmento de píxeles que representa el punto se calcula como

(x_w + .5, y_w + .5)

donde los subíndices w indican las coordenadas de la ventana. Todos los píxeles que se encuentran dentro de la cuadrícula cuadrada del tamaño redondeado centrado en (x,y) componen el fragmento. Si el tamaño es par, el punto central es

(x_w + .5, y_w + .5)

y los centros del fragmento rasterizado son las coordenadas de la ventana de medio entero dentro del cuadrado del tamaño redondeado centrado en (x,y). A todos los fragmentos de píxeles producidos al rasterizar un punto no fundamentado se les asignan los mismos datos asociados; del vértice correspondiente al punto.

Si el suavizado de contorno está habilitado, la rasterización de puntos genera un fragmento para cada cuadrado de píxeles que interseca la región que se encuentra dentro del círculo con diámetro igual al tamaño de punto actual y centrado en los puntos (x_w , _{y w} ). El valor de cobertura de cada fragmento es el área de coordenadas de ventana de la intersección de la región circular con el cuadrado de píxeles correspondiente. Este valor se guarda y se usa en el paso de rasterización final. Los datos asociados a cada fragmento son los datos asociados al punto que se va a rasterizar.

No todos los tamaños se admiten cuando se habilita el suavizado de contornos puntuales. Si se solicita un tamaño no admitido, se usa el tamaño admitido más cercano. Solo se garantiza que se admita el tamaño 1.0; otros dependen de la implementación. El intervalo de tamaños admitidos y la diferencia de tamaño entre los tamaños admitidos dentro del intervalo se pueden consultar llamando a glGet con argumentos GL_POINT_SIZE_RANGE y GL_POINT_SIZE_GRANULARITY.

El tamaño de punto especificado por glPointSize siempre se devuelve cuando se consulta GL_POINT_SIZE. La fijación y el redondeo de puntos con alias y antialias no tienen ningún efecto en el valor especificado.

El tamaño de punto no antialiased se puede sujetar a un máximo dependiente de la implementación. Aunque no se puede consultar este máximo, no debe ser menor que el valor máximo de puntos antialiased, redondeado al valor entero más cercano.

Las siguientes funciones recuperan información relacionada con glPointSize:

glGet con GL_POINT_SIZE de argumentos

glGet con GL_POINT_SIZE_RANGE de argumentos

glGet con GL_POINT_SIZE_GRANULARITY de argumentos

glIsEnabled con GL_POINT_SMOOTH de argumento

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

glEnable

glEnd

glIsEnabled