D3DXComputeNormalMap-Funktion

Konvertiert eine Höhenkarte in eine normale Karte. Die (x,y,z)-Komponenten jeder Normalen werden den (r,g,b)-Kanälen der Ausgabetextur zugeordnet.

Syntax

HRESULT D3DXComputeNormalMap(
  _Out_       LPDIRECT3DTEXTURE9 pTexture,
  _In_        LPDIRECT3DTEXTURE9 pSrcTexture,
  _In_  const PALETTEENTRY       *pSrcPalette,
  _In_        DWORD              Flags,
  _In_        DWORD              Channel,
  _In_        FLOAT              Amplitude
);

Parameter

pTexture [ out]

Typ: LPDIRECT3DTEXTURE9

Zeiger auf eine IDirect3DTexture9-Schnittstelle, die die Zieltextur darstellt.

pSrcTexture [ In]

Typ: LPDIRECT3DTEXTURE9

Zeiger auf eine IDirect3DTexture9-Schnittstelle, die die Quelltextur der Höhenzuordnung darstellt.

pSrcPalette [ In]

Typ: const PALETTEENTRY *

Zeiger auf einen PALETTEENTRY-Typ, der die Quellpalette mit 256 Farben oder NULL enthält.

Flags [ In]

Typ: DWORD

Mindestens ein D3DX _ NORMALMAP-Flag, das die Generierung normaler Zuordnungen steuert.

Kanal [ In]

Typ: DWORD

Ein D3DX-KANALflag, _ das die Quelle der Höheninformationen angibt.

Amplitude [ In]

Typ: FLOAT

Konstanter Wertmultiplikator, der die Werte in der normalen Zuordnung erhöht (oder verringert). Höhere Werte machen Bumps in der Regel sichtbarer, niedrigere Werte machen Bumps in der Regel weniger sichtbar.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ausgeführt wird, lautet der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert der folgende Wert sein: D3DERR _ INVALIDCALL.

Bemerkungen

Diese Methode berechnet die Normalität mithilfe des zentralen Unterschieds mit einer Kernelgröße von 3x3. Der zentrale differenzierende Nenner ist 2.0. RGB-Kanäle im Ziel enthalten voreingenommene (x,y,z)-Komponenten der Normalen.

Requirements (Anforderungen)

Anforderung Wert
Header
D3dx9tex.h
Bibliothek
D3dx9.lib

Weitere Informationen

Texturfunktionen in D3DX 9