[page:Material] →

[name]

Un materiale da utilizzare con una [page:Sprite].

Codice di Esempio


		const map = new THREE.TextureLoader().load( 'textures/sprite.png' );
		const material = new THREE.SpriteMaterial( { map: map, color: 0xffffff } );

		const sprite = new THREE.Sprite( material );
		sprite.scale.set(200, 200, 1)
		scene.add( sprite );

Esempi

[example:webgl_raycaster_sprite WebGL / raycast / sprite]
[example:webgl_sprites WebGL / sprites]
[example:svg_sandbox SVG / sandbox]

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.

L'eccezione è la proprietà [page:Hexadecimal colore], la quale può essere passata come stringa esadecimale e per impostazione predefinita è `0xffffff` (bianco). [page:Color.set]( color ) viene chiamato internamente. Gli SpriteMaterials non vengono ritagliati utilizzando [page:Material.clippingPlanes].

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:Color color]

[page:Color Colore] del materiale, il valore predefinito è impostato a bianco (0xffffff). La [page:.map] viene moltiplicata per il colore.

[property:Boolean fog]

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

[property:Boolean isSpriteMaterial]

Flag di sola lettura per verificare se l'oggetto dato è di tipo [name].

[property:Texture map]

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

[property:Radians rotation]

La rotazione della Sprite in radianti. Il valore predefinito è `0`.

[property:Boolean sizeAttenuation]

Indica se la dimensione della sprite viene attenuata dalla profondità della telecamera. (Solo telecamera prosepettica). Il valore predefinito è `true`.

[property:Boolean transparent]

Definisce se il materiale è trasparente. Il valore predefinto è `true`.

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]