Función glLineWidth
La función glLineWidth especifica el ancho de las líneas rasterizadas.
Sintaxis
void WINAPI glLineWidth(
GLfloat width
);
Parámetros
-
width
-
Ancho de líneas rasterizadas. 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 |
|---|---|
|
width 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 glLineWidth especifica el ancho rasterizado de líneas con alias y antialias. El uso de un ancho de línea distinto de 1,0 tiene efectos diferentes, dependiendo de si el suavizado de líneas está habilitado. El suavizado de líneas se controla llamando a glEnable y glDisable con GL_LINE_SMOOTH de argumentos.
Si el suavizado de líneas está deshabilitado, el ancho real se determina redondeando el ancho proporcionado al entero más cercano. (Si el redondeo da como resultado el valor 0,0, es como si el ancho de línea fuera 1,0) Si | ? x | = | ? y |, i píxeles se rellenan en cada columna rasterizada, donde i es el valor redondeado de ancho. De lo contrario, los píxeles i se rellenan en cada fila que se rasteriza.
Si el suavizado de contorno está habilitado, la rasterización de línea genera un fragmento para cada cuadrado de píxeles que interseca la región que se encuentra dentro del rectángulo que tiene ancho igual al ancho de línea actual, longitud igual a la longitud real de la línea y centrada en el segmento de línea matemática. El valor de cobertura de cada fragmento es el área de coordenadas de ventana de la intersección de la región rectangular con el cuadrado de píxeles correspondiente. Este valor se guarda y se usa en el paso de rasterización final.
No todos los anchos se pueden admitir cuando se habilita el suavizado de contornos de línea. Si se solicita un ancho no admitido, se usa el ancho admitido más cercano. Solo se garantiza que se admita el ancho 1,0; otros dependen de la implementación. El intervalo de anchos admitidos y la diferencia de tamaño entre los anchos admitidos dentro del intervalo se pueden consultar llamando a glGet con argumentos GL_LINE_WIDTH_RANGE y GL_LINE_WIDTH_GRANULARITY.
El ancho de línea especificado por glLineWidth siempre se devuelve cuando se consulta GL_LINE_WIDTH. La fijación y el redondeo de líneas con alias y antialias no tienen ningún efecto en el valor especificado.
El ancho de línea no antializado 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 las líneas antialias, redondeado al valor entero más cercano.
Las siguientes funciones recuperan información relacionada con glLineWidth:
glGet con GL_LINE_WIDTH de argumentos
glGet con GL_LINE_WIDTH_RANGE de argumentos
glGet con GL_LINE_WIDTH_GRANULARITY de argumentos
glIsEnabled con GL_LINE_SMOOTH 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 |
|
| Biblioteca |
|
| Archivo DLL |
|