fabrilis/docs/COORDINATES.md
loki5512344 878d144b77 Initial commit: Fabrilis docs, rules and deterministic core
Docs (architecture, decisions, coupling, determinism, UI, references), code rules enforced by tools/limits, deterministic core with units, time, math, sched, snapshot, vec and rng, plus smoke tests. ref/ stays out of git.
2026-11-16 23:06:29 +01:00

2.3 KiB
Raw Blame History

Системы координат и единицы

Мировая система

Правая, Z вверх, X вперёд, Y влево (как в робототехнике, ROS REP-103). Единицы СИ. Углы в радианах (Radians); градусы только в интерфейсе и при импорте.

Системы

Система Назначение
world неподвижная система мира
body связана с деталью; для инерции начало в центре масс
joint ось шарнира направлена вдоль локальной Z
sensor датчик, задаётся преобразованием от body
render только для рендера, получается в конце цепочки

Преобразования это Transform (кватернион и вектор, f64). Сцена хранит цепочку как граф; матрицы для рендера собираются в конце.

Вращения

Единичные кватернионы с контролем дрейфа нормы. Углы Эйлера только для ввода и вывода. Нормализация около нуля и вырожденные матрицы обрабатываются явно: ошибка, а не NaN.

Импорт: единицы и оси

Формат Единицы Оси Политика
STL не заданы не заданы проект задаёт единицы (по умолчанию мм)
OBJ не заданы не заданы проект задаёт единицы
glTF метры Y вверх, правая оси пересчитываются в Z вверх

Материалы: плотность в кг/м³, прочность в Па; в файлах материалов единицы указаны явно суффиксом и конвертируются при импорте. Единицы источника записываются в конструкцию.

Большие миры

Симуляция в f64. Для рендера и f32-компонентов начало координат переносится (origin rebasing).