Metodo IDirect3DDevice9::SetClipPlane (d3d9helper.h)

  • Articolo

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 di equazione del piano.

[in] pPlane

Tipo: const float*

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

Valore restituito

Tipo: HRESULT

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

Commenti

I coefficienti impostati da questo metodo prendono la forma dell'equazione del piano generale. Se i valori nella matrice in pPlane sono stati etichettati A, B, C e D nell'ordine in cui appaiono nella matrice, si adattano all'equazione del piano generale in modo che Ax + By + Cz + Dw = 0. Un punto con coordinate omogenee (x, y, z, w) è visibile nella metà spazio del piano se Ax + By + Cz + Dw >= 0. I punti che esistono dietro il piano di ritaglio vengono ritagliati dalla scena.

Quando viene usata la pipeline di funzione fissa, si presuppone che le equazioni del piano siano nello spazio mondiale. Quando viene usata 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

Requisito Valore
Piattaforma di destinazione Windows
Intestazione d3d9helper.h (include D3D9.h)
Libreria D3D9.lib

Vedi anche

IDirect3DDevice9

IDirect3DDevice9::GetClipPlane