Документация Docs/ru/reference/model-format/animation.md

Директивы анимации моделей

Сгенерированный справочник. Не редактируйте напрямую. Обновите BuildTools/ModelFormatInterface.json, затем запустите python BuildTools/docs_model_format.py --write.

Индекс

Синтаксис

Каноническая JSON-модель

Руководство

Здесь перечислены directives .fo3d, участвующие в выборе анимации и композиции позы движения. Effective durations, materialization aliases и script lookup описаны в Model Animation.

Directive	Синтаксис	Контракт авторинга	Runtime-эффект
`Anim`	`Anim <state> <action> <ModelFile\|animation-mesh> <clip\|~clip\|Base>`	Сопоставляет state/action pair с source clip. ModelFile выбирает primary source, ~ обращает playback, Base выбирает первый clip до runtime-rig conversion.	Регистрируется первая declaration пары; model-specific lookup и substitutions описаны в ModelAnimation.md.
`AnimSpeed`	`AnimSpeed <state> <action> <positive-float>`	Задаёт authored playback speed mapped pair.	Speed умножает runtime playback и делит common effective duration.
`AllowAnimationGeometry`	`AllowAnimationGeometry <external-animation-file>`	Временно разрешает drawable geometry в точном внешнем source Anim, пока source исправляется. Path разрешается от final concrete description.	Только validation, без serialization. Duplicate, unselected, duplicate-resolved и stale exceptions останавливают bake; удалите строку с исправлением export.
`AnimLayerValue`	`AnimLayerValue <state> <action> <layer> <value>`	Переопределяет layer value при запросе точной authored state/action pair.	Override применяется до redundant-call detection и model composition.
`FastTransitionBone`	`FastTransitionBone <bone>`	Помечает base-model bone для immediate transition reset, когда новый child использует её как Link.	Следующий body-animation track сбрасывает transition state attachment bone.
`StateAnimEqual`	`StateAnimEqual <from-state> <to-state>`	Определяет одношаговый state-animation alias.	Alias применяется один раз до exact lookup и имеет приоритет над exact source-key entry.
`ActionAnimEqual`	`ActionAnimEqual <from-action> <to-action>`	Определяет одношаговый action-animation alias.	Alias применяется один раз до exact lookup и имеет приоритет над exact source-key entry.
`DisableAnimationInterpolation`	`DisableAnimationInterpolation`	Отключает keyframe interpolation model animation controller.	Registered controller выполняет sampling без interpolation.
`DisableBackwardAnim`	`DisableBackwardAnim`	Отключает выбор WalkBack и RunBack для movement-pose animation.	Movement всегда использует forward walk/run, а SetMoveDir выравнивает look direction.
`RotationBone`	`RotationBone <bone>`	Выбирает проверенную torso/body rotation bone и включает movement overlay controller.	Look/move directions могут различаться; body и настроенные head bones получают directional rotation, пока movement/turn animations идут на overlay controller.

Отделение от 2D root motion

Эти directives управляют 3D skeletal clips и model composition. Offsets NextX / NextY и выбор кадров по направлению движения принадлежат Sprite Root Motion.