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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
|
.. _bpy.types.ShaderNodeTexVoronoi:
********************
Voronoi Texture Node
********************
.. figure:: /images/node-types_ShaderNodeTexVoronoi.webp
:align: right
:alt: Voronoi Texture Node.
The *Voronoi Texture* node evaluates a `Worley Noise <https://en.wikipedia.org/wiki/Worley_noise>`__ at
the input texture coordinates.
Inputs
======
The inputs are dynamic, they become available if needed depending on the node properties.
Vector
Texture coordinate to evaluate the noise at;
defaults to *Generated* texture coordinates if the socket is left unconnected.
W
Texture coordinate to evaluate the noise at.
Scale
Scale of the noise.
Detail
Number of noise octaves.
The fractional part of the input is multiplied by the magnitude of the highest octave.
Higher number of octaves corresponds to a higher evaluation time.
Roughness
Blend between a smoother noise pattern, and rougher with sharper peaks.
Lacunarity
The difference between the scale of each two consecutive octaves.
Larger values corresponds to larger scale for higher octaves.
Smoothness
The smoothness of the noise.
.. list-table::
* - .. figure:: /images/render_shader-nodes_textures_voronoi_smoothness-distance-zero.png
Smoothness: 0.0.
- .. figure:: /images/render_shader-nodes_textures_voronoi_smoothness-distance-quarter.png
Smoothness: 0.25.
- .. figure:: /images/render_shader-nodes_textures_voronoi_smoothness-distance-half.png
Smoothness: 0.5.
- .. figure:: /images/render_shader-nodes_textures_voronoi_smoothness-distance-one.png
Smoothness: 1.0.
* - .. figure:: /images/render_shader-nodes_textures_voronoi_smoothness-color-zero.png
Smoothness: 0.0.
- .. figure:: /images/render_shader-nodes_textures_voronoi_smoothness-color-quarter.png
Smoothness: 0.25.
- .. figure:: /images/render_shader-nodes_textures_voronoi_smoothness-color-half.png
Smoothness: 0.5.
- .. figure:: /images/render_shader-nodes_textures_voronoi_smoothness-color-one.png
Smoothness: 1.0.
Exponent
Exponent of the Minkowski distance metric.
.. list-table::
* - .. figure:: /images/render_shader-nodes_textures_voronoi_minkowski-half.png
Exponent: 0.5.
- .. figure:: /images/render_shader-nodes_textures_voronoi_minkowski-one.png
Exponent: 1.0.
- .. figure:: /images/render_shader-nodes_textures_voronoi_minkowski-two.png
Exponent: 2.0.
- .. figure:: /images/render_shader-nodes_textures_voronoi_minkowski-32.png
Exponent: 32.0.
Randomness
The randomness of the noise.
.. list-table::
* - .. figure:: /images/render_shader-nodes_textures_voronoi_randomness-one.png
Randomness: 1.0.
- .. figure:: /images/render_shader-nodes_textures_voronoi_randomness-half.png
Randomness: 0.5.
- .. figure:: /images/render_shader-nodes_textures_voronoi_randomness-quarter.png
Randomness: 0.25.
- .. figure:: /images/render_shader-nodes_textures_voronoi_randomness-zero.png
Randomness: 0.0.
Properties
==========
Dimensions
The dimensions of the space to evaluate the noise in.
:1D: Evaluate the noise in 1D space at the input W.
:2D: Evaluate the noise in 2D space at the input Vector. The Z component is ignored.
:3D: Evaluate the noise in 3D space at the input Vector.
:4D: Evaluate the noise in 4D space at the input Vector and the input W as the fourth dimension.
Higher dimensions corresponds to higher render time,
so lower dimensions should be used unless higher dimensions are necessary.
Feature
The Voronoi feature that the node will compute.
:F1:
The distance to the closest feature point as well as its position and color.
.. list-table::
* - .. figure:: /images/render_shader-nodes_textures_voronoi_smoothness-distance-zero.png
Distance.
- .. figure:: /images/render_shader-nodes_textures_voronoi_smoothness-color-zero.png
Color.
- .. figure:: /images/render_shader-nodes_textures_voronoi_f1-position.png
Position.
:F2:
The distance to the second closest feature point as well as its position and color.
.. list-table::
* - .. figure:: /images/render_shader-nodes_textures_voronoi_f2-distance.png
Distance.
- .. figure:: /images/render_shader-nodes_textures_voronoi_f2-color.png
Color.
- .. figure:: /images/render_shader-nodes_textures_voronoi_f2-position.png
Position.
:Smooth F1:
A smooth version of F1.
.. list-table::
* - .. figure:: /images/render_shader-nodes_textures_voronoi_smoothness-distance-one.png
Distance.
- .. figure:: /images/render_shader-nodes_textures_voronoi_smoothness-color-one.png
Color.
- .. figure:: /images/render_shader-nodes_textures_voronoi_smooth-f1-position.png
Position.
:Distance to Edge:
The distance to the edges of the Voronoi cells.
.. list-table::
* - .. figure:: /images/render_shader-nodes_textures_voronoi_distance-to-edge.png
Distance.
- .. figure:: /images/render_shader-nodes_textures_voronoi_distance-to-edge-less-than.png
Distance smaller than 0.05.
:N-Sphere Radius:
The radius of the n-sphere inscribed in the Voronoi cells.
In other words, it is half the distance between the closest feature point and the feature point closest to it.
.. list-table::
* - .. figure:: /images/render_shader-nodes_textures_voronoi_n-sphere-radius.png
The n-sphere radius can be used to create tightly packed n-spheres.
- .. figure:: /images/render_shader-nodes_textures_voronoi_n-sphere-radius-nodetree.png
Node tree for the shader to the left.
Distance Metric
The distance metric used to compute the texture.
:Euclidean:
Use the `Euclidean distance metric <https://en.wikipedia.org/wiki/Euclidean_distance>`__.
:Manhattan:
Use the `Manhattan distance metric <https://en.wikipedia.org/wiki/Taxicab_geometry>`__.
:Chebychev:
Use the `Chebychev distance metric <https://en.wikipedia.org/wiki/Chebyshev_distance>`__.
:Minkowski:
Use the `Minkowski distance metric <https://en.wikipedia.org/wiki/Minkowski_distance>`__.
The Minkowski distance is a generalization of the aforementioned metrics with an *Exponent* as a parameter.
Minkowski with an exponent of one is equivalent to the *Manhattan* distance metric.
Minkowski with an exponent of two is equivalent to the *Euclidean* distance metric.
Minkowski with an infinite exponent is equivalent to the *Chebychev* distance metric.
.. list-table::
* - .. figure:: /images/render_shader-nodes_textures_voronoi_minkowski-half.png
Minkowski Exponent: 0.5 (Minkowski 1/2).
- .. figure:: /images/render_shader-nodes_textures_voronoi_minkowski-one.png
Minkowski Exponent: 1.0 (Manhattan).
- .. figure:: /images/render_shader-nodes_textures_voronoi_minkowski-two.png
Minkowski Exponent: 2.0 (Euclidean).
- .. figure:: /images/render_shader-nodes_textures_voronoi_minkowski-32.png
Minkowski Exponent: 32.0 (approximation of Chebychev).
Normalize
If enabled, ensures that the output values stay in the range 0.0 to 1.0.
In rare cases, the output value may be outside that range when *Feature* is *F2*.
Outputs
=======
Distance
Distance.
Color
Cell color. The color is arbitrary.
Position
Position of feature point.
W
Position of feature point.
Radius
N-Sphere radius.
Notes
=====
In some configurations of the node, especially for low values of *Randomness*,
rendering artifacts may occur. This happens due to the same reasons described
in the :ref:`Notes section <shader-white-noise-notes>` in the White Noise Texture page
and can be fixed in a similar manner as described there.
Examples
========
.. figure:: /images/render_shader-nodes_textures_voronoi_example-beveled-cells.png
The difference between *F1* and *Smooth F1* can be used to create beveled Voronoi cells.
.. figure:: /images/render_shader-nodes_textures_voronoi_example-hammered-metal.jpg
Creating a hammered metal shader using the *Voronoi Texture* node.
|
