File: bevel.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 (71 lines) | stat: -rw-r--r-- 2,302 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
.. _bpy.types.ShaderNodeBevel:

**********
Bevel Node
**********

:guilabel:`Cycles Only`

.. figure:: /images/node-types_ShaderNodeBevel.webp
   :align: right
   :alt: Bevel Node.

The Bevel shader node can be used for rendering rounded corners.
Like bump mapping, this does not modify the actual geometry, only the shading is affected.
Slight rounding on edges helps to capture specular highlights that you would also see in the real world.

Note that this is a very expensive shader, and may slow down renders
by 20% even if there is a lot of other complexity in the scene.
For that reason, we suggest to mainly use this for baking or
still frame renders where render time is not as much of an issue.
The :doc:`/modeling/modifiers/generate/bevel` is a faster option when it works,
but sometimes fails on complex or messy geometry.

.. note::

   **The Bevel node will not produce a valid result when:**

   - The object is either a :ref:`Caustic caster <bpy.types.CyclesObjectSettings.is_caustics_caster>`
      or :ref:`Caustic receiver <bpy.types.CyclesObjectSettings.is_caustics_receiver>` while the scene
      contains an active :ref:`Caustic caster <bpy.types.CyclesObjectSettings.is_caustics_caster>`,
      :ref:`Caustic receiver <bpy.types.CyclesObjectSettings.is_caustics_receiver>`, and
      :ref:`Shadow Caustic Light <bpy.types.CyclesLightSettings.is_caustics_light>`.
   - :doc:`/render/shader_nodes/osl` is active while using the OptiX rendering backend.


Inputs
======

Radius
   Width of the bevel effect on edges.
Normal
   Normal to apply bevel on top of, to be combined with a :doc:`/render/shader_nodes/vector/bump`
   for example. When not connected, uses the surface normal.


Properties
==========

Samples
   Number of samples to take for each shader evaluation.
   More samples give more accurate results, but are also slower to render.
   The default value of 4 works well for most cases, with any noise resolved by using more AA samples.


Outputs
=======

Normal
   Standard normal output.


Examples
========

.. figure:: /images/render_shader-nodes_input_bevel_example_setup.jpg

   A minimal node setup for working with the Bevel node.

.. figure:: /images/render_shader-nodes_input_bevel_example.jpg

   Bevel shader bringing out specular highlights on the edges.