tex1D (HLSL-Referenz): Wählen Sie die MIP-Ebene aus.

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

ret tex1D(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 sampler1D 1
t in Vektor float 1
Ddx in Vektor float 1
ddy in Vektor float 1
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)