Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

SoftBody3D

继承: MeshInstance3D < GeometryInstance3D < VisualInstance3D < Node3D < Node < Object

可形变的 3D 物理网格。

描述

可形变的 3D 物理网格。用于创建弹性或可形变的对象,例如布料、橡胶或其他柔性材质。

注意:SoftBody3D 中有许多已知的问题。因此,不建议用于可能影响游戏玩法的东西上(例如蹦床)。

教程

属性

int

collision_layer

1

int

collision_mask

1

float

damping_coefficient

0.01

DisableMode

disable_mode

0

float

drag_coefficient

0.0

float

linear_stiffness

0.5

NodePath

parent_collision_ignore

NodePath("")

float

pressure_coefficient

0.0

bool

ray_pickable

true

int

simulation_precision

5

float

total_mass

1.0

方法

void

add_collision_exception_with ( Node body )

PhysicsBody3D[]

get_collision_exceptions ( )

bool

get_collision_layer_value ( int layer_number ) const

bool

get_collision_mask_value ( int layer_number ) const

RID

get_physics_rid ( ) const

Vector3

get_point_transform ( int point_index )

bool

is_point_pinned ( int point_index ) const

void

remove_collision_exception_with ( Node body )

void

set_collision_layer_value ( int layer_number, bool value )

void

set_collision_mask_value ( int layer_number, bool value )

void

set_point_pinned ( int point_index, bool pinned, NodePath attachment_path=NodePath("") )


枚举

enum DisableMode:

DisableMode DISABLE_MODE_REMOVE = 0

Node.process_mode 被设置为 Node.PROCESS_MODE_DISABLED 时,从物理仿真中移除,停止与此 SoftBody3D 的所有物理交互。

当该 Node 再次被处理时,会自动重新加入到物理仿真中。

DisableMode DISABLE_MODE_KEEP_ACTIVE = 1

Node.process_mode 被设置为 Node.PROCESS_MODE_DISABLED 时,不影响物理仿真。


属性说明

int collision_layer = 1

  • void set_collision_layer ( int value )

  • int get_collision_layer ( )

该 SoftBody3D 所在的物理层。碰撞对象可以存在于 32 个不同层中的一个或多个层中。另见 collision_mask

注意:只有当对象 B 位于对象 A 扫描的任意层中时,对象 A 才能检测到与对象 B 的接触。有关更多信息,请参阅文档中的《碰撞层与掩码》


int collision_mask = 1

  • void set_collision_mask ( int value )

  • int get_collision_mask ( )

该 SoftBody3D 扫描的物理层。碰撞对象可以扫描 32 个不同层中的一个或多个层。另见 collision_layer

注意:只有当对象 B 位于对象 A 扫描的任何层中时,对象 A 才能检测到与对象 B 的接触。有关更多信息,请参阅文档中的《碰撞层与掩码》


float damping_coefficient = 0.01

  • void set_damping_coefficient ( float value )

  • float get_damping_coefficient ( )

目前没有这个属性的描述。请帮我们贡献一个


DisableMode disable_mode = 0

Node.process_mode 被设置为 Node.PROCESS_MODE_DISABLED 时,定义物理行为。有关不同模式的更多详细信息,请参阅 DisableMode


float drag_coefficient = 0.0

  • void set_drag_coefficient ( float value )

  • float get_drag_coefficient ( )

目前没有这个属性的描述。请帮我们贡献一个


float linear_stiffness = 0.5

  • void set_linear_stiffness ( float value )

  • float get_linear_stiffness ( )

值越大得到的物体约坚硬,较低的值会提高物体的弯曲能力。取值范围为 0.01.0 之间(含端点)。


NodePath parent_collision_ignore = NodePath("")

  • void set_parent_collision_ignore ( NodePath value )

  • NodePath get_parent_collision_ignore ( )

指向 CollisionObject3DNodePath,这个 SoftBody3D 应该避免穿过它。


float pressure_coefficient = 0.0

  • void set_pressure_coefficient ( float value )

  • float get_pressure_coefficient ( )

目前没有这个属性的描述。请帮我们贡献一个


bool ray_pickable = true

  • void set_ray_pickable ( bool value )

  • bool is_ray_pickable ( )

如果为 true,则该 SoftBody3D 会响应 RayCast3D


int simulation_precision = 5

  • void set_simulation_precision ( int value )

  • int get_simulation_precision ( )

增加这个值会改善模拟结果,但会影响性能。请小心使用。


float total_mass = 1.0

  • void set_total_mass ( float value )

  • float get_total_mass ( )

该 SoftBody3D 的质量。


方法说明

void add_collision_exception_with ( Node body )

将一个物体添加到这个物体不能碰撞的物体列表中。


PhysicsBody3D[] get_collision_exceptions ( )

返回该物体的碰撞例外节点数组。


bool get_collision_layer_value ( int layer_number ) const

返回 collision_layer 中是否启用了指定的层,给定的 layer_number 应在 1 和 32 之间。


bool get_collision_mask_value ( int layer_number ) const

返回 collision_mask 中是否启用了指定的层,给定的 layer_number 应在 1 和 32 之间。


RID get_physics_rid ( ) const

目前没有这个方法的描述。请帮我们贡献一个


Vector3 get_point_transform ( int point_index )

返回表面数组中顶点的局部平移。


bool is_point_pinned ( int point_index ) const

如果顶点设置为固定,则返回 true


void remove_collision_exception_with ( Node body )

将一个物体从该物体不能碰撞的物体列表中移除。


void set_collision_layer_value ( int layer_number, bool value )

根据 value,启用或禁用 collision_layer 中指定的层,给定的 layer_number 应在 1 和 32 之间。


void set_collision_mask_value ( int layer_number, bool value )

根据 value,启用或禁用 collision_mask 中指定的层,给定的 layer_number 应在 1 和 32 之间。


void set_point_pinned ( int point_index, bool pinned, NodePath attachment_path=NodePath("") )

设置表面顶点的固定状态。当设置为 true 时,可选的 attachment_path 可以定义一个 Node3D,该固定顶点将被附加到该节点。