[page:Material] →

点精灵材质([name])

一种使用[page:Sprite]的材质。

代码示例


		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 );

例子

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

构造函数(Constructor)

[name]( [param:Object parameters] )

[page:Object parameters] - (可选)用于定义材质外观的对象，具有一个或多个属性。材质的任何属性都可以从此处传入(包括从[page:Material] 和 [page:ShaderMaterial]继承的任何属性)。

属性[page:Hexadecimal color]例外，其可以作为十六进制字符串传递，默认情况下为 *0xffffff*（白色），内部调用[page:Color.set](color)。 SpriteMaterials不会被[page:Material.clippingPlanes]裁剪。

属性(Properties)

共有属性请参见其基类[page:Material]。

[property:Texture alphaMap]

alpha贴图是一张灰度纹理，用于控制整个表面的不透明度。（黑色：完全透明；白色：完全不透明）。默认值为null。

仅使用纹理的颜色，忽略alpha通道（如果存在）。对于RGB和RGBA纹理，[page:WebGLRenderer WebGL]渲染器在采样此纹理时将使用绿色通道，因为在DXT压缩和未压缩RGB 565格式中为绿色提供了额外的精度。 Luminance-only以及luminance/alpha纹理也仍然有效。

[property:Color color]

材质的颜色([page:Color])，默认值为白色 (0xffffff)。 [page:.map]会和 color 相乘。

[property:Boolean fog]

材质是否受雾影响。默认为*true*。

[property:Boolean isSpriteMaterial]

Read-only flag to check if a given object is of type [name].

[property:Texture map]

颜色贴图。可以选择包括一个alpha通道，通常与[page:Material.transparent .transparent] 或[page:Material.alphaTest .alphaTest]。默认为null。

[property:Radians rotation]

sprite的转动，以弧度为单位。默认值为0。

[property:Boolean sizeAttenuation]

精灵的大小是否会被相机深度衰减。（仅限透视摄像头。）默认为*true*。

[property:Boolean transparent]

定义此材质是否透明。默认值为 *true*。

方法(Methods)

共有方法请参见其基类[page:Material]。

源码(Source)

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