Método IDirect3DDevice9::SetClipStatus (d3d9helper.h)

Establece el estado del clip.

Sintaxis

HRESULT SetClipStatus(
  [in] const D3DCLIPSTATUS9 *pClipStatus
);

Parámetros

[in] pClipStatus

Tipo: const D3DCLIPSTATUS9*

Puntero a una estructura D3DCLIPSTATUS9 , que describe la configuración de estado del clip que se va a establecer.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si uno de los argumentos no es válido, el valor devuelto es D3DERR_INVALIDCALL.

Comentarios

El estado del clip se usa durante el procesamiento de vértices de software. Por lo tanto, este método no se admite en dispositivos de procesamiento de hardware puros o no depuro. Para obtener más información sobre los dispositivos puros, consulte D3DCREATE.

Cuando se habilita el recorte durante el procesamiento de vértices (por IDirect3DDevice9::P rocessVertices, IDirect3DDevice9::D rawPrimitive u otras funciones de dibujo), Direct3D calcula un código de clip para cada vértice. El código de clip es una combinación de bits D3DCS_*. Cuando un vértice está fuera de un plano de recorte determinado, el bit correspondiente se establece en el código de recorte. Direct3D mantiene el estado del clip mediante D3DCLIPSTATUS9, que tiene miembros ClipUnion y ClipIntersection. ClipUnion es un "OR" bit a bit de todos los códigos de clip de vértice y ClipIntersection es un "AND" bit a bit de todos los códigos de clip de vértices. Los valores iniciales son cero para ClipUnion y 0xFFFFFFFF para ClipIntersection. Cuando D3DRS_CLIPPING se establece en FALSE, ClipUnion y ClipIntersection se establecen en cero. Direct3D actualiza el estado del clip durante las llamadas de dibujo. Para calcular el estado del clip de un objeto determinado, establezca ClipUnion y ClipIntersection en su valor inicial y continúe dibujando.

El estado del clip no se actualiza mediante IDirect3DDevice9::D rawRectPatch e IDirect3DDevice9::D rawTriPatch porque no hay ninguna emulación de software para ellos.

Requisitos

Consulte también

IDirect3DDevice9

IDirect3DDevice9::GetClipStatus