Blender V4.5
implicit.h File Reference
#include "BLI_compiler_compat.h"
#include <cstdio>

Go to the source code of this file.

Classes

struct  ImplicitSolverResult

Macros

#define IMPLICIT_SOLVER_BLENDER
#define CLOTH_ROOT_FRAME
#define CLOTH_FORCE_GRAVITY
#define CLOTH_FORCE_DRAG
#define CLOTH_FORCE_SPRING_STRUCTURAL
#define CLOTH_FORCE_SPRING_SHEAR
#define CLOTH_FORCE_SPRING_BEND
#define MAX_HAIR_GRID_RES   256

Functions

BLI_INLINE void implicit_print_matrix_elem (float v)
void SIM_mass_spring_set_vertex_mass (struct Implicit_Data *data, int index, float mass)
void SIM_mass_spring_set_rest_transform (struct Implicit_Data *data, int index, float tfm[3][3])
void SIM_mass_spring_set_motion_state (struct Implicit_Data *data, int index, const float x[3], const float v[3])
void SIM_mass_spring_set_position (struct Implicit_Data *data, int index, const float x[3])
void SIM_mass_spring_set_velocity (struct Implicit_Data *data, int index, const float v[3])
void SIM_mass_spring_get_motion_state (struct Implicit_Data *data, int index, float x[3], float v[3])
void SIM_mass_spring_get_position (struct Implicit_Data *data, int index, float x[3])
void SIM_mass_spring_get_velocity (struct Implicit_Data *data, int index, float v[3])
void SIM_mass_spring_get_new_position (struct Implicit_Data *data, int index, float x[3])
void SIM_mass_spring_set_new_position (struct Implicit_Data *data, int index, const float x[3])
void SIM_mass_spring_get_new_velocity (struct Implicit_Data *data, int index, float v[3])
void SIM_mass_spring_set_new_velocity (struct Implicit_Data *data, int index, const float v[3])
void SIM_mass_spring_clear_constraints (struct Implicit_Data *data)
void SIM_mass_spring_add_constraint_ndof0 (struct Implicit_Data *data, int index, const float dV[3])
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_add_constraint_ndof2 (struct Implicit_Data *data, int index, const float c1[3], const float dV[3])
bool SIM_mass_spring_solve_velocities (struct Implicit_Data *data, float dt, struct ImplicitSolverResult *result)
bool SIM_mass_spring_solve_positions (struct Implicit_Data *data, float dt)
void SIM_mass_spring_apply_result (struct Implicit_Data *data)
void SIM_mass_spring_clear_forces (struct Implicit_Data *data)
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_mass_spring_force_gravity (struct Implicit_Data *data, int index, float mass, const float g[3])
void SIM_mass_spring_force_drag (struct Implicit_Data *data, float drag)
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_force_face_wind (struct Implicit_Data *data, int v1, int v2, int v3, const float(*winvec)[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_force_edge_wind (struct Implicit_Data *data, int v1, int v2, float radius1, float radius2, const float(*winvec)[3])
void SIM_mass_spring_force_vertex_wind (struct Implicit_Data *data, int v, float radius, const float(*winvec)[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_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)
bool SIM_mass_spring_force_spring_bending (struct Implicit_Data *data, int i, int j, float restlen, float kb, float cb)
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)
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)
float SIM_tri_tetra_volume_signed_6x (struct Implicit_Data *data, int v1, int v2, int v3)
float SIM_tri_area (struct Implicit_Data *data, int v1, int v2, int v3)
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])
struct HairGridSIM_hair_volume_create_vertex_grid (float cellsize, const float gmin[3], const float gmax[3])
void SIM_hair_volume_free_vertex_grid (struct HairGrid *grid)
void SIM_hair_volume_grid_geometry (struct HairGrid *grid, float *cellsize, int res[3], float gmin[3], float gmax[3])
void SIM_hair_volume_grid_clear (struct HairGrid *grid)
void SIM_hair_volume_add_vertex (struct HairGrid *grid, const float x[3], const float v[3])
void SIM_hair_volume_add_segment (struct HairGrid *grid, const float x1[3], const float v1[3], const float x2[3], const float v2[3], const float x3[3], const float v3[3], const float x4[3], const float v4[3], const float dir1[3], const float dir2[3], const float dir3[3])
void SIM_hair_volume_normalize_vertex_grid (struct HairGrid *grid)
bool SIM_hair_volume_solve_divergence (struct HairGrid *grid, float dt, float target_density, float target_strength)
void SIM_hair_volume_grid_interpolate (struct 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_hair_volume_grid_velocity (struct HairGrid *grid, const float x[3], const float v[3], float fluid_factor, float r_v[3])
void SIM_hair_volume_vertex_grid_forces (struct 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])

