Freigeben über


SampleGrad::SampleGrad(S,float,float,float,int,float)-Funktion für Texture3D

Zeigt eine Textur mithilfe eines Farbverlaufs an, um die Berechnung der Stichprobenposition zu beeinflussen, mit einem optionalen Wert, mit dem LOD-Werte (Level-of-Detail) von Beispielen geklemmt werden können.

Syntax

DXGI_FORMAT SampleGrad(
  in SamplerState S,
  in float        Location,
  in float        DDX,
  in float        DDY,
  in int          Offset,
  in float        Clamp
);

Parameter

S [in]

Typ: SamplerState

Ein Samplerzustand. Dies ist ein In einer Effektdatei deklariertes Objekt, das 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

 

DDX [in]

Typ: float

Die Änderungsrate der Oberflächengeometrie in x-Richtung. Der Argumenttyp ist vom Texturobjekttyp abhängig.

Texture-Object Typ Parametertyp
Texture1D, Texture1DArray float
Texture2D, Texture2DArray float2
Texture3D, TextureCube, TextureCubeArray float3
Texture2DMS, Texture2DMSArray Nicht unterstützt

 

DDY [in]

Typ: float

Die Änderungsrate der Oberflächengeometrie in y-Richtung. Der Argumenttyp ist vom Texturobjekttyp abhängig.

Texture-Object Typ Parametertyp
Texture1D, Texture1DArray float
Texture2D, Texture2DArray float2
Texture3D, TextureCube, TextureCubeArray float3
Texture2DMS, Texture2DMSArray Nicht unterstützt

 

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 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]

Typ: float

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.

Rückgabewert

Typ: DXGI_FORMAT

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

Siehe auch

SampleGrad-Methoden

Texture3D