Metodo IDirect3DDevice9::SetClipPlane (d3d9.h)

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

Sintassi

HRESULT SetClipPlane(
  [in] DWORD       Index,
  [in] const float *pPlane
);

Parametri

[in] Index

Tipo: DWORD

Indice del piano di ritaglio per il quale devono essere impostati i coefficienti dell'equazione del piano.

[in] pPlane

Tipo: const float*

Puntatore a un indirizzo di una matrice di quattro elementi di valori che rappresentano i coefficienti del piano di ritaglio da impostare, sotto forma di equazione generale del piano. 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

I coefficienti impostati 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 dietro il piano di ritaglio vengono ritagliati dalla scena.

Quando viene usata la pipeline di funzioni fisse, si presuppone che le equazioni del piano si trovino nello spazio globale. Quando si utilizza la pipeline programmabile, si presuppone che le equazioni del piano si trovino nello spazio di ritaglio (lo stesso spazio dei vertici di output).

Questo metodo non abilita l'equazione del piano di ritaglio impostata. Per abilitare un piano di ritaglio, impostare il bit corrispondente nel valore DWORD applicato allo stato di rendering D3DRS_CLIPPLANEENABLE.

Requisiti

Vedi anche

IDirect3DDevice9

IDirect3DDevice9::GetClipPlane