SampleLevel::SampleLevel(S,float,float,int,uint)-Funktion für Texture3D
Probieren Sie eine Textur auf der angegebenen Mipmapebene aus und gibt den Status des Vorgangs 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 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 -
LOD [ In]
-
Typ: float
[in ] Eine Zahl, die die Mipmapebene angibt. Wenn der Wert ≤ 0 ist, wird Mipmapebene 0 (größte Karte) verwendet. Der Bruchwert (sofern angegeben) wird verwendet, um zwischen zwei Mipmapebenen zu interpolieren.
-
Offset [ In]
-
Typ: int
Ein optionaler Texturkoordinatenoffset, der für jeden Texturobjekttyp verwendet werden kann. Der Offset wird vor der Stichprobenentnahme auf den Speicherort angewendet. Verwenden Sie einen Offset nur auf einem ganzzahligen miplevel. 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 -
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 Ressourcezugegriffen haben. Wenn Werte aus einer nicht zugeordneten Kachel stammen, gibt CheckAccessFullyMapped FALSE zurück.
Rückgabewert
Typ: DXGI _ FORMAT
Das Texturformat, bei dem es sich um einen der typisierten Werte handelt, die in DXGI _ FORMATaufgeführt sind.