Funzione SampleGrad::SampleGrad(S,float,float,float,int,float,uint) per Texture2D
Campiona un oggetto Texture2D, usando una sfumatura per influenzare il modo in cui viene calcolata la posizione del campione, con un valore facoltativo per bloccare i valori del livello di dettaglio (LOD) del campione. Restituisce lo stato relativo all'operazione.
Sintassi
DXGI_FORMAT SampleGrad(
in SamplerState S,
in float Location,
in float DDX,
in float DDY,
in int Offset,
in float Clamp,
out uint Status
);
Parametri
-
S [in]
-
Tipo: SamplerState
Stato sampler. Si tratta di un oggetto dichiarato in un file di effetto che contiene assegnazioni di stato.
-
Posizione [in]
-
Tipo: float
Coordinate di trama. Il tipo di argomento dipende dal tipo di oggetto trama.
tipo Texture-Object Tipo di parametro Texture1D float Texture1DArray, Texture2D float2 Texture2DArray, Texture3D, TextureCube float3 TextureCubeArray float4 -
DDX [in]
-
Tipo: float
Frequenza di modifica della geometria della superficie nella direzione x. Il tipo di argomento dipende dal tipo di oggetto trama.
tipo Texture-Object Tipo di parametro Texture1D, Texture1DArray float Texture2D, Texture2DArray float2 Texture3D, TextureCube, TextureCubeArray float3 Texture2DMS, Texture2DMSArray non supportato -
DDY [in]
-
Tipo: float
Frequenza di modifica della geometria della superficie nella direzione y. Il tipo di argomento dipende dal tipo di oggetto trama.
tipo Texture-Object Tipo di parametro Texture1D, Texture1DArray float Texture2D, Texture2DArray float2 Texture3D, TextureCube, TextureCubeArray float3 Texture2DMS, Texture2DMSArray non supportato -
Offset [in]
-
Tipo: int
Offset di coordinate di trama facoltativo, che può essere usato per qualsiasi tipo di oggetto trama; l'offset viene applicato alla posizione prima del campionamento. Usa un offset solo in corrispondenza di un miplevel intero; in caso contrario, è possibile ottenere risultati che non si traducono correttamente nell'hardware. Il tipo di argomento dipende dal tipo di oggetto trama. Per altre informazioni, vedi Applicazione di offset integer.
tipo Texture-Object Tipo di parametro Texture1D, Texture1DArray INT Texture2D, Texture2DArray int2 Texture3D int3 TextureCube, TextureCubeArray non supportato -
Morsetto [in]
-
Tipo: float
Valore facoltativo per bloccare i valori LOD campione. Ad esempio, se si passa 2,0f per il valore di blocco, assicurarsi che nessun singolo campione accesa a un livello mip inferiore a 2,0f.
-
Stato [out]
-
Tipo: uint
Stato dell'operazione. Non è possibile accedere direttamente allo stato; Passare invece lo stato alla funzione intrinseca CheckAccessFullyMapped . CheckAccessFullyMapped restituisce TRUE se tutti i valori dell'operazione Sample, Gather o Load hanno eseguito l'accesso a riquadri mappati in una risorsa affiancata. Se sono stati acquisiti valori da un riquadro non mappato, CheckAccessFullyMapped restituisce FALSE.
Valore restituito
Tipo: DXGI_FORMAT
Formato trama, che è uno dei valori tipizzati elencati in DXGI_FORMAT.
Vedi anche