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

SampleLevel-Methoden

Texture2DArray