[name]

An extension of the [page:MeshStandardMaterial], providing more advanced physically-based rendering properties:

• Clearcoat: Some materials — like car paints, carbon fiber, and wet surfaces — require a clear, reflective layer on top of another layer that may be irregular or rough. Clearcoat approximates this effect, without the need for a separate transparent surface.
• Physically-based transparency: One limitation of [page:Material.opacity .opacity] is that highly transparent materials are less reflective. Physically-based [page:.transparency] provides a more realistic option for thin, transparent surfaces like glass.
• Advanced reflectivity: More flexible reflectivity for non-metallic materials.

As a result of these complex shading features, MeshPhysicalMaterial has a higher performance cost, per pixel, than other three.js materials. Most effects are disabled by default, and add cost as they are enabled. For best results, always specify an [page:.envMap environment map] when using this material.

Examples

[example:webgl_materials_variations_physical materials / variations / physical]
[example:webgl_materials_physical_clearcoat materials / physical / clearcoat]
[example:webgl_materials_physical_reflectivity materials / physical / reflectivity]
[example:webgl_materials_physical_transparency materials / physical / transparency]

Constructor

[name]( [param:Object parameters] )

[page:Object parameters] - (optional) an object with one or more properties defining the material's appearance. Any property of the material (including any property inherited from [page:Material] and [page:MeshStandardMaterial]) can be passed in here.

The exception is the property [page:Hexadecimal color], which can be passed in as a hexadecimal string and is *0xffffff* (white) by default. [page:Color.set]( color ) is called internally.

Properties

See the base [page:Material] and [page:MeshStandardMaterial] classes for common properties.

[property:Float clearcoat]

Represents the thickness of the clear coat layer, from *0.0* to *1.0*. Use clear coat related properties to enable multilayer materials that have a thin translucent layer over the base layer. Default is *0.0*.

[property:Texture clearcoatMap]

The red channel of this texture is multiplied against [page:.clearcoat], for per-pixel control over a coating's thickness. Default is *null*.

[property:Texture clearcoatNormalMap]

Can be used to enable independent normals for the clear coat layer. Default is *null*.

[property:Vector2 clearcoatNormalScale]

How much [page:.clearcoatNormalMap] affects the clear coat layer, from *(0,0)* to *(1,1)*. Default is *(1,1)*.

[property:Float clearcoatRoughness]

Roughness of the clear coat layer, from *0.0* to *1.0*. Default is *0.0*.

[property:Texture clearcoatRoughnessMap]

The green channel of this texture is multiplied against [page:.clearcoatRoughness], for per-pixel control over a coating's roughness. Default is *null*.

[property:Object defines]

An object of the form: { 'STANDARD': '' 'PHYSICAL': '', }; This is used by the [page:WebGLRenderer] for selecting shaders.

[property:Float reflectivity]

Degree of reflectivity, from *0.0* to *1.0*. Default is *0.5*.
This models the reflectivity of non-metallic materials. It has no effect when [page:MeshStandardMaterial.metalness metalness] is *1.0*

[property:Float transparency]

Degree of transparency, from *0.0* to *1.0*. Default is *0.0*.
Thin, transparent or semitransparent, plastic or glass materials remain largely reflective even if they are mostly transparent. The transparency property can be used to model these materials.
When transparency is non-zero, [page:Material.opacity opacity] should be set to *1*.

Methods

See the base [page:Material] and [page:MeshStandardMaterial] classes for common methods.

Source

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