Texture1DArray::Sample(S,float,int,float,uint)-Funktion

Probieren Sie eine Textur mit einem optionalen Wert zum Klammern von LoD-Werten (Sample Level of Detail) aus, und gibt den Status des Vorgangs zurück.

Syntax

DXGI_FORMAT Sample(
  in  SamplerState S,
  in  float        Location,
  in  int          Offset,
  in  float        Clamp,
  out uint         Status
);

Parameter

S [in]

Typ: SamplerState

Ein Samplerstatus. Dies ist ein Objekt, das in einer Effektdatei deklariert ist, die Zustandszuweisungen enthält.

Ort [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

 

Offset [in]

Typ: int

Ein optionaler Texturkoordinatenversatz, der für einen beliebigen Texturobjekttyp verwendet werden kann; der Offset wird vor dem Sampling auf die Position angewendet. Verwenden Sie einen Offset nur auf einer ganzzahligen Mipebene; andernfalls erhalten Sie möglicherweise Ergebnisse, die nicht gut in die Hardware übersetzt werden. 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

 

Klammer [in]

Typ: Float

Ein optionaler Wert zum Klammern von LOD-Werten Wenn Sie z. B. 2,0f für den Klammerwert übergeben, stellen Sie sicher, dass kein einzelnes Beispiel auf einen MIP-Wert zugreift, der kleiner als 2,0f ist.

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 Funktion CheckAccessFullyMapped . CheckAccessFullyMapped gibt TRUE zurück, wenn alle Werte aus dem entsprechenden Beispiel-, Gather- oder Load-Vorgang auf zugeordnete Kacheln in einer gruppierten Ressource zugegriffen haben. Wenn 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

Beispielmethoden