Función glLineStipple

La función glLineStipple especifica el patrón de stipple de línea.

Sintaxis

void WINAPI glLineStipple(
   GLint    factor,
   GLushort pattern
);

Parámetros

factor

Multiplicador por cada bit del patrón de esptippla de línea. Si el factor es 3, por ejemplo, cada bit del patrón se usará tres veces antes de que se use el siguiente bit del patrón. El parámetro factor se fija en el intervalo [1, 256] y tiene como valor predeterminado uno.

pattern

Entero de 16 bits cuyo patrón de bits determina qué fragmentos de una línea se dibujarán cuando se rasterice la línea. El bit cero se usa primero y el patrón predeterminado es todos.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar el siguiente código de error.

Nombre	Significado
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

La función glLineStipple especifica el patrón de stipple de línea. La espumosa de línea enmascara determinados fragmentos producidos por la rasterización; esos fragmentos no se dibujarán. El enmascaramiento se logra mediante el uso de tres parámetros: el patrón de esptipple de línea de 16 bits, el factor de recuento de repeticiones y un contador de esptipple de enteros.

El contador se restablece a cero cada vez que se llama a glBegin y antes de que se genere cada segmento de línea de una secuencia glBegin(GL_LINES)/glEnd . Se incrementa después de que se genere cada fragmento de un segmento de línea con alias de ancho de unidad, o después de que se generen cada fragmento i de un segmento de línea de ancho i . Los fragmentos i asociados a count s se enmascaran si el mod 16 del bit de patrón (s / factor) es cero. De lo contrario, estos fragmentos se envían al framebuffer. El bit cero del patrón es el bit menos significativo.

Las líneas antialias se tratan como una secuencia de rectángulos deancho 1x con fines de estrangulamiento. El rectángulo s se rasteriza o no se basa en la regla de fragmento descrita para las líneas con alias; cuenta rectángulos en lugar de grupos de fragmentos.

El stippling de líneas está habilitado o deshabilitado mediante glEnable y glDisable con el argumento GL_LINE_STIPPLE. Cuando se habilita, el patrón de esptippla de línea se aplica como se ha descrito anteriormente. Cuando está deshabilitado, es como si el patrón fuera el único. Inicialmente, el stippling de línea está deshabilitado.

Las siguientes funciones recuperan información relacionada con glLineStipple:

glGet con GL_LINE_STIPPLE_PATTERN de argumentos

glGet con GL_LINE_STIPPLE_REPEAT de argumentos

glIsEnabled con GL_LINE_STIPPLE 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

glEnd

glLineWidth

glPolygonStipple