Funzione XMVector3Project (directxmath.h)
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) |