Skip to content

Retarget human motion from video to an Adobe Mixamo-rigged 3D character.

Python
2.8 KB
Raw Blame
"""Single source of truth for project paths: assets, weights, outputs."""

from __future__ import annotations

import os
from datetime import datetime
from pathlib import Path

PROJECT_ROOT = Path(__file__).resolve().parents[1]

ASSETS = PROJECT_ROOT / "assets"
BODY_MODELS = ASSETS / "body_models"
SMPLX_NEUTRAL = BODY_MODELS / "smplx" / "SMPLX_NEUTRAL.npz"
MANO_DIR = BODY_MODELS / "mano"
MANO_RIGHT_PKL = MANO_DIR / "MANO_RIGHT.pkl"
MANO_RIGHT_NPZ = MANO_DIR / "MANO_RIGHT.npz"
MIXAMO_DIR = ASSETS / "mixamo"
DEFAULT_RIG = MIXAMO_DIR / "Y_Bot.fbx"
VIDEO_DIR = ASSETS / "video"
IMAGE_DIR = ASSETS / "image"

WEIGHTS = PROJECT_ROOT / "weights"
HAMER_WEIGHTS = WEIGHTS / "hamer"
HAMER_CKPT = HAMER_WEIGHTS / "hamer.ckpt"
HAMER_MEAN_PARAMS = HAMER_WEIGHTS / "mano_mean_params.npz"
OUTPUTS = PROJECT_ROOT / "outputs"

VIDEO_SUFFIXES = (".mp4", ".mov", ".avi", ".mkv", ".webm")
IMAGE_SUFFIXES = (".jpg", ".jpeg", ".png", ".webp", ".bmp")


def _list_media(folder: Path, suffixes: tuple[str, ...]) -> list[Path]:
    if not folder.is_dir():
        return []
    files = [
        p
        for p in folder.iterdir()
        if p.suffix.lower() in suffixes and not p.name.startswith(".")
    ]
    return sorted(files, key=lambda p: p.stat().st_mtime, reverse=True)


def is_image(path: Path) -> bool:
    return Path(path).suffix.lower() in IMAGE_SUFFIXES


def list_videos() -> list[Path]:
    """User-supplied videos in assets/video/, most recently added first."""
    return _list_media(VIDEO_DIR, VIDEO_SUFFIXES)


def latest_video() -> Path | None:
    """The video most recently placed into assets/video/ (by file mtime)."""
    videos = list_videos()
    return videos[0] if videos else None


def list_images() -> list[Path]:
    """User-supplied stills in assets/image/, most recently added first."""
    return _list_media(IMAGE_DIR, IMAGE_SUFFIXES)


def latest_image() -> Path | None:
    """The still most recently placed into assets/image/ (by file mtime)."""
    images = list_images()
    return images[0] if images else None


def new_run_dir(source: Path, now: datetime | None = None) -> Path:
    """Create outputs/<YYYYMMDD_HHMMSS>_<source-stem>/ for one `m2mr run`."""
    stamp = (now or datetime.now()).strftime("%Y%m%d_%H%M%S")
    run_dir = OUTPUTS / f"{stamp}_{source.stem}"
    run_dir.mkdir(parents=True, exist_ok=True)
    return run_dir


def export_gvhmr_env() -> None:
    """Point GVHMR at this project's weights/ and assets/ before importing it.

    The gvhmr package resolves its asset roots from these variables at import
    time. Auto-downloaded checkpoints land in weights/; the gated SMPL-X body
    model is read from assets/body_models/ where the user placed it.
    """
    os.environ.setdefault("GVHMR_CHECKPOINTS", str(WEIGHTS))
    os.environ.setdefault("GVHMR_BODY_MODELS", str(BODY_MODELS))