Macro Definition Documentation

◆ CLOTH_FORCE_DRAG

#define CLOTH_FORCE_DRAG

Definition at line 21 of file implicit.h.

◆ CLOTH_FORCE_GRAVITY

#define CLOTH_FORCE_GRAVITY

Definition at line 20 of file implicit.h.

◆ CLOTH_FORCE_SPRING_BEND

#define CLOTH_FORCE_SPRING_BEND

Definition at line 24 of file implicit.h.

◆ CLOTH_FORCE_SPRING_SHEAR

#define CLOTH_FORCE_SPRING_SHEAR

Definition at line 23 of file implicit.h.

◆ CLOTH_FORCE_SPRING_STRUCTURAL

#define CLOTH_FORCE_SPRING_STRUCTURAL

Definition at line 22 of file implicit.h.

◆ CLOTH_ROOT_FRAME

#define CLOTH_ROOT_FRAME

Definition at line 18 of file implicit.h.

◆ IMPLICIT_SOLVER_BLENDER

#define IMPLICIT_SOLVER_BLENDER

Definition at line 16 of file implicit.h.

◆ MAX_HAIR_GRID_RES

#define MAX_HAIR_GRID_RES   256

Definition at line 211 of file implicit.h.

Referenced by SIM_hair_volume_create_vertex_grid().

Function Documentation

◆ implicit_print_matrix_elem()

BLI_INLINE void implicit_print_matrix_elem ( float v)

Definition at line 41 of file implicit.h.

References BLI_INLINE, implicit_print_matrix_elem(), printf, and v.

Referenced by implicit_print_matrix_elem(), and print_lmatrix().

◆ SIM_hair_volume_add_segment()

void SIM_hair_volume_add_segment ( struct HairGrid * grid,
const float x1[3],
const float v1[3],
const float x2[3],
const float v2[3],
const float x3[3],
const float v3[3],
const float x4[3],
const float v4[3],
const float dir1[3],
const float dir2[3],
const float dir3[3] )

◆ SIM_hair_volume_add_vertex()

◆ SIM_hair_volume_create_vertex_grid()

◆ SIM_hair_volume_free_vertex_grid()

void SIM_hair_volume_free_vertex_grid ( struct HairGrid * grid)

◆ SIM_hair_volume_grid_clear()

◆ SIM_hair_volume_grid_geometry()

void SIM_hair_volume_grid_geometry ( struct HairGrid * grid,
float * cellsize,
int res[3],
float gmin[3],
float gmax[3] )

◆ SIM_hair_volume_grid_interpolate()

void SIM_hair_volume_grid_interpolate ( struct HairGrid * grid,
const float x[3],
float * density,
float velocity[3],
float velocity_smooth[3],
float density_gradient[3],
float velocity_gradient[3][3] )

◆ SIM_hair_volume_grid_velocity()

void SIM_hair_volume_grid_velocity ( struct HairGrid * grid,
const float x[3],
const float v[3],
float fluid_factor,
float r_v[3] )

Effect of fluid simulation grid on velocities. fluid_factor controls blending between PIC (Particle-in-Cell) and FLIP (Fluid-Implicit-Particle) methods (0 = only PIC, 1 = only FLIP)

Definition at line 250 of file hair_volume.cc.

References add_v3_v3(), copy_v3_v3(), HairGrid::gmin, hair_grid_interpolate(), interp_v3_v3v3(), HairGrid::inv_cellsize, HairGrid::res, SIM_hair_volume_grid_velocity(), sub_v3_v3v3(), v, HairGrid::verts, and x.

Referenced by cloth_continuum_step(), and SIM_hair_volume_grid_velocity().

◆ SIM_hair_volume_normalize_vertex_grid()

◆ SIM_hair_volume_solve_divergence()

◆ SIM_hair_volume_vertex_grid_forces()

void SIM_hair_volume_vertex_grid_forces ( struct 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] )

WARNING: expressing grid effects on velocity as a force is not very stable, due to discontinuities in interpolated values! Better use hybrid approaches such as described in "Detail Preserving Continuum Simulation of Straight Hair" (McAdams, Selle 2009)

