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 manual 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_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, when no Vertex Group used

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 :float array 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 :float array of 9 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 :float array of 9 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

Estimate matrix... split to COM, ROT, SCALE

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 “”

vertex_group_mass

Control point mass values

Type :string, default “”

vertex_group_spring

Control point spring strength values

Type :string, default “”

Inherited Properties

bpy_struct.id_data

Inherited Functions

bpy_struct.as_pointer bpy_struct.callback_add bpy_struct.callback_remove bpy_struct.driver_add bpy_struct.driver_remove bpy_struct.get bpy_struct.is_property_hidden bpy_struct.is_property_set

bpy_struct.items bpy_struct.keyframe_delete bpy_struct.keyframe_insert bpy_struct.keys bpy_struct.path_from_id bpy_struct.path_resolve bpy_struct.type_recast bpy_struct.values

References

Object.soft_body

SoftBodyModifier.settings