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 (Н⋅мН⋅м)