struktur D3DDDI_LIGHT (d3dumddi.h)
Struktur D3DDDI_LIGHT menjelaskan serangkaian properti pencahayaan.
Sintaks
typedef struct _D3DDDI_LIGHT {
[in] D3DLIGHTTYPE Type;
[in] D3DCOLORVALUE Diffuse;
[in] D3DCOLORVALUE Specular;
[in] D3DCOLORVALUE Ambient;
[in] D3DVECTOR Position;
[in] D3DVECTOR Direction;
[in] FLOAT Range;
[in] FLOAT Falloff;
[in] FLOAT Attenuation0;
[in] FLOAT Attenuation1;
[in] FLOAT Attenuation2;
[in] FLOAT Theta;
[in] FLOAT Phi;
} D3DDDI_LIGHT;
Anggota
[in] Type
Nilai jenis D3DLIGHTTYPE yang menunjukkan jenis sumber cahaya. Untuk informasi selengkapnya tentang D3DLIGHTTYPE, lihat dokumentasi Microsoft Windows SDK.
[in] Diffuse
Struktur D3DCOLORVALUE yang menunjukkan warna difus yang dipancarkan oleh cahaya. Untuk informasi selengkapnya tentang D3DCOLORVALUE, lihat dokumentasi Windows SDK.
[in] Specular
Struktur D3DCOLORVALUE yang menunjukkan warna spekular yang dipancarkan oleh cahaya.
[in] Ambient
Struktur D3DCOLORVALUE yang menunjukkan warna sekitar yang dipancarkan oleh cahaya.
[in] Position
Struktur D3DVECTOR yang menunjukkan posisi cahaya di ruang dunia. Anggota ini tidak memiliki arti untuk lampu arah (yaitu, jika D3DLIGHT_DIRECTIONAL diatur dalam anggota Jenis ) dan diabaikan dalam situasi tersebut. Untuk informasi selengkapnya tentang D3DVECTOR, lihat dokumentasi Windows SDK.
[in] Direction
Struktur D3DVECTOR yang menunjukkan arah cahaya menunjuk ke ruang dunia. Anggota ini hanya memiliki arti untuk lampu arah dan lampu sorot (yaitu, jika D3DLIGHT_DIRECTIONAL dan D3DLIGHT_SPOT diatur dalam Jenis). Vektor ini tidak diperlukan untuk dinormalisasi, tetapi harus memiliki panjang bukan nol.
[in] Range
Jarak di luar mana cahaya tidak berpengaruh. Nilai maksimum yang diizinkan untuk anggota ini adalah D3DLIGHT_RANGE_MAX, yang didefinisikan sebagai akar kuadrat FLT_MAX. Anggota ini tidak mempengaruhi lampu arah.
[in] Falloff
Penurunan iluminasi antara kerujut bagian dalam sorotan (sudut yang ditentukan oleh anggota Theta ) dan tepi luar kerujut luar (sudut yang ditentukan oleh anggota Phi ). Efek falloff pada pencahayaan halang. Selain itu, penalti performa kecil dikeluarkan dengan membentuk kurva falloff. Untuk alasan ini, sebagian besar pengembang menetapkan anggota ini ke 1.0.
[in] Attenuation0
Faktor redaman cahaya yang konstan. Nilai redaman menentukan bagaimana intensitas cahaya berubah dari jarak jauh. Redaman tidak memengaruhi lampu arah. Nilai yang valid untuk anggota ini berkisar antara 0,0 hingga tak terbatas.
[in] Attenuation1
Faktor redaman linier cahaya. Nilai redaman menentukan bagaimana intensitas cahaya berubah dari jarak jauh. Redaman tidak memengaruhi lampu arah. Nilai yang valid untuk anggota ini berkisar antara 0,0 hingga tak terbatas.
[in] Attenuation2
Faktor redaman kuadrat cahaya. Nilai redaman menentukan bagaimana intensitas cahaya berubah dari jarak jauh. Redaman tidak memengaruhi lampu arah. Nilai yang valid untuk anggota ini berkisar antara 0,0 hingga tak terbatas.
[in] Theta
Sudut, dalam radian, dari sorotan kerumum bagian dalam - yaitu, kerumum lampu sorot yang sepenuhnya disinari. Nilai ini harus dalam rentang dari 0 hingga nilai yang ditentukan oleh anggota Phi .
[in] Phi
Sudutnya, dalam radian, yang mendefinisikan tepi luar kerujut luar lampu sorot. Titik di luar kerujut ini tidak menyala oleh sorotan. Nilai ini harus antara 0 dan Pi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows. |
| Header | d3dumddi.h (termasuk D3dumddi.h) |