PathFollow3D

public PathFollow3D();

Создаёт Entity3D-последователь с Loop/CubicInterp/TiltEnabled=true, RotationMode=Xyz, UseModelFront=false. Нужен прямой родитель Path3D внутри дерева с пригодной Curve3D. Меняйте Progress самостоятельно; это перемещение transform без физического collision-solving.

public bool CubicInterp { get; set; }

Кубическая интерполяция baked-кеша, default true. Это не точная Bezier-выборка и не настройка физики; на редком кеше позиция может отличаться от линейного расстояния. Setter меняет флаг без немедленного пересчёта transform. Настройте его до изменения Progress; в 3D повтор того же Progress также не обновляет transform.

public float HOffset { get; set; }

Смещение вдоль локальной X итогового кадра пути после RotationMode/UseModelFront/tilt. UseModelFront меняет знак X и направление такого смещения. Применяется до восстановления собственного Scale последователя; Path3D scale всё равно влияет на world-позицию.

public bool Loop { get; set; }

При назначении Progress повторяет расстояние по длине; false ограничивает 0..length. Ненулевое кратное длины сохраняется на конце, не обязательно на нуле. Не соединяет концы или касательные открытой геометрии и не включает движение. Само переключение флага не нормализует ранее сохранённое расстояние.

public float Progress { get; set; }

Расстояние по baked-кривой родительского Path в локальных единицах, не секунды. Для скорости обновляйте Progress на speed×delta сами; автоматического движения нет. При активном пути setter применяет Loop/clamp. Значение, заданное до входа в дерево, может остаться вне диапазона: инициализируйте после подключения Path/Curve. Масштаб родителя меняет мировую скорость.

public float ProgressRatio { get; set; }

Доля текущей baked-длины: setter передаёт ratio×length в Progress. Требуется прямой родитель Path внутри дерева, Curve и ненулевая длина. Значения вне 0..1 подчиняются Loop/clamp, а не отдельно ограничиваются. Getter без пригодного пути возвращает 0, что не доказывает достижение начала. При изменении длины сохраняется расстояние, не прежняя доля.

public PathFollow3D.RotationModeEnum RotationMode { get; set; }

Корректирует базис: None сбрасывает вращение при обновлении, Y оставляет только Euler Y, Xy убирает roll Z, Xyz оставляет все оси; вычисления используют порядок YXZ. Oriented заново строит базис по касательной с Y-up, не сохраняя входной roll. TiltEnabled применяется ПОСЛЕ коррекции и может вернуть наклон при Y/Xy. Для Oriented учитывайте предупреждение о Curve.UpVectorEnabled; вырожденные/вертикальные случаи здесь не доказаны.

public bool TiltEnabled { get; set; }

Добавляет tilt Curve3D в радианах после RotationMode и UseModelFront. Поэтому Y-only не гарантирует отсутствие roll при включённом tilt. При RotationMode=None этот этап пропускается. Не задаёт новые tilt-точки кривой.

public bool UseModelFront { get; set; }

При включённой ориентации переключает model front на +Z вместо −Z, переворачивая X/Z базиса. Также меняет направление HOffset. Не меняет геометрию Curve или длину и не действует в RotationMode=None.

public float VOffset { get; set; }

Смещение вдоль локальной Y итогового кадра пути, не обязательно world-up. При наклоне Curve оно тоже поворачивается; задавайте конечные локальные единицы.

public static Transform3D CorrectPosture(Transform3D transform, PathFollow3D.RotationModeEnum rotationMode);

Статически корректирует Basis входного Transform3D по RotationMode, сохраняя Origin. None ставит единичный Basis; Y/Xy/Xyz пересобирают из нормализованных Euler YXZ; Oriented строит Y-up по −Basis.Z. Не сэмплирует кривую, не применяет UseModelFront/tilt и не сохраняет произвольный scale входного Basis как обещанный контракт. Возвращает значение, не меняет Entity.

public bool GetCubicInterpolation();

Читает CubicInterp. Кубическая интерполяция baked-кеша, default true. Это не точная Bezier-выборка и не настройка физики; на редком кеше позиция может отличаться от линейного расстояния. Setter меняет флаг без немедленного пересчёта transform. Настройте его до изменения Progress; в 3D повтор того же Progress также не обновляет transform.

public float GetHOffset();

Читает HOffset. Смещение вдоль локальной X итогового кадра пути после RotationMode/UseModelFront/tilt. UseModelFront меняет знак X и направление такого смещения. Применяется до восстановления собственного Scale последователя; Path3D scale всё равно влияет на world-позицию.

public float GetProgress();

Читает Progress. Расстояние по baked-кривой родительского Path в локальных единицах, не секунды. Для скорости обновляйте Progress на speed×delta сами; автоматического движения нет. При активном пути setter применяет Loop/clamp. Значение, заданное до входа в дерево, может остаться вне диапазона: инициализируйте после подключения Path/Curve. Масштаб родителя меняет мировую скорость.

public float GetProgressRatio();

