PhysicsDirectBodyState3D
繼承： Object
被繼承： PhysicsDirectBodyState3DExtension
提供對 PhysicsServer3D 中物理體的直接存取。
說明
提供對 PhysicsServer3D 中物理體的直接存取，從而安全地更改物理屬性。該對象會在 RigidBody3D 的直接狀態回呼函式中傳遞，目的是為了改變物體的直接狀態。見 RigidBody3D._integrate_forces()。
教學
屬性
方法
屬性說明
物體的旋轉速度，單位為弧度每秒。
Vector3 get_center_of_mass()
該物體質心的位置，相對於該物體的中心，使用全域坐標系。
Vector3 center_of_mass_local 🔗
Vector3 get_center_of_mass_local()
該物體質心的位置，使用該物體的局部坐標系。
The body's collision layer.
The body's collision mask.
Vector3 get_inverse_inertia()
物體慣性的倒數。
Basis inverse_inertia_tensor 🔗
Basis get_inverse_inertia_tensor()
該物體慣性張量的倒數。
float get_inverse_mass()
物體品質的倒數。
物體的線速度，單位為單位每秒。
Basis principal_inertia_axes 🔗
Basis get_principal_inertia_axes()
There is currently no description for this property. Please help us by contributing one!
如果為 true，則該物體目前處於睡眠狀態（不活動）。
float get_step()
用於模擬的時間步長（delta）。
float get_total_angular_damp()
物體停止轉動的速度，如果沒有任何其他力使它運動。
Vector3 get_total_gravity()
這個物體上的總重力向量。
float get_total_linear_damp()
物體停止運動的速率，如果沒有任何其他力使它運動。
Transform3D transform 🔗
void set_transform(value: Transform3D)
Transform3D get_transform()
物體的變換矩陣。
方法說明
void add_constant_central_force(force: Vector3 = Vector3(0, 0, 0)) 🔗
在不影響旋轉的情況下，新增一個恒定的定向力，該力會隨著時間的推移而持續施加，直到使用 constant_force = Vector3(0, 0, 0) 清除。
這相當於在物體的質心處，使用 add_constant_force()。
void add_constant_force(force: Vector3, position: Vector3 = Vector3(0, 0, 0)) 🔗
向實體新增一個恒定的定位力，持續施加，直到用 constant_force = Vector3(0, 0, 0) 清除。
position 是在全域座標中距實體原點的偏移量。
void add_constant_torque(torque: Vector3) 🔗
在不影響位置的情況下，新增一個恒定的旋轉力，該力會隨著時間的推移而持續施加，直到使用 constant_torque = Vector3(0, 0, 0) 清除。
void apply_central_force(force: Vector3 = Vector3(0, 0, 0)) 🔗
施加一個不影響旋轉的定向力。該力是時間相關的，意味著每次物理更新都會施加。
這相當於在物體的質心處，使用 apply_force()。
void apply_central_impulse(impulse: Vector3 = Vector3(0, 0, 0)) 🔗
施加一個不影響的旋轉定向脈衝。
脈衝與時間無關！每影格套用一個脈衝，會產生一個依賴於畫面播放速率的力。出於這個原因，它應該只在模擬一次性影響時使用（否則使用 “_force”函式）。
這相當於在物體的質心處，使用 apply_impulse()。
void apply_force(force: Vector3, position: Vector3 = Vector3(0, 0, 0)) 🔗
對實體施加一個定位力。力是時間相關的，意味著每次物理更新都會被施加。
position 是在全域座標中距實體原點的偏移量。
void apply_impulse(impulse: Vector3, position: Vector3 = Vector3(0, 0, 0)) 🔗
向實體施加一個定位脈衝。
脈衝是時間無關的！每影格施加一個脈衝將產生一個依賴於畫面播放速率的力。出於這個原因，它應該只在模擬一次性影響時使用（否則使用“_force”函式）。
position 是在全域座標中距實體原點的偏移量。
void apply_torque(torque: Vector3) 🔗
在不影響位置的情況下，施加一個旋轉力。該力是與時間相關的，這意味著每次物理更新時都會被施加。
注意：inverse_inertia 是該函式生效所必需的。要擁有 inverse_inertia，一個活動的 CollisionShape3D 必須是該節點的子節點，或者可以手動設定 inverse_inertia。
void apply_torque_impulse(impulse: Vector3) 🔗
在不影響位置的情況下，向實體施加一個旋轉脈衝。
脈衝是時間無關的！每影格施加一個脈衝將產生一個依賴於畫面播放速率的力。出於這個原因，它應該只在模擬一次性影響時使用（否則使用“_force”函式）。
注意：inverse_inertia 是生效所必需的。要擁有 inverse_inertia，活動的 CollisionShape3D 必須是該節點的子節點，或者可以手動設定 inverse_inertia。
Vector3 get_constant_force() const 🔗
返回在每次物理更新期間，施加在該物體上的總恒定位置力。
見 add_constant_force() 和 add_constant_central_force()。
Vector3 get_constant_torque() const 🔗
返回在每次物理更新期間，施加在該物體上的總恒定旋轉力。
RID get_contact_collider(contact_idx: int) const 🔗
返回該碰撞體的 RID。
int get_contact_collider_id(contact_idx: int) const 🔗
返回該碰撞體的對象 id。
Object get_contact_collider_object(contact_idx: int) const 🔗
返回碰撞對象。
Vector3 get_contact_collider_position(contact_idx: int) const 🔗
返回該碰撞體上接觸點的位置，使用全域坐標系。
int get_contact_collider_shape(contact_idx: int) const 🔗
返回該碰撞體的形狀索引。
Vector3 get_contact_collider_velocity_at_position(contact_idx: int) const 🔗
返回該碰撞體接觸點處的線速度向量。
int get_contact_count() const 🔗
返回這個物體與其他物體的接觸次數。
注意：預設情況下，除非物體被設為監視接觸，否則會返回 0。見 RigidBody3D.contact_monitor。
Vector3 get_contact_impulse(contact_idx: int) const 🔗
由接觸產生的脈衝。
Vector3 get_contact_local_normal(contact_idx: int) const 🔗
返回接觸點處的局部法線。
Vector3 get_contact_local_position(contact_idx: int) const 🔗
返回該物體上接觸點的位置，使用全域坐標系。
int get_contact_local_shape(contact_idx: int) const 🔗
返回碰撞的局部坐標系下的形狀索引。
Vector3 get_contact_local_velocity_at_position(contact_idx: int) const 🔗
返回該物體上接觸點處的線速度向量。
PhysicsDirectSpaceState3D get_space_state() 🔗
返回空間的目前狀態，這對查詢很有用。
Vector3 get_velocity_at_local_position(local_position: Vector3) const 🔗
返回給定相對位置的物體速度，包括平移和旋轉。
void integrate_forces() 🔗
Updates the body's linear and angular velocity by applying gravity and damping for the equivalent of one physics tick.
void set_constant_force(force: Vector3) 🔗
設定在每次物理更新期間，施加在該物體上的總恒定位置力。
見 add_constant_force() 和 add_constant_central_force()。
void set_constant_torque(torque: Vector3) 🔗
設定在每次物理更新期間，施加在該物體上的總恒定旋轉力。