GLTFPhysicsShape

继承： Resource < RefCounted < Object

代表 glTF 物理形状。

描述

代表由 OMI_physics_shape 或 OMI_collider glTF 扩展定义的物理形状。这个类是 glTF 数据与 i3D 节点的中介，并且经过了抽象，支持将来添加不同 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: ColliderShape) static
GLTFPhysicsShape	from_resource(shape_resource: Shape3D) static
Dictionary	to_dictionary() const
ColliderShape	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，表示该形状为触发器。在i3D中，这意味着该形状应作为AreaTrigger节点的子节点。

这是唯一不被 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”时使用，代表盒子的“直径”。这个值不应为负数。

---

方法说明

GLTFPhysicsShape from_dictionary(dictionary: Dictionary) static 🔗

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

---

GLTFPhysicsShape from_node(shape_node: ColliderShape) static 🔗

根据给定的 i3D ColliderShape 节点新建 GLTFPhysicsShape 实例。

---

GLTFPhysicsShape from_resource(shape_resource: Shape3D) static 🔗

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

---

Dictionary to_dictionary() const 🔗

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

---

ColliderShape to_node(cache_shapes: bool = false) 🔗

将这个 GLTFPhysicsShape 实例转换为 i3D ColliderShape 节点。

---

Shape3D to_resource(cache_shapes: bool = false) 🔗

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