funzione glLineStipple

La funzione glLineStipple specifica il modello stipple della linea.

Sintassi

void WINAPI glLineStipple(
   GLint    factor,
   GLushort pattern
);

Parametri

Fattore

Un moltiplicatore per ogni bit nel modello di stipple linea. Se il fattore è 3, ad esempio, ogni bit nel modello verrà usato tre volte prima che venga usato il bit successivo nel modello. Il parametro factor è bloccato all'intervallo [1, 256] e il valore predefinito è uno.

pattern

Intero a 16 bit il cui criterio di bit determina quali frammenti di una riga verranno disegnati quando la riga viene rasterizzata. Lo zero bit viene usato prima e il modello predefinito è tutti quelli.

Valore restituito

Questa funzione non restituisce un valore.

Codici di errore

Il codice di errore seguente può essere recuperato dalla funzione glGetError .

Nome	Significato
GL_INVALID_OPERATION	La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

La funzione glLineStipple specifica il modello stipple della linea. La sfitta linea nasconde alcuni frammenti generati dalla rasterizzazione; tali frammenti non verranno disegnati. Il mascheramento viene ottenuto usando tre parametri: il modello di pattern stipple linea a 16 bit, il fattore di conteggio ripeti e un contatore di stipple intero.

Il contatore viene reimpostato su zero ogni volta che viene chiamato glBegin e prima che venga generata ogni segmento di riga di una sequenza glBegin(GL_LINES)/glEnd. Viene incrementato dopo la generazione di ogni frammento di un segmento di riga con alias di larghezza unità oppure dopo la generazione di ogni frammento di un segmento di riga di larghezza i . I frammenti associati al conteggio sono mascherati se il modello bit (s / factor) mod 16 è zero. In caso contrario, questi frammenti vengono inviati al framebuffer. Il bit zero del modello è il bit meno significativo.

Le linee antialiased vengono considerate come una sequenza di rettangoli dilarghezza 1x a scopo di stippling. Il rettangolo è rasterizzato o meno in base alla regola del frammento descritta per le righe aliaste; conta rettangoli anziché gruppi di frammenti.

La stippling della riga è abilitata o disabilitata usando glEnable e glDisable con l'argomento GL_LINE_STIPPLE. Se abilitato, il modello stipple della linea viene applicato come descritto in precedenza. Se disabilitato, è come se il modello fosse tutti quelli. Inizialmente, la stippling della riga è disabilitata.

Le funzioni seguenti recuperano informazioni correlate a glLineStipple:

glGet con argomento GL_LINE_STIPPLE_PATTERN

glGet con argomento GL_LINE_STIPPLE_REPEAT

glIsEnabled con argomento GL_LINE_STIPPLE

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Gl.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

glBegin

glEnd

glLineWidth

glPolygonStipple