Funzione XMVector3Project (directxmath.h)

  • Articolo

Proiettare un vettore 3D dallo spazio degli oggetti nello spazio dello schermo.

Sintassi

XMVECTOR XM_CALLCONV XMVector3Project(
  [in] FXMVECTOR V,
  [in] float     ViewportX,
  [in] float     ViewportY,
  [in] float     ViewportWidth,
  [in] float     ViewportHeight,
  [in] float     ViewportMinZ,
  [in] float     ViewportMaxZ,
  [in] FXMMATRIX Projection,
  [in] CXMMATRIX View,
  [in] CXMMATRIX World
) noexcept;

Parametri

[in] V

Vettore 3D nello spazio degli oggetti che verrà proiettato nello spazio dello schermo.

[in] ViewportX

Coordinata pixel dell'angolo superiore sinistro del riquadro di visualizzazione. A meno che non si voglia eseguire il rendering in un subset della superficie, questo parametro può essere impostato su 0.

[in] ViewportY

Coordinata pixel dell'angolo superiore sinistro del viewport nell'area di destinazione di rendering. A meno che non si voglia eseguire il rendering in un subset della superficie, questo parametro può essere impostato su 0.

[in] ViewportWidth

Dimensione di larghezza del volume clip, in pixel. A meno che non si esegue il rendering solo in un subset della superficie, questo parametro deve essere impostato sulla dimensione di larghezza della superficie di destinazione di rendering.

[in] ViewportHeight

Dimensione altezza del volume clip, in pixel. A meno che non si esegue il rendering solo in un subset della superficie, questo parametro deve essere impostato sulla dimensione di altezza della superficie di destinazione di rendering.

[in] ViewportMinZ

Insieme a ViewportMaxZ, valore che descrive l'intervallo di valori di profondità in cui deve essere eseguito il rendering di una scena, i valori minimi e massimi del volume clip. La maggior parte delle applicazioni imposta questo valore su 0,0f. Il ritaglio viene eseguito dopo aver applicato la matrice di proiezione.

[in] ViewportMaxZ

Insieme a MinZ, valore che descrive l'intervallo di valori di profondità in cui deve essere eseguito il rendering di una scena, i valori minimi e massimi del volume clip. La maggior parte delle applicazioni imposta questo valore su 1,0f. Il ritaglio viene eseguito dopo aver applicato la matrice di proiezione.

[in] Projection

Matrice di proiezione.

[in] View

Matrice di visualizzazione.

[in] World

Matrice mondiale.

Valore restituito

Restituisce un vettore nello spazio dello schermo.

Commenti

I parametri ViewportX, ViewportY, ViewportWidth e ViewportHeight descrivono la posizione e le dimensioni del viewport nella superficie di destinazione di rendering. In genere, le applicazioni eseguono il rendering dell'intera superficie di destinazione; quando si esegue il rendering in una superficie 640*480, questi parametri devono essere rispettivamente 0, 0, 640 e 480. ViewportMinZ e ViewportMaxZ sono in genere impostati su 0,0f e 1.0f, ma possono essere impostati su altri valori per ottenere effetti specifici.

Requisiti della piattaforma

Microsoft Visual Studio 2010 o Microsoft Visual Studio 2012 con Windows SDK per Windows 8. Supportato per app desktop Win32, app di Windows Store e Windows Phone 8 app.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione directxmath.h (include DirectXMath.h)

Vedi anche

Funzioni di trasformazione vettore DirectXMath library 3D

XMVector3ProjectStream