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

manual/render/shader_nodes/shader/metallic.rst

@@ -0,0 +1,86 @@
+.. _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
+======
+
+Base Color :guilabel:`F82 Tint Only`
+   Color of the material when viewed straight on.
+
+Edge Tint :guilabel:`F82 Tint Only`
+   Color of the material when viewed at a 82° angle.
+
+IOR :guilabel:`Physical Conductor Only`
+   The Index of Refraction (sometimes denoted by n) per color channel. Combined with *Extinction*, this controls the base
+   and edge color of the metallic material.
+
+Extinction :guilabel:`Physical Conductor Only`
+   The Extinction Coefficient (sometimes denoted by k) per color channel. Combined with *IOR*, this controls the base
+   and edge color of the metallic material.
+
+Roughness
+   Sharpness of the reflection; perfectly sharp at 0.0 and smoother with higher values.
+
+Anisotropic :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.
+
+Anisotropic 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 Method
+   Metallic Fresnel type to use.
+
+   :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 :abbr:`IOR (Index of Refraction)` and Extinction coefficients, measurements from real world
+      metals to replicate a more accurate rendering of metals than the *F82 Tint* Fresnel type.
+
+      :abbr:`IOR (Index of Refraction)` and Extinction coefficients, otherwise known as n, k,
+      commonly referred to as a complex :abbr:`IOR (Index of Refraction)`, can be found
+      from source like the `Physically Based database for CG artists <https://physicallybased.info/>`__
+      and `Refractive Index nk database <https://refractiveindex.info/>`__.
+
+Outputs
+=======
+
+BSDF
+   Standard shader output.