Share via


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

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,
  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.

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

SampleLevel-Methoden

TextureCube