Función glClipPlane
La función glClipPlane especifica un plano con el que se recorta toda la geometría.
Sintaxis
void WINAPI glClipPlane(
GLenum plane,
const GLdouble *equation
);
Parámetros
-
avión
-
Plano de recorte que se está colocando. Se aceptan nombres simbólicos del formulario GL_CLIP_PLANEi, donde i es un entero entre 0 y GL_MAX_CLIP_PLANES - 1.
-
ecuación
-
Dirección de una matriz de cuatro valores de punto flotante de precisión doble. Estos valores se interpretan como una ecuación de plano.
Valor devuelto
Esta función no devuelve ningún valor.
Códigos de error
La función glGetError puede recuperar los siguientes códigos de error.
| Nombre | Significado |
|---|---|
|
plane no era un valor aceptado. |
|
Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd. |
Comentarios
La geometría siempre se recorta en los límites de un frustum de seis planos en x, y y z. La función glClipPlane permite la especificación de planos adicionales, no necesariamente perpendiculares al eje x, eje y o eje z, con el que se recorta toda la geometría. Se pueden especificar hasta GL_MAX_CLIP_PLANES planos, donde GL_MAX_CLIP_PLANES es al menos seis en todas las implementaciones. Dado que la región de recorte resultante es la intersección de los espacios medios definidos, siempre es convexa.
La función glClipPlane especifica un espacio medio mediante una ecuación de plano de cuatro componentes. Cuando se llama a glClipPlane, la ecuación se transforma por el inverso de la matriz modelview y se almacena en las coordenadas oculares resultantes. Los cambios posteriores en la matriz modelview no tienen ningún efecto en los componentes almacenados de la ecuación del plano. Si el producto de punto de las coordenadas oculares de un vértice con los componentes de ecuación del plano almacenado es positivo o cero, el vértice está en relación con ese plano de recorte. De lo contrario, está fuera.
Use las funciones glEnable y glDisable para habilitar y deshabilitar planos de recorte. Llame a los planos de recorte con el argumento GL_CLIP_PLANEi, donde i es el número de plano.
De forma predeterminada, todos los planos de recorte se definen como (0,0,0,0) en coordenadas oculares y están deshabilitados.
Siempre es el caso de que GL_CLIP_PLANEi = GL_CLIP_PLANE0 + i.
Las siguientes funciones recuperan información relacionada con glClipPlane:
glIsEnabled con argumento GL_CLIP_PLANE i
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|