Property Descriptions

bool collide_with_areas = false

• void set_collide_with_areas ( bool value )
• bool is_collide_with_areas_enabled ( )

If true, collisions with Area2Ds will be reported.

bool collide_with_bodies = true

• void set_collide_with_bodies ( bool value )
• bool is_collide_with_bodies_enabled ( )

If true, collisions with PhysicsBody2Ds will be reported.

int collision_mask = 1

• void set_collision_mask ( int value )
• int get_collision_mask ( )

The shape's collision mask. Only objects in at least one collision layer enabled in the mask will be detected.

Array collision_result = []

Returns the complete collision information from the collision sweep. The data returned is the same as in the PhysicsDirectSpaceState2D.get_rest_info method.

bool enabled = true

• void set_enabled ( bool value )
• bool is_enabled ( )

If true, collisions will be reported.

bool exclude_parent = true

• void set_exclude_parent_body ( bool value )
• bool get_exclude_parent_body ( )

If true, the parent node will be excluded from collision detection.

float margin = 0.0

• void set_margin ( float value )
• float get_margin ( )

The collision margin for the shape. A larger margin helps detecting collisions more consistently, at the cost of precision.

int max_results = 32

• void set_max_results ( int value )
• int get_max_results ( )

The number of intersections can be limited with this parameter, to reduce the processing time.

Shape2D shape

• void set_shape ( Shape2D value )
• Shape2D get_shape ( )

The Shape2D-derived shape to be used for collision queries.

Vector2 target_position = Vector2(0, 50)

• void set_target_position ( Vector2 value )
• Vector2 get_target_position ( )

The shape's destination point, relative to this node's position.

Method Descriptions

void add_exception ( CollisionObject2D node )

Adds a collision exception so the shape does not report collisions with the specified CollisionObject2D node.

void add_exception_rid ( RID rid )

Adds a collision exception so the shape does not report collisions with the specified RID.

void clear_exceptions ( )

Removes all collision exceptions for this shape.

void force_shapecast_update ( )

Updates the collision information for the shape immediately, without waiting for the next _physics_process call. Use this method, for example, when the shape or its parent has changed state.

Note: enabled == true is not required for this to work.

float get_closest_collision_safe_fraction ( ) const

The fraction from the ShapeCast2D's origin to its target_position (between 0 and 1) of how far the shape can move without triggering a collision.

float get_closest_collision_unsafe_fraction ( ) const

The fraction from the ShapeCast2D's origin to its target_position (between 0 and 1) of how far the shape must move to trigger a collision.

Object get_collider ( int index ) const

Returns the collided Object of one of the multiple collisions at index, or null if no object is intersecting the shape (i.e. is_colliding returns false).

RID get_collider_rid ( int index ) const

Returns the RID of the collided object of one of the multiple collisions at index.

int get_collider_shape ( int index ) const

Returns the shape ID of the colliding shape of one of the multiple collisions at index, or 0 if no object is intersecting the shape (i.e. is_colliding returns false).

int get_collision_count ( ) const

The number of collisions detected at the point of impact. Use this to iterate over multiple collisions as provided by get_collider, get_collider_shape, get_collision_point, and get_collision_normal methods.

bool get_collision_mask_value ( int layer_number ) const

Returns whether or not the specified layer of the collision_mask is enabled, given a layer_number between 1 and 32.

Vector2 get_collision_normal ( int index ) const

Returns the normal of one of the multiple collisions at index of the intersecting object.

Vector2 get_collision_point ( int index ) const

Returns the collision point of one of the multiple collisions at index where the shape intersects the colliding object.

Note: this point is in the global coordinate system.

bool is_colliding ( ) const

Returns whether any object is intersecting with the shape's vector (considering the vector length).

void remove_exception ( CollisionObject2D node )

Removes a collision exception so the shape does report collisions with the specified CollisionObject2D node.

void remove_exception_rid ( RID rid )

Removes a collision exception so the shape does report collisions with the specified RID.

void set_collision_mask_value ( int layer_number, bool value )

Based on value, enables or disables the specified layer in the collision_mask, given a layer_number between 1 and 32.