Definition at line 191 of file hair_volume.cc.

References HairGrid::gmin, hair_grid_interpolate(), I, HairGrid::inv_cellsize, madd_v3_v3fl(), mul_m3_fl(), mul_v3_fl(), mul_v3_v3fl(), normalize_v3(), HairGrid::res, SIM_hair_volume_vertex_grid_forces(), sub_m3_m3m3(), sub_v3_v3(), v, HairGrid::verts, x, zero_m3(), and zero_v3().

Referenced by SIM_hair_volume_vertex_grid_forces().

◆ SIM_mass_spring_add_constraint_ndof0()

void SIM_mass_spring_add_constraint_ndof0 ( struct Implicit_Data * data,
int index,
const float dV[3] )

◆ SIM_mass_spring_add_constraint_ndof1()

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] )

◆ SIM_mass_spring_add_constraint_ndof2()

void SIM_mass_spring_add_constraint_ndof2 ( struct Implicit_Data * data,
int index,
const float c1[3],
const float dV[3] )

◆ SIM_mass_spring_apply_result()

void SIM_mass_spring_apply_result ( struct Implicit_Data * data)

◆ SIM_mass_spring_clear_constraints()

void SIM_mass_spring_clear_constraints ( struct Implicit_Data * data)

◆ SIM_mass_spring_clear_forces()

void SIM_mass_spring_clear_forces ( struct Implicit_Data * data)

Clear the force vector at the beginning of the time step.

Definition at line 1328 of file implicit_blender.cc.

References data, init_bfmatrix(), SIM_mass_spring_clear_forces(), ZERO, and zero_lfvector().

Referenced by SIM_cloth_solve(), and SIM_mass_spring_clear_forces().

◆ SIM_mass_spring_force_drag()

void SIM_mass_spring_force_drag ( struct Implicit_Data * data,
float drag )

Global drag force (velocity damping).

Definition at line 1403 of file implicit_blender.cc.

References add_m3_m3m3(), copy_m3_m3(), data, I, i, madd_v3_v3fl(), mul_m3_fl(), and SIM_mass_spring_force_drag().

Referenced by cloth_calc_force(), and SIM_mass_spring_force_drag().

◆ SIM_mass_spring_force_edge_wind()

void SIM_mass_spring_force_edge_wind ( struct Implicit_Data * data,
int v1,
int v2,
float radius1,
float radius2,
const float(*) winvec[3] )

◆ SIM_mass_spring_force_extern()

void SIM_mass_spring_force_extern ( struct Implicit_Data * data,
int i,
const float f[3],
float dfdx[3][3],
float dfdv[3][3] )

Custom external force.

Definition at line 1418 of file implicit_blender.cc.

References add_m3_m3m3(), add_v3_v3(), data, i, SIM_mass_spring_force_extern(), world_to_root_m3(), and world_to_root_v3().

Referenced by SIM_mass_spring_force_extern().

◆ SIM_mass_spring_force_face_extern()

void SIM_mass_spring_force_face_extern ( struct Implicit_Data * data,
int v1,
int v2,
int v3,
const float(*) forcevec[3] )

Arbitrary per-unit-area vector force field acting on a face..

Definition at line 1488 of file implicit_blender.cc.

References add_v3_v3(), calc_nor_area_tri(), data, i, mul_v3_fl(), SIM_mass_spring_force_face_extern(), v2, world_to_root_v3(), and zero_v3().

Referenced by cloth_calc_force(), and SIM_mass_spring_force_face_extern().

◆ SIM_mass_spring_force_face_wind()

void SIM_mass_spring_force_face_wind ( struct Implicit_Data * data,
int v1,
int v2,
int v3,
const float(*) winvec[3] )

Wind force, acting on a face (only generates pressure from the normal component).

Definition at line 1445 of file implicit_blender.cc.

References calc_nor_area_tri(), data, dot_v3v3(), i, madd_v3_v3fl(), mul_v3_fl(), SIM_mass_spring_force_face_wind(), v2, and world_to_root_v3().

Referenced by cloth_calc_force(), and SIM_mass_spring_force_face_wind().

◆ SIM_mass_spring_force_gravity()

void SIM_mass_spring_force_gravity ( struct Implicit_Data * data,
int index,
float mass,
const float g[3] )

Simple uniform gravity force.

Definition at line 1393 of file implicit_blender.cc.

