SampleCmp::SampleCmp(S,float,float,int,float,uint)-Funktion für Texture1D
Samples a texture, using a comparison value to reject samples, with an optional value to clamp sample level-of-detail (LOD) values to . Gibt den Status des Vorgangs zurück.
Syntax
DXGI_FORMAT SampleCmp(
in SamplerState S,
in float Location,
in float CompareValue,
in int Offset,
in float Clamp,
out uint Status
);
Parameter
-
S [ in]
-
Typ: SamplerState
Ein Samplerzustand. Dies ist ein Objekt, das in einer Effektdatei deklariert ist, die 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 bei einer ganzzahligen MIP-Ebene. Andernfalls erhalten Sie möglicherweise Ergebnisse, die sich nicht gut in die Hardware übersetzen lassen. Der Argumenttyp ist vom Texturobjekttyp abhängig. Weitere Informationen finden Sie unter Anwenden von ganzzahligen Offsets.
Texture-Object Typ Parametertyp Texture1D, Texture1DArray INT Texture2D, Texture2DArray int2 Texture3D int3 TextureCube, TextureCubeArray Nicht unterstützt -
Klammer [ In]
-
Typ: float
Ein optionaler Wert, an den LoD-Beispielwerte klammern werden. Wenn Sie z. B. 2,0f für den Klammerwert übergeben, stellen Sie sicher, dass keine einzelne Stichprobe auf eine Mip-Ebene unter 2,0f zuf zutritt.
-
Status [ out]
-
Typ: uint
Der Status des Vorgangs. Sie können nicht direkt auf den Status zugreifen. Übergeben Sie stattdessen den Status an die systeminterne CheckAccessFullyMapped-Funktion. CheckAccessFullyMapped gibt TRUE zurück, wenn alle Werte aus dem entsprechenden Beispiel-, Gather- oder Load-Vorgang auf zugeordnete Kacheln in einer gekachelten Ressource zugegriffen haben. Wenn Werte aus einer nicht zugeordneten Kachel übernommen wurden, gibt CheckAccessFullyMapped FALSE zurück.
Rückgabewert
Typ: DXGI _ FORMAT
Das Texturformat, bei dem es sich um einen der typierten Werte handelt, die in DXGI _ FORMAT aufgeführt sind.