funzione glClipPlane

La funzione glClipPlane specifica un piano in base al quale viene ritagliata tutta la geometria.

Sintassi

void WINAPI glClipPlane(
         GLenum   plane,
   const GLdouble *equation
);

Parametri

Aereo

Piano di ritaglio posizionato. I nomi simbolici del modulo GL_CLIP_PLANEi, dove i è un numero intero compreso tra 0 e GL_MAX_CLIP_PLANES - 1, vengono accettati.

equation

Indirizzo di una matrice di quattro valori a virgola mobile e precisione doppia. Questi valori vengono interpretati come equazione del piano.

Valore restituito

Questa funzione non restituisce un valore.

Codici di errore

I codici di errore seguenti possono essere recuperati dalla funzione glGetError .

Nome	Significato
GL_INVALID_ENUM	plane non è un valore accettato.
GL_INVALID_OPERATION	La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

La geometria viene sempre ritagliata rispetto ai limiti di un frustum a sei piani in x, y e z. La funzione glClipPlane consente la specifica di piani aggiuntivi, non necessariamente perpendicolare all'asse x, all'asse y o all'asse z, su cui viene ritagliata tutta la geometria. È possibile specificare fino a GL_MAX_CLIP_PLANES piani, dove GL_MAX_CLIP_PLANES è almeno sei in tutte le implementazioni. Poiché l'area di ritaglio risultante è l'intersezione degli spazi mezzo definiti, è sempre convessa.

La funzione glClipPlane specifica uno spazio mezzo utilizzando un'equazione del piano a quattro componenti. Quando si chiama glClipPlane, l'equazione viene trasformata dall'inverso della matrice modelview e archiviata nelle coordinate oculari risultanti. Le modifiche successive alla matrice modelview non hanno alcun effetto sui componenti dell'equazione del piano archiviato. Se il prodotto punto delle coordinate oculari di un vertice con i componenti dell'equazione del piano archiviato è positivo o zero, il vertice è rispetto a tale piano di ritaglio. In caso contrario, è fuori.

Usare le funzioni glEnable e glDisable per abilitare e disabilitare i piani di ritaglio. Chiamare piani di ritaglio con l'argomento GL_CLIP_PLANEi, dove i è il numero del piano.

Per impostazione predefinita, tutti i piani di ritaglio sono definiti come (0,0,0,0) nelle coordinate degli occhi e sono disabilitati.

È sempre il caso che GL_CLIP_PLANEi = GL_CLIP_PLANE0 + i.

Le funzioni seguenti recuperano informazioni correlate a glClipPlane:

glGetClipPlane

glIsEnabled con argomento GL_CLIP_PLANE i

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

glDisable

glEnable

glEnd

glGetClipPlane

glIsEnabled