References add_v3_v3(), data, mul_v3_fl(), SIM_mass_spring_force_gravity(), and world_to_root_v3().

Referenced by cloth_calc_force(), and SIM_mass_spring_force_gravity().

◆ SIM_mass_spring_force_pressure()

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] )

◆ SIM_mass_spring_force_reference_frame()

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 )

◆ SIM_mass_spring_force_spring_angular()

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 )

◆ SIM_mass_spring_force_spring_bending()

bool SIM_mass_spring_force_spring_bending ( struct Implicit_Data * data,
int i,
int j,
float restlen,
float kb,
float cb )

Bending force, forming a triangle at the base of two structural springs.

Definition at line 1826 of file implicit_blender.cc.

References apply_spring(), data, fbstar(), fbstar_jacobi(), i, length(), mul_m3_fl(), mul_v3_v3fl(), outerproduct(), SIM_mass_spring_force_spring_bending(), spring_length(), and zero_m3().

Referenced by cloth_calc_spring_force(), and SIM_mass_spring_force_spring_bending().

◆ SIM_mass_spring_force_spring_bending_hair()

◆ SIM_mass_spring_force_spring_goal()

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 )

◆ SIM_mass_spring_force_spring_linear()

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 )

◆ SIM_mass_spring_force_vertex_wind()

void SIM_mass_spring_force_vertex_wind ( struct Implicit_Data * data,
int v,
float radius,
const float(*) winvec[3] )

Wind force, acting on a vertex.

Definition at line 1618 of file implicit_blender.cc.

References add_v3_v3(), data, mul_v3_v3fl(), SIM_mass_spring_force_vertex_wind(), v, and world_to_root_v3().

Referenced by cloth_calc_force(), and SIM_mass_spring_force_vertex_wind().

◆ SIM_mass_spring_get_motion_state()

void SIM_mass_spring_get_motion_state ( struct Implicit_Data * data,
int index,
float x[3],
float v[3] )

◆ SIM_mass_spring_get_new_position()

void SIM_mass_spring_get_new_position ( struct Implicit_Data * data,
int index,
float x[3] )

◆ SIM_mass_spring_get_new_velocity()

void SIM_mass_spring_get_new_velocity ( struct Implicit_Data * data,
int index,
float v[3] )

◆ SIM_mass_spring_get_position()

void SIM_mass_spring_get_position ( struct Implicit_Data * data,
int index,
float x[3] )

◆ SIM_mass_spring_get_velocity()

void SIM_mass_spring_get_velocity ( struct Implicit_Data * data,
int index,
float v[3] )

◆ SIM_mass_spring_set_motion_state()

void SIM_mass_spring_set_motion_state ( struct Implicit_Data * data,
int index,
const float x[3],
const float v[3] )

◆ SIM_mass_spring_set_new_position()

void SIM_mass_spring_set_new_position ( struct Implicit_Data * data,
int index,
const float x[3] )

◆ SIM_mass_spring_set_new_velocity()

void SIM_mass_spring_set_new_velocity ( struct Implicit_Data * data,
int index,
const float v[3] )

◆ SIM_mass_spring_set_position()

void SIM_mass_spring_set_position ( struct Implicit_Data * data,
int index,
const float x[3] )

◆ SIM_mass_spring_set_rest_transform()

void SIM_mass_spring_set_rest_transform ( struct Implicit_Data * data,
int index,
float tfm[3][3] )

◆ SIM_mass_spring_set_velocity()

void SIM_mass_spring_set_velocity ( struct Implicit_Data * data,
int index,
const float v[3] )

◆ SIM_mass_spring_set_vertex_mass()

void SIM_mass_spring_set_vertex_mass ( struct Implicit_Data * data,
int index,
float mass )

◆ SIM_mass_spring_solve_positions()

bool SIM_mass_spring_solve_positions ( struct Implicit_Data * data,
float dt )

◆ SIM_mass_spring_solve_velocities()

◆ SIM_tri_area()

float SIM_tri_area ( struct Implicit_Data * data,
int v1,
int v2,
int v3 )

Definition at line 1525 of file implicit_blender.cc.

References calc_nor_area_tri(), data, SIM_tri_area(), and v2.

Referenced by cloth_calc_average_pressure(), and SIM_tri_area().

◆ SIM_tri_tetra_volume_signed_6x()

float SIM_tri_tetra_volume_signed_6x ( struct Implicit_Data * data,
int v1,
int v2,
int v3 )