Blender V5.3
enhance_details.cc
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2024 Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
8
10
11#include "DNA_brush_types.h"
12#include "DNA_mesh_types.h"
13#include "DNA_object_types.h"
14#include "DNA_scene_types.h"
15
16#include "BKE_mesh.hh"
17#include "BKE_object_types.hh"
18#include "BKE_paint.hh"
19#include "BKE_paint_bvh.hh"
20#include "BKE_subdiv_ccg.hh"
21
22#include "BLI_array.hh"
24#include "BLI_task.hh"
25
30
31#include "bmesh.hh"
32
33namespace blender {
34
36inline namespace enhance_details_cc {
37
47
48static void calc_faces(const Depsgraph &depsgraph,
49 const Sculpt &sd,
50 const Brush &brush,
51 const MeshAttributeData &attribute_data,
52 const Span<float3> vert_normals,
53 const Span<float3> all_translations,
54 const float strength,
56 Object &object,
57 const PositionDeformData &position_data)
58{
59 SculptSession &ss = *object.runtime->sculpt_session;
60
61 const Span<int> verts = node.verts();
62
66 brush,
67 object,
68 attribute_data,
69 position_data.eval,
70 vert_normals,
71 node,
72 factors,
73 distances);
74
75 scale_factors(factors, strength);
76
78 gather_data_mesh<float3>(all_translations, verts, translations);
79 scale_translations(translations, factors);
80
81 clip_and_lock_translations(sd, ss, position_data.eval, verts, translations);
82 position_data.deform(translations, verts);
83}
84
85static void calc_grids(const Depsgraph &depsgraph,
86 const Sculpt &sd,
87 Object &object,
88 const Brush &brush,
89 const Span<float3> all_translations,
90 const float strength,
92 LocalData &tls)
93{
94 SculptSession &ss = *object.runtime->sculpt_session;
95 SubdivCCG &subdiv_ccg = *ss.subdiv_ccg;
96
97 const Span<int> grids = node.grids();
98 const MutableSpan positions = gather_grids_positions(subdiv_ccg, grids, tls.positions);
99
100 calc_factors_common_grids(depsgraph, brush, object, positions, node, tls.factors, tls.distances);
101
102 scale_factors(tls.factors, strength);
103
104 const MutableSpan<float3> translations = gather_data_grids(
105 subdiv_ccg, all_translations, grids, tls.translations);
106 scale_translations(translations, tls.factors);
107
108 clip_and_lock_translations(sd, ss, positions, translations);
109 apply_translations(translations, grids, subdiv_ccg);
110}
111
112static void calc_bmesh(const Depsgraph &depsgraph,
113 const Sculpt &sd,
114 Object &object,
115 const Brush &brush,
116 const Span<float3> all_translations,
117 const float strength,
119 LocalData &tls)
120{
121 SculptSession &ss = *object.runtime->sculpt_session;
122
124 const MutableSpan positions = gather_bmesh_positions(verts, tls.positions);
125
126 calc_factors_common_bmesh(depsgraph, brush, object, positions, node, tls.factors, tls.distances);
127
128 scale_factors(tls.factors, strength);
129
130 const MutableSpan translations = gather_data_bmesh(all_translations, verts, tls.translations);
131 scale_translations(translations, tls.factors);
132
133 clip_and_lock_translations(sd, ss, positions, translations);
134 apply_translations(translations, verts);
135}
136
137static void calc_translations_faces(const Span<float3> vert_positions,
138 const OffsetIndices<int> faces,
139 const Span<int> corner_verts,
140 const GroupedSpan<int> vert_to_face_map,
141 const Span<bool> hide_poly,
143 LocalData &tls,
144 const MutableSpan<float3> all_translations)
145{
146 const Span<int> verts = node.verts();
147
148 const GroupedSpan<int> neighbors = calc_vert_neighbors(faces,
149 corner_verts,
150 vert_to_face_map,
151 hide_poly,
152 verts,
153 tls.neighbor_offsets,
154 tls.neighbor_data);
155
156 tls.new_positions.resize(verts.size());
157 const MutableSpan<float3> new_positions = tls.new_positions;
158 smooth::neighbor_data_average_mesh_check_loose(vert_positions, verts, neighbors, new_positions);
159
160 tls.translations.resize(verts.size());
161 const MutableSpan<float3> translations = tls.translations;
162 translations_from_new_positions(new_positions, verts, vert_positions, translations);
163 scatter_data_mesh(translations.as_span(), verts, all_translations);
164}
165
166static void calc_translations_grids(const SubdivCCG &subdiv_ccg,
168 LocalData &tls,
169 const MutableSpan<float3> all_translations)
170{
171 const Span<int> grids = node.grids();
172 const MutableSpan positions = gather_grids_positions(subdiv_ccg, grids, tls.positions);
173
174 tls.new_positions.resize(positions.size());
175 const MutableSpan<float3> new_positions = tls.new_positions;
176 smooth::average_data_grids(subdiv_ccg, subdiv_ccg.positions.as_span(), grids, new_positions);
177
178 tls.translations.resize(positions.size());
179 const MutableSpan<float3> translations = tls.translations;
180 translations_from_new_positions(new_positions, positions, translations);
181 scatter_data_grids(subdiv_ccg, translations.as_span(), grids, all_translations);
182}
183
185 LocalData &tls,
186 const MutableSpan<float3> all_translations)
187{
189 const_cast<bke::pbvh::BMeshNode *>(&node));
190 const MutableSpan positions = gather_bmesh_positions(verts, tls.positions);
191
192 tls.new_positions.resize(verts.size());
193 const MutableSpan<float3> new_positions = tls.new_positions;
194 smooth::neighbor_position_average_bmesh(verts, new_positions);
195
196 tls.translations.resize(verts.size());
197 const MutableSpan<float3> translations = tls.translations;
198 translations_from_new_positions(new_positions, positions, translations);
199 scatter_data_bmesh(translations.as_span(), verts, all_translations);
200}
201
202} // namespace enhance_details_cc
203
204void do_enhance_details_brush(const Depsgraph &depsgraph,
205 const Sculpt &sd,
206 Object &object,
207 const IndexMask &node_mask)
208{
210 SculptSession &ss = *object.runtime->sculpt_session;
213
214 if (ss.cache->detail_directions.is_empty()) {
216 IndexMaskMemory memory;
217 const IndexMask effective_nodes = bke::pbvh::search_nodes(
218 pbvh, memory, [&](const bke::pbvh::Node &node) {
220 });
221 calc_smooth_translations(depsgraph, object, effective_nodes, ss.cache->detail_directions);
222 }
223
224 const float strength = std::clamp(ss.cache->bstrength, -1.0f, 1.0f);
226
228 switch (pbvh.type()) {
230 const Mesh &mesh = *id_cast<Mesh *>(object.data);
231 const MeshAttributeData attribute_data(mesh);
232 const PositionDeformData position_data(depsgraph, object);
233 const Span<float3> vert_normals = bke::pbvh::vert_normals_eval(depsgraph, object);
235 node_mask.foreach_index(
236 [&](const int i) {
237 calc_faces(depsgraph,
238 sd,
239 brush,
240 attribute_data,
241 vert_normals,
242 translations,
243 strength,
244 nodes[i],
245 object,
246 position_data);
247 bke::pbvh::update_node_bounds_mesh(position_data.eval, nodes[i]);
248 },
250 break;
251 }
253 SubdivCCG &subdiv_ccg = *object.runtime->sculpt_session->subdiv_ccg;
254 MutableSpan<float3> positions = subdiv_ccg.positions;
256 node_mask.foreach_index(
257 [&](const int i) {
258 LocalData &tls = all_tls.local();
259 calc_grids(depsgraph, sd, object, brush, translations, strength, nodes[i], tls);
260 bke::pbvh::update_node_bounds_grids(subdiv_ccg.grid_area, positions, nodes[i]);
261 },
263 break;
264 }
267 node_mask.foreach_index(
268 [&](const int i) {
269 LocalData &tls = all_tls.local();
270 calc_bmesh(depsgraph, sd, object, brush, translations, strength, nodes[i], tls);
272 },
274 break;
275 }
276 }
277 pbvh.tag_positions_changed(node_mask);
278 pbvh.flush_bounds_to_parents();
279}
280
281} // namespace ed::sculpt_paint::brushes
282namespace ed::sculpt_paint {
283void calc_smooth_translations(const Depsgraph &depsgraph,
284 const Object &object,
285 const IndexMask &node_mask,
286 const MutableSpan<float3> translations)
287{
288 const SculptSession &ss = *object.runtime->sculpt_session;
290
292 switch (pbvh.type()) {
294 Mesh &mesh = *id_cast<Mesh *>(object.data);
295 const MeshAttributeData attribute_data(mesh);
296 const Span<float3> positions_eval = bke::pbvh::vert_positions_eval(depsgraph, object);
297 const OffsetIndices faces = mesh.faces();
298 const Span<int> corner_verts = mesh.corner_verts();
299 const GroupedSpan<int> vert_to_face_map = mesh.vert_to_face_map();
301 node_mask.foreach_index(
302 [&](const int i) {
303 brushes::LocalData &tls = all_tls.local();
304 calc_translations_faces(positions_eval,
305 faces,
306 corner_verts,
307 vert_to_face_map,
308 attribute_data.hide_poly,
309 nodes[i],
310 tls,
311 translations);
312 },
314 break;
315 }
317 SubdivCCG &subdiv_ccg = *ss.subdiv_ccg;
319 node_mask.foreach_index(
320 [&](const int i) {
321 brushes::LocalData &tls = all_tls.local();
322 calc_translations_grids(subdiv_ccg, nodes[i], tls, translations);
323 },
325 break;
326 }
328 vert_random_access_ensure(const_cast<Object &>(object));
330 node_mask.foreach_index(
331 [&](const int i) {
332 brushes::LocalData &tls = all_tls.local();
333 calc_translations_bmesh(nodes[i], tls, translations);
334 },
336 break;
337 }
338}
339
340} // namespace ed::sculpt_paint
341
342} // namespace blender
A BVH for high poly meshes.
Object is a sort of wrapper for general info.
#define PRF_scope(category)
Span< T > as_span() const
Definition BLI_array.hh:254
void reinitialize(const int64_t new_size)
Definition BLI_array.hh:430
bool is_empty() const
Definition BLI_array.hh:275
constexpr int64_t size() const
Definition BLI_span.hh:499
constexpr Span< T > as_span() const
Definition BLI_span.hh:667
int64_t size() const
Definition BLI_set.hh:606
constexpr int64_t size() const
Definition BLI_span.hh:256
void foreach_index(Fn &&fn, Mode mode=exec_mode::serial) const
pbvh::Tree * pbvh_get(Object &object)
IndexMask search_nodes(const Tree &pbvh, IndexMaskMemory &memory, FunctionRef< bool(const Node &)> filter_fn)
Definition pbvh.cc:2556
void update_node_bounds_bmesh(BMeshNode &node)
Definition pbvh.cc:1216
void update_node_bounds_mesh(Span< float3 > positions, MeshNode &node)
Definition pbvh.cc:1196
Span< float3 > vert_normals_eval(const Depsgraph &depsgraph, const Object &object_orig)
Definition pbvh.cc:952
void update_node_bounds_grids(int grid_area, Span< float3 > positions, GridsNode &node)
Definition pbvh.cc:1205
Span< float3 > vert_positions_eval(const Depsgraph &depsgraph, const Object &object_orig)
Definition pbvh.cc:933
static void calc_translations_faces(const Span< float3 > vert_positions, const OffsetIndices< int > faces, const Span< int > corner_verts, const GroupedSpan< int > vert_to_face_map, const Span< bool > hide_poly, const bke::pbvh::MeshNode &node, LocalData &tls, const MutableSpan< float3 > all_translations)
static void calc_translations_grids(const SubdivCCG &subdiv_ccg, const bke::pbvh::GridsNode &node, LocalData &tls, const MutableSpan< float3 > all_translations)
static void calc_translations_bmesh(const bke::pbvh::BMeshNode &node, LocalData &tls, const MutableSpan< float3 > all_translations)
static void calc_bmesh(const Depsgraph &depsgraph, const Sculpt &sd, const Brush &brush, Object &object, bke::pbvh::BMeshNode &node, LocalData &tls, MutableSpan< float > layer_displacement_factor)
static void calc_grids(const Depsgraph &depsgraph, const Sculpt &sd, const Brush &brush, Object &object, const bool use_persistent_base, const Span< float3 > persistent_base_positions, const Span< float3 > persistent_base_normals, bke::pbvh::GridsNode &node, LocalData &tls, MutableSpan< float > layer_displacement_factor)
static void calc_faces(const Depsgraph &depsgraph, const Sculpt &sd, const Brush &brush, const MeshAttributeData &attribute_data, const Span< float3 > vert_normals, const bool use_persistent_base, const Span< float3 > persistent_base_positions, const Span< float3 > persistent_base_normals, Object &object, bke::pbvh::MeshNode &node, MutableSpan< float > layer_displacement_factor, const PositionDeformData &position_data)
void do_enhance_details_brush(const Depsgraph &depsgraph, const Sculpt &sd, Object &object, const IndexMask &node_mask)
void neighbor_data_average_mesh_check_loose(const Span< T > src, const Span< int > verts, const GroupedSpan< int > vert_neighbors, const MutableSpan< T > dst)
void average_data_grids(const SubdivCCG &subdiv_ccg, const Span< T > src, const Span< int > grids, const MutableSpan< T > dst)
void neighbor_position_average_bmesh(const Set< BMVert *, 0 > &verts, const MutableSpan< float3 > new_positions)
MutableSpan< float3 > gather_grids_positions(const SubdivCCG &subdiv_ccg, const Span< int > grids, Vector< float3 > &positions)
void calc_smooth_translations(const Depsgraph &depsgraph, const Object &object, const IndexMask &node_mask, const MutableSpan< float3 > translations)
void scatter_data_bmesh(Span< T > node_data, const Set< BMVert *, 0 > &verts, MutableSpan< T > dst)
Definition sculpt.cc:6577
void gather_bmesh_positions(const Set< BMVert *, 0 > &verts, MutableSpan< float3 > positions)
Definition sculpt.cc:6497
void gather_data_grids(const SubdivCCG &subdiv_ccg, Span< T > src, Span< int > grids, MutableSpan< T > node_data)
Definition sculpt.cc:6528
void vert_random_access_ensure(Object &object)
Definition sculpt.cc:154
void calc_factors_common_grids(const Depsgraph &depsgraph, const Brush &brush, const Object &object, Span< float3 > positions, const bke::pbvh::GridsNode &node, Vector< float > &r_factors, Vector< float > &r_distances)
Definition sculpt.cc:6804
GroupedSpan< int > calc_vert_neighbors(OffsetIndices< int > faces, Span< int > corner_verts, GroupedSpan< int > vert_to_face, Span< bool > hide_poly, Span< int > verts, Vector< int > &r_offset_data, Vector< int > &r_data)
Definition sculpt.cc:7949
bool node_fully_masked_or_hidden(const bke::pbvh::Node &node)
Definition sculpt.cc:2500
int vertex_count_get(const Object &object)
Definition sculpt.cc:163
void gather_data_bmesh(Span< T > src, const Set< BMVert *, 0 > &verts, MutableSpan< T > node_data)
Definition sculpt.cc:6545
void scale_translations(MutableSpan< float3 > translations, Span< float > factors)
Definition sculpt.cc:7837
void calc_factors_common_mesh_indexed(const Depsgraph &depsgraph, const Brush &brush, const Object &object, const MeshAttributeData &attribute_data, Span< float3 > vert_positions, Span< float3 > vert_normals, const bke::pbvh::MeshNode &node, MutableSpan< float > factors, MutableSpan< float > distances)
Definition sculpt.cc:6739
void scale_factors(MutableSpan< float > factors, float strength)
Definition sculpt.cc:7856
void translations_from_new_positions(Span< float3 > new_positions, Span< int > verts, Span< float3 > old_positions, MutableSpan< float3 > translations)
Definition sculpt.cc:7889
void clip_and_lock_translations(const Sculpt &sd, const SculptSession &ss, Span< float3 > positions, Span< int > verts, MutableSpan< float3 > translations)
Definition sculpt.cc:7664
void scatter_data_mesh(Span< T > src, Span< int > indices, MutableSpan< T > dst)
void apply_translations(Span< float3 > translations, Span< int > verts, MutableSpan< float3 > positions)
Definition sculpt.cc:7592
void gather_data_mesh(Span< T > src, Span< int > indices, MutableSpan< T > dst)
void scatter_data_grids(const SubdivCCG &subdiv_ccg, Span< T > node_data, Span< int > grids, MutableSpan< T > dst)
Definition sculpt.cc:6560
void calc_factors_common_bmesh(const Depsgraph &depsgraph, const Brush &brush, const Object &object, Span< float3 > positions, bke::pbvh::BMeshNode &node, Vector< float > &r_factors, Vector< float > &r_distances)
Definition sculpt.cc:6891
constexpr ParallelGrainSize grain_size(int grain_size)
BMesh Iterators.
BMesh const char void * data
const Brush * BKE_paint_brush_for_read(const Paint *paint)
const Set< BMVert *, 0 > & BKE_pbvh_bmesh_node_unique_verts(bke::pbvh::BMeshNode *node)
ed::sculpt_paint::StrokeCache * cache
Definition BKE_paint.hh:409
Array< float3 > positions