SoftBody

    A soft mesh physics body.

    A deformable physics body. Used to create elastic or deformable objects such as cloth, rubber, or other flexible materials.

    Tutorials

    Methods

    voidadd_collision_exception_with ( body )
    Array ( )
    bool ( int bit ) const
    get_collision_mask_bit ( bit ) const
    voidremove_collision_exception_with ( body )
    voidset_collision_layer_bit ( bit, bool value )
    void ( int bit, value )
    • float areaAngular_stiffness
    Default0.5
    Setterset_areaAngular_stiffness(value)
    Getterget_areaAngular_stiffness()

    Default1
    Setterset_collision_layer(value)
    Getterget_collision_layer()

    The physics layers this SoftBody is in.

    Collidable objects can exist in any of 32 different layers. These layers work like a tagging system, and are not visual. A collidable can use these layers to select with which objects it can collide, using the collision_mask property.

    A contact is detected if object A is in any of the layers that object B scans, or object B is in any layer scanned by object A. See in the documentation for more information.


    • int collision_mask
    Default1
    Setterset_collision_mask(value)
    Getterget_collision_mask()

    • damping_coefficient

    Default0.0
    Setterset_drag_coefficient(value)
    Getterget_drag_coefficient()

    • linear_stiffness
    Default
    Setterset_linear_stiffness(value)
    Getterget_linear_stiffness()

    DefaultNodePath(“”)
    Setterset_parent_collision_ignore(value)
    Getterget_parent_collision_ignore()

    to a CollisionObject this SoftBody should avoid clipping.


    • pose_matching_coefficient
    Default0.0
    Setterset_pose_matching_coefficient(value)
    Getterget_pose_matching_coefficient()

    • float pressure_coefficient

    • ray_pickable
    Defaulttrue
    Setterset_ray_pickable(value)
    Getteris_ray_pickable()

    If true, the SoftBody will respond to RayCasts.


    Default5
    Setterset_simulation_precision(value)
    Getterget_simulation_precision()

    Increasing this value will improve the resulting simulation, but can affect performance. Use with care.


    • total_mass
    Default1.0
    Setterset_total_mass(value)
    Getterget_total_mass()

    The SoftBody’s mass.


    Default
    Setterset_volume_stiffness(value)
    Getterget_volume_stiffness()

    Method Descriptions

    • void add_collision_exception_with ( body )

    Adds a body to the list of bodies that this body can’t collide with.


    • Array get_collision_exceptions ( )

    • get_collision_layer_bit ( int bit ) const

    Returns an individual bit on the collision mask.


    • get_collision_mask_bit ( int bit ) const

    Returns an individual bit on the collision mask.


    • void remove_collision_exception_with ( body )

    Removes a body from the list of bodies that this body can’t collide with.


    • void set_collision_layer_bit ( int bit, value )

    Sets individual bits on the layer mask. Use this if you only need to change one layer’s value.


    Sets individual bits on the collision mask. Use this if you only need to change one layer’s value.