tex3Dgrad

Stichproben einer 3D-Textur mithilfe eines Farbverlaufs, um die MIP-Ebene auszuwählen.

ret tex3Dgrad(s, t, ddx, ddy)

Parameter

Element BESCHREIBUNG
s
[im ] Zustand "Sampler".
T
[in ] Die Texturkoordinate.
Ddx
[in ] Änderungsrate der Oberflächengeometrie in x-Richtung.
ddy
[in ] Änderungsrate der Oberflächengeometrie in y-Richtung.

Rückgabewert

Der Wert der Texturdaten.

Typbeschreibung

Name Ein/Aus Vorlagentyp Komponententyp Size
s in Objekt sampler3D 1
t in Vektor schweben 3
Ddx in Vektor schweben 3
ddy in Vektor schweben 3
Ret out Vektor float 4

Minimales Shadermodell

Diese Funktion wird in den folgenden Shadermodellen unterstützt.

Shadermodell Unterstützt
Shadermodell 4 Ja (nur Pixel-Shader)
Shadermodell 3 (DirectX HLSL) Ja (nur Pixel-Shader)
Shadermodell 2 (DirectX HLSL) Ja (nur Pixel-Shader)
Shadermodell 1 (DirectX HLSL) Nein
  1. Eine erhebliche Code-Neuanordnung erfolgt, um Gradientenberechnungen außerhalb der Flusssteuerung zu verschieben.
  2. Wenn die D3DPSHADERCAPS2 0-Obergrenze mit _ D3DD3DPSHADERCAPS2 _ 0 GRADIENTINSTRUCTIONS festgelegt ist, ordnet der Compiler diese Funktion _ texldd zu.

Bemerkungen

Wenn die Flusssteuerung in einem Shader vorhanden ist, ist das Ergebnis einer farbverlaufsberechnung, die innerhalb eines bestimmten Verzweigungspfads angefordert wird, mehrdeutig, wenn benachbarte Pixel separate Flusssteuerungspfade heruntergefahren werden können. Daher wird die Verwendung von Pixel-Shader-Vorgangen, bei denen eine Farbverlaufsberechnung an einer Position innerhalb eines Flusssteuerungskonstrukts durchgeführt werden soll, als unzulässig eingestuft, die für ein bestimmtes Primitives, das rastert wird, in Pixel variieren kann. Wenn eine der Seiten einer if-Anweisung mit dem Branchattribut eine Gradient-Funktion verwendet, kann ein Compilerfehler generiert werden. Siehe if-Anweisung (DirectX HLSL).

Weitere Informationen

Systeminterne Funktionen (DirectX HLSL)