Fungsi D3DXComputeNormals

Artikel
06/13/2023

Unit komputasi normal untuk setiap puncak dalam jala. Disediakan untuk mendukung aplikasi warisan. Gunakan D3DXComputeTangentFrameEx untuk hasil yang lebih baik.

Sintaks

HRESULT D3DXComputeNormals(
  _Inout_       LPD3DXBASEMESH pMesh,
  _In_    const DWORD          *pAdjacency
);

Parameter

pMesh [masuk, keluar]

Jenis: LPD3DXBASEMESH

Penunjuk ke antarmuka ID3DXBaseMesh , mewakili objek jala yang dinormalisasi.

pAdjacency [in]

Jenis: const DWORD*

Arahkan ke array tiga DWORD per wajah yang menentukan tiga tetangga untuk setiap wajah dalam jala progresif yang dibuat. Parameter ini bersifat opsional dan harus diatur ke NULL jika tidak digunakan.

Menampilkan nilai

Jenis: HRESULT

Jika fungsi berhasil, nilai yang dikembalikan S_OK. Jika fungsi gagal, nilai yang dikembalikan dapat berupa salah satu hal berikut: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Keterangan

Jala input harus memiliki bendera D3DFVF_NORMAL yang ditentukan dalam format vertex fleksibel (FVF).

Normal untuk vertex dihasilkan dengan rata-rata normal semua wajah yang berbagi puncak tersebut.

Jika bersebelahan disediakan, simpul yang direplikasi diabaikan dan "dihaluskan" di atas. Jika bersebelahan tidak disediakan, simpul yang direplikasi akan memiliki normal rata-rata dari hanya wajah yang secara eksplisit mereferensikannya.

Fungsi ini hanya memanggil D3DXComputeTangentFrameEx dengan parameter input berikut:

D3DXComputeTangentFrameEx( pMesh,
                           D3DX_DEFAULT,
                           0,
                           D3DX_DEFAULT,
                           0,
                           D3DX_DEFAULT,
                           0,
                           D3DDECLUSAGE_NORMAL,
                           0,
                           D3DXTANGENT_GENERATE_IN_PLACE | D3DXTANGENT_CALCULATE_NORMALS,
                           pAdjacency,
                           -1.01f,
                           -0.01f,
                           -1.01f,
                           NULL,
                           NULL);

Persyaratan

Persyaratan	Nilai
Header	D3DX9Mesh.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi Jala