Método IDirect3DDevice9::SetClipPlane (d3d9.h)
Establece los coeficientes de un plano de recorte definido por el usuario para el dispositivo.
Sintaxis
HRESULT SetClipPlane(
[in] DWORD Index,
[in] const float *pPlane
);
Parámetros
[in] Index
Tipo: DWORD
Índice del plano de recorte para el que se van a establecer los coeficientes de ecuación del plano.
[in] pPlane
Tipo: const float*
Puntero a una dirección de una matriz de cuatro elementos de valores que representan los coeficientes del plano de recorte que se van a establecer, en forma de ecuación del plano general. Vea la sección Comentarios.
Valor devuelto
Tipo: HRESULT
Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto es D3DERR_INVALIDCALL. Este error indica que el valor de Index supera el índice máximo del plano de recorte admitido por el dispositivo o que la matriz de pPlane no es lo suficientemente grande como para contener cuatro valores de punto flotante.
Comentarios
Los coeficientes que establece este método toman la forma de la ecuación del plano general. Si los valores de la matriz de pPlane se etiquetaron como A, B, C y D en el orden en que aparecen en la matriz, caberían en la ecuación del plano general para que Ax + By + Cz + Dw = 0. Un punto con coordenadas homogéneas (x, y, z, w) es visible en el espacio medio del plano si Ax + By + Cz + Dw >= 0. Los puntos que existen detrás del plano de recorte se recortan desde la escena.
Cuando se usa la canalización de función fija, se supone que las ecuaciones del plano están en el espacio mundial. Cuando se usa la canalización programable, se supone que las ecuaciones del plano están en el espacio de recorte (el mismo espacio que los vértices de salida).
Este método no habilita la ecuación del plano de recorte que se va a establecer. Para habilitar un plano de recorte, establezca el bit correspondiente en el valor DWORD aplicado al estado de representación D3DRS_CLIPPLANEENABLE.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | d3d9.h (incluya D3D9.h) |
| Library | D3D9.lib |