Читает ProgressRatio. Доля текущей baked-длины: setter передаёт ratio×length в Progress. Требуется прямой родитель Path внутри дерева, Curve и ненулевая длина. Значения вне 0..1 подчиняются Loop/clamp, а не отдельно ограничиваются. Getter без пригодного пути возвращает 0, что не доказывает достижение начала. При изменении длины сохраняется расстояние, не прежняя доля.

public PathFollow3D.RotationModeEnum GetRotationMode();

Читает RotationMode. Корректирует базис: None сбрасывает вращение при обновлении, Y оставляет только Euler Y, Xy убирает roll Z, Xyz оставляет все оси; вычисления используют порядок YXZ. Oriented заново строит базис по касательной с Y-up, не сохраняя входной roll. TiltEnabled применяется ПОСЛЕ коррекции и может вернуть наклон при Y/Xy. Для Oriented учитывайте предупреждение о Curve.UpVectorEnabled; вырожденные/вертикальные случаи здесь не доказаны.

public float GetVOffset();

Читает VOffset. Смещение вдоль локальной Y итогового кадра пути, не обязательно world-up. При наклоне Curve оно тоже поворачивается; задавайте конечные локальные единицы.

public bool HasLoop();

Читает Loop. При назначении Progress повторяет расстояние по длине; false ограничивает 0..length. Ненулевое кратное длины сохраняется на конце, не обязательно на нуле. Не соединяет концы или касательные открытой геометрии и не включает движение. Само переключение флага не нормализует ранее сохранённое расстояние.

public bool IsTiltEnabled();

Читает TiltEnabled. Добавляет tilt Curve3D в радианах после RotationMode и UseModelFront. Поэтому Y-only не гарантирует отсутствие roll при включённом tilt. При RotationMode=None этот этап пропускается. Не задаёт новые tilt-точки кривой.

public bool IsUsingModelFront();

Читает UseModelFront. При включённой ориентации переключает model front на +Z вместо −Z, переворачивая X/Z базиса. Также меняет направление HOffset. Не меняет геометрию Curve или длину и не действует в RotationMode=None.

public void SetCubicInterpolation(bool enabled);

Устанавливает CubicInterp. Кубическая интерполяция baked-кеша, default true. Это не точная Bezier-выборка и не настройка физики; на редком кеше позиция может отличаться от линейного расстояния. Setter меняет флаг без немедленного пересчёта transform. Настройте его до изменения Progress; в 3D повтор того же Progress также не обновляет transform.

public void SetHOffset(float hOffset);

Устанавливает HOffset. Смещение вдоль локальной X итогового кадра пути после RotationMode/UseModelFront/tilt. UseModelFront меняет знак X и направление такого смещения. Применяется до восстановления собственного Scale последователя; Path3D scale всё равно влияет на world-позицию.

public void SetLoop(bool loop);

Устанавливает Loop. При назначении Progress повторяет расстояние по длине; false ограничивает 0..length. Ненулевое кратное длины сохраняется на конце, не обязательно на нуле. Не соединяет концы или касательные открытой геометрии и не включает движение. Само переключение флага не нормализует ранее сохранённое расстояние.

public void SetProgress(float progress);

Задаёт конечное локальное расстояние и обновляет transform при активном Path3D. В 1.0.0 одинаковое сохранённому значение возвращается ДО нормализации: повторное присваивание не исправит Progress, заданный вне дерева, и не заставит обновиться transform. Инициализируйте после готовности пути и проверяйте границы.

public void SetProgressRatio(float ratio);

Устанавливает ProgressRatio. Доля текущей baked-длины: setter передаёт ratio×length в Progress. Требуется прямой родитель Path внутри дерева, Curve и ненулевая длина. Значения вне 0..1 подчиняются Loop/clamp, а не отдельно ограничиваются. Getter без пригодного пути возвращает 0, что не доказывает достижение начала. При изменении длины сохраняется расстояние, не прежняя доля.

public void SetRotationMode(PathFollow3D.RotationModeEnum rotationMode);

Устанавливает RotationMode. Корректирует базис: None сбрасывает вращение при обновлении, Y оставляет только Euler Y, Xy убирает roll Z, Xyz оставляет все оси; вычисления используют порядок YXZ. Oriented заново строит базис по касательной с Y-up, не сохраняя входной roll. TiltEnabled применяется ПОСЛЕ коррекции и может вернуть наклон при Y/Xy. Для Oriented учитывайте предупреждение о Curve.UpVectorEnabled; вырожденные/вертикальные случаи здесь не доказаны.

public void SetTiltEnabled(bool enabled);

Устанавливает TiltEnabled. Добавляет tilt Curve3D в радианах после RotationMode и UseModelFront. Поэтому Y-only не гарантирует отсутствие roll при включённом tilt. При RotationMode=None этот этап пропускается. Не задаёт новые tilt-точки кривой.

public void SetUseModelFront(bool enabled);

Устанавливает UseModelFront. При включённой ориентации переключает model front на +Z вместо −Z, переворачивая X/Z базиса. Также меняет направление HOffset. Не меняет геометрию Curve или длину и не действует в RotationMode=None.

public void SetVOffset(float vOffset);

Устанавливает VOffset. Смещение вдоль локальной Y итогового кадра пути, не обязательно world-up. При наклоне Curve оно тоже поворачивается; задавайте конечные локальные единицы.