SoftBodySettings(bpy_struct)

base class — bpy_struct

class bpy.types.SoftBodySettings(bpy_struct)

Soft body simulation settings for an object

aero

Make edges ‘sail’

Type:

int in [0, 30000], default 0

aerodynamics_type

Method of calculating aerodynamic interaction

  • SIMPLE Simple – Edges receive a drag force from surrounding media.

  • LIFT_FORCE Lift Force – Edges receive a lift force when passing through surrounding media.

Type:

enum in [‘SIMPLE’, ‘LIFT_FORCE’], default ‘SIMPLE’

ball_damp

Blending to inelastic collision

Type:

float in [0.001, 1], default 0.0

ball_size

Absolute ball size or factor if not manually adjusted

Type:

float in [-10, 10], default 0.0

ball_stiff

Ball inflating pressure

Type:

float in [0.001, 100], default 0.0

bend

Bending Stiffness

Type:

float in [0, 10], default 0.0

choke

‘Viscosity’ inside collision target

Type:

int in [0, 100], default 0

collision_collection

Limit colliders to this collection

Type:

Collection

collision_type

Choose Collision Type

  • MANUAL Manual – Manual adjust.

  • AVERAGE Average – Average Spring length * Ball Size.

  • MINIMAL Minimal – Minimal Spring length * Ball Size.

  • MAXIMAL Maximal – Maximal Spring length * Ball Size.

  • MINMAX AvMinMax – (Min+Max)/2 * Ball Size.

Type:

enum in [‘MANUAL’, ‘AVERAGE’, ‘MINIMAL’, ‘MAXIMAL’, ‘MINMAX’], default ‘MANUAL’

damping

Edge spring friction

Type:

float in [0, 50], default 0.0

effector_weights
Type:

EffectorWeights, (readonly)

error_threshold

The Runge-Kutta ODE solver error limit, low value gives more precision, high values speed

Type:

float in [0.001, 10], default 0.0

friction

General media friction for point movements

Type:

float in [0, 50], default 0.0

fuzzy

Fuzziness while on collision, high values make collision handling faster but less stable

Type:

int in [1, 100], default 0

goal_default

Default Goal (vertex target position) value

Type:

float in [0, 1], default 0.0

goal_friction

Goal (vertex target position) friction

Type:

float in [0, 50], default 0.0

goal_max

Goal maximum, vertex weights are scaled to match this range

Type:

float in [0, 1], default 0.0

goal_min

Goal minimum, vertex weights are scaled to match this range

Type:

float in [0, 1], default 0.0

goal_spring

Goal (vertex target position) spring stiffness

Type:

float in [0, 0.999], default 0.0

gravity

Apply gravitation to point movement

Type:

float in [-10, 10], default 0.0

location_mass_center

Location of center of mass

Type:

mathutils.Vector of 3 items in [-inf, inf], default (0.0, 0.0, 0.0)

mass

General Mass value

Type:

float in [0, 50000], default 0.0

plastic

Permanent deform

Type:

int in [0, 100], default 0

pull

Edge spring stiffness when longer than rest length

Type:

float in [0, 0.999], default 0.0

push

Edge spring stiffness when shorter than rest length

Type:

float in [0, 0.999], default 0.0

rotation_estimate

Estimated rotation matrix

Type:

mathutils.Matrix of 3 * 3 items in [-inf, inf], default ((0.0, 0.0, 0.0), (0.0, 0.0, 0.0), (0.0, 0.0, 0.0))

scale_estimate

Estimated scale matrix

Type:

mathutils.Matrix of 3 * 3 items in [-inf, inf], default ((0.0, 0.0, 0.0), (0.0, 0.0, 0.0), (0.0, 0.0, 0.0))

shear

Shear Stiffness

Type:

float in [0, 1], default 0.0

speed

Tweak timing for physics to control frequency and speed

Type:

float in [0.01, 100], default 0.0

spring_length

Alter spring length to shrink/blow up (unit %) 0 to disable

Type:

int in [0, 200], default 0

step_max

Maximal # solver steps/frame

Type:

int in [0, 30000], default 0

step_min

Minimal # solver steps/frame

Type:

int in [0, 30000], default 0

use_auto_step

Use velocities for automagic step sizes

Type:

boolean, default False

use_diagnose

Turn on SB diagnose console prints

Type:

boolean, default False

use_edge_collision

Edges collide too

Type:

boolean, default False

use_edges

Use Edges as springs

Type:

boolean, default False

use_estimate_matrix

Store the estimated transforms in the soft body settings

Type:

boolean, default False

use_face_collision

Faces collide too, can be very slow

Type:

boolean, default False

use_goal

Define forces for vertices to stick to animated position

Type:

boolean, default False

use_self_collision

Enable naive vertex ball self collision

Type:

boolean, default False

use_stiff_quads

Add diagonal springs on 4-gons

Type:

boolean, default False

vertex_group_goal

Control point weight values

Type:

string, default “”, (never None)

vertex_group_mass

Control point mass values

Type:

string, default “”, (never None)

vertex_group_spring

Control point spring strength values

Type:

string, default “”, (never None)

classmethod bl_rna_get_subclass(id, default=None)
Parameters:

id (str) – The RNA type identifier.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)
Parameters:

id (str) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References