SampleLevel::SampleLevel(S,float,float,int,uint)-Funktion für Texture1DArray
Stichproben einer Textur auf der angegebenen Mipmap-Ebene und geben status zum Vorgang zurück.
Syntax
DXGI_FORMAT SampleLevel(
in SamplerState S,
in float Location,
in float LOD,
in int Offset,
out uint Status
);
Parameter
-
S [in]
-
Typ: SamplerState
Ein Samplerzustand. Dies ist ein Objekt, das in einer Effektdatei deklariert wurde, die Zustandszuweisungen enthält.
-
Standort [in]
-
Typ: float
Texturkoordinaten Der Argumenttyp ist vom Texturobjekttyp abhängig.
Texture-Object Typ Parametertyp Textur1D float Texture1DArray, Texture2D float2 Texture2DArray, Texture3D, TextureCube float3 TextureCubeArray float4 -
LOD [in]
-
Typ: float
[in] Eine Zahl, die die Mipmap-Ebene angibt. Wenn der Wert ≤ 0 ist, wird mipmap Level 0 (größte Karte) verwendet. Der Bruchwert (sofern angegeben) wird verwendet, um zwischen zwei Mipmap-Ebenen zu interpolieren.
-
Offset [in]
-
Typ: int
Ein optionaler Texturkoordinatenoffset, der für jeden Texturobjekttyp verwendet werden kann; Der Offset wird vor dem Sampling auf die Position angewendet. Verwenden Sie einen Offset nur auf einer ganzzahligen Mipebene. Andernfalls erhalten Sie möglicherweise Ergebnisse, die nicht gut auf Hardware übertragen werden. Der Argumenttyp ist vom Texturobjekttyp abhängig. Weitere Informationen finden Sie unter Anwenden von Ganzzahloffsets.
Texture-Object Typ Parametertyp Texture1D, Texture1DArray INT Texture2D, Texture2DArray int2 Texture3D int3 TextureCube, TextureCubeArray Nicht unterstützt -
Status [out]
-
Typ: uint
Der Status des Vorgangs. Sie können nicht direkt auf die status zugreifen. Übergeben Sie stattdessen die status an die systeminterne Funktion CheckAccessFullyMapped. CheckAccessFullyMapped gibt TRUE zurück, wenn alle Werte aus dem entsprechenden Sample-, Gather- oder Load-Vorgang auf zugeordnete Kacheln in einer kachelten Ressource zugegriffen haben. Wenn Werte aus einer nicht zugeordneten Kachel stammen, gibt CheckAccessFullyMappedFALSE zurück.
Rückgabewert
Typ: DXGI_FORMAT
Das Texturformat, das einer der in DXGI_FORMAT aufgeführten typisierten Werte ist.
Siehe auch