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 |
|---|---|
|
plane non è un valore accettato. |
|
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:
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 |
|
| Libreria |
|
| DLL |
|