SeparationRayShape2D

SeparationRayShape2D is a contact-separation shape resource, not a standalone RayCast2D. The ray starts at local (0,0) and points toward (0,Length), along +Y. Length defaults to 20. The shape user’s transform sets position and direction. For ordinary world-object ray queries, use RayCast2D or a space query.

SlideOnSlope defaults to false: separation follows the ray axis. When true, the solver directs separation along the hit surface normal. A direct check against a rotated rectangle confirmed that the flag changes the contact pair. This does not establish finished character behavior on steps or slopes: that depends on the body and movement logic.

A ray fully contained inside another shape may produce no contact: the current solver discards that case. This was checked with a length-20 ray inside a 100×100 rectangle. Do not use it as a universal inside-geometry test. Ray–ray pairs also produce no ordinary contact according to source.

Length must be positive and finite; the setter does not perform those checks. Length/SlideOnSlope emit Changed only for a new value. GetRect() includes debug-drawing padding: its width is not the ray’s physical thickness.

For collider use, assign the resource to Shape on CollisionShape2D under a direct CollisionObject2D parent. The resource itself neither finds bodies nor adds them to the world.

Values, notifications, GetRect() padding, +Y direction, contact pairs and SlideOnSlope effects in a direct query were checked. Character movement, continuous collisions, editor interface and images were not tested.

Declarations checked against C# SDK 1.0.0. Expand a name to see declarations and documentation.

public SeparationRayShape2D();

public float Length { get; set; }

public bool SlideOnSlope { get; set; }

public float GetLength();

public bool GetSlideOnSlope();

public void SetLength(float length);

public void SetSlideOnSlope(bool active);