ClothSettings(bpy_struct)

base class — bpy_struct

class bpy.types.ClothSettings(bpy_struct)

Cloth simulation settings for an object

air_damping

Air has normally some thickness which slows falling things down

Type:float in [0, 10], default 0.0
bending_damping

Damping of bending motion

Type:float in [0, 1000], default 0.0
bending_stiffness

Wrinkle coefficient (higher = less smaller but more big wrinkles)

Type:float in [0, 10000], default 0.0
bending_stiffness_max

Maximum bending stiffness value

Type:float in [0, 10000], default 0.0
collider_friction
Type:float in [0, 1], default 0.0
density_strength

Influence of target density on the simulation

Type:float in [0, 1], default 0.0
density_target

Maximum density of hair

Type:float in [0, 10000], default 0.0
effector_weights
Type:EffectorWeights, (readonly)
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 group weights are scaled to match this range

Type:float in [0, 1], default 0.0
goal_min

Goal minimum, vertex group 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

Gravity or external force vector

Type:float array of 3 items in [-100, 100], default (0.0, 0.0, 0.0)
internal_friction
Type:float in [0, 1], default 0.0
mass

Mass of cloth material

Type:float in [0, 10], default 0.0
pin_stiffness

Pin (vertex target position) spring stiffness

Type:float in [0, 50], default 0.0
quality

Quality of the simulation in steps per frame (higher is better quality but slower)

Type:int in [1, inf], default 0
rest_shape_key

Shape key to use the rest spring lengths from

Type:ShapeKey
sewing_force_max

Maximum sewing force

Type:float in [0, 10000], default 0.0
shrink_max

Max amount to shrink cloth by

Type:float in [0, 1], default 0.0
shrink_min

Min amount to shrink cloth by

Type:float in [0, 1], default 0.0
spring_damping

Damping of cloth velocity (higher = more smooth, less jiggling)

Type:float in [0, 50], default 0.0
structural_stiffness

Overall stiffness of structure

Type:float in [0, 10000], default 0.0
structural_stiffness_max

Maximum structural stiffness value

Type:float in [0, 10000], default 0.0
time_scale

Cloth speed is multiplied by this value

Type:float in [0, inf], default 0.0
use_dynamic_mesh

Make simulation respect deformations in the base mesh

Type:boolean, default False
use_pin_cloth

Enable pinning of cloth vertices to other objects/positions

Type:boolean, default False
use_sewing_springs

Pulls loose edges together

Type:boolean, default False
use_stiffness_scale

If enabled, stiffness can be scaled along a weight painted vertex group

Type:boolean, default False
vel_damping

Damp velocity to help cloth reach the resting position faster (1.0 = no damping, 0.0 = fully dampened)

Type:float in [0, 1], default 0.0
vertex_group_bending

Vertex group for fine control over bending stiffness

Type:string, default “”, (never None)
vertex_group_mass

Vertex Group for pinning of vertices

Type:string, default “”, (never None)
vertex_group_shrink

Vertex Group for shrinking cloth

Type:string, default “”, (never None)
vertex_group_structural_stiffness

Vertex group for fine control over structural stiffness

Type:string, default “”, (never None)
voxel_cell_size

Size of the voxel grid cells for interaction effects

Type:float in [0.0001, 10000], default 0.1

Inherited Properties

Inherited Functions

References