Files
VMD-Motion-Optimizer/README.md
T
Barış Keser f8512adde5 Add VMD Motion Optimizer and supporting scripts
- Implemented `optimize_vmd.py`, a comprehensive VMD motion optimizer that includes features for position and rotation simplification, depth alignment removal, and ground stabilization.
- Introduced `peek_bytes.py`, a utility script for inspecting byte data from VMD files.
- Created `version.txt` to track the version of the VMD Motion Optimizer, initialized to 0.1.0.
2025-08-17 21:48:36 +03:00

1.8 KiB
Raw Permalink Blame History

VMD Motion Optimizer by Barış Keser (barkeser2002)

VMD Motion Optimizer, MikuMikuDance (MMD) .vmd motion dosyalarını akıllı sezgilerle optimize eden bir araçtır. Pozisyon/rotasyon anahtarlarını azaltır, derinlik hizasını kaldırır ve zemin stabilizasyonu uygular.

  • Yazar: Barış Keser (barkeser2002)
  • Lisans: GNU GPL v3.0 — bkz. LICENSE
  • Sürüm: bkz. version.txt

Logo

Özellikler

  • RDP benzeri eğri sadeleştirme (pozisyon)
  • Quaternion SLERP açısal hata sınırlı sadeleştirme (rotasyon)
  • Morph anahtar sadeleştirme
  • Depth (Z) hizasını kaldırma: kökten ölç, tüm kemiklere global çeviri uygula
  • Ground (Y) stabilizasyon: minY’ye göre global çeviri (ayak/tüm kemikler seçilebilir)
  • PyQt6 GUI, profil desteği
  • PyInstaller ile portable derleme (Windows)

Kurulum (CLI)

  1. Python 3.11/3.12 önerilir
  2. Sanal ortam ve bağımlılıklar:
    • py -3 -m venv .venv
    • .venv\\Scripts\\pip.exe install -r requirements.txt

CLI Kullanımı

python scripts/optimize_vmd.py input.vmd -o output.vmd \
  --pos-eps 0.05 --rot-eps-deg 0.5 --morph-eps 0.001 \
  --remove-depth --depth-smooth 3 --depth-scale 1.0 \
  --stabilize-ground --ground-target-y 0.0 --ground-smooth 5 --ground-scale 1.0 \
  --ground-all-bones

GUI

python scripts/app.py

Derleme

  • CMD: build_exe.bat (portable klasör dist/VMDOptimizer)
  • PowerShell: build_exe.ps1

Notlar

  • Bazı VMD’lerde başlık farklı/bozuk olabilir; okuyucu otomatik onarıma çalışır.
  • Kamera/ışık blokları şimdilik yazılmıyor (0).
  • Model adı “XR Animator” ise varsayılan olarak “Barış Keser” ile değiştirilir (CLI ile değiştirilebilir).

Kredi

  • VMD Motion Optimizer by Barış Keser (barkeser2002)
  • GPL-3.0 — bkz. LICENSE

Dil

  • Türkçe: README-tr.md
  • English: README-en.md