mirror of
https://github.com/barkeser2002/VMD-Motion-Optimizer.git
synced 2026-09-25 01:50:14 +03:00
Barış Keser
f8512adde5
- 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.
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
Ö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)
- Python 3.11/3.12 önerilir
- 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ördist/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