Blender V5.3
kelvinlet.cc
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
8
9#include "BKE_kelvinlet.h"
10#include "BLI_math_base_c.hh"
11#include "BLI_math_vector_c.hh"
12
13namespace blender {
14
15/* Regularized Kelvinlets: Sculpting Brushes based on Fundamental Solutions of Elasticity
16 * Pixar Technical Memo #17-03 */
17
19 KelvinletParams *params, float radius, float force, float shear_modulus, float poisson_ratio)
20{
21 params->a = 1.0f / (4.0f * float(M_PI) * shear_modulus);
22 params->b = params->a / (4.0f * (1.0f - poisson_ratio));
23 params->c = 2 * (3.0f * params->a - 2.0f * params->b);
24
25 /* Used in scale and twist. */
26 params->f = force;
27
28 /* This can be exposed if needed */
29 const float radius_e[KELVINLET_MAX_ITERATIONS] = {1.0f, 2.0f, 2.0f};
30 params->radius_scaled[0] = radius * radius_e[0];
31 params->radius_scaled[1] = params->radius_scaled[0] * radius_e[1];
32 params->radius_scaled[2] = params->radius_scaled[1] * radius_e[2];
33}
34
35static void init_kelvinlet_grab(float radius_e[3],
36 float kelvinlet[3],
37 const float radius,
38 const KelvinletParams *params,
39 const int num_iterations)
40{
41 const float a = params->a;
42 const float b = params->b;
43 const float *radius_scaled = params->radius_scaled;
44
45 for (int i = 0; i < num_iterations; i++) {
46 radius_e[i] = sqrtf(pow2f(radius) + pow2f(params->radius_scaled[i]));
47 }
48
49 /* Regularized Kelvinlets: Formula (6) */
50 for (int i = 0; i < num_iterations; i++) {
51 kelvinlet[i] = ((a - b) / radius_e[i]) + ((b * pow2f(radius)) / pow3f(radius_e[i])) +
52 ((a * pow2f(radius_scaled[i])) / (2.0f * pow3f(radius_e[i])));
53 }
54}
55
56void BKE_kelvinlet_grab(float radius_elem_disp[3],
57 const KelvinletParams *params,
58 const float elem_orig_co[3],
59 const float brush_location[3],
60 const float brush_delta[3])
61{
62 float radius_e[3], kelvinlet[3];
63 const float c = params->c;
64 const float radius = len_v3v3(brush_location, elem_orig_co);
65
66 init_kelvinlet_grab(radius_e, kelvinlet, radius, params, 1);
67
68 const float fade = kelvinlet[0] * c;
69
70 mul_v3_v3fl(radius_elem_disp, brush_delta, fade);
71}
72
73void BKE_kelvinlet_grab_biscale(float radius_elem_disp[3],
74 const KelvinletParams *params,
75 const float elem_orig_co[3],
76 const float brush_location[3],
77 const float brush_delta[3])
78{
79 float radius_e[3], kelvinlet[3];
80 const float c = params->c;
81 const float *radius_scaled = params->radius_scaled;
82 float radius = len_v3v3(brush_location, elem_orig_co);
83
84 init_kelvinlet_grab(radius_e, kelvinlet, radius, params, 2);
85
86 const float u = kelvinlet[0] - kelvinlet[1];
87 const float fade = u * c / ((1.0f / radius_scaled[0]) - (1.0f / radius_scaled[1]));
88
89 mul_v3_v3fl(radius_elem_disp, brush_delta, fade);
90}
91
92void BKE_kelvinlet_grab_triscale(float radius_elem_disp[3],
93 const KelvinletParams *params,
94 const float elem_orig_co[3],
95 const float brush_location[3],
96 const float brush_delta[3])
97{
98 float radius_e[3], kelvinlet[3], weights[3];
99 const float c = params->c;
100 const float *radius_scaled = params->radius_scaled;
101 const float radius = len_v3v3(brush_location, elem_orig_co);
102
103 init_kelvinlet_grab(radius_e, kelvinlet, radius, params, 3);
104
105 weights[0] = 1.0f;
106 weights[1] = -((pow2f(radius_scaled[2]) - pow2f(radius_scaled[0])) /
107 (pow2f(radius_scaled[2]) - pow2f(radius_scaled[1])));
108 weights[2] = ((pow2f(radius_scaled[1]) - pow2f(radius_scaled[0])) /
109 (pow2f(radius_scaled[2]) - pow2f(radius_scaled[1])));
110
111 const float u = weights[0] * kelvinlet[0] + weights[1] * kelvinlet[1] +
112 weights[2] * kelvinlet[2];
113 const float fade = u * c /
114 (weights[0] / radius_scaled[0] + weights[1] / radius_scaled[1] +
115 weights[2] / radius_scaled[2]);
116
117 mul_v3_v3fl(radius_elem_disp, brush_delta, fade);
118}
119
121 void (*)(float[3], const float *, const float *, const float *, const KelvinletParams *);
122
124 float r_disp[3],
125 const float vertex_co[3],
126 const float location[3],
127 const float normal[3],
128 const KelvinletParams *p)
129{
130 float k[4][3], k_it[4][3];
131 kelvinlet(k[0], vertex_co, location, normal, p);
132 copy_v3_v3(k_it[0], k[0]);
133 mul_v3_fl(k_it[0], 0.5f);
134 add_v3_v3v3(k_it[0], vertex_co, k_it[0]);
135 kelvinlet(k[1], k_it[0], location, normal, p);
136 copy_v3_v3(k_it[1], k[1]);
137 mul_v3_fl(k_it[1], 0.5f);
138 add_v3_v3v3(k_it[1], vertex_co, k_it[1]);
139 kelvinlet(k[2], k_it[1], location, normal, p);
140 copy_v3_v3(k_it[2], k[2]);
141 add_v3_v3v3(k_it[2], vertex_co, k_it[2]);
142 sub_v3_v3v3(k_it[2], k_it[2], location);
143 kelvinlet(k[3], k_it[2], location, normal, p);
144 copy_v3_v3(r_disp, k[0]);
145 madd_v3_v3fl(r_disp, k[1], 2.0f);
146 madd_v3_v3fl(r_disp, k[2], 2.0f);
147 add_v3_v3(r_disp, k[3]);
148 mul_v3_fl(r_disp, 1.0f / 6.0f);
149}
150
151/* Regularized Kelvinlets: Formula (16) */
152static void kelvinlet_scale(float disp[3],
153 const float vertex_co[3],
154 const float location[3],
155 const float /*normal*/[3],
156 const KelvinletParams *p)
157{
158 float radius_vertex[3];
159 sub_v3_v3v3(radius_vertex, vertex_co, location);
160 const float radius = len_v3(radius_vertex);
161 const float radius_e = sqrtf(pow2f(radius) + pow2f(p->radius_scaled[0]));
162 const float u = (2.0f * p->b - p->a) * (1.0f / pow3f(radius_e)) +
163 ((3.0f * pow2f(p->radius_scaled[0])) / (2.0f * pow5f(radius_e)));
164 const float fade = u * p->c;
165 mul_v3_v3fl(disp, radius_vertex, fade * p->f);
166}
167
168void BKE_kelvinlet_scale(float radius_elem_disp[3],
169 const KelvinletParams *params,
170 const float elem_orig_co[3],
171 const float brush_location[3],
172 const float surface_normal[3])
173{
175 kelvinlet_scale, radius_elem_disp, elem_orig_co, brush_location, surface_normal, params);
176}
177
178/* Regularized Kelvinlets: Formula (15) */
179static void kelvinlet_twist(float disp[3],
180 const float vertex_co[3],
181 const float location[3],
182 const float normal[3],
183 const KelvinletParams *p)
184{
185 float radius_vertex[3], q_r[3];
186 sub_v3_v3v3(radius_vertex, vertex_co, location);
187 const float radius = len_v3(radius_vertex);
188 const float radius_e = sqrtf(pow2f(radius) + pow2f(p->radius_scaled[0]));
189 const float u = -p->a * (1.0f / pow3f(radius_e)) +
190 ((3.0f * pow2f(p->radius_scaled[0])) / (2.0f * pow5f(radius_e)));
191 const float fade = u * p->c;
192 cross_v3_v3v3(q_r, normal, radius_vertex);
193 mul_v3_v3fl(disp, q_r, fade * p->f);
194}
195
196void BKE_kelvinlet_twist(float radius_elem_disp[3],
197 const KelvinletParams *params,
198 const float elem_orig_co[3],
199 const float brush_location[3],
200 const float surface_normal[3])
201{
203 kelvinlet_twist, radius_elem_disp, elem_orig_co, brush_location, surface_normal, params);
204}
205
206} // namespace blender
#define KELVINLET_MAX_ITERATIONS
#define M_PI
float fade(float t)
BMesh Iterators.
void BKE_kelvinlet_grab(float radius_elem_disp[3], const KelvinletParams *params, const float elem_orig_co[3], const float brush_location[3], const float brush_delta[3])
Definition kelvinlet.cc:56
void BKE_kelvinlet_twist(float radius_elem_disp[3], const KelvinletParams *params, const float elem_orig_co[3], const float brush_location[3], const float surface_normal[3])
Definition kelvinlet.cc:196
void BKE_kelvinlet_init_params(KelvinletParams *params, float radius, float force, float shear_modulus, float poisson_ratio)
Definition kelvinlet.cc:18
MINLINE void copy_v3_v3(float r[3], const float a[3])
MINLINE void add_v3_v3v3(float r[3], const float a[3], const float b[3])
static void init_kelvinlet_grab(float radius_e[3], float kelvinlet[3], const float radius, const KelvinletParams *params, const int num_iterations)
Definition kelvinlet.cc:35
static void kelvinlet_scale(float disp[3], const float vertex_co[3], const float location[3], const float[3], const KelvinletParams *p)
Definition kelvinlet.cc:152
MINLINE float pow3f(float x)
static void sculpt_kelvinet_integrate(kelvinlet_fn kelvinlet, float r_disp[3], const float vertex_co[3], const float location[3], const float normal[3], const KelvinletParams *p)
Definition kelvinlet.cc:123
MINLINE void mul_v3_fl(float r[3], float f)
MINLINE float pow2f(float x)
void BKE_kelvinlet_scale(float radius_elem_disp[3], const KelvinletParams *params, const float elem_orig_co[3], const float brush_location[3], const float surface_normal[3])
Definition kelvinlet.cc:168
MINLINE void madd_v3_v3fl(float r[3], const float a[3], float f)
MINLINE float pow5f(float x)
MINLINE void cross_v3_v3v3(float r[3], const float a[3], const float b[3])
static void kelvinlet_twist(float disp[3], const float vertex_co[3], const float location[3], const float normal[3], const KelvinletParams *p)
Definition kelvinlet.cc:179
void BKE_kelvinlet_grab_triscale(float radius_elem_disp[3], const KelvinletParams *params, const float elem_orig_co[3], const float brush_location[3], const float brush_delta[3])
Definition kelvinlet.cc:92
MINLINE float len_v3(const float a[3]) ATTR_WARN_UNUSED_RESULT
void(*)(float[3], const float *, const float *, const float *, const KelvinletParams *) kelvinlet_fn
Definition kelvinlet.cc:120
MINLINE void mul_v3_v3fl(float r[3], const float a[3], float f)
MINLINE void add_v3_v3(float r[3], const float a[3])
MINLINE void sub_v3_v3v3(float r[3], const float a[3], const float b[3])
MINLINE float len_v3v3(const float a[3], const float b[3]) ATTR_WARN_UNUSED_RESULT
void BKE_kelvinlet_grab_biscale(float radius_elem_disp[3], const KelvinletParams *params, const float elem_orig_co[3], const float brush_location[3], const float brush_delta[3])
Definition kelvinlet.cc:73
#define sqrtf
KERNEL_FEATURE_LIGHT_PASSES KERNEL_FEATURE_PATH_GUIDING float
float radius_scaled[KELVINLET_MAX_ITERATIONS]