Blender V5.3
GEO_xpbd_constraint_damping_linear.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
8
9namespace blender::xpbd {
10
12 : public TemplatedVelocityConstraintSet<LinearDampingConstraintSet> {
13 private:
14 int geo_i_;
15 IndexRange points_;
17 Span<float> linear_dampings_;
18 MutableSpan<float> lambdas_;
19
20 public:
21 static constexpr StringRefNull debug_name = "Linear Damping";
22
24 const IndexRange points,
25 const Span<float> linear_dampings,
26 MutableSpan<float> lambdas)
28 geo_i_(geo_i),
29 points_(points),
30 linear_dampings_(linear_dampings),
31 lambdas_(lambdas)
32 {
33 }
34
35 void reset_force(const int constraint_i) const
36 {
37 lambdas_[constraint_i] = 0.0f;
38 }
39
40 template<typename UpdaterT>
42 UpdaterT &updater,
43 const int constraint_i) const
44 {
45 const int point_i = points_[constraint_i];
46 const float3 &velocity = params.velocity(geo_i_, point_i);
47 const float damping = linear_dampings_[constraint_i];
48 const float damping_factor = std::clamp(params.delta_time * damping, 0.0f, 1.0f);
49 float residual;
50 const float3 gradient = math::normalize_and_get_length(velocity, residual);
51 const float delta_lambda = -residual * damping_factor - lambdas_[constraint_i];
52 const float3 offset = gradient * delta_lambda;
53 lambdas_[constraint_i] += delta_lambda;
54 updater.update_velocity(geo_i_, point_i, offset);
55 }
56};
57
58} // namespace blender::xpbd
const float3 & velocity(int geo_i, int point_i) const
LinearDampingConstraintSet(const int geo_i, const IndexRange points, const Span< float > linear_dampings, MutableSpan< float > lambdas)
void solve_single(const ConstraintSetParams &params, UpdaterT &updater, const int constraint_i) const
TemplatedVelocityConstraintSet(int constraints_num, Vector< int > affected_geo_indices)
QuaternionBase< T > normalize_and_get_length(const QuaternionBase< T > &q, T &out_length)
VecBase< float, 3 > float3