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 |
|---|---|
|
size era menor o igual que cero. |
|
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
(xw + .5, yw + .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
(xw + .5, yw + .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 (xw , 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 |
|
| Biblioteca |
|
| Archivo DLL |
|