Skip to content

[SIGGRAPH Asia 2026] UniMate: One Unified Model to Animate Diverse Skeletons

Python
1.9 KB
Raw Blame
#!/bin/bash
# Stage 5 — bake raw animation FBX/GLB clips onto a chosen rigged character
# (action transfer by bone name — made for Mixamo-style shared skeletons,
# where any clip can drive any compatible character without remapping).
#
# Usage:
#   bash data_process/scripts/run_animate_fbx.sh                    # Y Bot x animation_motion/
#   CHAR_PATH=dataset/raw/mixamo/character_refined/Amy.fbx \
#       bash data_process/scripts/run_animate_fbx.sh                # whole library on Amy
#   ANIM_PATH=dataset/raw/mixamo/animation_motion/Jab_Cross.fbx \
#   CHAR_PATH=dataset/raw/mixamo/character_refined/Amy.fbx \
#       bash data_process/scripts/run_animate_fbx.sh                # a single clip
#
# Env overrides:
#   CHAR_PATH       rigged character FBX/GLB (default: character_refined/Y_Bot.fbx)
#   ANIM_PATH       animation clip or directory of clips
#                   (default: dataset/raw/mixamo/animation_motion)
#   OUTPUT_DIR      destination directory (default: outputs/animated_<character stem>)
#   CHAR_ANIM_TYPE  glb|fbx (default: fbx)
#
# Extra arguments are passed through to animate_fbx.py (e.g. --overwrite).

set -euo pipefail
source "$(dirname "${BASH_SOURCE[0]}")/_common.sh"

handle_help "$@"

CHAR_PATH=${CHAR_PATH:-dataset/raw/mixamo/character_refined/Y_Bot.fbx}
if [[ ! -f "$CHAR_PATH" ]]; then
    echo "Character file not found: $CHAR_PATH" >&2
    echo "Download the mixamo raw data (run_download.sh mixamo) or set CHAR_PATH." >&2
    exit 1
fi
ANIM_PATH=${ANIM_PATH:-dataset/raw/mixamo/animation_motion}
CHAR_STEM=$(basename "${CHAR_PATH%.*}")
OUTPUT_DIR=${OUTPUT_DIR:-outputs/animated_${CHAR_STEM}}
CHAR_ANIM_TYPE=${CHAR_ANIM_TYPE:-fbx}

blender -b --python-exit-code 1 -P data_process/mesh_animation/animate_fbx.py -- \
    --char_path="$CHAR_PATH" \
    --anim_path="$ANIM_PATH" \
    --output_dir="$OUTPUT_DIR" \
    --char_anim_type="$CHAR_ANIM_TYPE" "$@"