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.
2.3 KiB
2.3 KiB
Системы координат и единицы
Мировая система
Правая, 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).