Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

GLTFPhysicsBody

繼承: Resource < RefCounted < Object

代表 glTF 物理體。

說明

代表物理體作為 OMI_physics_body glTF 資料和 Godot 節點之間的中介,並且它的抽象方式允許在未來新增對不同 glTF 物理擴充的支援。

教學

屬性

Vector3

angular_velocity

Vector3(0, 0, 0)

String

body_type

"rigid"

Vector3

center_of_mass

Vector3(0, 0, 0)

Vector3

inertia_diagonal

Vector3(0, 0, 0)

Quaternion

inertia_orientation

Quaternion(0, 0, 0, 1)

Basis

inertia_tensor

Basis(0, 0, 0, 0, 0, 0, 0, 0, 0)

Vector3

linear_velocity

Vector3(0, 0, 0)

float

mass

1.0

方法

GLTFPhysicsBody

from_dictionary(dictionary: Dictionary) static

GLTFPhysicsBody

from_node(body_node: CollisionObject3D) static

Dictionary

to_dictionary() const

CollisionObject3D

to_node() const


屬性說明

Vector3 angular_velocity = Vector3(0, 0, 0) 🔗

  • void set_angular_velocity(value: Vector3)

  • Vector3 get_angular_velocity()

該物理體的角速度,單位為弧度每秒。僅在物體型別為“rigid”或“vehicle”時使用。


String body_type = "rigid" 🔗

物體的型別。

匯入時,控制 Godot 應該生成哪種型別的 CollisionObject3D 節點。有效值有 "static"、"animatable"、"character"、"rigid"、"vehicle"、"trigger"。

匯出時,會合併為 "static"、"kinematic" 或 "dynamic" 運動型別,或 "trigger" 屬性。


Vector3 center_of_mass = Vector3(0, 0, 0) 🔗

  • void set_center_of_mass(value: Vector3)

  • Vector3 get_center_of_mass()

主體的質心,以米為單位。這是在相對於主體的區域空間中。預設情況下,質心是主體的原點。


Vector3 inertia_diagonal = Vector3(0, 0, 0) 🔗

  • void set_inertia_diagonal(value: Vector3)

  • Vector3 get_inertia_diagonal()

物理體的慣性強度,單位為千克平方米(kg⋅m²)。這表示繞主軸的慣性,而該軸為慣性張量矩陣的對角線。僅在物體型別為 “rigid” 或 “vehicle” 時使用。

當轉換為 Godot RigidBody3D 節點時,如果該值為零,則會自動計算慣性。


Quaternion inertia_orientation = Quaternion(0, 0, 0, 1) 🔗

物理體的慣性方向。這定義了慣性主軸相對於物件區域軸的旋轉。僅當物體型別為“剛性”或“車輛”且 inertia_diagonal 被設定為非零值時才使用。


Basis inertia_tensor = Basis(0, 0, 0, 0, 0, 0, 0, 0, 0) 🔗

  • void set_inertia_tensor(value: Basis)

  • Basis get_inertia_tensor()

已棄用: 此屬性可能在未來版本中變更或移除。

該物理體的慣性張量,單位為千克平方米(kg⋅m²)。僅在物體型別為“rigid”或“vehicle”時使用。

轉換為 Godot RigidBody3D 節點時,如果該值為零,則會自動計算慣性。


Vector3 linear_velocity = Vector3(0, 0, 0) 🔗

  • void set_linear_velocity(value: Vector3)

  • Vector3 get_linear_velocity()

該物理體的線速度,單位為米每秒。僅在物體型別為“rigid”或“vehicle”時使用。


float mass = 1.0 🔗

該物理體的質量,單位為千克。僅在物體型別為“rigid”或“vehicle”時使用。


方法說明

GLTFPhysicsBody from_dictionary(dictionary: Dictionary) static 🔗

通過解析 OMI_physics_body glTF 擴充格式中給定的 Dictionary,建立新的 GLTFPhysicsBody 實例。


GLTFPhysicsBody from_node(body_node: CollisionObject3D) static 🔗

從給定的 Godot CollisionObject3D 節點新建 GLTFPhysicsBody 實例。


Dictionary to_dictionary() const 🔗

將這個 GLTFPhysicsBody 實例序列化到 Dictionary 中。使用的是 OMI_physics_body glTF 擴充所需要的格式。


CollisionObject3D to_node() const 🔗

將這個 GLTFPhysicsBody 實例轉換為 Godot CollisionObject3D 節點。