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

Amount of damping in bending behavior

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

Physical model for simulating bending forces

  • ANGULAR Angular, Cloth model with angular bending springs.
  • LINEAR Linear, Cloth model with linear bending springs (legacy).
Type:enum in [‘ANGULAR’, ‘LINEAR’], default ‘LINEAR’
bending_stiffness

How much the material resists bending

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
compression_damping

Amount of damping in compression behavior

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

How much the material resists compression

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

Maximum compression stiffness value

Type:float in [0, 10000], 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_compression_stiffness

How much the material resists compression

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

Maximum compression stiffness value

Type:float in [0, 10000], default 0.0
internal_friction
Type:float in [0, 1], default 0.0
internal_spring_max_diversion

How much the rays used to connect the internal points can diverge from the vertex normal

Type:float in [0, 0.785398], default 0.0
internal_spring_max_length

The maximum length an internal spring can have during creation. If the distance between internal points is greater than this, no internal spring will be created between these points. A length of zero means that there is no length limit

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

Require the points the internal springs connect to have opposite normal directions

Type:boolean, default False
internal_tension_stiffness

How much the material resists stretching

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

Maximum tension stiffness value

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

The mass of each vertex on the cloth material

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

Pin (vertex target position) spring stiffness

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

Air pressure scaling factor

Type:float in [0, 10000], default 1.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
shear_damping

Amount of damping in shearing behavior

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

How much the material resists shearing

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

Maximum shear scaling value

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

Max amount to shrink cloth by

Type:float in [-inf, 1], default 0.0
shrink_min

Factor by which to shrink cloth

Type:float in [-inf, 1], default 0.0
target_volume

The mesh volume where the inner/outer pressure will be the same. If set to zero the volume will not contribute to the total pressure

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

Amount of damping in stretching behavior

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

How much the material resists stretching

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

Maximum tension 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
uniform_pressure_force

The uniform pressure that is constantly applied to the mesh. Can be negative

Type:float in [-10000, 10000], default 0.0
use_dynamic_mesh

Make simulation respect deformations in the base mesh

Type:boolean, default False
use_internal_springs

Simulate an internal volume structure by creating springs connecting the opposite sides of the mesh

Type:boolean, default False
use_pressure

Simulate pressure inside a closed cloth mesh

Type:boolean, default False
use_pressure_volume

Use the Volume parameter as the initial volume

Type:boolean, default False
use_sewing_springs

Pulls loose edges together

Type:boolean, default False
vertex_group_bending

Vertex group for fine control over bending stiffness

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

Vertex group for fine control over the internal spring stiffness

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

Vertex Group for pinning of vertices

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

Vertex Group for where to apply pressure. Zero weight means no pressure while a weight of one means full pressure. Faces with a vertex that has zero weight will be excluded from the volume calculation

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

Vertex group for fine control over shear stiffness

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
classmethod bl_rna_get_subclass(id, default=None)
Parameters:id (string) – 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 (string) – The RNA type identifier.
Returns:The class or default when not found.
Return type:type

Inherited Properties

Inherited Functions

References