Méthode IDirect3DDevice9 ::SetClipPlane (d3d9.h)
Définit les coefficients d’un plan de découpage défini par l’utilisateur pour l’appareil.
Syntaxe
HRESULT SetClipPlane(
[in] DWORD Index,
[in] const float *pPlane
);
Paramètres
[in] Index
Type : DWORD
Index du plan de découpage pour lequel les coefficients d’équation du plan doivent être définis.
[in] pPlane
Type : const float*
Pointeur vers une adresse d’un tableau de quatre éléments de valeurs qui représentent les coefficients de plan de découpage à définir, sous la forme de l’équation de plan général. Consultez la section Notes.
Valeur de retour
Type : HRESULT
Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour est D3DERR_INVALIDCALL. Cette erreur indique que la valeur dans Index dépasse l’index de plan de découpage maximal pris en charge par l’appareil ou que le tableau de pPlane n’est pas assez grand pour contenir quatre valeurs à virgule flottante.
Remarques
Les coefficients que cette méthode définit prennent la forme de l’équation de plan général. Si les valeurs du tableau de pPlane étaient étiquetées A, B, C et D dans l’ordre dans lequel elles apparaissent dans le tableau, elles s’intégreraient à l’équation de plan général de sorte que Ax + By + Cz + Dw = 0. Un point avec des coordonnées homogènes (x, y, z, w) est visible dans la moitié de l’espace du plan si Ax + By + Cz + Dw >= 0. Les points qui existent derrière le plan de découpage sont coupés de la scène.
Lorsque le pipeline de fonction fixe est utilisé, les équations de plan sont supposées se trouver dans l’espace mondial. Lorsque le pipeline programmable est utilisé, les équations de plan sont supposées se trouver dans l’espace de découpage (le même espace que les sommets de sortie).
Cette méthode n’active pas l’équation du plan de découpage en cours de définition. Pour activer un plan de découpage, définissez le bit correspondant dans la valeur DWORD appliquée à l’état de rendu D3DRS_CLIPPLANEENABLE.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | d3d9.h (inclure D3D9.h) |
| Bibliothèque | D3D9.lib |