Metodo IDirect3DDevice9::GetClipPlane (d3d9.h)

Recupera i coefficienti di un piano di ritaglio definito dall'utente per il dispositivo.

Sintassi

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

Parametri

[in] Index

Tipo: DWORD

Indice del piano di ritaglio per cui vengono recuperati i coefficienti dell'equazione del piano.

[out] pPlane

Tipo: float*

Puntatore a una matrice di valori a quattro elementi che rappresentano i coefficienti del piano di ritaglio sotto forma di equazione del piano generale. Vedere la sezione Osservazioni.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene D3D_OK. Se il metodo ha esito negativo, il valore restituito viene D3DERR_INVALIDCALL. Questo errore indica che il valore in Index supera l'indice massimo del piano di ritaglio supportato dal dispositivo o che la matrice in pPlane non è sufficientemente grande per contenere quattro valori a virgola mobile.

Commenti

Questo metodo non restituirà lo stato del dispositivo per un dispositivo creato usando D3DCREATE_PUREDEVICE. Se si vuole usare questo metodo, è necessario creare il dispositivo con uno degli altri valori in D3DCREATE."

I coefficienti segnalati da questo metodo assumono la forma dell'equazione generale del piano. Se i valori nella matrice in corrispondenza di pPlane sono stati etichettati A, B, C e D nell'ordine in cui vengono visualizzati nella matrice, questi vengono inseriti nell'equazione del piano generale in modo che Ax + By + Ctrl + Dw = 0. Un punto con coordinate omogenee (x, y, z, w) è visibile nello spazio intermedio del piano se Ax + By + Distribuisci + Dw >= 0. I punti presenti sul piano di ritaglio o dietro il piano di ritaglio vengono ritagliati dalla scena.

L'equazione del piano usata da questo metodo esiste nello spazio globale ed è impostata da una chiamata precedente al metodo IDirect3DDevice9::SetClipPlane .

Requisiti

Vedi anche

IDirect3DDevice9

IDirect3DDevice9::SetClipPlane