SampleGrad::SampleGrad(S,float,float,float,int,float,uint)-Funktion für Texture2D
Beispiel für Eine Textur2D mit einem Farbverlauf, um die Berechnung des Beispielstandorts zu beeinflussen, mit einem optionalen Wert, mit dem LoD-Werte (Level-of-Detail) von Beispielen geklemmt werden können. Gibt status zum Vorgang zurück.
Syntax
DXGI_FORMAT SampleGrad(
in SamplerState S,
in float Location,
in float DDX,
in float DDY,
in int Offset,
in float Clamp,
out uint Status
);
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.
-
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 gekachelten Ressource zugegriffen haben. Wenn Werte von einer nicht zugeordneten Kachel übernommen wurden, gibt CheckAccessFullyMappedFALSE zurück.
Rückgabewert
Typ: DXGI_FORMAT
Das Texturformat, das einer der in DXGI_FORMAT aufgeführten typisierten Werte ist.
Siehe auch