[page:Material] → [page:MeshStandardMaterial] →

物理网格材质([name])

[page:MeshStandardMaterial]的扩展,提供了更高级的基于物理的渲染属性:

物理网格材质使用了更复杂的着色器功能,所以在每个像素的渲染都要比three.js中的其他材质更费性能,大部分的特性是默认关闭的,需要手动开启,每开启一项功能在开启的时候才会更耗性能。请注意,为获得最佳效果,您在使用此材质时应始终指定[page:.envMap environment map]。

例子

[example:webgl_loader_gltf_anisotropy loader / gltf / anisotropy]
[example:webgl_materials_physical_clearcoat materials / physical / clearcoat]
[example:webgl_loader_gltf_iridescence loader / gltf / iridescence]
[example:webgl_loader_gltf_sheen loader / gltf / sheen]
[example:webgl_materials_physical_transmission materials / physical / transmission]

构造函数(Constructor)

[name]( [param:Object parameters] )

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

属性[page:Hexadecimal color]例外,其可以作为十六进制字符串传递,默认情况下为 *0xffffff*(白色),内部调用[page:Color.set](color)。

属性(Properties)

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

[property:Float anisotropy]

各向异性强度。默认值为 `0.0`。

[property:Texture anisotropyMap]

红色和绿色通道表示 `[-1, 1]` 切线、双切线空间中的各向异性方向,将通过 [page:.anisotropyRotation] 进行旋转。蓝色通道包含 `[0, 1]` 的强度,将与 [page:.anisotropy]相乘。默认值为 `null`。

[property:Float anisotropyRotation]

切线、双切线空间中各向异性的旋转,以弧度为单位从切线逆时针测量。当存在 [page:.anisotropyMap] 时,此属性为纹理中的矢量提供额外的旋转。默认值为 `0.0`。

[property:Color attenuationColor]

白光到达衰减距离后因吸收而变成的颜色。默认值为 *white* (0xffffff)。

[property:Float attenuationDistance]

介质的密度,表示光在与粒子相互作用之前在介质中传播的平均距离。该值以世界空间单位给出,并且必须大于零。默认值为 `Infinity`。

[property:Float clearcoat]

表示clear coat层的强度,范围从*0.0*到*1.0*m,当需要在表面加一层薄薄的半透明材质的时候,可以使用与clear coat相关的属性,默认为*0.0*;

[property:Texture clearcoatMap]

这个贴图的红色通道值会与[page:.clearcoat]相乘作为整个clear coat的强度值层,默认为*null*。

[property:Texture clearcoatNormalMap]

用于为clear coat层设置的独立的法线贴图,默认为*null*。

[property:Vector2 clearcoatNormalScale]

衡量[page:.clearcoatNormalMap]影响clear coat层多少的值,由*(0,0)*到*(1,1)*,默认为*(1,1)*。

[property:Float clearcoatRoughness]

clear coat层的粗糙度,由*0.0*到*1.0*。 默认为*0.0*

[property:Texture clearcoatRoughnessMap]

此纹理的绿色通道值会与[page:.clearcoatRoughness]相乘,用于改变clear coat的粗糙度,默认为*null*

[property:Object defines]

如下形式的对象: { 'STANDARD': '' 'PHYSICAL': '', }; [page:WebGLRenderer]使用它来选择shaders。

[property:Float dispersion]

定义穿过相对清晰体积的颜色角分离(色差)的强度。任何零或更大的值都是有效的,实际值的典型范围是 `[0, 1]`。 默认值为 `0` (无色散)。 此属性只能用于透射对象,请参见 [page:.transmission]。

[property:Float ior]

为非金属材质所设置的折射率,范围由*1.0*到*2.333*。默认为*1.5*。

[property:Float reflectivity]

反射率,由*0.0*到*1.0*。默认为*0.5*, 相当于折射率1.5。
这模拟了非金属材质的反射率。当[page:MeshStandardMaterial metalness]为*1.0*时,此属性无效。

[property:Float iridescence]

虹彩([link:https://en.wikipedia.org/wiki/Iridescence iridescence])层的强度,根据表面和观察者之间的角度模拟RGB颜色偏移,从 `0.0` 到 `1.0`。默认值为 `0.0`。

[property:Texture iridescenceMap]

此纹理的红色通道与 [page:.iridescence] 相乘,以实现对虹彩的每像素控制。默认值为 `null`。

[property:Float iridescenceIOR]

虹彩 RGB 色移效果的强度,由折射率表示。在 `1.0` 到 `2.333` 之间。 默认值为 `1.3`。

[property:Array iridescenceThicknessRange]

由 2 个元素组成的数组,指定虹彩层的最小和最大厚度。 虹彩层的厚度与 [page:.thickness] 对 [page:.ior] 的影响相同。默认值为 `[100, 400]`。
如果未定义 [page:.iridescenceThicknessMap],则虹彩厚度将仅使用给定数组的第二个元素。

[property:Texture iridescenceThicknessMap]

一种定义虹彩层厚度的纹理,存储在绿色通道中。厚度的最小值和最大值由 [page:.iridescenceThicknessRange] 数组定义:

默认值为 `null`。

[property:Float sheen]

光泽层的强度,范围是*0.0*到*1.0*。默认为*0.0*。

[property:Float sheenRoughness]

光泽层的粗糙度,由*0.0*到*1.0*。默认值是*1.0*。

[property:Texture sheenRoughnessMap]

此纹理的透明通道会与[page:.sheenRoughness]相乘,用于改变光泽层的粗糙度,默认为*null*;

[property:Color sheenColor]

光泽颜色,默认为*0x000000*黑色。

[property:Texture sheenColorMap]

此纹理的RGB通道会与[page:.sheenColor]光泽颜色相乘,最终作为光泽颜色结果,默认为*null*。

[property:Float specularIntensity]

用于控制非金属材质高光反射强度的浮点值。漫反射材质对应的值为0。范围从*0.0*到*1.0*。 默认值为*1.0*。

[property:Texture specularIntensityMap]

此纹理的alpha通道将与[page:.specularIntensity]相乘,用于逐像素地控制高光强度。默认值为*null*。

[property:Color specularColor]

非金属材质在垂直于法线方向观看时的高光反射颜色。默认值为*0xffffff*,白色。

[property:Texture specularColorMap]

此纹理的alpha通道将与[page:.specularColor]相乘,用于逐像素地控制高光颜色。默认值为*null*。

[property:Float thickness]

表面下体积的厚度。该值在网格的坐标空间中给出。如果该值为 *0*,则材料为薄壁。否则,材质将成为体积边界。默认值为 *0*。

[property:Texture thicknessMap]

定义厚度的纹理,存储在 G 通道中。这将与 [page:.thickness] 相乘。默认值为 *null*。

[property:Float transmission]

透光率(或者说透光性),范围从*0.0*到*1.0*。默认值是*0.0*。
很薄的透明或者半透明的塑料、玻璃材质即便在几乎完全透明的情况下仍旧会保留反射的光线,透光性属性用于这种类型的材质。
当透光率不为0的时候, [page:Material.opacity opacity]透明度应设置为*1*.

[property:Texture transmissionMap]

此纹理的红色通道会与透光性[page:.transmission]相乘最为最终的透光性结果。默认为*null*。

方法(Methods)

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

源码(Source)

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