SampleLevel::SampleLevel(S,float,float,int,uint)-Funktion für Texture2DArray
Beispiele eine Textur auf der angegebenen mipmap-Ebene und gibt den Status für den 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 Samplerstatus. Dies ist ein Objekt, das in einer Effektdatei deklariert ist, die Zustandszuweisungen enthält.
-
Standort [in]
-
Typ: Float
Texturkoordinaten Der Argumenttyp hängt vom Texturobjekttyp ab.
Texture-Object Typ Parametertyp Texture1D 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 (falls angegeben) wird verwendet, um zwischen zwei mipmap-Ebenen zu interpolieren.
-
Offset [in]
-
Typ: int
Ein optionaler Texturkoordinatenversatz, der für jeden Texturobjekttyp verwendet werden kann; der Offset wird vor der Stichprobe auf den Speicherort angewendet. Verwenden Sie einen Offset nur auf ganzzahliger MIP-Ebene; Andernfalls erhalten Sie möglicherweise Ergebnisse, die nicht gut in Hardware übersetzt werden. Der Argumenttyp hängt vom Texturobjekttyp ab. 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 Systemfunktion CheckAccessFullyMapped . CheckAccessFullyMapped gibt TRUE zurück, wenn alle Werte aus dem entsprechenden Beispiel, Sammeln oder Laden-Vorgang auf zugeordnete Kacheln in einer gruppierten Ressource zugreifen. Wenn alle Werte aus einer nicht zugeordneten Kachel stammen, gibt CheckAccessFullyMappedFALSE zurück.
Rückgabewert
Typ: DXGI_FORMAT
Das Texturformat, das eine der in DXGI_FORMAT aufgeführten typierten Werte ist.
Siehe auch