Função glClipPlane

A função glClipPlane especifica um plano no qual toda geometria é recortada.

Sintaxe

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

Parâmetros

avião

O plano de recorte que está sendo posicionado. Nomes simbólicos do formulário GL_CLIP_PLANEi, em que eu é um inteiro entre 0 e GL_MAX_CLIP_PLANES - 1, são aceitos.

equação

O endereço de uma matriz de quatro valores de ponto flutuante de precisão dupla. Esses valores são interpretados como uma equação de plano.

Retornar valor

Essa função não retorna um valor.

Códigos de erro

Os códigos de erro a seguir podem ser recuperados pela função glGetError .

Comentários

A geometria é sempre recortada contra os limites de um frusto de seis planos em x, y e z. A função glClipPlane permite a especificação de planos adicionais, não necessariamente perpendiculares ao eixo x, eixo y ou eixo z, no qual toda geometria é recortada. Até GL_MAX_CLIP_PLANES planos podem ser especificados, em que GL_MAX_CLIP_PLANES é pelo menos seis em todas as implementações. Como a região de recorte resultante é a interseção dos meio-espaços definidos, ela é sempre convexa.

A função glClipPlane especifica um meio espaço usando uma equação de plano de quatro componentes. Quando você chama glClipPlane, a equação é transformada pelo inverso da matriz de modelview e armazenada nas coordenadas oculares resultantes. As alterações subsequentes na matriz de visão de modelo não têm efeito sobre os componentes armazenados da equação de plano. Se o produto de ponto das coordenadas oculares de um vértice com os componentes de equação do plano armazenado for positivo ou zero, o vértice estará em relação a esse plano de recorte. Caso contrário, ele está fora.

Use as funções glEnable e glDisable para habilitar e desabilitar planos de recorte. Chame planos de recorte com o argumento GL_CLIP_PLANEi, em que é o número do plano.

Por padrão, todos os planos de recorte são definidos como (0,0,0,0) em coordenadas oculares e são desabilitados.

É sempre o caso que GL_CLIP_PLANEi = GL_CLIP_PLANE0 + i.

As seguintes funções recuperam informações relacionadas ao glClipPlane:

glGetClipPlane

glIsEnabled com argumento GL_CLIP_PLANE i

Requisitos

Confira também

glBegin

glDisable

glEnable

glEnd

glGetClipPlane

glIsEnabled