Funzione glPolygonOffset
La funzione glPolygonOffset imposta la scala e le unità usate da OpenGL per calcolare i valori di profondità.
Sintassi
void WINAPI glPolygonOffset(
GLfloat factor,
GLfloat units
);
Parametri
-
Fattore
-
Specifica un fattore di scala utilizzato per creare un offset di profondità variabile per ogni poligono. Il valore iniziale è zero.
-
Unità
-
Specifica un valore moltiplicato per un valore specifico dell'implementazione per creare un offset di profondità costante. Il valore iniziale è 0.
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
Quando GL_POLYGON_OFFSET è abilitato, il valore di profondità di ogni frammento verrà sfalsato dopo l'interpolazione dai valori di profondità dei vertici appropriati. Il valore dell'offset è factor * ?z + r *units, dove ?z è una misura della variazione di profondità rispetto all'area dello schermo del poligono e r è il valore più piccolo che è garantito per produrre un offset risolvibile per una determinata implementazione. L'offset viene aggiunto prima dell'esecuzione del test di profondità e prima che il valore venga scritto nel buffer di profondità.
La funzione glPolygonOffset è utile per il rendering di immagini a linee nascoste, per l'applicazione di decali alle superfici e per il rendering di solidi con bordi evidenziati.
La funzione glPolygonOffset non ha alcun effetto sulle coordinate di profondità posizionate nel buffer di feedback. Non ha alcun effetto sulla selezione.
Le funzioni seguenti recuperano informazioni correlate a glPolygonOffset:
- glGet con argomento GL_POLYGON_OFFSET_FACTOR
- glGet con argomento GL_POLYGON_OFFSET_UNITS
- glIsEnabled con argomento GL_POLYGON_OFFSET_FILL
- glIsEnabled con argomento GL_POLYGON_OFFSET_LINE
- glIsEnabled con argomento GL_POLYGON_OFFSET_POINT
Nota
La funzione glPolygonOffset è disponibile solo in OpenGl versione 1.1 o successiva.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|