Blender V5.3
GEO_xpbd_constraint_pin_position.hh
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2026 Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
5#pragma once
6
10
11namespace blender::xpbd {
12
13class PinPositionConstraintSet : public TemplatedConstraintSet<PinPositionConstraintSet> {
14 private:
16 Span<int> point_indices_;
17 Span<float3> pin_positions_;
18 Span<float> compliances_;
19 /* Scale factor for residual error. */
20 float error_scale_;
21 MutableSpan<float> lambdas_;
22
23 public:
24 static constexpr StringRefNull debug_name = "Pinned Position";
25
26 PinPositionConstraintSet(const int geo_i,
27 const Span<int> point_indices,
28 const Span<float3> pin_positions,
29 const Span<float> compliances,
30 const float error_scale,
31 const MutableSpan<float> lambdas)
32 : TemplatedConstraintSet<PinPositionConstraintSet>(point_indices.size(), {geo_i}),
33 point_indices_(point_indices),
34 pin_positions_(pin_positions),
35 compliances_(compliances),
36 error_scale_(error_scale),
37 lambdas_(lambdas)
38 {
39 }
40
41 void reset_force(const int constraint_i) const
42 {
43 lambdas_[constraint_i] = 0.0f;
44 }
45
46 template<typename UpdaterT>
48 UpdaterT &updater,
49 const int constraint_i) const
50 {
51 const int geo_i = affected_geo_indices_[0];
52 const int point_i = point_indices_[constraint_i];
54 params.position(geo_i, point_i),
55 pin_positions_[constraint_i],
56 params.inv_mass(geo_i, point_i),
57 0.0f,
58 0.0f,
59 compliances_[constraint_i] * params.compliance_term_factor,
60 lambdas_[constraint_i]);
61 lambdas_[constraint_i] += result.delta_lambda;
62 updater.update_position(geo_i, point_i, result.offset0);
63 updater.add_residual_error(geo_i, result.residual_error_squared * error_scale_);
64 }
65
67 {
68 return color_constraints__unary(point_indices_, memory);
69 }
70};
71
72} // namespace blender::xpbd
const float3 & position(int geo_i, int point_i) const
float inv_mass(int geo_i, int point_i) const
PinPositionConstraintSet(const int geo_i, const Span< int > point_indices, const Span< float3 > pin_positions, const Span< float > compliances, const float error_scale, const MutableSpan< float > lambdas)
void solve_single(const ConstraintSetParams &params, UpdaterT &updater, const int constraint_i) const
ConstraintColoring color_constraints(LinearAllocator<> &memory) const override
TemplatedConstraintSet(const int constraints_num, Vector< int > affected_geo_indices)
ConstraintColoring color_constraints__unary(const Span< int > affected_points, LinearAllocator<> &memory)
DistanceConstraintResult evaluate_distance_constraint(const float3 &p0, const float3 &p1, const float inv_m0, const float inv_m1, const float rest_distance, const float compliance_term, const float lambda_prev)