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 1.0

bending_damping

Amount of damping in bending behavior

Type:

float in [0, 1000], default 0.5

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 ‘ANGULAR’

bending_stiffness

How much the material resists bending

Type:

float in [0, 10000], default 0.5

bending_stiffness_max

Maximum bending stiffness value

Type:

float in [0, 10000], default 0.5

collider_friction
Type:

float in [0, 1], default 0.0

compression_damping

Amount of damping in compression behavior

Type:

float in [0, 50], default 5.0

compression_stiffness

How much the material resists compression

Type:

float in [0, 10000], default 15.0

compression_stiffness_max

Maximum compression stiffness value

Type:

float in [0, 10000], default 15.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)

fluid_density

Density (kg/l) of the fluid contained inside the object, used to create a hydrostatic pressure gradient simulating the weight of the internal fluid, or buoyancy from the surrounding fluid if negative

Type:

float in [-inf, inf], default 0.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 group weights are scaled to match this range

Type:

float in [0, 1], default 1.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 1.0

gravity

Gravity or external force vector

Type:

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

internal_compression_stiffness

How much the material resists compression

Type:

float in [0, 10000], default 15.0

internal_compression_stiffness_max

Maximum compression stiffness value

Type:

float in [0, 10000], default 15.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.785398

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 True

internal_tension_stiffness

How much the material resists stretching

Type:

float in [0, 10000], default 15.0

internal_tension_stiffness_max

Maximum tension stiffness value

Type:

float in [0, 10000], default 15.0

mass

The mass of each vertex on the cloth material

Type:

float in [0, inf], default 0.3

pin_stiffness

Pin (vertex target position) spring stiffness

Type:

float in [0, 50], default 1.0

pressure_factor

Ambient pressure (kPa) that balances out between the inside and outside of the object when it has the target volume

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 5

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 5.0

shear_stiffness

How much the material resists shearing

Type:

float in [0, 10000], default 5.0

shear_stiffness_max

Maximum shear scaling value

Type:

float in [0, 10000], default 5.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 change in volume will not affect pressure.

Type:

float in [0, 10000], default 0.0

tension_damping

Amount of damping in stretching behavior

Type:

float in [0, 50], default 5.0

tension_stiffness

How much the material resists stretching

Type:

float in [0, 10000], default 15.0

tension_stiffness_max

Maximum tension stiffness value

Type:

float in [0, 10000], default 15.0

time_scale

Cloth speed is multiplied by this value

Type:

float in [0, inf], default 1.0

uniform_pressure_force

The uniform pressure that is constantly applied to the mesh, in units of Pressure Scale. 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 Target Volume parameter as the initial volume, instead of calculating it from the mesh itself

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 (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