[page:Material] →

[name]

[name] viene utilizzata internamente per implementare la mappatura delle ombre con [page:PointLight].

Può anche essere utilizzato per personalizzare la proiezione dell'ombra di un oggetto assegnando un'istanza di [name] a [page:Object3D.customDistanceMaterial]. L'esempio seguente dimostra questo approccio per garantire che le parti trasparenti degli oggetti non proiettano ombre.

Esempi

[example:webgl_shadowmap_pointlight WebGL / shadowmap / pointlight]

Costruttore

[name]( [param:Object parameters] )

[page:Object parameters] - (opzionale) un oggetto con una o più proprietà che definiscono l'aspetto del materiale. Qualsiasi proprietà del materiale (inclusa qualsiasi proprietà ereditata da [page:Material]) può essere passata qui.

Proprietà

Vedi la classe base [page:Material] per le proprietà comuni.

[property:Texture alphaMap]

La mappa alfa è una texture in scala di grigi che controlla l'opacità sulla superficie (nero: completamente trasparente; bianco: completamente opaco). Il valore predefinito è `null`.

Viene utilizzato solo il colore della texture, ignorando il canale alfa, se esiste. Per le texuture RGB e RGBA, il renderer [page:WebGLRenderer WebGL] utilizzarà il canale del verde durante il campionamento di questa texture a causa del bit extra di precisione fornito per il verde nei formati RGB 565 compressi e non compressi DXT. Anche le texture solo luminanza e luminanza/alfa continueranno a funzionare come previsto.

[property:Texture displacementMap]

La mappa di spostamento influisce sulla posizione dei vertici della mesh. A differenza di altre mappe che influenzano solo la luce e l'ombra del materiale, i vertici spostati possono proiettare ombre, bloccare altri oggetti, e altrimenti agire come una vera geometria. La texture di spostamento è un'immagine in cui il valore di ciascun pixel (il bianco è il più alto) viene mappato e riposizionato rispetto ai vertici della mesh.

[property:Float displacementScale]

Quando la mappa di spostamento influenza la mesh (dove il nero non è lo spostamento, e il bianco è lo spostamento massimo). Senza una mappa di spostamento impostata, questo valore non viene applicato. Il valore predefinito è 1.

[property:Float displacementBias]

L'offset dei valori della mappa di spostamento sui vertici della mesh. Senza una mappa di spostamento impostata, questo valore non viene applicato. Il valore predefinito è 0.

[property:Float farDistance]

Il valore far della telecamera d'ombra interna della luce puntiforme.

[property:Boolean fog]

Indica se il materiale è influenzato dalla nebbia. Il valore predefinito è `false`.

[property:Texture map]

La mappa colore. Può includere facoltativamente un canale alfa, tipicamente combinato con [page:Material.transparent .transparent] o [page:Material.alphaTest .alphaTest]. Il valore predefinito è `null`.

[property:Float nearDistance]

Il valore near della telecamera d'obra interna della luce puntiforme.

[property:Vector3 referencePosition]

La posizione della luce puntiforme nello spazio world.

Metodi

Vedi la classe base [page:Material] per i metodi comuni.

Source

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]