GLTFPhysicsShape

继承： Resource < RefCounted < Object

代表 glTF 物理形状。

描述

代表由 OMI_physics_shape 或 OMI_collider glTF 扩展定义的物理形状。这个类是 glTF 数据与 Godot 节点的中介，并且经过了抽象，支持将来添加不同 glTF 物理扩展。

教程

• 运行时文件加载与保存

• OMI_physics_shape glTF 扩展

• OMI_collider glTF 扩展

属性

float	height	2.0
ImporterMesh	importer_mesh
bool	is_trigger	false
int	mesh_index	-1
float	radius	0.5
String	shape_type	""
Vector3	size	Vector3(1, 1, 1)

方法

GLTFPhysicsShape	from_dictionary(dictionary: Dictionary) static
GLTFPhysicsShape	from_node(shape_node: CollisionShape3D) static
GLTFPhysicsShape	from_resource(shape_resource: Shape3D) static
Dictionary	to_dictionary() const
CollisionShape3D	to_node(cache_shapes: bool = false)
Shape3D	to_resource(cache_shapes: bool = false)

---

属性说明

float height = 2.0 🔗

• void set_height(value: float)

• float get_height()

形状的高度，单位为米。仅在形状类型为 "capsule" 或 "cylinder" 时使用。这个值不能为负数，并且对于 "capsule" 而言应当至少是半径的两倍。

---

ImporterMesh importer_mesh 🔗

• void set_importer_mesh(value: ImporterMesh)

• ImporterMesh get_importer_mesh()

形状的 ImporterMesh 资源。仅在形状类型为 "hull"（凸包）和 "trimesh"（凹三角网格）时使用。

---

bool is_trigger = false 🔗

• void set_is_trigger(value: bool)

• bool get_is_trigger()

如果为 true，则表示这个形状是触发器。对于 Godot 而言，这意味着该形状应当是 Area3D 节点的子节点。

这是 to_node() 方法中唯一没有用到的变量，应该单独用来确定要将生成的节点添加到哪个节点之下。

---

int mesh_index = -1 🔗

• void set_mesh_index(value: int)

• int get_mesh_index()

形状网格在 glTF 文件中的索引。仅在形状类型为 "hull"（凸包）和 "trimesh"（凹三角网格）时使用。

---

float radius = 0.5 🔗

• void set_radius(value: float)

• float get_radius()

形状的半径，单位为米。仅在形状类型为 "capsule"、"cylinder" 或 "sphere" 时使用。这个值不应为负数。

---

String shape_type = "" 🔗

• void set_shape_type(value: String)

• String get_shape_type()

这个形状所代表的形状类型。有效取值有 "box"、"capsule"、"cylinder"、"sphere"、"hull"、"trimesh"。

---

Vector3 size = Vector3(1, 1, 1) 🔗

• void set_size(value: Vector3)

• Vector3 get_size()

形状的大小，单位为米。仅在碰撞体类型为 "box" 时使用，代表盒子的 "diameter"（直径）。这个值不应为负数。

---

方法说明

GLTFPhysicsShape from_dictionary(dictionary: Dictionary) static 🔗

通过解析给定的 Dictionary 新建 GLTFPhysicsShape 实例。

---

GLTFPhysicsShape from_node(shape_node: CollisionShape3D) static 🔗

根据给定的 Godot CollisionShape3D 节点新建 GLTFPhysicsShape 实例。

---

GLTFPhysicsShape from_resource(shape_resource: Shape3D) static 🔗

根据给定的 Godot Shape3D 节点新建 GLTFPhysicsShape 实例。

---

Dictionary to_dictionary() const 🔗

将该 GLTFPhysicsShape 实例序列化为 Dictionary，其格式由 OMI_physics_shape 定义。

---

CollisionShape3D to_node(cache_shapes: bool = false) 🔗

将这个 GLTFPhysicsShape 实例转换为 Godot CollisionShape3D 节点。

---

Shape3D to_resource(cache_shapes: bool = false) 🔗

将这个 GLTFPhysicsShape 实例转换为 Godot Shape3D 节点。