SampleLevel::SampleLevel(S,float,float,int,uint)-Funktion für Texture2D

Samples a Texture2D on the specified mipmap level and returns status about the operation.

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 Mipmap-Ebene 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 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

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.

Siehe auch

SampleLevel-Methoden