:github_url: hide .. Generated automatically by doc/tools/make_rst.py in Godot's source tree. .. DO NOT EDIT THIS FILE, but the PhysicsDirectBodyState3D.xml source instead. .. The source is found in doc/classes or modules//doc_classes. .. _class_PhysicsDirectBodyState3D: PhysicsDirectBodyState3D ======================== **Inherits:** :ref:`Object` Direct access object to a physics body in the :ref:`PhysicsServer3D`. Description ----------- Provides direct access to a physics body in the :ref:`PhysicsServer3D`, allowing safe changes to physics properties. This object is passed via the direct state callback of dynamic bodies, and is intended for changing the direct state of that body. See :ref:`RigidDynamicBody3D._integrate_forces`. Tutorials --------- - :doc:`Physics introduction <../tutorials/physics/physics_introduction>` - :doc:`Ray-casting <../tutorials/physics/ray-casting>` Properties ---------- +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`angular_velocity` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`center_of_mass` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`center_of_mass_local` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`inverse_inertia` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`inverse_mass` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`linear_velocity` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`Basis` | :ref:`principal_inertia_axes` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`sleeping` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`step` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`total_angular_damp` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`total_gravity` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`total_linear_damp` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ | :ref:`Transform3D` | :ref:`transform` | +---------------------------------------+-----------------------------------------------------------------------------------------------+ Methods ------- +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_constant_central_force` **(** :ref:`Vector3` force=Vector3(0, 0, 0) **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_constant_force` **(** :ref:`Vector3` force, :ref:`Vector3` position=Vector3(0, 0, 0) **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`add_constant_torque` **(** :ref:`Vector3` torque **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`apply_central_force` **(** :ref:`Vector3` force=Vector3(0, 0, 0) **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`apply_central_impulse` **(** :ref:`Vector3` impulse=Vector3(0, 0, 0) **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`apply_force` **(** :ref:`Vector3` force, :ref:`Vector3` position=Vector3(0, 0, 0) **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`apply_impulse` **(** :ref:`Vector3` impulse, :ref:`Vector3` position=Vector3(0, 0, 0) **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`apply_torque` **(** :ref:`Vector3` torque **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`apply_torque_impulse` **(** :ref:`Vector3` impulse **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_constant_force` **(** **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_constant_torque` **(** **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_contact_collider` **(** :ref:`int` contact_idx **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_contact_collider_id` **(** :ref:`int` contact_idx **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Object` | :ref:`get_contact_collider_object` **(** :ref:`int` contact_idx **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_contact_collider_position` **(** :ref:`int` contact_idx **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_contact_collider_shape` **(** :ref:`int` contact_idx **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_contact_collider_velocity_at_position` **(** :ref:`int` contact_idx **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_contact_count` **(** **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_contact_impulse` **(** :ref:`int` contact_idx **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_contact_local_normal` **(** :ref:`int` contact_idx **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_contact_local_position` **(** :ref:`int` contact_idx **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_contact_local_shape` **(** :ref:`int` contact_idx **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PhysicsDirectSpaceState3D` | :ref:`get_space_state` **(** **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_velocity_at_local_position` **(** :ref:`Vector3` local_position **)** |const| | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`integrate_forces` **(** **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_constant_force` **(** :ref:`Vector3` force **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | void | :ref:`set_constant_torque` **(** :ref:`Vector3` torque **)** | +-------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ Property Descriptions --------------------- .. _class_PhysicsDirectBodyState3D_property_angular_velocity: - :ref:`Vector3` **angular_velocity** +----------+-----------------------------+ | *Setter* | set_angular_velocity(value) | +----------+-----------------------------+ | *Getter* | get_angular_velocity() | +----------+-----------------------------+ The body's rotational velocity in *radians* per second. ---- .. _class_PhysicsDirectBodyState3D_property_center_of_mass: - :ref:`Vector3` **center_of_mass** +----------+----------------------+ | *Getter* | get_center_of_mass() | +----------+----------------------+ The body's center of mass position relative to the body's center in the global coordinate system. ---- .. _class_PhysicsDirectBodyState3D_property_center_of_mass_local: - :ref:`Vector3` **center_of_mass_local** +----------+----------------------------+ | *Getter* | get_center_of_mass_local() | +----------+----------------------------+ The body's center of mass position in the body's local coordinate system. ---- .. _class_PhysicsDirectBodyState3D_property_inverse_inertia: - :ref:`Vector3` **inverse_inertia** +----------+-----------------------+ | *Getter* | get_inverse_inertia() | +----------+-----------------------+ The inverse of the inertia of the body. ---- .. _class_PhysicsDirectBodyState3D_property_inverse_mass: - :ref:`float` **inverse_mass** +----------+--------------------+ | *Getter* | get_inverse_mass() | +----------+--------------------+ The inverse of the mass of the body. ---- .. _class_PhysicsDirectBodyState3D_property_linear_velocity: - :ref:`Vector3` **linear_velocity** +----------+----------------------------+ | *Setter* | set_linear_velocity(value) | +----------+----------------------------+ | *Getter* | get_linear_velocity() | +----------+----------------------------+ The body's linear velocity in units per second. ---- .. _class_PhysicsDirectBodyState3D_property_principal_inertia_axes: - :ref:`Basis` **principal_inertia_axes** +----------+------------------------------+ | *Getter* | get_principal_inertia_axes() | +----------+------------------------------+ ---- .. _class_PhysicsDirectBodyState3D_property_sleeping: - :ref:`bool` **sleeping** +----------+------------------------+ | *Setter* | set_sleep_state(value) | +----------+------------------------+ | *Getter* | is_sleeping() | +----------+------------------------+ If ``true``, this body is currently sleeping (not active). ---- .. _class_PhysicsDirectBodyState3D_property_step: - :ref:`float` **step** +----------+------------+ | *Getter* | get_step() | +----------+------------+ The timestep (delta) used for the simulation. ---- .. _class_PhysicsDirectBodyState3D_property_total_angular_damp: - :ref:`float` **total_angular_damp** +----------+--------------------------+ | *Getter* | get_total_angular_damp() | +----------+--------------------------+ The rate at which the body stops rotating, if there are not any other forces moving it. ---- .. _class_PhysicsDirectBodyState3D_property_total_gravity: - :ref:`Vector3` **total_gravity** +----------+---------------------+ | *Getter* | get_total_gravity() | +----------+---------------------+ The total gravity vector being currently applied to this body. ---- .. _class_PhysicsDirectBodyState3D_property_total_linear_damp: - :ref:`float` **total_linear_damp** +----------+-------------------------+ | *Getter* | get_total_linear_damp() | +----------+-------------------------+ The rate at which the body stops moving, if there are not any other forces moving it. ---- .. _class_PhysicsDirectBodyState3D_property_transform: - :ref:`Transform3D` **transform** +----------+----------------------+ | *Setter* | set_transform(value) | +----------+----------------------+ | *Getter* | get_transform() | +----------+----------------------+ The body's transformation matrix. Method Descriptions ------------------- .. _class_PhysicsDirectBodyState3D_method_add_constant_central_force: - void **add_constant_central_force** **(** :ref:`Vector3` force=Vector3(0, 0, 0) **)** Adds a constant directional force without affecting rotation that keeps being applied over time until cleared with ``constant_force = Vector3(0, 0, 0)``. This is equivalent to using :ref:`add_constant_force` at the body's center of mass. ---- .. _class_PhysicsDirectBodyState3D_method_add_constant_force: - void **add_constant_force** **(** :ref:`Vector3` force, :ref:`Vector3` position=Vector3(0, 0, 0) **)** Adds a constant positioned force to the body that keeps being applied over time until cleared with ``constant_force = Vector3(0, 0, 0)``. \ ``position`` is the offset from the body origin in global coordinates. ---- .. _class_PhysicsDirectBodyState3D_method_add_constant_torque: - void **add_constant_torque** **(** :ref:`Vector3` torque **)** Adds a constant rotational force without affecting position that keeps being applied over time until cleared with ``constant_torque = Vector3(0, 0, 0)``. ---- .. _class_PhysicsDirectBodyState3D_method_apply_central_force: - void **apply_central_force** **(** :ref:`Vector3` force=Vector3(0, 0, 0) **)** Applies a directional force without affecting rotation. A force is time dependent and meant to be applied every physics update. This is equivalent to using :ref:`apply_force` at the body's center of mass. ---- .. _class_PhysicsDirectBodyState3D_method_apply_central_impulse: - void **apply_central_impulse** **(** :ref:`Vector3` impulse=Vector3(0, 0, 0) **)** Applies a directional impulse without affecting rotation. An impulse is time-independent! Applying an impulse every frame would result in a framerate-dependent force. For this reason, it should only be used when simulating one-time impacts (use the "_force" functions otherwise). This is equivalent to using :ref:`apply_impulse` at the body's center of mass. ---- .. _class_PhysicsDirectBodyState3D_method_apply_force: - void **apply_force** **(** :ref:`Vector3` force, :ref:`Vector3` position=Vector3(0, 0, 0) **)** Applies a positioned force to the body. A force is time dependent and meant to be applied every physics update. \ ``position`` is the offset from the body origin in global coordinates. ---- .. _class_PhysicsDirectBodyState3D_method_apply_impulse: - void **apply_impulse** **(** :ref:`Vector3` impulse, :ref:`Vector3` position=Vector3(0, 0, 0) **)** Applies a positioned impulse to the body. An impulse is time-independent! Applying an impulse every frame would result in a framerate-dependent force. For this reason, it should only be used when simulating one-time impacts (use the "_force" functions otherwise). \ ``position`` is the offset from the body origin in global coordinates. ---- .. _class_PhysicsDirectBodyState3D_method_apply_torque: - void **apply_torque** **(** :ref:`Vector3` torque **)** Applies a rotational force without affecting position. A force is time dependent and meant to be applied every physics update. ---- .. _class_PhysicsDirectBodyState3D_method_apply_torque_impulse: - void **apply_torque_impulse** **(** :ref:`Vector3` impulse **)** Applies a rotational impulse to the body without affecting the position. An impulse is time-independent! Applying an impulse every frame would result in a framerate-dependent force. For this reason, it should only be used when simulating one-time impacts (use the "_force" functions otherwise). ---- .. _class_PhysicsDirectBodyState3D_method_get_constant_force: - :ref:`Vector3` **get_constant_force** **(** **)** |const| Returns the body's total constant positional forces applied during each physics update. See :ref:`add_constant_force` and :ref:`add_constant_central_force`. ---- .. _class_PhysicsDirectBodyState3D_method_get_constant_torque: - :ref:`Vector3` **get_constant_torque** **(** **)** |const| Returns the body's total constant rotational forces applied during each physics update. See :ref:`add_constant_torque`. ---- .. _class_PhysicsDirectBodyState3D_method_get_contact_collider: - :ref:`RID` **get_contact_collider** **(** :ref:`int` contact_idx **)** |const| Returns the collider's :ref:`RID`. ---- .. _class_PhysicsDirectBodyState3D_method_get_contact_collider_id: - :ref:`int` **get_contact_collider_id** **(** :ref:`int` contact_idx **)** |const| Returns the collider's object id. ---- .. _class_PhysicsDirectBodyState3D_method_get_contact_collider_object: - :ref:`Object` **get_contact_collider_object** **(** :ref:`int` contact_idx **)** |const| Returns the collider object. ---- .. _class_PhysicsDirectBodyState3D_method_get_contact_collider_position: - :ref:`Vector3` **get_contact_collider_position** **(** :ref:`int` contact_idx **)** |const| Returns the contact position in the collider. ---- .. _class_PhysicsDirectBodyState3D_method_get_contact_collider_shape: - :ref:`int` **get_contact_collider_shape** **(** :ref:`int` contact_idx **)** |const| Returns the collider's shape index. ---- .. _class_PhysicsDirectBodyState3D_method_get_contact_collider_velocity_at_position: - :ref:`Vector3` **get_contact_collider_velocity_at_position** **(** :ref:`int` contact_idx **)** |const| Returns the linear velocity vector at the collider's contact point. ---- .. _class_PhysicsDirectBodyState3D_method_get_contact_count: - :ref:`int` **get_contact_count** **(** **)** |const| Returns the number of contacts this body has with other bodies. \ **Note:** By default, this returns 0 unless bodies are configured to monitor contacts. See :ref:`RigidDynamicBody3D.contact_monitor`. ---- .. _class_PhysicsDirectBodyState3D_method_get_contact_impulse: - :ref:`float` **get_contact_impulse** **(** :ref:`int` contact_idx **)** |const| Impulse created by the contact. Only implemented for Bullet physics. ---- .. _class_PhysicsDirectBodyState3D_method_get_contact_local_normal: - :ref:`Vector3` **get_contact_local_normal** **(** :ref:`int` contact_idx **)** |const| Returns the local normal at the contact point. ---- .. _class_PhysicsDirectBodyState3D_method_get_contact_local_position: - :ref:`Vector3` **get_contact_local_position** **(** :ref:`int` contact_idx **)** |const| Returns the local position of the contact point. ---- .. _class_PhysicsDirectBodyState3D_method_get_contact_local_shape: - :ref:`int` **get_contact_local_shape** **(** :ref:`int` contact_idx **)** |const| Returns the local shape index of the collision. ---- .. _class_PhysicsDirectBodyState3D_method_get_space_state: - :ref:`PhysicsDirectSpaceState3D` **get_space_state** **(** **)** Returns the current state of the space, useful for queries. ---- .. _class_PhysicsDirectBodyState3D_method_get_velocity_at_local_position: - :ref:`Vector3` **get_velocity_at_local_position** **(** :ref:`Vector3` local_position **)** |const| Returns the body's velocity at the given relative position, including both translation and rotation. ---- .. _class_PhysicsDirectBodyState3D_method_integrate_forces: - void **integrate_forces** **(** **)** Calls the built-in force integration code. ---- .. _class_PhysicsDirectBodyState3D_method_set_constant_force: - void **set_constant_force** **(** :ref:`Vector3` force **)** Sets the body's total constant positional forces applied during each physics update. See :ref:`add_constant_force` and :ref:`add_constant_central_force`. ---- .. _class_PhysicsDirectBodyState3D_method_set_constant_torque: - void **set_constant_torque** **(** :ref:`Vector3` torque **)** Sets the body's total constant rotational forces applied during each physics update. See :ref:`add_constant_torque`. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)` .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)` .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)` .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)` .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)` .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`