SeparationRayShape2D

SeparationRayShape2D — ресурс формы для разделения контактов, а не самостоятельный RayCast2D. Луч начинается в локальном (0,0) и направлен к (0,Length), то есть по +Y. Length по умолчанию 20. Положение и направление задаются трансформацией пользователя формы. Для обычного поиска объектов лучом используйте RayCast2D или запрос пространства.

SlideOnSlope по умолчанию false: разделение направлено вдоль луча. При true решатель направляет его по нормали найденной поверхности. В прямом тесте на наклонённом прямоугольнике флаг изменил контактную пару. Это не подтверждение готового поведения персонажа на ступенях или склонах: оно зависит от тела и логики движения.

Если луч целиком внутри другой формы, контакта может не быть: текущий решатель отбрасывает такой случай. Это проверено на луче длиной 20 внутри прямоугольника 100×100. Не используйте форму как универсальную проверку нахождения внутри геометрии. Пары луч–луч также не дают обычного контакта по исходникам.

Length должен быть положительным и конечным; setter сам не выполняет эти проверки. Length/SlideOnSlope испускают Changed только при новом значении. GetRect() содержит дополнительные поля для отладочного изображения: его ширина не равна физической толщине луча.

Для коллайдера ресурс назначается Shape у CollisionShape2D внутри непосредственного родителя CollisionObject2D. Сам ресурс не ищет тела и не добавляет их в мир.

Проверены значения, события, поля GetRect(), направление +Y, пары контактов и влияние SlideOnSlope в прямом запросе. Движение персонажа, непрерывные столкновения, интерфейс редактора и изображение не проверялись.

Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.

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);