StaticBody¶
Inherits: PhysicsBody < CollisionObject < Spatial < Node < Object
Static body for 3D physics.
Description¶
Static body for 3D physics. A static body is a simple body that is not intended to move. In contrast to RigidBody, they don’t consume any CPU resources as long as they don’t move.
Additionally, a constant linear or angular velocity can be set for the static body, so even if it doesn’t move, it affects other bodies as if it was moving (this is useful for simulating conveyor belts or conveyor wheels).
Properties¶
| float | bounce | |
| Vector3 | constant_angular_velocity | Vector3( 0, 0, 0 ) |
| Vector3 | constant_linear_velocity | Vector3( 0, 0, 0 ) |
| float | friction | |
| PhysicsMaterial | physics_material_override |
Property Descriptions¶
- float bounce
| Setter | set_bounce(value) |
| Getter | get_bounce() |
The body’s bounciness. Values range from 0 (no bounce) to 1 (full bounciness).
Deprecated, use PhysicsMaterial.bounce instead via physics_material_override.
- Vector3 constant_angular_velocity
| Default | Vector3( 0, 0, 0 ) |
| Setter | set_constant_angular_velocity(value) |
| Getter | get_constant_angular_velocity() |
The body’s constant angular velocity. This does not rotate the body, but affects other bodies that touch it, as if it was in a state of rotation.
- Vector3 constant_linear_velocity
| Default | Vector3( 0, 0, 0 ) |
| Setter | set_constant_linear_velocity(value) |
| Getter | get_constant_linear_velocity() |
The body’s constant linear velocity. This does not move the body, but affects other bodies that touch it, as if it was in a state of movement.
- float friction
| Setter | set_friction(value) |
| Getter | get_friction() |
The body’s friction, from 0 (frictionless) to 1 (full friction).
Deprecated, use PhysicsMaterial.friction instead via physics_material_override.
- PhysicsMaterial physics_material_override
| Setter | set_physics_material_override(value) |
| Getter | get_physics_material_override() |
The physics material override for the body.
If a material is assigned to this property, it will be used instead of any other physics material, such as an inherited one.