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