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
GL_INVALID_ENUM	plane no era un valor aceptado.
GL_INVALID_OPERATION	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:

glGetClipPlane

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	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glDisable

glEnable

glEnd

glGetClipPlane

glIsEnabled