PFND3DDDI_SETMATERIAL funzione di callback (d3dumddi.h)

  • Articolo

La funzione SetMaterial imposta le proprietà del materiale usate dal 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 usate per il rendering.

Valore restituito

SetMaterial restituisce S_OK o un risultato di errore appropriato se le proprietà del materiale non vengono impostate correttamente.

Commenti

Le proprietà del materiale dettagliano le caratteristiche di riflessione diffusa, riflesso ambientale, emissione di luce e caratteristiche di evidenziazione speculare di un materiale. Il runtime di Microsoft Direct3D usa la struttura D3DDDIARG_SETMATERIAL per passare tutte le informazioni sulla proprietà del materiale al driver di visualizzazione in modalità utente. Le proprietà del materiale 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 colore RGBA che rappresenta la quantità di parti rosse, verdi e blu di un determinato tipo di luce che 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à del materiale, vedere la documentazione di Microsoft Windows SDK.

Requisiti

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)

Vedi anche

D3DDDIARG_SETMATERIAL

D3DDDI_DEVICEFUNCS