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
GL_INVALID_VALUE	width 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 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	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glEnable

glEnd

glIsEnabled