File: metallic.rst

package info (click to toggle)
blender-doc 4.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 253,604 kB
  • sloc: python: 13,030; javascript: 322; makefile: 113; sh: 107
file content (153 lines) | stat: -rw-r--r-- 4,334 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
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 <https://helpx.adobe.com/content/dam/substance-3d/general-knowledge/asm/Adobe%20Standard%20Material%20-%20Technical%20Documentation%20-%20May2023.pdf>`__
      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 <https://physicallybased.info/>`__
      and `Refractive Index nk database <https://refractiveindex.info/>`__.


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