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 |
|---|---|
|
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 |
|
| Libreria |
|
| DLL |
|