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 .
| Nome | Significado |
|---|---|
|
plane não era um valor aceito. |
|
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd. |
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:
glIsEnabled com argumento GL_CLIP_PLANE i
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|