Condividi tramite

Funzione SampleCmp::SampleCmp(S,float,float,int,float,uint) per Texture1D

  • Articolo

Esempi di una trama, usando un valore di confronto per rifiutare campioni, con un valore facoltativo per bloccare i valori di livello di dettaglio di esempio (LOD). Restituisce lo stato dell'operazione.

Sintassi

DXGI_FORMAT SampleCmp(
  in  SamplerState S,
  in  float        Location,
  in  float        CompareValue,
  in  int          Offset,
  in  float        Clamp,
  out uint         Status
);

Parametri

S [in]

Tipo: SamplerState

Stato di 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.

Texture-Object tipo Tipo di parametro
Trama1D float
Texture1DArray, Texture2D float2
Texture2DArray, Texture3D, TextureCube float3
TextureCubeArray float4

 

CompareValue [in]

Tipo: float

Valore a virgola mobile da usare come valore di confronto.

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. Usare un offset solo a un miplevel intero; in caso contrario, è possibile ottenere risultati che non si traducono bene nell'hardware. Il tipo di argomento dipende dal tipo di oggetto trama. Per altre informazioni, vedere Applicazione di offset integer.

Texture-Object tipo Tipo di parametro
Texture1D, Texture1DArray INT
Texture2D, Texture2DArray int2
Texture3D int3
TextureCube, TextureCubeArray non supportato

 

Blocca [in]

Tipo: float

Valore facoltativo per bloccare i valori LOD di esempio. Ad esempio, se si passa 2.0f per il valore di blocco, assicurarsi che nessun singolo esempio accesa 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'esempio, della raccolta o del carico corrispondenti hanno eseguito l'accesso ai riquadri mappati in una risorsa riquadri riquadri. Se i valori sono stati acquisiti da un riquadro non mappato, CheckAccessFullyMapped restituisce FALSE.

Valore restituito

Tipo: DXGI_FORMAT

Formato trama, ovvero uno dei valori tipizzati elencati in DXGI_FORMAT.

Vedi anche

Metodi SampleCmp