Freigeben über


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

Stichproben einer Textur2D mit einem Farbverlauf, um die Art und Weise zu beeinflussen, wie die Stichprobenposition berechnet wird, mit einem optionalen Wert, mit dem LoD-Werte (Level-of-Detail) für Stichproben eingeklemmt 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 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

 

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 dem Sampling auf die Position angewendet. Verwenden Sie einen Offset nur auf einer ganzzahligen Mipebene. Andernfalls erhalten Sie möglicherweise Ergebnisse, die nicht gut auf Hardware übertragen werden. Der Argumenttyp ist vom Texturobjekttyp abhängig. Weitere Informationen finden Sie unter Anwenden von Ganzzahloffsets.

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

 

Clamp [in]

Typ: float

Ein optionaler Wert zum Klammern von LOD-Beispielwerten. Wenn Sie beispielsweise 2,0f für den Clampwert übergeben, stellen Sie sicher, dass kein einzelnes Beispiel auf einen MIP-Wert 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