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

  • Article

Définit le status du clip.

Syntaxe

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

Paramètres

[in] pClipStatus

Type : const D3DCLIPSTATUS9*

Pointeur vers une structure D3DCLIPSTATUS9, décrivant les paramètres de status de clip à définir.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si l’un des arguments n’est pas valide, la valeur de retour est D3DERR_INVALIDCALL.

Notes

La status est utilisée pendant le traitement du vertex logiciel. Par conséquent, cette méthode n’est pas prise en charge sur les appareils de traitement matériel purs ou non purs. Pour plus d’informations sur les appareils purs, consultez D3DCREATE.

Lorsque le découpage est activé pendant le traitement du vertex (par IDirect3DDevice9::P rocessVertices, IDirect3DDevice9::D rawPrimitive ou d’autres fonctions de dessin), Direct3D calcule un code clip pour chaque vertex. Le code clip est une combinaison de bits D3DCS_*. Lorsqu’un sommet se trouve en dehors d’un plan de découpage particulier, le bit correspondant est défini dans le code de découpage. Direct3D gère le clip status à l’aide de D3DCLIPSTATUS9, qui a des membres ClipUnion et ClipIntersection. ClipUnion est un « OR » au niveau du bit de tous les codes clip de vertex et ClipIntersection est un « AND » au niveau du bit de tous les codes clip de vertex. Les valeurs initiales sont zéro pour ClipUnion et 0xFFFFFFFF pour ClipIntersection. Lorsque D3DRS_CLIPPING a la valeur FALSE, ClipUnion et ClipIntersection ont la valeur zéro. Direct3D met à jour le clip status pendant les appels de dessin. Pour calculer les status de découpage d’un objet particulier, définissez ClipUnion et ClipIntersection sur leur valeur initiale et continuez à dessiner.

L’status clip n’est pas mis à jour par IDirect3DDevice9::D rawRectPatch et IDirect3DDevice9::D rawTriPatch, car il n’existe aucune émulation logicielle pour eux.

Spécifications

   
Plateforme cible Windows
En-tête d3d9helper.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DDevice9

IDirect3DDevice9::GetClipStatus