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

Beispiel für eine Textur mit einem optionalen Wert zum Klammern von LOD-Werten (Sample Level-of-Detail) und gibt 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]

Ein Samplerzustand. Dies ist ein In einer Effektdatei deklariertes Objekt, das Zustandszuweisungen enthält.

Standort [in]

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]

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 auf einer ganzzahligen MIP-Ebene. andernfalls erhalten Sie möglicherweise Ergebnisse, die sich nicht gut auf die Hardware übersetzen lassen. Der Argumenttyp ist vom Texturobjekttyp abhängig. Weitere Informationen finden Sie unter Anwenden ganzzahliger Offsets.

Texture-Object Typ	Parametertyp
Texture1D, Texture1DArray	INT
Texture2D, Texture2DArray	int2
Texture3D	int3
TextureCube, TextureCubeArray	Nicht unterstützt

 

Klemme [in]

Ein optionaler Wert zum Klammern von BEISPIEL-LOD-Werten. Wenn Sie beispielsweise 2.0f für den Klemmwert übergeben, stellen Sie sicher, dass kein einzelnes Beispiel auf eine MIP-Ebene unter 2,0f zugreift.

Status [out]

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 gekachelten Ressource zugegriffen haben. Wenn Werte von einer nicht zugeordneten Kachel übernommen wurden, gibt CheckAccessFullyMappedFALSE zurück.

Rückgabewert

Das Texturformat, das einer der in DXGI_FORMAT aufgeführten typisierten Werte ist.

Weitere Informationen

Beispielmethoden

Texture3D