Curve2D

public Curve2D();

Создаёт собственный пустой ресурс 2D-кривой, BakeInterval=5. Добавьте управляющие точки до выборки позиций. Кривая хранит локальные данные, не является автоматически движущейся Entity и не создаёт коллизии. Dispose ресурс после использования.

public float BakeInterval { get; set; }

Положительный конечный масштаб плотности CPU-кеша в локальных единицах, default 5. Меньше обычно даёт больше сэмплов и затрат памяти/CPU; это не точная аналитическая длина и не обещание одинакового шага. Подразделение ограничено глубиной. Setter сам не ограничивает положительность/конечность и помечает кеш dirty даже при том же значении.

public int PointCount { get; set; }

Количество управляющих точек, не baked-сэмплов. Рост добавляет нулевые позиции/handles и может испускать Changed для каждой точки; уменьшение отбрасывает конец. Это не атомарное назначение новой кривой. Для смены готового пути сначала подготовьте отдельный ресурс, затем назначьте Path2D.Curve.

public Reckfell.Collections.Dictionary _Data { get; set; }

Внутренний Dictionary-снимок с points:Vector2[] тройками in/out/position. Setter требует длину, кратную 3; корректный roundtrip копирует управляющие данные, не общую геометрию двух Curve2D. Это не полный внешний формат ресурса и не контейнер для непроверенного ввода. Для обычной работы используйте методы точек; собственный Dictionary wrapper Dispose после чтения.

public void AddPoint(Vector2 position, Vector2? @in = default, Vector2? @out = default, int index = -1);

Добавляет позицию и относительные ручки @in/@out. Абсолютная контрольная точка сегмента получается прибавлением ручки к позиции соответствующего конца.

public void ClearPoints();

Удаляет управляющие точки; baked-данные очищаются при следующем запросе. Сохраняет BakeInterval. GetBakedLength пустой кривой даёт 0, GetBakedPoints — пустой массив; Sample и выборку ориентации до добавления точек не вызывайте.

public float GetBakeInterval();

Читает BakeInterval. Положительный конечный масштаб плотности CPU-кеша в локальных единицах, default 5. Меньше обычно даёт больше сэмплов и затрат памяти/CPU; это не точная аналитическая длина и не обещание одинакового шага. Подразделение ограничено глубиной. Setter сам не ограничивает положительность/конечность и помечает кеш dirty даже при том же значении.

public float GetBakedLength();

Лениво пересчитывает dirty-кеш и возвращает приближённую длину его полилинии в локальных единицах. Для пустой/одноточечной кривой 0. Масштаб/поворот Path2D не включаются автоматически; это не world-длина.

public Vector2[] GetBakedPoints();

Возвращает независимый C# массив локальных baked-позиций, обновляя кеш при необходимости. Индексы массива не являются индексами управляющих точек. Изменение массива не меняет Curve2D.

public float GetClosestOffset(Vector2 toPoint);

Возвращает локальное расстояние вдоль baked-пути до ближайшей проекции toPoint, а не поперечное расстояние до кривой и не t. Для одной точки 0; для большого кеша учитывайте полный перебор сегментов.

public Vector2 GetClosestPoint(Vector2 toPoint);

Ищет ближайшую локальную проекцию на сегменты baked-полилинии перебором. Это аппроксимация, не точное решение по исходному Bezier и не физический raycast. Для world-точки сначала Path2D.ToLocal, после запроса при необходимости ToGlobal. Вырожденные сегменты отдельно не проверены.

public int GetPointCount();

Читает количество управляющих точек, не число сегментов или baked-позиций. Для N точек обычная Curve2D содержит N−1 сегментов при N≥2.

public Vector2 GetPointIn(int idx);

Читает относительный входящий handle. Абсолютная Bezier-контрольная позиция — GetPointPosition(idx)+GetPointIn(idx). У первой точки открытого пути этот handle не задаёт предыдущий сегмент.

public Vector2 GetPointOut(int idx);

Читает относительный исходящий handle. У последней точки он не создаёт дополнительный сегмент; для петли нужно явно согласовать геометрию концов.

public Vector2 GetPointPosition(int idx);

Читает локальную позицию существующей управляющей точки; не world-позицию и не baked sample. Для world-координат используйте transform соответствующего Path2D.

public void RemovePoint(int idx);

Удаляет существующий индекс, сдвигает последующие и инвалидирует кеш. Не соединяет автоматически геометрию в замкнутую петлю.

public Vector2 Sample(int idx, float t);

Выбирает точку по параметру t сегмента idx. Равные шаги t не означают равное расстояние вдоль кривой.

public Vector2 SampleBaked(float offset = 0f, bool cubic = false);

Выбирает точку по расстоянию offset в запечённом кэше. Это приближённая длина; согласуйте cubic с настройкой PathFollow2D при сравнении.

public Transform2D SampleBakedWithRotation(float offset = 0f, bool cubic = false);

Возвращает локальный Transform2D: Origin — выбранная baked-позиция, ось +X — касательная, +Y — перпендикуляр. offset — конечное расстояние с ограничением 0..length; cubic меняет интерполяцию позиций. Для ориентации нужны минимум две невырожденные точки: одна даёт диагностику. Не включает transform Path2D и не присваивает положение Entity автоматически.

public Vector2 Samplef(float fofs);

Целая часть fofs — индекс сегмента, дробная — t. Не нормализованная доля всей кривой и не число локальных единиц. За пределами диапазона возвращает крайние точки, не делает looping. Используйте корректные сегменты 0..PointCount−2 для обычной выборки.

public void SetBakeInterval(float distance);

Устанавливает BakeInterval. Положительный конечный масштаб плотности CPU-кеша в локальных единицах, default 5. Меньше обычно даёт больше сэмплов и затрат памяти/CPU; это не точная аналитическая длина и не обещание одинакового шага. Подразделение ограничено глубиной. Setter сам не ограничивает положительность/конечность и помечает кеш dirty даже при том же значении.

public void SetPointCount(int count);

Устанавливает PointCount. Количество управляющих точек, не baked-сэмплов. Рост добавляет нулевые позиции/handles и может испускать Changed для каждой точки; уменьшение отбрасывает конец. Это не атомарное назначение новой кривой. Для смены готового пути сначала подготовьте отдельный ресурс, затем назначьте Path2D.Curve.

public void SetPointIn(int idx, Vector2 position);

Задаёт относительный входящий handle существующей точки и инвалидирует кеш. Это не world-позиция и не координата соседней точки.

public void SetPointOut(int idx, Vector2 position);

Задаёт относительный исходящий handle существующей точки и инвалидирует кеш. Абсолютная контрольная позиция получается добавлением к позиции этой точки.

public void SetPointPosition(int idx, Vector2 position);

Меняет локальную позицию существующей точки, сохраняя её относительные handles. Инвалидирует кеш и испускает Changed; общий ресурс изменится для всех владельцев.

public Vector2[] Tessellate(int maxStages = 5, float toleranceDegrees = 4f);

Возвращает локальную полилинию адаптивного подразделения по угловому критерию toleranceDegrees. maxStages ограничивает глубину, не количество точек. Не меняет управляющие данные и не обещает одинаковые расстояния или точную длину.

public Vector2[] TessellateEvenLength(int maxStages = 5, float toleranceLength = 20f);

Возвращает локальную полилинию по критерию длины toleranceLength, публичный default SDK 1.0.0 — 20 локальных единиц. Не путайте с default 0.2 у Curve3D. maxStages ограничивает глубину: строго одинаковый шаг или достижение допуска не гарантируются. Требуется минимум две точки.