IDirect3DDevice9 ::GetClipPlane, méthode (d3d9.h)

  • Article

Récupère les coefficients d’un plan de découpage défini par l’utilisateur pour l’appareil.

Syntaxe

HRESULT GetClipPlane(
  [in]  DWORD Index,
  [out] float *pPlane
);

Paramètres

[in] Index

Type : DWORD

Index du plan de découpage pour lequel les coefficients d’équation du plan sont récupérés.

[out] pPlane

Type : float*

Pointeur vers un tableau de valeurs à quatre éléments qui représentent les coefficients du plan de découpage 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 sur pPlane n’est pas assez grand pour contenir quatre valeurs à virgule flottante.

Remarques

Cette méthode ne retourne pas l’état de l’appareil pour un appareil créé à l’aide de D3DCREATE_PUREDEVICE. Si vous souhaitez utiliser cette méthode, vous devez créer votre appareil avec l’une des autres valeurs de D3DCREATE. »

Les coefficients signalés par cette méthode prennent la forme de l’équation de plan général. Si les valeurs du tableau au niveau de pPlane étaient étiquetées A, B, C et D dans l’ordre dans lequel elles apparaissent dans le tableau, elles tiennent dans 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 sur ou derrière le plan de découpage sont extraits de la scène.

L’équation de plan utilisée par cette méthode existe dans l’espace mondial et est définie par un appel précédent à la méthode IDirect3DDevice9 ::SetClipPlane .

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d9.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DDevice9

IDirect3DDevice9 ::SetClipPlane