PFND3DDDI_SETMATERIAL funzione di callback (d3dumddi.h)
La funzione SetMaterial imposta le proprietà materiali usate dai dispositivi nel sistema per creare l'effetto necessario durante il rendering.
Sintassi
PFND3DDDI_SETMATERIAL Pfnd3dddiSetmaterial;
HRESULT Pfnd3dddiSetmaterial(
HANDLE hDevice,
const D3DDDIARG_SETMATERIAL *unnamedParam2
)
{...}
Parametri
hDevice
Handle per il dispositivo di visualizzazione (contesto grafico).
unnamedParam2
pData [in]
Puntatore a una struttura D3DDDIARG_SETMATERIAL che descrive le proprietà del materiale utilizzate per il rendering.
Valore restituito
SetMaterial restituisce S_OK o un risultato di errore appropriato se le proprietà del materiale non sono impostate correttamente.
Osservazioni
Le proprietà materiali descrivono in dettaglio le caratteristiche di riflessione diffusa, riflesso ambientale, emissione di luce e evidenziazione speculare di un materiale. Il runtime di Microsoft Direct3D usa la struttura D3DDDIARG_SETMATERIAL per passare tutte le informazioni sulle proprietà materiali al driver di visualizzazione in modalità utente. Le proprietà dei materiali influiscono sui colori usati dal runtime Direct3D per rasterizzare i poligoni che usano il materiale. Ad eccezione della proprietà speculare, ognuna delle proprietà viene descritta come un colore RGBA che rappresenta la quantità di parti rosse, verdi e blu di un determinato tipo di luce riflette e un fattore di fusione alfa (il componente alfa del colore RGBA). La proprietà speculare del materiale è descritta in due parti: colore e potenza. Per altre informazioni sulle proprietà dei materiali, vedere la documentazione di Microsoft Windows SDK.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
| piattaforma di destinazione | Desktop |
| intestazione | d3dumddi.h (include D3dumddi.h) |