5. Протокол и API для написания физических эффектов
Для создания собственного эффекта в узел эффекта или на ребро записывается JS-скрипт _StrengthJS.
5.1. Сигнатура функции плагина:
codeJavaScript
| Параметр | Тип | Описание |
| data | object | Указатель на структуру mjData MuJoCo WASM (xpos, qvel, xfrc_applied и др.). |
| model | object | Указатель на структуру mjModel MuJoCo WASM (body_mass, nbody и др.). |
| bodyId | int | Целочисленный индекс тела в MuJoCo, к которому привязан эффект. |
| params | object | Параметры эффекта: params.power, params.worldDir (вектор [x,y,z][x,y,z]), params.coneAngle и т.д. |
| nowSec | float | Текущее время симуляции в секундах. |
5.2. Главный вектор приложения сил (data.xfrc_applied):
В MuJoCo внешние силы прикладываются через массив xfrc_applied (размер 6×Nbodies6×Nbodies).
Для тела с индексом bodyId доступны 6 степеней свободы:
- xfrc_applied[bodyId * 6 + 0] — Линейная сила по оси X (Ньютоны)
- xfrc_applied[bodyId * 6 + 1] — Линейная сила по оси Y (Ньютоны, вертикаль)
- xfrc_applied[bodyId * 6 + 2] — Линейная сила по оси Z (Ньютоны)
- xfrc_applied[bodyId * 6 + 3] — Вращающий момент вокруг оси X (Н⋅мН⋅м)
- xfrc_applied[bodyId * 6 + 4] — Вращающий момент вокруг оси Y (Н⋅мН⋅м)
data.xfrc_applied[bodyId * 6 + 5] — Вращающий момент вокруг оси Z (Н⋅мН⋅м)