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
GL_INVALID_OPERATION	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	Gl.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

glDepthFunc

glDisable

glEnable

glGet

glIsEnabled

glLineWidth

glStencilOp

glTexEnv