Blender V5.3
GEO_xpbd_constraint_pin_rotation.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 PinRotationConstraintSet : public TemplatedConstraintSet<PinRotationConstraintSet> {
14 private:
16 Span<float> compliances_;
17 Span<int> point_indices_;
18 Span<math::Quaternion> pin_rotations_;
19 /* Scale factor for residual error. */
20 float error_scale_;
21 MutableSpan<float4> lambdas_;
22
23 public:
24 static constexpr StringRefNull debug_name = "Pin Rotation";
25
26 PinRotationConstraintSet(const int geo_i,
27 const Span<int> point_indices,
28 const Span<math::Quaternion> pin_rotations,
29 const Span<float> compliances,
30 const float error_scale,
31 MutableSpan<float4> lambdas)
32 : TemplatedConstraintSet<PinRotationConstraintSet>(point_indices.size(), {geo_i}),
33 compliances_(compliances),
34 point_indices_(point_indices),
35 pin_rotations_(pin_rotations),
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] = float4(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.rotation(geo_i, point_i),
55 pin_rotations_[constraint_i],
56 params.moment_of_inertia(geo_i, point_i),
57 float3(std::numeric_limits<float>::infinity()),
59 compliances_[constraint_i] * params.compliance_term_factor,
60 lambdas_[constraint_i]);
61 lambdas_[constraint_i] += result.delta_lambda;
62 updater.update_rotation(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 math::Quaternion & rotation(int geo_i, int point_i) const
float3 moment_of_inertia(int geo_i, int point_i) const
void solve_single(const ConstraintSetParams &params, UpdaterT &updater, const int constraint_i) const
ConstraintColoring color_constraints(LinearAllocator<> &memory) const override
PinRotationConstraintSet(const int geo_i, const Span< int > point_indices, const Span< math::Quaternion > pin_rotations, const Span< float > compliances, const float error_scale, MutableSpan< float4 > lambdas)
TemplatedConstraintSet(const int constraints_num, Vector< int > affected_geo_indices)
ConstraintColoring color_constraints__unary(const Span< int > affected_points, LinearAllocator<> &memory)
AlignRotationsConstraintResult evaluate_align_rotations_constraint(const math::Quaternion &r0, const math::Quaternion &r1, const float3 &inertia0, const float3 &inertia1, const math::Quaternion &rest_rotation, const float compliance_term, const float4 &lambda_prev)
VecBase< float, 4 > float4
VecBase< float, 3 > float3