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.

Shape2D

Inherits: Resource < RefCounted < Object

Inherited By: CapsuleShape2D, CircleShape2D, ConcavePolygonShape2D, ConvexPolygonShape2D, RectangleShape2D, SegmentShape2D, SeparationRayShape2D, WorldBoundaryShape2D

Abstract base class for 2D shapes used for physics collision.

Description

Abstract base class for all 2D shapes, intended for use in physics.

Performance: Primitive shapes, especially CircleShape2D, are fast to check collisions against. ConvexPolygonShape2D is slower, and ConcavePolygonShape2D is the slowest.

Tutorials

Properties

float

custom_solver_bias

0.0

Methods

bool

collide ( Transform2D local_xform, Shape2D with_shape, Transform2D shape_xform )

PackedVector2Array

collide_and_get_contacts ( Transform2D local_xform, Shape2D with_shape, Transform2D shape_xform )

bool

collide_with_motion ( Transform2D local_xform, Vector2 local_motion, Shape2D with_shape, Transform2D shape_xform, Vector2 shape_motion )

PackedVector2Array

collide_with_motion_and_get_contacts ( Transform2D local_xform, Vector2 local_motion, Shape2D with_shape, Transform2D shape_xform, Vector2 shape_motion )

void

draw ( RID canvas_item, Color color )

Rect2

get_rect ( ) const


Property Descriptions

float custom_solver_bias = 0.0

  • void set_custom_solver_bias ( float value )

  • float get_custom_solver_bias ( )

The shape's custom solver bias. Defines how much bodies react to enforce contact separation when this shape is involved.

When set to 0, the default value from ProjectSettings.physics/2d/solver/default_contact_bias is used.


Method Descriptions

bool collide ( Transform2D local_xform, Shape2D with_shape, Transform2D shape_xform )

Returns true if this shape is colliding with another.

This method needs the transformation matrix for this shape (local_xform), the shape to check collisions with (with_shape), and the transformation matrix of that shape (shape_xform).