SampleCmp::SampleCmp(S,float,float,int,float)-Funktion für Texture2DArray

Beispiel für eine Textur mithilfe eines Vergleichswerts zum Ablehnen von Beispielen mit einem optionalen Wert zum Klammern von LOD-Werten (Sample Level-of-Detail).

Syntax

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

Parameter

S [in]

Typ: SamplerState

Ein Samplerzustand. Dies ist ein In einer Effektdatei deklariertes Objekt, das Zustandszuweisungen enthält.

Standort [in]

Typ: float

Texturkoordinaten Der Argumenttyp ist vom Texturobjekttyp abhängig.

Texture-Object Typ	Parametertyp
Texture1D	float
Texture1DArray, Texture2D	float2
Texture2DArray, Texture3D, TextureCube	float3
TextureCubeArray	float4

 

CompareValue [in]

Typ: float

Ein Gleitkommawert, der als Vergleichswert verwendet werden soll.

Offset [in]

Typ: int

Ein optionaler Texturkoordinatenoffset, der für jeden Texturobjekttyp verwendet werden kann; der Offset wird vor der Stichprobenentnahme auf die Position angewendet. Verwenden Sie einen Offset nur auf einer ganzzahligen MIP-Ebene. andernfalls erhalten Sie möglicherweise Ergebnisse, die sich nicht gut auf die Hardware übersetzen lassen. Der Argumenttyp ist vom Texturobjekttyp abhängig. Weitere Informationen finden Sie unter Anwenden ganzzahliger Offsets.

Texture-Object Typ	Parametertyp
Texture1D, Texture1DArray	INT
Texture2D, Texture2DArray	int2
Texture3D	int3
TextureCube, TextureCubeArray	Nicht unterstützt

 

Klemme [in]

Typ: float

Ein optionaler Wert zum Klammern von BEISPIEL-LOD-Werten. Wenn Sie beispielsweise 2.0f für den Klemmwert übergeben, stellen Sie sicher, dass kein einzelnes Beispiel auf eine MIP-Ebene unter 2,0f zugreift.

Rückgabewert

Typ: DXGI_FORMAT

Das Texturformat, das einer der in DXGI_FORMAT aufgeführten typisierten Werte ist.

Siehe auch

SampleCmp-Methoden