diff --git a/manual/images/node-types_ShaderNodeBsdfMetallic.webp b/manual/images/node-types_ShaderNodeBsdfMetallic.webp new file mode 100755 index 000000000..425c5488a --- /dev/null +++ b/manual/images/node-types_ShaderNodeBsdfMetallic.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:d6865bb9145986a3a804761585573353b474c86010b2d036d3eda8c1c5bf6f61 +size 8780 diff --git a/manual/images/render_shader-nodes_shader_metallic_f82-Al.webp b/manual/images/render_shader-nodes_shader_metallic_f82-Al.webp new file mode 100644 index 000000000..7b4358059 --- /dev/null +++ b/manual/images/render_shader-nodes_shader_metallic_f82-Al.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:436a75d9708f716107593d89000d8ee5cf74ffd76df1f9b918523985ffc7c7e5 +size 23908 diff --git a/manual/images/render_shader-nodes_shader_metallic_f82-Au.webp b/manual/images/render_shader-nodes_shader_metallic_f82-Au.webp new file mode 100644 index 000000000..5403cdced --- /dev/null +++ b/manual/images/render_shader-nodes_shader_metallic_f82-Au.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ffcbd05f9c6dd9140cf3cfe91669b74e6ea848f1e07e2463040ecf3cb734b2ab +size 26022 diff --git a/manual/images/render_shader-nodes_shader_metallic_f82-Cu.webp b/manual/images/render_shader-nodes_shader_metallic_f82-Cu.webp new file mode 100644 index 000000000..e68207ab6 --- /dev/null +++ b/manual/images/render_shader-nodes_shader_metallic_f82-Cu.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e0f8d0f6209ce0d6e7085a8b44c0843af6e3656e5c73dd47fd1d7649d8d5acbe +size 25814 diff --git a/manual/images/render_shader-nodes_shader_metallic_f82-Ti.webp b/manual/images/render_shader-nodes_shader_metallic_f82-Ti.webp new file mode 100644 index 000000000..99cbfc301 --- /dev/null +++ b/manual/images/render_shader-nodes_shader_metallic_f82-Ti.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0b474c0c68f7bcd12297e8dbda4cbf2dba14c330b7ddc75013a7bd9b191c17ab +size 22966 diff --git a/manual/images/render_shader-nodes_shader_metallic_physical-Al.webp b/manual/images/render_shader-nodes_shader_metallic_physical-Al.webp new file mode 100644 index 000000000..84352b15d --- /dev/null +++ b/manual/images/render_shader-nodes_shader_metallic_physical-Al.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:87d02731ec1f5ed7a0f36d147ba10321eb1f06d23597312c5f2951da79de0ac0 +size 23802 diff --git a/manual/images/render_shader-nodes_shader_metallic_physical-Au.webp b/manual/images/render_shader-nodes_shader_metallic_physical-Au.webp new file mode 100644 index 000000000..0ca93a53f --- /dev/null +++ b/manual/images/render_shader-nodes_shader_metallic_physical-Au.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:4efd73d70d924702c5b54402e490bfecb5927e34abd4f55a66f00f1c86960d87 +size 26010 diff --git a/manual/images/render_shader-nodes_shader_metallic_physical-Cu.webp b/manual/images/render_shader-nodes_shader_metallic_physical-Cu.webp new file mode 100644 index 000000000..9d86087ba --- /dev/null +++ b/manual/images/render_shader-nodes_shader_metallic_physical-Cu.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:9c3603115772cbf48b693ea24967d369a65f4a3fa61eea3265b31df3bfc52754 +size 25750 diff --git a/manual/images/render_shader-nodes_shader_metallic_physical-Ti.webp b/manual/images/render_shader-nodes_shader_metallic_physical-Ti.webp new file mode 100644 index 000000000..797b175a4 --- /dev/null +++ b/manual/images/render_shader-nodes_shader_metallic_physical-Ti.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:261d3d3763e1c3ed42dff90ff5d9f3c7ceb3d900a96b8009a7ebdb819606fb57 +size 22806 diff --git a/manual/render/shader_nodes/shader/index.rst b/manual/render/shader_nodes/shader/index.rst index 620bfab01..25668c29e 100644 --- a/manual/render/shader_nodes/shader/index.rst +++ b/manual/render/shader_nodes/shader/index.rst @@ -16,6 +16,7 @@ hair.rst holdout.rst mix.rst + metallic.rst principled.rst hair_principled.rst volume_principled.rst diff --git a/manual/render/shader_nodes/shader/metallic.rst b/manual/render/shader_nodes/shader/metallic.rst new file mode 100644 index 000000000..8d4493d47 --- /dev/null +++ b/manual/render/shader_nodes/shader/metallic.rst @@ -0,0 +1,153 @@ +.. _bpy.types.ShaderNodeBsdfMetallic: + +************* +Metallic BSDF +************* + +.. figure:: /images/node-types_ShaderNodeBsdfMetallic.webp + :align: right + :alt: Metallic BSDF node. + +The *Metallic* :abbr:`BSDF (Bidirectional Scattering Distribution Function)` +node is used to recreate the appearance of metals. + + +Inputs +====== + +F82 Tint +-------- + +Base Color + Color of the material when viewed straight on. + +Edge Tint + Color of the material when viewed at a 82° angle. + +Physical Conductor +------------------ + +IOR + Refractive index per color channel. This is the real part of a complex refractive index, + scientifically denoted as n. + +Extinction + Extinction coefficients per color channel. This is the imaginary part of a + complex refractive index, scientifically denoted as k. + +Common +------ + +Roughness + Sharpness of the reflection; perfectly sharp at 0.0 and smoother with higher values. + +Anisotropy :guilabel:`Cycles Only` + Amount of anisotropy. Higher values give elongated highlights along the tangent direction; + negative values give highlights shaped perpendicular to the tangent direction. + +Rotation :guilabel:`Cycles Only` + Rotates the direction of anisotropy, with 1.0 going full circle. + + Compared to the *Glossy BSDF* node, the direction of highlight elongation + is rotated by 90°. Add 0.25 to the value to correct. + +Normal + Normal used for shading; if nothing is connected the default shading normal is used. + +Tangent + Tangent used for shading; if nothing is connected the default shading tangent is used. + + +Properties +========== + +Distribution + Microfacet distribution to use. + + :GGX: + GGX microfacet distribution. + :Multiscatter GGX: + Takes multiple scattering events between microfacets into account. + This gives more energy conserving results, which would otherwise be visible as excessive darkening. + :Beckmann: :guilabel:`Cycles Only` + Beckmann microfacet distribution. + +Fresnel Type + Models for describing the metal's appearance, by specifying the apparent color or the physical IOR. + + :F82 Tint: + Uses the `Adobe F82-Tint formula `__ + for the metallic fresnel. This allows for artist friendly control of the color near the edge of the + material to simulate a complex IOR. + :Physical Conductor: + Accepts Complex IOR measurements from real world metals to replicate a more accurate rendering + of metals than the *F82 Tint* Fresnel type. + + Complex IOR values can be found from sources like the + `Physically Based database for CG artists `__ + and `Refractive Index nk database `__. + + +Outputs +======= + +BSDF + Standard shader output. + + +Examples +======== + +F82 Tint +-------- + +.. list-table:: + :widths: 12 22 22 22 22 + + * - + - .. figure:: /images/render_shader-nodes_shader_metallic_f82-Ti.webp + - .. figure:: /images/render_shader-nodes_shader_metallic_f82-Al.webp + - .. figure:: /images/render_shader-nodes_shader_metallic_f82-Cu.webp + - .. figure:: /images/render_shader-nodes_shader_metallic_f82-Au.webp + * - Material + - Titanium (Default) + - Aluminum + - Copper + - Gold + * - Base Color + - 0.617, 0.576, 0.540 + - 0.911, 0.912, 0.917 + - 0.972, 0.694, 0.486 + - 1.000, 0.735, 0.353 + * - Edge Tint + - 0.695, 0.726, 0.770 + - 0.848, 0.877, 0.916 + - 0.961, 0.969, 0.942 + - 0.993, 1.000, 1.000 + +Physical Conductor +------------------ + +.. list-table:: + :widths: 12 22 22 22 22 + + * - + - .. figure:: /images/render_shader-nodes_shader_metallic_physical-Ti.webp + - .. figure:: /images/render_shader-nodes_shader_metallic_physical-Al.webp + - .. figure:: /images/render_shader-nodes_shader_metallic_physical-Cu.webp + - .. figure:: /images/render_shader-nodes_shader_metallic_physical-Au.webp + * - Material + - Titanium (Default) + - Aluminum + - Copper + - Gold + * - IOR + - 2.757, 2.512, 2.231 + - 1.333, 0.945, 0.582 + - 0.235, 0.729, 1.369 + - 0.000, 0.470, 1.439 + * - Extinction + - 3.867, 3.404, 3.009 + - 7.434, 6.340, 5.181 + - 5.666, 2.562, 2.227 + - 182.6, 2.189, 1.660