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 |
|---|---|
|
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 |
|
| Biblioteca |
|
| Archivo DLL |
|