Blender V5.3
implicit.h
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: Blender Authors
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4
5#pragma once
6
10
12
13#include <cstdio>
14
15namespace blender {
16
17// #define IMPLICIT_SOLVER_EIGEN
18#define IMPLICIT_SOLVER_BLENDER
19
20#define CLOTH_ROOT_FRAME /* enable use of root frame coordinate transform */
21
22#define CLOTH_FORCE_GRAVITY
23#define CLOTH_FORCE_DRAG
24#define CLOTH_FORCE_SPRING_STRUCTURAL
25#define CLOTH_FORCE_SPRING_SHEAR
26#define CLOTH_FORCE_SPRING_BEND
27// #define CLOTH_FORCE_SPRING_GOAL /* UNUSED. */
28// #define CLOTH_FORCE_EFFECTORS /* UNUSED. */
29
30// #define IMPLICIT_PRINT_SOLVER_INPUT_OUTPUT
31
32// #define IMPLICIT_ENABLE_EIGEN_DEBUG
33
34struct Implicit_Data;
35
37 int status;
38
40 float error;
41};
42
44{
45 printf("%-8.3f", v);
46}
47
48void SIM_mass_spring_set_vertex_mass(struct Implicit_Data *data, int index, float mass);
49void SIM_mass_spring_set_rest_transform(struct Implicit_Data *data, int index, float tfm[3][3]);
50
51void SIM_mass_spring_set_motion_state(struct Implicit_Data *data,
52 int index,
53 const float x[3],
54 const float v[3]);
55void SIM_mass_spring_set_position(struct Implicit_Data *data, int index, const float x[3]);
56void SIM_mass_spring_set_velocity(struct Implicit_Data *data, int index, const float v[3]);
57void SIM_mass_spring_get_motion_state(struct Implicit_Data *data,
58 int index,
59 float x[3],
60 float v[3]);
61void SIM_mass_spring_get_position(struct Implicit_Data *data, int index, float x[3]);
62void SIM_mass_spring_get_velocity(struct Implicit_Data *data, int index, float v[3]);
63
64/* Access to modified motion state during solver step. */
65
66void SIM_mass_spring_get_new_position(struct Implicit_Data *data, int index, float x[3]);
67void SIM_mass_spring_set_new_position(struct Implicit_Data *data, int index, const float x[3]);
68void SIM_mass_spring_get_new_velocity(struct Implicit_Data *data, int index, float v[3]);
69void SIM_mass_spring_set_new_velocity(struct Implicit_Data *data, int index, const float v[3]);
70
71void SIM_mass_spring_clear_constraints(struct Implicit_Data *data);
72void SIM_mass_spring_add_constraint_ndof0(struct Implicit_Data *data,
73 int index,
74 const float dV[3]);
75void SIM_mass_spring_add_constraint_ndof1(struct Implicit_Data *data,
76 int index,
77 const float c1[3],
78 const float c2[3],
79 const float dV[3]);
80void SIM_mass_spring_add_constraint_ndof2(struct Implicit_Data *data,
81 int index,
82 const float c1[3],
83 const float dV[3]);
84
85bool SIM_mass_spring_solve_velocities(struct Implicit_Data *data,
86 float dt,
87 struct ImplicitSolverResult *result);
88bool SIM_mass_spring_solve_positions(struct Implicit_Data *data, float dt);
89void SIM_mass_spring_apply_result(struct Implicit_Data *data);
90
94void SIM_mass_spring_clear_forces(struct Implicit_Data *data);
98void SIM_mass_spring_force_reference_frame(struct Implicit_Data *data,
99 int index,
100 const float acceleration[3],
101 const float omega[3],
102 const float domega_dt[3],
103 float mass);
107void SIM_mass_spring_force_gravity(struct Implicit_Data *data,
108 int index,
109 float mass,
110 const float g[3]);
114void SIM_mass_spring_force_drag(struct Implicit_Data *data, float drag);
119 struct Implicit_Data *data, int i, const float f[3], float dfdx[3][3], float dfdv[3][3]);
124 struct Implicit_Data *data, int v1, int v2, int v3, const float (*winvec)[3]);
129 struct Implicit_Data *data, int v1, int v2, int v3, const float (*forcevec)[3]);
133void SIM_mass_spring_force_edge_wind(struct Implicit_Data *data,
134 int v1,
135 int v2,
136 float radius1,
137 float radius2,
138 const float (*winvec)[3]);
142void SIM_mass_spring_force_vertex_wind(struct Implicit_Data *data,
143 int v,
144 float radius,
145 const float (*winvec)[3]);
149bool SIM_mass_spring_force_spring_linear(struct Implicit_Data *data,
150 int i,
151 int j,
152 float restlen,
153 float stiffness_tension,
154 float damping_tension,
155 float stiffness_compression,
156 float damping_compression,
157 bool resist_compress,
158 bool new_compress,
159 float clamp_force);
163bool SIM_mass_spring_force_spring_angular(struct Implicit_Data *data,
164 int i,
165 int j,
166 int *i_a,
167 int *i_b,
168 int len_a,
169 int len_b,
170 float restang,
171 float stiffness,
172 float damping);
177 struct Implicit_Data *data, int i, int j, float restlen, float kb, float cb);
181bool SIM_mass_spring_force_spring_bending_hair(struct Implicit_Data *data,
182 int i,
183 int j,
184 int k,
185 const float target[3],
186 float stiffness,
187 float damping);
191bool SIM_mass_spring_force_spring_goal(struct Implicit_Data *data,
192 int i,
193 const float goal_x[3],
194 const float goal_v[3],
195 float stiffness,
196 float damping);
197
198float SIM_tri_tetra_volume_signed_6x(struct Implicit_Data *data, int v1, int v2, int v3);
199float SIM_tri_area(struct Implicit_Data *data, int v1, int v2, int v3);
200
201void SIM_mass_spring_force_pressure(struct Implicit_Data *data,
202 int v1,
203 int v2,
204 int v3,
205 float common_pressure,
206 const float *vertex_pressure,
207 const float weights[3]);
208
209/* ======== Hair Volumetric Forces ======== */
210
211struct HairGrid;
212
213#define MAX_HAIR_GRID_RES 256
214
215struct HairGrid *SIM_hair_volume_create_vertex_grid(float cellsize,
216 const float gmin[3],
217 const float gmax[3]);
218void SIM_hair_volume_free_vertex_grid(struct HairGrid *grid);
220 struct HairGrid *grid, float *cellsize, int res[3], float gmin[3], float gmax[3]);
221
222void SIM_hair_volume_grid_clear(struct HairGrid *grid);
223void SIM_hair_volume_add_vertex(struct HairGrid *grid, const float x[3], const float v[3]);
224void SIM_hair_volume_add_segment(struct HairGrid *grid,
225 const float x1[3],
226 const float v1[3],
227 const float x2[3],
228 const float v2[3],
229 const float x3[3],
230 const float v3[3],
231 const float x4[3],
232 const float v4[3],
233 const float dir1[3],
234 const float dir2[3],
235 const float dir3[3]);
236
237void SIM_hair_volume_normalize_vertex_grid(struct HairGrid *grid);
238
239bool SIM_hair_volume_solve_divergence(struct HairGrid *grid,
240 float dt,
241 float target_density,
242 float target_strength);
243#if 0 /* XXX weighting is incorrect, disabled for now */
244void SIM_hair_volume_vertex_grid_filter_box(struct HairVertexGrid *grid, int kernel_size);
245#endif
246
247void SIM_hair_volume_grid_interpolate(struct HairGrid *grid,
248 const float x[3],
249 float *density,
250 float velocity[3],
251 float velocity_smooth[3],
252 float density_gradient[3],
253 float velocity_gradient[3][3]);
254
261 struct HairGrid *grid, const float x[3], const float v[3], float fluid_factor, float r_v[3]);
269void SIM_hair_volume_vertex_grid_forces(struct HairGrid *grid,
270 const float x[3],
271 const float v[3],
272 float smoothfac,
273 float pressurefac,
274 float minpressure,
275 float f[3],
276 float dfdx[3][3],
277 float dfdv[3][3]);
278
279} // namespace blender
#define BLI_INLINE
#define index(i)
BMesh Iterators.
void SIM_mass_spring_get_velocity(struct Implicit_Data *data, int index, float v[3])
void SIM_mass_spring_clear_forces(struct Implicit_Data *data)
bool SIM_mass_spring_force_spring_goal(struct Implicit_Data *data, int i, const float goal_x[3], const float goal_v[3], float stiffness, float damping)
void SIM_mass_spring_add_constraint_ndof1(struct Implicit_Data *data, int index, const float c1[3], const float c2[3], const float dV[3])
void SIM_mass_spring_force_edge_wind(struct Implicit_Data *data, int v1, int v2, float radius1, float radius2, const float(*winvec)[3])
void SIM_mass_spring_force_pressure(struct Implicit_Data *data, int v1, int v2, int v3, float common_pressure, const float *vertex_pressure, const float weights[3])
void SIM_mass_spring_add_constraint_ndof0(struct Implicit_Data *data, int index, const float dV[3])
BLI_INLINE void implicit_print_matrix_elem(float v)
Definition implicit.h:43
float SIM_tri_area(struct Implicit_Data *data, int v1, int v2, int v3)
void SIM_hair_volume_normalize_vertex_grid(HairGrid *grid)
void SIM_mass_spring_force_vertex_wind(struct Implicit_Data *data, int v, float radius, const float(*winvec)[3])
void SIM_hair_volume_free_vertex_grid(HairGrid *grid)
void SIM_mass_spring_set_rest_transform(struct Implicit_Data *data, int index, float tfm[3][3])
ATTR_WARN_UNUSED_RESULT const BMVert * v
void SIM_hair_volume_grid_interpolate(HairGrid *grid, const float x[3], float *density, float velocity[3], float velocity_smooth[3], float density_gradient[3], float velocity_gradient[3][3])
void SIM_mass_spring_force_gravity(struct Implicit_Data *data, int index, float mass, const float g[3])
void SIM_mass_spring_clear_constraints(struct Implicit_Data *data)
bool SIM_mass_spring_force_spring_bending_hair(struct Implicit_Data *data, int i, int j, int k, const float target[3], float stiffness, float damping)
void SIM_mass_spring_set_new_velocity(struct Implicit_Data *data, int index, const float v[3])
void SIM_mass_spring_set_vertex_mass(struct Implicit_Data *data, int index, float mass)
void SIM_hair_volume_vertex_grid_forces(HairGrid *grid, const float x[3], const float v[3], float smoothfac, float pressurefac, float minpressure, float f[3], float dfdx[3][3], float dfdv[3][3])
void SIM_mass_spring_force_extern(struct Implicit_Data *data, int i, const float f[3], float dfdx[3][3], float dfdv[3][3])
void SIM_mass_spring_set_new_position(struct Implicit_Data *data, int index, const float x[3])
BMesh const char void * data
bool SIM_mass_spring_solve_velocities(struct Implicit_Data *data, float dt, struct ImplicitSolverResult *result)
void SIM_mass_spring_get_new_velocity(struct Implicit_Data *data, int index, float v[3])
void SIM_hair_volume_grid_velocity(HairGrid *grid, const float x[3], const float v[3], float fluid_factor, float r_v[3])
void SIM_mass_spring_apply_result(struct Implicit_Data *data)
void SIM_mass_spring_force_drag(struct Implicit_Data *data, float drag)
void SIM_mass_spring_force_reference_frame(struct Implicit_Data *data, int index, const float acceleration[3], const float omega[3], const float domega_dt[3], float mass)
void SIM_hair_volume_add_vertex(HairGrid *grid, const float x[3], const float v[3])
bool SIM_mass_spring_force_spring_angular(struct Implicit_Data *data, int i, int j, int *i_a, int *i_b, int len_a, int len_b, float restang, float stiffness, float damping)
float SIM_tri_tetra_volume_signed_6x(struct Implicit_Data *data, int v1, int v2, int v3)
void SIM_mass_spring_get_motion_state(struct Implicit_Data *data, int index, float x[3], float v[3])
bool SIM_mass_spring_force_spring_bending(struct Implicit_Data *data, int i, int j, float restlen, float kb, float cb)
void SIM_hair_volume_add_segment(HairGrid *grid, const float[3], const float[3], const float x2[3], const float v2[3], const float x3[3], const float v3[3], const float[3], const float[3], const float[3], const float[3], const float[3])
HairGrid * SIM_hair_volume_create_vertex_grid(float cellsize, const float gmin[3], const float gmax[3])
void SIM_mass_spring_set_velocity(struct Implicit_Data *data, int index, const float v[3])
ATTR_WARN_UNUSED_RESULT const BMVert * v2
void SIM_hair_volume_grid_clear(HairGrid *grid)
void SIM_mass_spring_set_position(struct Implicit_Data *data, int index, const float x[3])
bool SIM_mass_spring_force_spring_linear(struct Implicit_Data *data, int i, int j, float restlen, float stiffness_tension, float damping_tension, float stiffness_compression, float damping_compression, bool resist_compress, bool new_compress, float clamp_force)
bool SIM_hair_volume_solve_divergence(HairGrid *grid, float, float target_density, float target_strength)
void SIM_mass_spring_force_face_wind(struct Implicit_Data *data, int v1, int v2, int v3, const float(*winvec)[3])
void SIM_hair_volume_grid_geometry(HairGrid *grid, float *cellsize, int res[3], float gmin[3], float gmax[3])
void SIM_mass_spring_add_constraint_ndof2(struct Implicit_Data *data, int index, const float c1[3], const float dV[3])
void SIM_mass_spring_get_position(struct Implicit_Data *data, int index, float x[3])
void SIM_mass_spring_force_face_extern(struct Implicit_Data *data, int v1, int v2, int v3, const float(*forcevec)[3])
void SIM_mass_spring_get_new_position(struct Implicit_Data *data, int index, float x[3])
void SIM_mass_spring_set_motion_state(struct Implicit_Data *data, int index, const float x[3], const float v[3])
bool SIM_mass_spring_solve_positions(struct Implicit_Data *data, float dt)