Skip to content

class_rigidbody2d

Jump to bottom
reduz edited this page Feb 23, 2014 · 13 revisions

RigidBody2D

Inherits: PhysicsBody2D\n\n### Brief Description
Rigid body 2D node.

Member Functions

Signals

Numeric Constants

  • MODE_STATIC = 1 - Static mode (does not move, can't be moved).
  • MODE_KINEMATIC = 3
  • MODE_RIGID = 0 - Rigid body, can move and rotate.
  • MODE_CHARACTER = 2 - Character body, can move but not rotate.

Description

Rigid body 2D node. This node is used for placing rigid bodies in the scene. It can contain a number of shapes, and also shift state between regular Rigid Body to Character or even Static. Character mode forbids the node from being rotated. This node can have a custom force integrator function, for writing complex physics motion behavior per node.\

As a warning, don't change this node position every frame or very often. Sporadic changes work fine, but physics runs at a different granularity (fixed hz) than usual rendering (process callback) and maybe even in a separate thread, so changing this from a process loop will yield strange behavior.

Member Function Description

== _integrate_forces ==

  • void _integrate_forces" ( Physics2DDirectBodyState state ) virtual \ Override this function to use a custom force integrator. This allows to hook up to the physics processing and alter the simulation state for the object on every frame. == set_mode ==
  • void set_mode" ( int mode ) \ Set the body mode, fromt he MODE_* enum. This allows to change to a static body or a character body. == get_mode ==
  • int get_mode" ( ) const \ Return the current body mode, see [set_mode]. == set_mass ==
  • void set_mass" ( real mass ) \ Set the body mass. == get_mass ==
  • real get_mass" ( ) const \ Return the body mass. == set_weight ==
  • void set_weight" ( real weight ) \ Set the body mass given standard earth-weight (gravity 9.8). Not really useful for 2D since most measuers for this node are in pixels. == get_weight ==
  • real get_weight" ( ) const \ Return the body mass given standard earth-weight (gravity 9.8). == set_friction ==
  • void set_friction" ( real friction ) \ Set the body friction, from 0 (friction less) to 1 (full friction). == get_friction ==
  • real get_friction" ( ) const \ Return the body friction. == set_bounce ==
  • void set_bounce" ( real bounce ) \ Set the body bounciness, from 0 (no bounce) to 1 (bounce). == get_bounce ==
  • real get_bounce" ( ) const \ Return the body bouncyness. == set_linear_velocity ==
  • void set_linear_velocity" ( Vector2 linear_velocity ) \ Set the body linear velocity. Can be used sporadically, but** DONT SET THIS IN EVERY FRAME **, because physics may be running in another thread and definitely runs at a different granularity. Use [_integrate_forces] as your process loop if you want to have precise control of the body state. == get_linear_velocity ==
  • Vector2 get_linear_velocity" ( ) const \ Return the body linear velocity. This changes by physics granularity. See [set_linear_velocity]. == set_angular_velocity ==
  • void set_angular_velocity" ( real angular_velocity ) \ Set the body angular velocity. Can be used sporadically, but** DONT SET THIS IN EVERY FRAME **, because physics may be running in another thread and definitely runs at a different granularity. Use [_integrate_forces] as your process loop if you want to have precise control of the body state. == get_angular_velocity ==
  • real get_angular_velocity" ( ) const \ Return the body angular velocity. This changes by physics granularity. See [set_angular_velocity]. == set_max_contacts_reported ==
  • void set_max_contacts_reported" ( int amount ) \ Set the maximum contacts to report. Bodies can keep a log of the contacts with other bodies, this is enabled by setting the maximum amount of contacts reported to a number greater than 0. == get_max_contacts_reported ==
  • int get_max_contacts_reported" ( ) const \ Return the maximum contacts that can be reported. See [set_max_contacts_reported]. == set_use_custom_integrator ==
  • void set_use_custom_integrator" ( bool enable ) \ Set to true if the body shall not do any internal force integration at all (like gravity or air friction). Only the [_integrate_forces] will be able to integrate them if overrided. == is_using_custom_integrator ==
  • bool is_using_custom_integrator" ( ) \ Return true if the body is not doing any built-in force integration. == set_contact_monitor ==
  • void set_contact_monitor" ( bool enabled ) \ Enable contact monitoring. (the signals to notify when a body entered/exited collision). == is_contact_monitor_enabled ==
  • bool is_contact_monitor_enabled" ( ) const \ Return wether contact monitoring is enabled. == set_use_continuous_collision_detection ==
  • void set_use_continuous_collision_detection" ( bool enable ) \ Enable continuos collision detection. This prevents very fast-moving bodies (such as bullets) to not go through objects. == is_using_continuous_collision_detection ==
  • bool is_using_continuous_collision_detection" ( ) const \ Return true if continuous collision detection is in use. == set_axis_velocity ==
  • void set_axis_velocity" ( Vector2 axis_velocity ) \ Set an axis velocity. The velocity in the given vector axis will be set as the given vector length. (This is useful for jumping behavior). == apply_impulse ==
  • void apply_impulse" ( Vector2 pos, Vector2 impulse ) \ Apply a positioned impulse (which will be affected by the body mass and shape). == set_active ==
  • void set_active" ( bool active ) \ Change the body state between sleeping/active states. As a note, static bodies can never be active. == is_active ==
  • bool is_active" ( ) const \ Return the body state. As a note, static bodies are never active. == set_can_sleep ==
  • void set_can_sleep" ( bool able_to_sleep ) \ Set the body ability to fall asleep when not moving. This saves an enormous amount of processor time when there are plenty of rigid bodies (non static) in a scene. == is_able_to_sleep ==
  • bool is_able_to_sleep" ( ) const \ Return true if the body has the ability to fall asleep when not moving. See [set_can_sleep].

Clone this wiki locally