Skip to content

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

Python

Translate the self-intersection diagnostics into all 18 languages

MaxLiue54238848962
diff --git a/blender_extension/motion2mixamorig_blender/locales/ar.py b/blender_extension/motion2mixamorig_blender/locales/ar.py
index ff1d64d..6466b00 100644
--- a/blender_extension/motion2mixamorig_blender/locales/ar.py
+++ b/blender_extension/motion2mixamorig_blender/locales/ar.py
@@ -21,4 +21,30 @@ STRINGS = {
"dl_eta_unknown": "جارٍ قياس السرعة…",
"dl_eta_under_minute": "أقل من دقيقة متبقية",
"dl_eta_minutes": "~{minutes} دقيقة متبقية",
+ "section_diagnostics": "التشخيص",
+ "diag_summary": "{n} أزواج · الأعمق {cm} cm",
+ "diag_clean": "لا تداخل ذاتي أعمق من {cm} cm",
+ "diag_missing": "لا يوجد تشخيص لهذه النتيجة. انقر «تحديث بيئة التشغيل» ثم أعد التوليد.",
+ "diag_frame_bad": "الإطار {f} فيه تداخل:",
+ "diag_frame_ok": "الإطار {f}: لا تداخل",
+ "diag_prev": "السابق",
+ "diag_next": "التالي",
+ "diag_no_more": "لا مزيد من المشكلات في هذا الاتجاه",
+ "diag_report": "فتح تقرير HTML",
+ "diag_report_building": "جارٍ إنشاء التقرير… (نحو 15 ثانية)",
+ "diag_report_failed": "فشل إنشاء التقرير. راجع diagnose.log في مجلد الناتج.",
+ "part_head": "الرأس",
+ "part_torso": "الجذع",
+ "part_left_upper_arm": "العضد الأيسر",
+ "part_left_forearm": "الساعد الأيسر",
+ "part_left_hand": "اليد اليسرى",
+ "part_right_upper_arm": "العضد الأيمن",
+ "part_right_forearm": "الساعد الأيمن",
+ "part_right_hand": "اليد اليمنى",
+ "part_left_thigh": "الفخذ الأيسر",
+ "part_left_shin": "الساق اليسرى",
+ "part_left_foot": "القدم اليسرى",
+ "part_right_thigh": "الفخذ الأيمن",
+ "part_right_shin": "الساق اليمنى",
+ "part_right_foot": "القدم اليمنى",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/de.py b/blender_extension/motion2mixamorig_blender/locales/de.py
index d735be3..ce176ed 100644
--- a/blender_extension/motion2mixamorig_blender/locales/de.py
+++ b/blender_extension/motion2mixamorig_blender/locales/de.py
@@ -21,4 +21,30 @@ STRINGS = {
"dl_eta_unknown": "Geschwindigkeit wird gemessen…",
"dl_eta_under_minute": "weniger als 1 Min. übrig",
"dl_eta_minutes": "~{minutes} Min. übrig",
+ "section_diagnostics": "Diagnose",
+ "diag_summary": "{n} Paare · tiefste {cm} cm",
+ "diag_clean": "Keine Selbstdurchdringung tiefer als {cm} cm",
+ "diag_missing": "Keine Diagnose für dieses Ergebnis. Auf „Laufzeitumgebung aktualisieren“ klicken und neu erzeugen.",
+ "diag_frame_bad": "Frame {f} durchdringt sich:",
+ "diag_frame_ok": "Frame {f}: keine Durchdringung",
+ "diag_prev": "Zurück",
+ "diag_next": "Weiter",
+ "diag_no_more": "In dieser Richtung keine weiteren Probleme",
+ "diag_report": "HTML-Bericht öffnen",
+ "diag_report_building": "Bericht wird erstellt… (ca. 15 s)",
+ "diag_report_failed": "Bericht fehlgeschlagen. Siehe diagnose.log im Ausgabeordner.",
+ "part_head": "Kopf",
+ "part_torso": "Rumpf",
+ "part_left_upper_arm": "linker Oberarm",
+ "part_left_forearm": "linker Unterarm",
+ "part_left_hand": "linke Hand",
+ "part_right_upper_arm": "rechter Oberarm",
+ "part_right_forearm": "rechter Unterarm",
+ "part_right_hand": "rechte Hand",
+ "part_left_thigh": "linker Oberschenkel",
+ "part_left_shin": "linkes Schienbein",
+ "part_left_foot": "linker Fuß",
+ "part_right_thigh": "rechter Oberschenkel",
+ "part_right_shin": "rechtes Schienbein",
+ "part_right_foot": "rechter Fuß",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/es.py b/blender_extension/motion2mixamorig_blender/locales/es.py
index 6afa066..4881ff0 100644
--- a/blender_extension/motion2mixamorig_blender/locales/es.py
+++ b/blender_extension/motion2mixamorig_blender/locales/es.py
@@ -109,4 +109,30 @@ STRINGS = {
"dl_eta_unknown": "midiendo velocidad…",
"dl_eta_under_minute": "falta menos de 1 min",
"dl_eta_minutes": "faltan ~{minutes} min",
+ "section_diagnostics": "Diagnóstico",
+ "diag_summary": "{n} pares · máx. {cm} cm",
+ "diag_clean": "Sin autointersecciones de más de {cm} cm",
+ "diag_missing": "Este resultado no tiene diagnóstico. Haz clic en “Actualizar entorno” y vuelve a generar.",
+ "diag_frame_bad": "Frame {f} con intersecciones:",
+ "diag_frame_ok": "Frame {f}: sin intersecciones",
+ "diag_prev": "Anterior",
+ "diag_next": "Siguiente",
+ "diag_no_more": "No hay más problemas en esa dirección",
+ "diag_report": "Abrir reporte HTML",
+ "diag_report_building": "Generando reporte… (unos 15 s)",
+ "diag_report_failed": "No se pudo generar el reporte. Revisa diagnose.log en la carpeta de salida.",
+ "part_head": "cabeza",
+ "part_torso": "torso",
+ "part_left_upper_arm": "brazo izquierdo",
+ "part_left_forearm": "antebrazo izquierdo",
+ "part_left_hand": "mano izquierda",
+ "part_right_upper_arm": "brazo derecho",
+ "part_right_forearm": "antebrazo derecho",
+ "part_right_hand": "mano derecha",
+ "part_left_thigh": "muslo izquierdo",
+ "part_left_shin": "espinilla izquierda",
+ "part_left_foot": "pie izquierdo",
+ "part_right_thigh": "muslo derecho",
+ "part_right_shin": "espinilla derecha",
+ "part_right_foot": "pie derecho",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/fil.py b/blender_extension/motion2mixamorig_blender/locales/fil.py
index f2fb173..c745a66 100644
--- a/blender_extension/motion2mixamorig_blender/locales/fil.py
+++ b/blender_extension/motion2mixamorig_blender/locales/fil.py
@@ -109,4 +109,30 @@ STRINGS = {
"dl_eta_unknown": "sinusukat ang bilis…",
"dl_eta_under_minute": "wala nang 1 min",
"dl_eta_minutes": "~{minutes} min pa",
+ "section_diagnostics": "Diagnostics",
+ "diag_summary": "{n} pares · pinakamalalim {cm} cm",
+ "diag_clean": "Walang self-intersection na mas malalim sa {cm} cm",
+ "diag_missing": "Walang diagnostics ang resultang ito. I-click ang “I-update ang Runtime”, saka mag-generate ulit.",
+ "diag_frame_bad": "May intersection sa frame {f}:",
+ "diag_frame_ok": "Frame {f}: walang intersection",
+ "diag_prev": "Nauna",
+ "diag_next": "Susunod",
+ "diag_no_more": "Wala nang problema sa direksyong iyon",
+ "diag_report": "Buksan ang HTML Report",
+ "diag_report_building": "Binubuo ang report… (mga 15 s)",
+ "diag_report_failed": "Hindi nabuo ang report. Tingnan ang diagnose.log sa output folder.",
+ "part_head": "ulo",
+ "part_torso": "katawan",
+ "part_left_upper_arm": "kaliwang upper arm",
+ "part_left_forearm": "kaliwang forearm",
+ "part_left_hand": "kaliwang kamay",
+ "part_right_upper_arm": "kanang upper arm",
+ "part_right_forearm": "kanang forearm",
+ "part_right_hand": "kanang kamay",
+ "part_left_thigh": "kaliwang hita",
+ "part_left_shin": "kaliwang binti",
+ "part_left_foot": "kaliwang paa",
+ "part_right_thigh": "kanang hita",
+ "part_right_shin": "kanang binti",
+ "part_right_foot": "kanang paa",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/fr.py b/blender_extension/motion2mixamorig_blender/locales/fr.py
index 021271a..8e129a9 100644
--- a/blender_extension/motion2mixamorig_blender/locales/fr.py
+++ b/blender_extension/motion2mixamorig_blender/locales/fr.py
@@ -109,4 +109,30 @@ STRINGS = {
"dl_eta_unknown": "mesure du débit…",
"dl_eta_under_minute": "moins d’1 min restante",
"dl_eta_minutes": "~{minutes} min restantes",
+ "section_diagnostics": "Diagnostic",
+ "diag_summary": "{n} paires · max {cm} cm",
+ "diag_clean": "Aucune auto-intersection de plus de {cm} cm",
+ "diag_missing": "Aucun diagnostic pour ce résultat. Cliquez sur « Mettre à jour l’environnement », puis générez à nouveau.",
+ "diag_frame_bad": "Image {f}, intersections :",
+ "diag_frame_ok": "Image {f} : aucune intersection",
+ "diag_prev": "Précédent",
+ "diag_next": "Suivant",
+ "diag_no_more": "Plus de problème dans cette direction",
+ "diag_report": "Ouvrir le rapport HTML",
+ "diag_report_building": "Création du rapport… (environ 15 s)",
+ "diag_report_failed": "Échec du rapport. Voir diagnose.log dans le dossier de sortie.",
+ "part_head": "tête",
+ "part_torso": "torse",
+ "part_left_upper_arm": "bras gauche",
+ "part_left_forearm": "avant-bras gauche",
+ "part_left_hand": "main gauche",
+ "part_right_upper_arm": "bras droit",
+ "part_right_forearm": "avant-bras droit",
+ "part_right_hand": "main droite",
+ "part_left_thigh": "cuisse gauche",
+ "part_left_shin": "tibia gauche",
+ "part_left_foot": "pied gauche",
+ "part_right_thigh": "cuisse droite",
+ "part_right_shin": "tibia droit",
+ "part_right_foot": "pied droit",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/id.py b/blender_extension/motion2mixamorig_blender/locales/id.py
index 80c5ac1..4fdefc0 100644
--- a/blender_extension/motion2mixamorig_blender/locales/id.py
+++ b/blender_extension/motion2mixamorig_blender/locales/id.py
@@ -109,4 +109,30 @@ STRINGS = {
"dl_eta_unknown": "mengukur kecepatan…",
"dl_eta_under_minute": "kurang dari 1 menit lagi",
"dl_eta_minutes": "sekitar {minutes} menit lagi",
+ "section_diagnostics": "Diagnostik",
+ "diag_summary": "{n} pasang · terdalam {cm} cm",
+ "diag_clean": "Tidak ada self-intersection lebih dalam dari {cm} cm",
+ "diag_missing": "Hasil ini belum punya diagnostik. Klik “Perbarui Runtime”, lalu buat ulang.",
+ "diag_frame_bad": "Frame {f} saling tembus:",
+ "diag_frame_ok": "Frame {f}: tidak ada tembusan",
+ "diag_prev": "Sebelumnya",
+ "diag_next": "Berikutnya",
+ "diag_no_more": "Tidak ada masalah lagi ke arah itu",
+ "diag_report": "Buka Laporan HTML",
+ "diag_report_building": "Membuat laporan… (sekitar 15 dtk)",
+ "diag_report_failed": "Laporan gagal dibuat. Lihat diagnose.log di folder output.",
+ "part_head": "kepala",
+ "part_torso": "torso",
+ "part_left_upper_arm": "lengan atas kiri",
+ "part_left_forearm": "lengan bawah kiri",
+ "part_left_hand": "tangan kiri",
+ "part_right_upper_arm": "lengan atas kanan",
+ "part_right_forearm": "lengan bawah kanan",
+ "part_right_hand": "tangan kanan",
+ "part_left_thigh": "paha kiri",
+ "part_left_shin": "tulang kering kiri",
+ "part_left_foot": "kaki kiri",
+ "part_right_thigh": "paha kanan",
+ "part_right_shin": "tulang kering kanan",
+ "part_right_foot": "kaki kanan",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/ja.py b/blender_extension/motion2mixamorig_blender/locales/ja.py
index 115a013..ecf5d5c 100644
--- a/blender_extension/motion2mixamorig_blender/locales/ja.py
+++ b/blender_extension/motion2mixamorig_blender/locales/ja.py
@@ -21,4 +21,30 @@ STRINGS = {
"dl_eta_unknown": "速度を計測中…",
"dl_eta_under_minute": "残り 1 分未満",
"dl_eta_minutes": "残り約 {minutes} 分",
+ "section_diagnostics": "診断",
+ "diag_summary": "{n} 組 · 最深 {cm} cm",
+ "diag_clean": "{cm} cm より深いめり込みはありません",
+ "diag_missing": "この結果には診断がありません。「ランタイムを更新」を押してから、もう一度生成してください。",
+ "diag_frame_bad": "フレーム {f} でめり込み:",
+ "diag_frame_ok": "フレーム {f}:めり込みなし",
+ "diag_prev": "前へ",
+ "diag_next": "次へ",
+ "diag_no_more": "この方向にはもう問題はありません",
+ "diag_report": "HTML レポートを開く",
+ "diag_report_building": "レポートを作成中…(約 15 秒)",
+ "diag_report_failed": "レポートの作成に失敗しました。出力フォルダーの diagnose.log を確認してください。",
+ "part_head": "頭",
+ "part_torso": "胴体",
+ "part_left_upper_arm": "左上腕",
+ "part_left_forearm": "左前腕",
+ "part_left_hand": "左手",
+ "part_right_upper_arm": "右上腕",
+ "part_right_forearm": "右前腕",
+ "part_right_hand": "右手",
+ "part_left_thigh": "左太もも",
+ "part_left_shin": "左すね",
+ "part_left_foot": "左足",
+ "part_right_thigh": "右太もも",
+ "part_right_shin": "右すね",
+ "part_right_foot": "右足",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/ko.py b/blender_extension/motion2mixamorig_blender/locales/ko.py
index af527b2..127e81c 100644
--- a/blender_extension/motion2mixamorig_blender/locales/ko.py
+++ b/blender_extension/motion2mixamorig_blender/locales/ko.py
@@ -21,4 +21,30 @@ STRINGS = {
"dl_eta_unknown": "속도 측정 중…",
"dl_eta_under_minute": "1분 미만 남음",
"dl_eta_minutes": "약 {minutes}분 남음",
+ "section_diagnostics": "진단",
+ "diag_summary": "{n}쌍 · 최대 {cm} cm",
+ "diag_clean": "{cm} cm보다 깊은 파고듦 없음",
+ "diag_missing": "이 결과에는 진단이 없습니다. “런타임 업데이트”를 누른 뒤 다시 생성하세요.",
+ "diag_frame_bad": "{f} 프레임 파고듦:",
+ "diag_frame_ok": "{f} 프레임: 파고듦 없음",
+ "diag_prev": "이전",
+ "diag_next": "다음",
+ "diag_no_more": "이 방향에는 더 이상 문제가 없습니다",
+ "diag_report": "HTML 보고서 열기",
+ "diag_report_building": "보고서 만드는 중… (약 15초)",
+ "diag_report_failed": "보고서를 만들지 못했습니다. 출력 폴더의 diagnose.log를 확인하세요.",
+ "part_head": "머리",
+ "part_torso": "몸통",
+ "part_left_upper_arm": "왼쪽 위팔",
+ "part_left_forearm": "왼쪽 아래팔",
+ "part_left_hand": "왼손",
+ "part_right_upper_arm": "오른쪽 위팔",
+ "part_right_forearm": "오른쪽 아래팔",
+ "part_right_hand": "오른손",
+ "part_left_thigh": "왼쪽 허벅지",
+ "part_left_shin": "왼쪽 정강이",
+ "part_left_foot": "왼발",
+ "part_right_thigh": "오른쪽 허벅지",
+ "part_right_shin": "오른쪽 정강이",
+ "part_right_foot": "오른발",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/ne.py b/blender_extension/motion2mixamorig_blender/locales/ne.py
index 6f2ae37..e527eb0 100644
--- a/blender_extension/motion2mixamorig_blender/locales/ne.py
+++ b/blender_extension/motion2mixamorig_blender/locales/ne.py
@@ -109,4 +109,30 @@ STRINGS = {
"dl_eta_unknown": "गति नापिँदैछ…",
"dl_eta_under_minute": "1 मिनेटभन्दा कम बाँकी",
"dl_eta_minutes": "करिब {minutes} मिनेट बाँकी",
+ "section_diagnostics": "निदान",
+ "diag_summary": "{n} जोडी · सबैभन्दा गहिरो {cm} cm",
+ "diag_clean": "{cm} cm भन्दा गहिरो self-intersection छैन",
+ "diag_missing": "यो नतिजाको निदान छैन। “रनटाइम अपडेट गर्नुहोस्” थिच्नुहोस्, अनि फेरि बनाउनुहोस्।",
+ "diag_frame_bad": "frame {f} मा पसाइ:",
+ "diag_frame_ok": "frame {f}: पसाइ छैन",
+ "diag_prev": "अघिल्लो",
+ "diag_next": "अर्को",
+ "diag_no_more": "त्यस दिशामा अरू समस्या छैनन्",
+ "diag_report": "HTML रिपोर्ट खोल्नुहोस्",
+ "diag_report_building": "रिपोर्ट बनाउँदै… (करिब 15 सेकेन्ड)",
+ "diag_report_failed": "रिपोर्ट बनेन। आउटपुट फोल्डरको diagnose.log हेर्नुहोस्।",
+ "part_head": "टाउको",
+ "part_torso": "धड",
+ "part_left_upper_arm": "देब्रे माथिल्लो पाखुरा",
+ "part_left_forearm": "देब्रे तल्लो पाखुरा",
+ "part_left_hand": "देब्रे हात",
+ "part_right_upper_arm": "दाहिने माथिल्लो पाखुरा",
+ "part_right_forearm": "दाहिने तल्लो पाखुरा",
+ "part_right_hand": "दाहिने हात",
+ "part_left_thigh": "देब्रे तिघ्रा",
+ "part_left_shin": "देब्रे पिँडुला",
+ "part_left_foot": "देब्रे खुट्टा",
+ "part_right_thigh": "दाहिने तिघ्रा",
+ "part_right_shin": "दाहिने पिँडुला",
+ "part_right_foot": "दाहिने खुट्टा",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/nl.py b/blender_extension/motion2mixamorig_blender/locales/nl.py
index 46036a3..632d489 100644
--- a/blender_extension/motion2mixamorig_blender/locales/nl.py
+++ b/blender_extension/motion2mixamorig_blender/locales/nl.py
@@ -109,4 +109,30 @@ STRINGS = {
"dl_eta_unknown": "snelheid meten…",
"dl_eta_under_minute": "nog minder dan 1 min",
"dl_eta_minutes": "nog ~{minutes} min",
+ "section_diagnostics": "Diagnose",
+ "diag_summary": "{n} paren · diepste {cm} cm",
+ "diag_clean": "Geen zelfdoorsnijding dieper dan {cm} cm",
+ "diag_missing": "Geen diagnose voor dit resultaat. Klik op ‘Runtime bijwerken’ en genereer opnieuw.",
+ "diag_frame_bad": "Frame {f} doorsnijdt:",
+ "diag_frame_ok": "Frame {f}: geen doorsnijding",
+ "diag_prev": "Vorige",
+ "diag_next": "Volgende",
+ "diag_no_more": "Geen problemen meer in die richting",
+ "diag_report": "HTML-rapport openen",
+ "diag_report_building": "Rapport wordt gemaakt… (ongeveer 15 s)",
+ "diag_report_failed": "Rapport mislukt. Zie diagnose.log in de uitvoermap.",
+ "part_head": "hoofd",
+ "part_torso": "romp",
+ "part_left_upper_arm": "linkerbovenarm",
+ "part_left_forearm": "linkeronderarm",
+ "part_left_hand": "linkerhand",
+ "part_right_upper_arm": "rechterbovenarm",
+ "part_right_forearm": "rechteronderarm",
+ "part_right_hand": "rechterhand",
+ "part_left_thigh": "linkerdij",
+ "part_left_shin": "linkerscheenbeen",
+ "part_left_foot": "linkervoet",
+ "part_right_thigh": "rechterdij",
+ "part_right_shin": "rechterscheenbeen",
+ "part_right_foot": "rechtervoet",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/pl.py b/blender_extension/motion2mixamorig_blender/locales/pl.py
index 138a501..1f70f8a 100644
--- a/blender_extension/motion2mixamorig_blender/locales/pl.py
+++ b/blender_extension/motion2mixamorig_blender/locales/pl.py
@@ -109,4 +109,30 @@ STRINGS = {
"dl_eta_unknown": "mierzenie prędkości…",
"dl_eta_under_minute": "zostało mniej niż 1 min",
"dl_eta_minutes": "zostało ok. {minutes} min",
+ "section_diagnostics": "Diagnostyka",
+ "diag_summary": "{n} par · najgłębiej {cm} cm",
+ "diag_clean": "Brak samoprzenikania głębszego niż {cm} cm",
+ "diag_missing": "Brak diagnostyki dla tego wyniku. Kliknij „Zaktualizuj środowisko”, a potem wygeneruj ponownie.",
+ "diag_frame_bad": "Klatka {f} – przenikanie:",
+ "diag_frame_ok": "Klatka {f}: brak przenikania",
+ "diag_prev": "Poprzedni",
+ "diag_next": "Następny",
+ "diag_no_more": "Brak kolejnych problemów w tym kierunku",
+ "diag_report": "Otwórz raport HTML",
+ "diag_report_building": "Tworzenie raportu… (ok. 15 s)",
+ "diag_report_failed": "Nie udało się utworzyć raportu. Zobacz diagnose.log w folderze wyjściowym.",
+ "part_head": "głowa",
+ "part_torso": "tułów",
+ "part_left_upper_arm": "lewe ramię",
+ "part_left_forearm": "lewe przedramię",
+ "part_left_hand": "lewa dłoń",
+ "part_right_upper_arm": "prawe ramię",
+ "part_right_forearm": "prawe przedramię",
+ "part_right_hand": "prawa dłoń",
+ "part_left_thigh": "lewe udo",
+ "part_left_shin": "lewa goleń",
+ "part_left_foot": "lewa stopa",
+ "part_right_thigh": "prawe udo",
+ "part_right_shin": "prawa goleń",
+ "part_right_foot": "prawa stopa",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/ru.py b/blender_extension/motion2mixamorig_blender/locales/ru.py
index 87a296f..76e1896 100644
--- a/blender_extension/motion2mixamorig_blender/locales/ru.py
+++ b/blender_extension/motion2mixamorig_blender/locales/ru.py
@@ -21,4 +21,30 @@ STRINGS = {
"dl_eta_unknown": "измерение скорости…",
"dl_eta_under_minute": "осталось меньше 1 мин",
"dl_eta_minutes": "осталось ~{minutes} мин",
+ "section_diagnostics": "Диагностика",
+ "diag_summary": "{n} пар · глубже всего {cm} см",
+ "diag_clean": "Нет самопересечений глубже {cm} см",
+ "diag_missing": "Для этого результата нет диагностики. Нажмите «Обновить среду» и сгенерируйте заново.",
+ "diag_frame_bad": "Кадр {f}, пересечения:",
+ "diag_frame_ok": "Кадр {f}: пересечений нет",
+ "diag_prev": "Назад",
+ "diag_next": "Вперёд",
+ "diag_no_more": "В этом направлении проблем больше нет",
+ "diag_report": "Открыть HTML-отчёт",
+ "diag_report_building": "Создаётся отчёт… (около 15 с)",
+ "diag_report_failed": "Не удалось создать отчёт. См. diagnose.log в папке результатов.",
+ "part_head": "голова",
+ "part_torso": "торс",
+ "part_left_upper_arm": "левое плечо",
+ "part_left_forearm": "левое предплечье",
+ "part_left_hand": "левая кисть",
+ "part_right_upper_arm": "правое плечо",
+ "part_right_forearm": "правое предплечье",
+ "part_right_hand": "правая кисть",
+ "part_left_thigh": "левое бедро",
+ "part_left_shin": "левая голень",
+ "part_left_foot": "левая стопа",
+ "part_right_thigh": "правое бедро",
+ "part_right_shin": "правая голень",
+ "part_right_foot": "правая стопа",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/th.py b/blender_extension/motion2mixamorig_blender/locales/th.py
index 0ec4b27..e0cbf86 100644
--- a/blender_extension/motion2mixamorig_blender/locales/th.py
+++ b/blender_extension/motion2mixamorig_blender/locales/th.py
@@ -109,4 +109,30 @@ STRINGS = {
"dl_eta_unknown": "กำลังวัดความเร็ว…",
"dl_eta_under_minute": "เหลือไม่ถึง 1 นาที",
"dl_eta_minutes": "เหลือประมาณ {minutes} นาที",
+ "section_diagnostics": "การวินิจฉัย",
+ "diag_summary": "{n} คู่ · ลึกสุด {cm} cm",
+ "diag_clean": "ไม่มีการทะลุกันเองที่ลึกกว่า {cm} cm",
+ "diag_missing": "ผลลัพธ์นี้ยังไม่มีการวินิจฉัย กด “อัปเดตรันไทม์” แล้วสร้างใหม่อีกครั้ง",
+ "diag_frame_bad": "เฟรม {f} มีการทะลุ:",
+ "diag_frame_ok": "เฟรม {f}: ไม่มีการทะลุ",
+ "diag_prev": "ก่อนหน้า",
+ "diag_next": "ถัดไป",
+ "diag_no_more": "ไม่มีปัญหาเพิ่มเติมในทิศทางนี้",
+ "diag_report": "เปิดรายงาน HTML",
+ "diag_report_building": "กำลังสร้างรายงาน… (ประมาณ 15 วินาที)",
+ "diag_report_failed": "สร้างรายงานไม่สำเร็จ ดู diagnose.log ในโฟลเดอร์ผลลัพธ์",
+ "part_head": "หัว",
+ "part_torso": "ลำตัว",
+ "part_left_upper_arm": "ต้นแขนซ้าย",
+ "part_left_forearm": "ปลายแขนซ้าย",
+ "part_left_hand": "มือซ้าย",
+ "part_right_upper_arm": "ต้นแขนขวา",
+ "part_right_forearm": "ปลายแขนขวา",
+ "part_right_hand": "มือขวา",
+ "part_left_thigh": "ต้นขาซ้าย",
+ "part_left_shin": "หน้าแข้งซ้าย",
+ "part_left_foot": "เท้าซ้าย",
+ "part_right_thigh": "ต้นขาขวา",
+ "part_right_shin": "หน้าแข้งขวา",
+ "part_right_foot": "เท้าขวา",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/tr.py b/blender_extension/motion2mixamorig_blender/locales/tr.py
index a6be543..cdc9ce0 100644
--- a/blender_extension/motion2mixamorig_blender/locales/tr.py
+++ b/blender_extension/motion2mixamorig_blender/locales/tr.py
@@ -109,4 +109,30 @@ STRINGS = {
"dl_eta_unknown": "hız ölçülüyor…",
"dl_eta_under_minute": "1 dakikadan az kaldı",
"dl_eta_minutes": "yaklaşık {minutes} dk kaldı",
+ "section_diagnostics": "Tanılama",
+ "diag_summary": "{n} çift · en derin {cm} cm",
+ "diag_clean": "{cm} cm'den derin kendi içine geçme yok",
+ "diag_missing": "Bu sonuç için tanılama yok. “Çalışma Ortamını Güncelle” düğmesine tıklayıp yeniden oluşturun.",
+ "diag_frame_bad": "{f}. karede iç içe geçme:",
+ "diag_frame_ok": "{f}. kare: iç içe geçme yok",
+ "diag_prev": "Önceki",
+ "diag_next": "Sonraki",
+ "diag_no_more": "Bu yönde başka sorun yok",
+ "diag_report": "HTML Raporunu Aç",
+ "diag_report_building": "Rapor oluşturuluyor… (yaklaşık 15 sn)",
+ "diag_report_failed": "Rapor oluşturulamadı. Çıktı klasöründeki diagnose.log dosyasına bakın.",
+ "part_head": "baş",
+ "part_torso": "gövde",
+ "part_left_upper_arm": "sol üst kol",
+ "part_left_forearm": "sol ön kol",
+ "part_left_hand": "sol el",
+ "part_right_upper_arm": "sağ üst kol",
+ "part_right_forearm": "sağ ön kol",
+ "part_right_hand": "sağ el",
+ "part_left_thigh": "sol uyluk",
+ "part_left_shin": "sol baldır",
+ "part_left_foot": "sol ayak",
+ "part_right_thigh": "sağ uyluk",
+ "part_right_shin": "sağ baldır",
+ "part_right_foot": "sağ ayak",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/vi.py b/blender_extension/motion2mixamorig_blender/locales/vi.py
index 340ff59..3477c7d 100644
--- a/blender_extension/motion2mixamorig_blender/locales/vi.py
+++ b/blender_extension/motion2mixamorig_blender/locales/vi.py
@@ -109,4 +109,30 @@ STRINGS = {
"dl_eta_unknown": "đang đo tốc độ…",
"dl_eta_under_minute": "còn chưa đến 1 phút",
"dl_eta_minutes": "còn khoảng {minutes} phút",
+ "section_diagnostics": "Chẩn đoán",
+ "diag_summary": "{n} cặp · sâu nhất {cm} cm",
+ "diag_clean": "Không có tự giao cắt sâu hơn {cm} cm",
+ "diag_missing": "Kết quả này chưa có chẩn đoán. Bấm “Cập nhật runtime” rồi tạo lại.",
+ "diag_frame_bad": "Khung {f} có giao cắt:",
+ "diag_frame_ok": "Khung {f}: không giao cắt",
+ "diag_prev": "Trước",
+ "diag_next": "Tiếp",
+ "diag_no_more": "Không còn vấn đề nào theo hướng này",
+ "diag_report": "Mở báo cáo HTML",
+ "diag_report_building": "Đang tạo báo cáo… (khoảng 15 giây)",
+ "diag_report_failed": "Tạo báo cáo thất bại. Xem diagnose.log trong thư mục đầu ra.",
+ "part_head": "đầu",
+ "part_torso": "thân",
+ "part_left_upper_arm": "cánh tay trên trái",
+ "part_left_forearm": "cẳng tay trái",
+ "part_left_hand": "bàn tay trái",
+ "part_right_upper_arm": "cánh tay trên phải",
+ "part_right_forearm": "cẳng tay phải",
+ "part_right_hand": "bàn tay phải",
+ "part_left_thigh": "đùi trái",
+ "part_left_shin": "cẳng chân trái",
+ "part_left_foot": "bàn chân trái",
+ "part_right_thigh": "đùi phải",
+ "part_right_shin": "cẳng chân phải",
+ "part_right_foot": "bàn chân phải",
}
diff --git a/blender_extension/motion2mixamorig_blender/locales/zh_TW.py b/blender_extension/motion2mixamorig_blender/locales/zh_TW.py
index e5009bd..c4af8e9 100644
--- a/blender_extension/motion2mixamorig_blender/locales/zh_TW.py
+++ b/blender_extension/motion2mixamorig_blender/locales/zh_TW.py
@@ -109,4 +109,30 @@ STRINGS = {
"dl_eta_unknown": "正在測速…",
"dl_eta_under_minute": "剩不到 1 分鐘",
"dl_eta_minutes": "約剩 {minutes} 分鐘",
+ "section_diagnostics": "診斷",
+ "diag_summary": "{n} 處穿模 · 最深 {cm} cm",
+ "diag_clean": "沒有超過 {cm} cm 的穿模",
+ "diag_missing": "這個結果沒有診斷報告。請點「更新執行環境」,再重新產生。",
+ "diag_frame_bad": "第 {f} 影格有穿模:",
+ "diag_frame_ok": "第 {f} 影格:沒有穿模",
+ "diag_prev": "上一個問題",
+ "diag_next": "下一個問題",
+ "diag_no_more": "這個方向沒有更多問題了",
+ "diag_report": "開啟 HTML 報告",
+ "diag_report_building": "正在產生報告…(約 15 秒)",
+ "diag_report_failed": "報告產生失敗,請查看輸出資料夾中的 diagnose.log。",
+ "part_head": "頭",
+ "part_torso": "軀幹",
+ "part_left_upper_arm": "左上臂",
+ "part_left_forearm": "左前臂",
+ "part_left_hand": "左手",
+ "part_right_upper_arm": "右上臂",
+ "part_right_forearm": "右前臂",
+ "part_right_hand": "右手",
+ "part_left_thigh": "左大腿",
+ "part_left_shin": "左小腿",
+ "part_left_foot": "左腳",
+ "part_right_thigh": "右大腿",
+ "part_right_shin": "右小腿",
+ "part_right_foot": "右腳",
}
diff --git a/docs/i18n/README.ar.md b/docs/i18n/README.ar.md
index e454bbd..49be8a7 100644
--- a/docs/i18n/README.ar.md
+++ b/docs/i18n/README.ar.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
`--image` دون مسار يستخدم آخر ملف أُضيف إلى `assets/image/`.
+### 6. فحص التداخل الذاتي
+
+كل تشغيل يفحص أيضًا الشخصية الناتجة بحثًا عن **التداخل الذاتي** — دخول جزء من الجسم في جزء آخر، مثل يد داخل الرأس — ويكتب `diagnostics.json`. تطبع الطرفية سطرًا واحدًا، مثل `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`. لا يُفحص التداخل مع الأرضية.
+
+لإعادة فحص تشغيل ما، أو لرؤية المشكلات:
+
+```bash
+m2mr diagnose outputs/<run> # يعيد كتابة diagnostics.json
+m2mr diagnose outputs/<run> --visualize # وأيضًا diagnostics.html: الفيديو المصدر بجانب الشخصية، خط زمني، قائمة مشكلات قابلة للنقر
+m2mr diagnose outputs/<run> --threshold-cm 2 # يبلّغ فقط عن التداخلات الأعمق من 2 cm (الافتراضي 1)
+```
+
+كل مشكلة في `diagnostics.json` هي زوج من أجزاء الجسم مع نطاقات الإطارات التي يتداخلان فيها، وأسوأ إطار، وعمقه. تبدأ أرقام الإطارات من 0، كما في الخط الزمني لـ Blender بعد استيراد glTF. لا تُقارَن الأجزاء المتصلة بمفصل (العضد والساعد، الجذع والفخذ، …): جلدها يتداخل حول المفصل في أي وضعية. يضمّن `diagnostics.html` الفيديو المصدر (يتطلب `ffmpeg`) ويحمّل three.js من CDN، لذا يحتاج العرض ثلاثي الأبعاد إلى اتصال بالإنترنت.
+
## المخرجات
-كل `m2mr run` ينشئ مجلدًا باسم **وقت بدء الأمر**. الملفات الأربعة في الجذر واحدة للفيديو والصورة؛ يتغيّر مجلد المعاينة فقط.
+كل `m2mr run` ينشئ مجلدًا باسم **وقت بدء الأمر**. الملفات في الجذر واحدة للفيديو والصورة؛ يتغيّر مجلد المعاينة فقط.
```
outputs/20260829_193205_dance/ # تشغيل الصورة: …_pose/
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # تشغيل الصورة: …_pose/
├── skeleton_motion.npz # هيكل إنسان ثلاثي الأبعاد (إعادة استخدام بـ --skeleton)
├── mixamo_rotations.npz # دورانات عظام Mixamo لكل عظم
├── mixamo_character.glb # شخصية مكسوّة، استيراد إلى Blender / Unity
+├── diagnostics.json # تقرير التداخل الذاتي (انظر الخطوة 6 في البدء السريع)
+├── diagnostics.html # فقط بعد `m2mr diagnose <run> --visualize`
└── videos/ أو images/ # المعاينات — حسب المدخل
```
@@ -176,7 +192,7 @@ images/
# اليمين: مدار 10° حول الهيكل (دورة كاملة)
```
-افتح `mixamo_character.glb` في Blender: File → Import → glTF 2.0 (.glb/.gltf). إن وُجّهت الكاميرا إلى فراغ، حدّد شبكة الشخصية ثم View → Frame Selected. مجموعة الكرات على الرأس واليدين هي عرض للعظام وليست الشبكة: في Outliner أخفِ **Icosphere** و**armature** واترك الشبكة المكسوّة ظاهرة. اضبط FPS المشهد وإطار نهاية الخط الزمني من `run.json` (`fps` و`n_frames`) حتى تطابق مدة المصدر. في تشغيل الفيديو قارن مع `videos/mixamo_character.mp4`، وفي تشغيل الصورة مع `images/mixamo_character.png` أو مقطع المدار.
+افتح `mixamo_character.glb` في Blender: File → Import → glTF 2.0 (.glb/.gltf). إن وُجّهت الكاميرا إلى فراغ، حدّد شبكة الشخصية ثم View → Frame Selected. مجموعة الكرات على الرأس واليدين هي عرض للعظام وليست الشبكة: في Outliner أخفِ **Icosphere** و**armature** واترك الشبكة المكسوّة ظاهرة. اضبط FPS المشهد من `run.json` (`fps`) والخط الزمني على الإطارات من 0 إلى `n_frames` − 1 حتى يطابق التشغيل المصدر وتطابق أرقام الإطارات `diagnostics.json`. في تشغيل الفيديو قارن مع `videos/mixamo_character.mp4`، وفي تشغيل الصورة مع `images/mixamo_character.png` أو مقطع المدار.
## الرخصة
@@ -190,3 +206,13 @@ images/
إن واجهت مشكلة، أو احتجت إلى مساعدة لإكمال الإعداد المحلي، أو رغبت في الحديث عن التعاون، يُرجى المراسلة على:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.de.md b/docs/i18n/README.de.md
index 610c9e5..0e717d2 100644
--- a/docs/i18n/README.de.md
+++ b/docs/i18n/README.de.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
`--image` ohne Pfad nimmt die zuletzt nach `assets/image/` gelegte Datei.
+### 6. Auf Selbstdurchdringung prüfen
+
+Jeder Lauf prüft den fertigen Charakter außerdem auf **Selbstdurchdringung** — ein Körperteil dringt in ein anderes ein, etwa eine Hand in den Kopf — und schreibt `diagnostics.json`. Das Terminal gibt eine Zeile aus, z. B. `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`. Der Boden wird nicht geprüft.
+
+Um einen Lauf erneut zu prüfen oder die Probleme anzusehen:
+
+```bash
+m2mr diagnose outputs/<run> # diagnostics.json neu schreiben
+m2mr diagnose outputs/<run> --visualize # zusätzlich diagnostics.html: Quellvideo neben dem Charakter, Timeline, anklickbare Problemliste
+m2mr diagnose outputs/<run> --threshold-cm 2 # nur Durchdringungen tiefer als 2 cm melden (Standard 1)
+```
+
+Jedes Problem in `diagnostics.json` ist ein Paar von Körperteilen mit den Frame-Bereichen, in denen sie sich durchdringen, dem schlimmsten Frame und dessen Tiefe. Frame-Nummern zählen ab 0, wie die Blender-Timeline nach einem glTF-Import. Durch ein Gelenk verbundene Teile (Ober- und Unterarm, Rumpf und Oberschenkel, …) werden nicht verglichen: Ihre Haut überlappt am Gelenk in jeder Pose. `diagnostics.html` bettet das Quellvideo ein (braucht `ffmpeg`) und lädt three.js von einem CDN, daher braucht die 3D-Ansicht eine Internetverbindung.
+
## Ausgaben
-Jeder `m2mr run` legt ein Verzeichnis an, benannt nach **Startzeit des Befehls**. Die vier Dateien im Wurzelverzeichnis sind für Video und Foto gleich; nur der Vorschauordner ändert sich.
+Jeder `m2mr run` legt ein Verzeichnis an, benannt nach **Startzeit des Befehls**. Die Dateien im Wurzelverzeichnis sind für Video und Foto gleich; nur der Vorschauordner ändert sich.
```
outputs/20260829_193205_dance/ # Foto-Lauf: …_pose/
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # Foto-Lauf: …_pose/
├── skeleton_motion.npz # 3D-Körperskelett (mit --skeleton wiederverwenden)
├── mixamo_rotations.npz # Mixamo-Rotationen pro Bone
├── mixamo_character.glb # Charakter mit Skinning, Import in Blender / Unity
+├── diagnostics.json # Bericht zur Selbstdurchdringung (siehe Schnellstart, Schritt 6)
+├── diagnostics.html # nur nach `m2mr diagnose <run> --visualize`
└── videos/ oder images/ # Vorschauen — je nach Eingabe
```
@@ -176,7 +192,7 @@ images/
# rechts: 10°-Orbit um den Rig (eine volle Umdrehung)
```
-`mixamo_character.glb` in Blender öffnen: File → Import → glTF 2.0 (.glb/.gltf). Zeigt die Kamera ins Leere, das Charakter-Mesh wählen und View → Frame Selected. Die Kugeln an Kopf und Händen sind die Knochenanzeige, nicht das Mesh: im Outliner **Icosphere** und die **Armature** ausblenden, das Mesh mit Skinning sichtbar lassen. Szene-FPS und letztes Timeline-Frame aus `run.json` (`fps`, `n_frames`) setzen, damit die Wiedergabe zur Quelle passt. Videolauf mit `videos/mixamo_character.mp4` vergleichen, Fotolauf mit `images/mixamo_character.png` oder dem Orbit-Clip.
+`mixamo_character.glb` in Blender öffnen: File → Import → glTF 2.0 (.glb/.gltf). Zeigt die Kamera ins Leere, das Charakter-Mesh wählen und View → Frame Selected. Die Kugeln an Kopf und Händen sind die Knochenanzeige, nicht das Mesh: im Outliner **Icosphere** und die **Armature** ausblenden, das Mesh mit Skinning sichtbar lassen. Szene-FPS aus `run.json` (`fps`) und die Timeline auf die Frames 0 bis `n_frames` − 1 setzen, damit die Wiedergabe zur Quelle passt und die Frame-Nummern zu `diagnostics.json`. Videolauf mit `videos/mixamo_character.mp4` vergleichen, Fotolauf mit `images/mixamo_character.png` oder dem Orbit-Clip.
## Lizenz
@@ -190,3 +206,13 @@ Der Code dieses Repositories ist Apache-2.0. Die selbst beschafften Assets haben
Bei Problemen, wenn Hilfe beim lokalen Setup nötig ist oder Sie über eine Zusammenarbeit sprechen möchten, schreiben Sie an:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.es-MX.md b/docs/i18n/README.es-MX.md
index 2a633b3..76560fa 100644
--- a/docs/i18n/README.es-MX.md
+++ b/docs/i18n/README.es-MX.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
`--image` sin ruta usa el archivo agregado más recientemente a `assets/image/`.
+### 6. Revisar autointersecciones
+
+Cada ejecución también revisa el personaje terminado en busca de **autointersecciones** — una parte del cuerpo que entra en otra, como una mano dentro de la cabeza — y escribe `diagnostics.json`. La terminal imprime una línea, por ejemplo `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`. No se revisa el piso.
+
+Para volver a revisar una ejecución, o para ver los problemas:
+
+```bash
+m2mr diagnose outputs/<run> # reescribe diagnostics.json
+m2mr diagnose outputs/<run> --visualize # además diagnostics.html: video fuente junto al personaje, timeline, lista de problemas en la que puedes hacer clic
+m2mr diagnose outputs/<run> --threshold-cm 2 # reporta solo penetraciones de más de 2 cm (por defecto 1)
+```
+
+Cada problema en `diagnostics.json` es un par de partes del cuerpo con los rangos de frames en que se intersectan, el peor frame y su profundidad. Los números de frame empiezan en 0, como la timeline de Blender después de importar un glTF. Las partes unidas por una articulación (brazo y antebrazo, torso y muslo, …) no se comparan: su piel se traslapa alrededor de la articulación en cualquier pose. `diagnostics.html` incrusta el video fuente (requiere `ffmpeg`) y carga three.js desde un CDN, así que su vista 3D necesita conexión a internet.
+
## Salidas
-Cada `m2mr run` crea un directorio con el nombre de **la hora en que inició el comando**. Los cuatro archivos de la raíz son iguales para video y foto; solo cambia la carpeta de vistas previas.
+Cada `m2mr run` crea un directorio con el nombre de **la hora en que inició el comando**. Los archivos de la raíz son iguales para video y foto; solo cambia la carpeta de vistas previas.
```
outputs/20260829_193205_dance/ # o …_pose/ para una foto
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # o …_pose/ para una foto
├── skeleton_motion.npz # esqueleto humano 3D (reutilízalo con --skeleton)
├── mixamo_rotations.npz # rotaciones de Mixamo por hueso
├── mixamo_character.glb # personaje con skinning, impórtalo en Blender / Unity
+├── diagnostics.json # reporte de autointersecciones (ver el paso 6 de Inicio rápido)
+├── diagnostics.html # solo después de `m2mr diagnose <run> --visualize`
└── videos/ o images/ # vistas previas — según la entrada
```
@@ -176,7 +192,7 @@ images/
# derecha: órbita del rig en pasos de 10° (una vuelta completa)
```
-Abre `mixamo_character.glb` en Blender: File → Import → glTF 2.0 (.glb/.gltf). Si la cámara apunta a un espacio vacío, selecciona el mesh del personaje y usa View → Frame Selected. El grupo de esferas en la cabeza y las manos es la visualización de los huesos, no el mesh: en el Outliner, oculta **Icosphere** y la **armature**; deja visible el mesh con skinning. Ajusta los FPS de la escena y el último frame de la timeline según `run.json` (`fps`, `n_frames`) para que la reproducción coincida con la fuente. Compara una ejecución con video contra `videos/mixamo_character.mp4`, y una con foto contra `images/mixamo_character.png` o el clip orbital.
+Abre `mixamo_character.glb` en Blender: File → Import → glTF 2.0 (.glb/.gltf). Si la cámara apunta a un espacio vacío, selecciona el mesh del personaje y usa View → Frame Selected. El grupo de esferas en la cabeza y las manos es la visualización de los huesos, no el mesh: en el Outliner, oculta **Icosphere** y la **armature**; deja visible el mesh con skinning. Ajusta los FPS de la escena según `run.json` (`fps`) y la timeline a los frames 0 a `n_frames` − 1 para que la reproducción coincida con la fuente y los números de frame con `diagnostics.json`. Compara una ejecución con video contra `videos/mixamo_character.mp4`, y una con foto contra `images/mixamo_character.png` o el clip orbital.
## Licencia
@@ -190,3 +206,13 @@ El código de este repositorio es Apache-2.0. Los recursos que descargues tienen
Si tienes algún problema, necesitas ayuda para terminar una instalación local o quieres platicar sobre una colaboración, escribe a:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.fil.md b/docs/i18n/README.fil.md
index 6d28861..ed0292b 100644
--- a/docs/i18n/README.fil.md
+++ b/docs/i18n/README.fil.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
Kapag walang path ang `--image`, ang file na pinakahuling idinagdag sa `assets/image/` ang gagamitin.
+### 6. Suriin ang self-intersection
+
+Sinusuri rin ng bawat run ang natapos na character para sa **self-intersection** — isang bahagi ng katawan na pumapasok sa isa pa, gaya ng kamay sa loob ng ulo — at isinusulat ang `diagnostics.json`. Nagpi-print ang terminal ng isang linya, hal. `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`. Hindi sinusuri ang sahig.
+
+Para suriin muli ang isang run, o para makita ang mga problema:
+
+```bash
+m2mr diagnose outputs/<run> # isulat muli ang diagnostics.json
+m2mr diagnose outputs/<run> --visualize # pati diagnostics.html: source video katabi ng character, timeline, listahan ng problema na puwedeng i-click
+m2mr diagnose outputs/<run> --threshold-cm 2 # iulat lang ang pagpasok na mas malalim sa 2 cm (default 1)
+```
+
+Ang bawat problema sa `diagnostics.json` ay isang pares ng bahagi ng katawan, kasama ang mga frame range kung saan sila nagsasalubong, ang pinakamalalang frame, at ang lalim nito. Nagsisimula sa 0 ang bilang ng frame, gaya ng timeline ng Blender pagkatapos mag-import ng glTF. Hindi pinaghahambing ang mga bahaging pinagdugtong ng kasukasuan (upper arm at forearm, torso at hita, …): nagpapatong ang balat nila sa paligid ng kasukasuan sa anumang pose. Ini-embed ng `diagnostics.html` ang source video (kailangan ng `ffmpeg`) at nilo-load ang three.js mula sa CDN, kaya kailangan ng internet ang 3D view nito.
+
## Mga Output
-Bawat `m2mr run` ay gumagawa ng directory na pinangalanan ayon sa **oras ng pagsisimula ng command**. Pareho para sa video at still ang apat na file sa root; ang preview folder lang ang nagbabago.
+Bawat `m2mr run` ay gumagawa ng directory na pinangalanan ayon sa **oras ng pagsisimula ng command**. Pareho para sa video at still ang mga file sa root; ang preview folder lang ang nagbabago.
```
outputs/20260829_193205_dance/ # o …_pose/ para sa still
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # o …_pose/ para sa still
├── skeleton_motion.npz # 3D skeleton ng tao (gamitin muli sa --skeleton)
├── mixamo_rotations.npz # Mixamo rotation ng bawat buto
├── mixamo_character.glb # skinned na character, i-import sa Blender / Unity
+├── diagnostics.json # ulat ng self-intersection (tingnan ang hakbang 6 ng Mabilis na Pagsisimula)
+├── diagnostics.html # pagkatapos lang ng `m2mr diagnose <run> --visualize`
└── videos/ o images/ # mga preview — depende sa input
```
@@ -176,7 +192,7 @@ images/
# kanan: 10° na orbit ng rig (isang buong ikot)
```
-Buksan ang `mixamo_character.glb` sa Blender: File → Import → glTF 2.0 (.glb/.gltf). Kung nakatutok ang camera sa bakanteng espasyo, piliin ang character mesh at gamitin ang View → Frame Selected. Ang kumpol ng mga sphere sa ulo at mga kamay ay display ng buto, hindi ang mesh: sa Outliner, itago ang **Icosphere** at ang **armature**; hayaang nakikita ang skinned na mesh. Itakda ang FPS ng scene at ang huling frame ng timeline mula sa `run.json` (`fps`, `n_frames`) para tumugma ang playback sa source. Ikumpara ang video run sa `videos/mixamo_character.mp4`, at ang still run sa `images/mixamo_character.png` o sa orbit clip.
+Buksan ang `mixamo_character.glb` sa Blender: File → Import → glTF 2.0 (.glb/.gltf). Kung nakatutok ang camera sa bakanteng espasyo, piliin ang character mesh at gamitin ang View → Frame Selected. Ang kumpol ng mga sphere sa ulo at mga kamay ay display ng buto, hindi ang mesh: sa Outliner, itago ang **Icosphere** at ang **armature**; hayaang nakikita ang skinned na mesh. Itakda ang FPS ng scene mula sa `run.json` (`fps`) at ang timeline sa mga frame 0 hanggang `n_frames` − 1 para tumugma ang playback sa source at ang mga numero ng frame sa `diagnostics.json`. Ikumpara ang video run sa `videos/mixamo_character.mp4`, at ang still run sa `images/mixamo_character.png` o sa orbit clip.
## Lisensya
@@ -190,3 +206,13 @@ Apache-2.0 ang code ng repository na ito. May sariling mga tuntunin ang mga asse
Kung may problema ka, kailangan mo ng tulong para matapos ang local setup, o gusto mong pag-usapan ang pakikipagtulungan, mag-email sa:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.fr.md b/docs/i18n/README.fr.md
index f493c01..c051974 100644
--- a/docs/i18n/README.fr.md
+++ b/docs/i18n/README.fr.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
`--image` sans chemin utilise le fichier le plus récemment ajouté à `assets/image/`.
+### 6. Vérifier les auto-intersections
+
+Chaque exécution vérifie aussi le personnage final à la recherche d’**auto-intersections** — une partie du corps qui entre dans une autre, comme une main dans la tête — et écrit `diagnostics.json`. Le terminal affiche une ligne, par exemple `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`. Le sol n’est pas vérifié.
+
+Pour revérifier une exécution, ou pour voir les problèmes :
+
+```bash
+m2mr diagnose outputs/<run> # réécrit diagnostics.json
+m2mr diagnose outputs/<run> --visualize # écrit aussi diagnostics.html : vidéo source à côté du personnage, timeline, liste cliquable des problèmes
+m2mr diagnose outputs/<run> --threshold-cm 2 # ne signale que les pénétrations de plus de 2 cm (1 par défaut)
+```
+
+Chaque problème dans `diagnostics.json` est une paire de parties du corps, avec les plages d’images où elles s’intersectent, la pire image et sa profondeur. Les numéros d’image commencent à 0, comme la timeline de Blender après un import glTF. Les parties reliées par une articulation (bras et avant-bras, torse et cuisse, …) ne sont pas comparées : leur peau se chevauche autour de l’articulation dans toutes les poses. `diagnostics.html` intègre la vidéo source (nécessite `ffmpeg`) et charge three.js depuis un CDN ; sa vue 3D a donc besoin d’une connexion internet.
+
## Sorties
-Chaque `m2mr run` crée un répertoire nommé d’après **l’heure de démarrage de la commande**. Les quatre fichiers à la racine sont identiques pour la vidéo et la photo ; seul le dossier d’aperçu change.
+Chaque `m2mr run` crée un répertoire nommé d’après **l’heure de démarrage de la commande**. Les fichiers à la racine sont identiques pour la vidéo et la photo ; seul le dossier d’aperçu change.
```
outputs/20260829_193205_dance/ # ou …_pose/ pour une photo
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # ou …_pose/ pour une photo
├── skeleton_motion.npz # squelette humain 3D (réutilisable avec --skeleton)
├── mixamo_rotations.npz # rotations Mixamo par os
├── mixamo_character.glb # personnage skinné, à importer dans Blender / Unity
+├── diagnostics.json # rapport d’auto-intersection (voir l’étape 6 du Démarrage rapide)
+├── diagnostics.html # seulement après `m2mr diagnose <run> --visualize`
└── videos/ ou images/ # aperçus — selon l’entrée
```
@@ -176,7 +192,7 @@ images/
# droite : orbite du rig par pas de 10° (un tour complet)
```
-Ouvrez `mixamo_character.glb` dans Blender : File → Import → glTF 2.0 (.glb/.gltf). Si la caméra vise un espace vide, sélectionnez le mesh du personnage puis utilisez View → Frame Selected. L’amas de sphères sur la tête et les mains correspond à l’affichage des os, pas au mesh : dans l’Outliner, masquez **Icosphere** et l’**armature** ; laissez le mesh skinné visible. Réglez le FPS de la scène et la dernière image de la timeline d’après `run.json` (`fps`, `n_frames`) pour que la lecture corresponde à la source. Comparez une exécution vidéo à `videos/mixamo_character.mp4`, une exécution photo à `images/mixamo_character.png` ou au clip en orbite.
+Ouvrez `mixamo_character.glb` dans Blender : File → Import → glTF 2.0 (.glb/.gltf). Si la caméra vise un espace vide, sélectionnez le mesh du personnage puis utilisez View → Frame Selected. L’amas de sphères sur la tête et les mains correspond à l’affichage des os, pas au mesh : dans l’Outliner, masquez **Icosphere** et l’**armature** ; laissez le mesh skinné visible. Réglez le FPS de la scène d’après `run.json` (`fps`) et la timeline sur les images 0 à `n_frames` − 1 pour que la lecture corresponde à la source et que les numéros d’image correspondent à `diagnostics.json`. Comparez une exécution vidéo à `videos/mixamo_character.mp4`, une exécution photo à `images/mixamo_character.png` ou au clip en orbite.
## Licence
@@ -190,3 +206,13 @@ Le code de ce dépôt est sous licence Apache-2.0. Les ressources que vous tél
Si vous rencontrez un problème, avez besoin d’aide pour terminer une installation locale ou souhaitez discuter d’une collaboration, écrivez à :
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.id.md b/docs/i18n/README.id.md
index 5a253ac..3b751d9 100644
--- a/docs/i18n/README.id.md
+++ b/docs/i18n/README.id.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
`--image` tanpa path akan memakai file yang paling terakhir ditambahkan ke `assets/image/`.
+### 6. Periksa self-intersection
+
+Setiap run juga memeriksa karakter yang sudah jadi untuk **self-intersection** — satu bagian tubuh masuk ke bagian lain, misalnya tangan di dalam kepala — dan menulis `diagnostics.json`. Terminal mencetak satu baris, misalnya `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`. Lantai tidak diperiksa.
+
+Untuk memeriksa ulang sebuah run, atau melihat masalahnya:
+
+```bash
+m2mr diagnose outputs/<run> # tulis ulang diagnostics.json
+m2mr diagnose outputs/<run> --visualize # juga diagnostics.html: video sumber di samping karakter, timeline, daftar masalah yang bisa diklik
+m2mr diagnose outputs/<run> --threshold-cm 2 # laporkan hanya tembusan yang lebih dalam dari 2 cm (default 1)
+```
+
+Setiap masalah di `diagnostics.json` adalah sepasang bagian tubuh beserta rentang frame saat keduanya saling tembus, frame terparah, dan kedalamannya. Nomor frame dihitung dari 0, sama seperti timeline Blender setelah impor glTF. Bagian yang tersambung oleh sendi (lengan atas dan lengan bawah, torso dan paha, …) tidak dibandingkan: kulitnya tumpang tindih di sekitar sendi dalam pose apa pun. `diagnostics.html` menyematkan video sumber (perlu `ffmpeg`) dan memuat three.js dari CDN, jadi tampilan 3D-nya perlu koneksi internet.
+
## Keluaran
-Setiap `m2mr run` membuat direktori yang dinamai berdasarkan **waktu perintah dimulai**. Empat file di root sama untuk video dan foto; hanya folder pratinjaunya yang berbeda.
+Setiap `m2mr run` membuat direktori yang dinamai berdasarkan **waktu perintah dimulai**. File di root sama untuk video dan foto; hanya folder pratinjaunya yang berbeda.
```
outputs/20260829_193205_dance/ # atau …_pose/ untuk foto
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # atau …_pose/ untuk foto
├── skeleton_motion.npz # skeleton manusia 3D (pakai ulang dengan --skeleton)
├── mixamo_rotations.npz # rotasi Mixamo per tulang
├── mixamo_character.glb # karakter yang sudah di-skin, impor ke Blender / Unity
+├── diagnostics.json # laporan self-intersection (lihat Mulai Cepat langkah 6)
+├── diagnostics.html # hanya setelah `m2mr diagnose <run> --visualize`
└── videos/ atau images/ # pratinjau — tergantung input
```
@@ -176,7 +192,7 @@ images/
# kanan: orbit rig per 10° (satu putaran penuh)
```
-Buka `mixamo_character.glb` di Blender: File → Import → glTF 2.0 (.glb/.gltf). Jika kamera mengarah ke ruang kosong, pilih mesh karakter lalu gunakan View → Frame Selected. Kumpulan bola di kepala dan tangan adalah tampilan tulang, bukan mesh: di Outliner, sembunyikan **Icosphere** dan **armature**; biarkan mesh yang sudah di-skin tetap terlihat. Atur FPS scene dan frame terakhir timeline sesuai `run.json` (`fps`, `n_frames`) agar pemutaran sesuai dengan sumbernya. Bandingkan run video dengan `videos/mixamo_character.mp4`, dan run foto dengan `images/mixamo_character.png` atau klip orbit.
+Buka `mixamo_character.glb` di Blender: File → Import → glTF 2.0 (.glb/.gltf). Jika kamera mengarah ke ruang kosong, pilih mesh karakter lalu gunakan View → Frame Selected. Kumpulan bola di kepala dan tangan adalah tampilan tulang, bukan mesh: di Outliner, sembunyikan **Icosphere** dan **armature**; biarkan mesh yang sudah di-skin tetap terlihat. Atur FPS scene sesuai `run.json` (`fps`) dan timeline ke frame 0 sampai `n_frames` − 1 agar pemutaran sesuai dengan sumbernya dan nomor frame cocok dengan `diagnostics.json`. Bandingkan run video dengan `videos/mixamo_character.mp4`, dan run foto dengan `images/mixamo_character.png` atau klip orbit.
## Lisensi
@@ -190,3 +206,13 @@ Kode di repositori ini berlisensi Apache-2.0. Aset yang kamu unduh sendiri memil
Jika kamu mengalami masalah, butuh bantuan menyelesaikan instalasi lokal, atau ingin membicarakan kerja sama, kirim email ke:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.ja.md b/docs/i18n/README.ja.md
index d40fa51..cc3fc0c 100644
--- a/docs/i18n/README.ja.md
+++ b/docs/i18n/README.ja.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
パスなしの `--image` は、`assets/image/` に最後に入れたファイルを使います。
+### 6. 自己交差(めり込み)をチェック
+
+各実行では、完成したキャラクターの**自己交差**(ある体の部位が別の部位にめり込むこと。例:手が頭に入り込む)もチェックし、`diagnostics.json` を書き出します。ターミナルには `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm` のような 1 行が表示されます。床とのめり込みはチェックしません。
+
+実行を再チェックする、または問題を目で確認するには:
+
+```bash
+m2mr diagnose outputs/<run> # diagnostics.json を書き直す
+m2mr diagnose outputs/<run> --visualize # diagnostics.html も出力:元動画とキャラクターを並べて表示、タイムライン、クリックできる問題一覧
+m2mr diagnose outputs/<run> --threshold-cm 2 # 2 cm より深いめり込みだけを報告(既定 1)
+```
+
+`diagnostics.json` の各問題は体の部位のペアで、交差しているフレーム範囲、最もひどいフレームとその深さを含みます。フレーム番号は glTF を Blender にインポートしたときのタイムラインと同じく 0 から数えます。関節でつながった部位(上腕と前腕、胴体と太ももなど)は比較しません。どんなポーズでも関節まわりで皮膚が重なるためです。`diagnostics.html` は元動画を埋め込み(`ffmpeg` が必要)、three.js を CDN から読み込むため、3D ビューにはインターネット接続が必要です。
+
## 出力
-各 `m2mr run` は**コマンド開始時刻**でディレクトリを作ります。ルートの 4 ファイルは動画も写真も同じで、プレビューフォルダだけが変わります。
+各 `m2mr run` は**コマンド開始時刻**でディレクトリを作ります。ルートのファイルは動画も写真も同じで、プレビューフォルダだけが変わります。
```
outputs/20260829_193205_dance/ # 写真実行は …_pose/
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # 写真実行は …_pose/
├── skeleton_motion.npz # 人体 3D スケルトン(--skeleton で再利用)
├── mixamo_rotations.npz # Mixamo ボーンごとの回転
├── mixamo_character.glb # スキン付きキャラクター、Blender / Unity にインポート
+├── diagnostics.json # 自己交差レポート(クイックスタートの手順 6 を参照)
+├── diagnostics.html # `m2mr diagnose <run> --visualize` の実行後のみ
└── videos/ または images/ # プレビュー — 入力によって決まる
```
@@ -176,7 +192,7 @@ images/
# 右:10° で一周する周回
```
-`mixamo_character.glb` は Blender で File → Import → glTF 2.0 (.glb/.gltf) で開きます。カメラが空を向いているときはキャラクターのメッシュを選び、View → Frame Selected。頭と手の球の塊はメッシュではなくボーン表示です。Outliner で **Icosphere** と **armature** を非表示にし、スキン付きメッシュは残してください。再生を原寸に合わせるには、`run.json` の `fps` / `n_frames` でシーンの FPS とタイムライン終了フレームを設定します。動画実行は `videos/mixamo_character.mp4`、写真実行は `images/mixamo_character.png` または周回クリップと見比べてください。
+`mixamo_character.glb` は Blender で File → Import → glTF 2.0 (.glb/.gltf) で開きます。カメラが空を向いているときはキャラクターのメッシュを選び、View → Frame Selected。頭と手の球の塊はメッシュではなくボーン表示です。Outliner で **Icosphere** と **armature** を非表示にし、スキン付きメッシュは残してください。再生を元の長さに合わせ、フレーム番号を `diagnostics.json` とそろえるには、シーンの FPS を `run.json` の `fps` に、タイムラインを 0 〜 `n_frames` − 1 フレームに設定します。動画実行は `videos/mixamo_character.mp4`、写真実行は `images/mixamo_character.png` または周回クリップと見比べてください。
## ライセンス
@@ -190,3 +206,13 @@ images/
ご不明点がある場合、ローカル環境の構築でお手伝いが必要な場合、または協業をご相談したい場合は、メールでご連絡ください:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.ko.md b/docs/i18n/README.ko.md
index ea52c55..903a4e0 100644
--- a/docs/i18n/README.ko.md
+++ b/docs/i18n/README.ko.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
경로 없이 `--image`만 쓰면 `assets/image/`에 가장 최근에 넣은 파일을 씁니다.
+### 6. 자기 교차(파고듦) 확인
+
+모든 실행은 완성된 캐릭터의 **자기 교차**(한 신체 부위가 다른 부위로 파고드는 것, 예: 손이 머리 안으로 들어감)도 확인하고 `diagnostics.json`을 씁니다. 터미널에는 `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm` 같은 한 줄이 출력됩니다. 바닥은 확인하지 않습니다.
+
+실행을 다시 확인하거나 문제를 눈으로 보려면:
+
+```bash
+m2mr diagnose outputs/<run> # diagnostics.json 다시 쓰기
+m2mr diagnose outputs/<run> --visualize # diagnostics.html도 생성: 원본 영상과 캐릭터 나란히, 타임라인, 클릭 가능한 문제 목록
+m2mr diagnose outputs/<run> --threshold-cm 2 # 2 cm보다 깊은 파고듦만 보고 (기본값 1)
+```
+
+`diagnostics.json`의 각 문제는 신체 부위 한 쌍과, 두 부위가 교차하는 프레임 범위, 가장 심한 프레임과 그 깊이입니다. 프레임 번호는 glTF를 Blender로 임포트한 뒤의 타임라인처럼 0부터 셉니다. 관절로 이어진 부위(위팔과 아래팔, 몸통과 허벅지 등)는 비교하지 않습니다. 어떤 자세에서도 관절 주변의 피부가 겹치기 때문입니다. `diagnostics.html`은 원본 영상을 포함하고(`ffmpeg` 필요) three.js를 CDN에서 불러오므로, 3D 뷰에는 인터넷 연결이 필요합니다.
+
## 출력
-각 `m2mr run`은 **명령이 시작된 시각**으로 디렉터리를 만듭니다. 루트의 네 파일은 영상과 사진이 같고, 미리보기 폴더만 달라집니다.
+각 `m2mr run`은 **명령이 시작된 시각**으로 디렉터리를 만듭니다. 루트의 파일은 영상과 사진이 같고, 미리보기 폴더만 달라집니다.
```
outputs/20260829_193205_dance/ # 사진 실행은 …_pose/
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # 사진 실행은 …_pose/
├── skeleton_motion.npz # 인체 3D 스켈레톤 (--skeleton으로 재사용)
├── mixamo_rotations.npz # Mixamo 본별 회전
├── mixamo_character.glb # 스키닝된 캐릭터, Blender / Unity에 임포트
+├── diagnostics.json # 자기 교차 보고서 (빠른 시작 6단계 참고)
+├── diagnostics.html # `m2mr diagnose <run> --visualize` 실행 후에만
└── videos/ 또는 images/ # 미리보기 — 입력에 따라 결정
```
@@ -176,7 +192,7 @@ images/
# 오른쪽: 10° 궤도(한 바퀴)
```
-`mixamo_character.glb`는 Blender에서 File → Import → glTF 2.0 (.glb/.gltf)로 엽니다. 카메라가 빈 곳을 보고 있으면 캐릭터 메시를 선택한 뒤 View → Frame Selected. 머리와 손의 구체들은 메시가 아니라 본 표시입니다. Outliner에서 **Icosphere**와 **armature**를 숨기고, 스키닝된 메시는 그대로 두세요. 재생이 원본과 같아지려면 `run.json`의 `fps` / `n_frames`로 장면 FPS와 타임라인 끝 프레임을 맞추세요. 영상 실행은 `videos/mixamo_character.mp4`와, 사진 실행은 `images/mixamo_character.png` 또는 궤도 클립과 비교하세요.
+`mixamo_character.glb`는 Blender에서 File → Import → glTF 2.0 (.glb/.gltf)로 엽니다. 카메라가 빈 곳을 보고 있으면 캐릭터 메시를 선택한 뒤 View → Frame Selected. 머리와 손의 구체들은 메시가 아니라 본 표시입니다. Outliner에서 **Icosphere**와 **armature**를 숨기고, 스키닝된 메시는 그대로 두세요. 재생이 원본과 같고 프레임 번호가 `diagnostics.json`과 맞으려면, 장면 FPS는 `run.json`의 `fps`로, 타임라인은 0부터 `n_frames` − 1 프레임까지로 맞추세요. 영상 실행은 `videos/mixamo_character.mp4`와, 사진 실행은 `images/mixamo_character.png` 또는 궤도 클립과 비교하세요.
## 라이선스
@@ -190,3 +206,13 @@ images/
문제가 있으시거나, 로컬 설치에 도움이 필요하시거나, 협업을 논의하고 싶으시면 이메일로 연락해 주세요:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.ne.md b/docs/i18n/README.ne.md
index ec4b73b..0c604fa 100644
--- a/docs/i18n/README.ne.md
+++ b/docs/i18n/README.ne.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
path बिनाको `--image` ले `assets/image/` मा सबैभन्दा पछि थपिएको फाइल प्रयोग गर्छ।
+### 6. self-intersection जाँच गर्नुहोस्
+
+हरेक run ले तयार भएको क्यारेक्टरमा **self-intersection** पनि जाँच्छ — शरीरको एउटा भाग अर्को भागभित्र पस्नु, जस्तै हात टाउकोभित्र — र `diagnostics.json` लेख्छ। टर्मिनलले एउटा लाइन देखाउँछ, जस्तै `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`। भुइँ जाँच गरिँदैन।
+
+कुनै run फेरि जाँच्न, वा समस्याहरू हेर्न:
+
+```bash
+m2mr diagnose outputs/<run> # diagnostics.json फेरि लेख्छ
+m2mr diagnose outputs/<run> --visualize # diagnostics.html पनि: क्यारेक्टरसँगै स्रोत भिडियो, timeline, क्लिक गर्न मिल्ने समस्या सूची
+m2mr diagnose outputs/<run> --threshold-cm 2 # 2 cm भन्दा गहिरो पसाइ मात्र रिपोर्ट गर्छ (पूर्वनिर्धारित 1)
+```
+
+`diagnostics.json` मा हरेक समस्या शरीरका दुई भागको जोडी हो, साथमा ती भाग एकअर्कामा पसेका frame दायरा, सबैभन्दा खराब frame र त्यसको गहिराइ हुन्छ। frame नम्बर 0 बाट गनिन्छ, glTF import पछि Blender को timeline जस्तै। जोर्नीले जोडिएका भागहरू (पाखुराको माथिल्लो र तल्लो भाग, धड र तिघ्रा, …) तुलना गरिँदैनन्: जुनसुकै पोजमा पनि जोर्नी वरिपरि तिनको छाला खप्टिन्छ। `diagnostics.html` ले स्रोत भिडियो embed गर्छ (`ffmpeg` चाहिन्छ) र three.js CDN बाट लोड गर्छ, त्यसैले यसको 3D दृश्यलाई इन्टरनेट जडान चाहिन्छ।
+
## आउटपुट
-हरेक `m2mr run` ले **कमान्ड सुरु भएको समय** अनुसार नाम दिइएको डाइरेक्टरी बनाउँछ। root मा रहेका चारवटा फाइल भिडियो र फोटो दुवैका लागि उस्तै हुन्छन्; प्रिभ्यु फोल्डर मात्र फरक हुन्छ।
+हरेक `m2mr run` ले **कमान्ड सुरु भएको समय** अनुसार नाम दिइएको डाइरेक्टरी बनाउँछ। root मा रहेका फाइलहरू भिडियो र फोटो दुवैका लागि उस्तै हुन्छन्; प्रिभ्यु फोल्डर मात्र फरक हुन्छ।
```
outputs/20260829_193205_dance/ # फोटोका लागि …_pose/
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # फोटोका लागि …_po
├── skeleton_motion.npz # मानिसको 3D skeleton (--skeleton सँग पुनः प्रयोग गर्नुहोस्)
├── mixamo_rotations.npz # हड्डी अनुसार Mixamo rotation
├── mixamo_character.glb # skin गरिएको क्यारेक्टर, Blender / Unity मा import गर्नुहोस्
+├── diagnostics.json # self-intersection रिपोर्ट (छिटो सुरुवातको चरण 6 हेर्नुहोस्)
+├── diagnostics.html # `m2mr diagnose <run> --visualize` पछि मात्र
└── videos/ वा images/ # प्रिभ्यु — इनपुटमा भर पर्छ
```
@@ -176,7 +192,7 @@ images/
# दायाँ: rig वरिपरि 10° का दरले orbit (एक पूरा फन्को)
```
-`mixamo_character.glb` लाई Blender मा खोल्नुहोस्: File → Import → glTF 2.0 (.glb/.gltf)। क्यामेरा खाली ठाउँतिर फर्केको छ भने क्यारेक्टरको mesh छानेर View → Frame Selected प्रयोग गर्नुहोस्। टाउको र हातमा देखिने गोलाहरूको झुप्पा हड्डीको display हो, mesh होइन: Outliner मा **Icosphere** र **armature** लुकाउनुहोस्; skin गरिएको mesh देखिने नै राख्नुहोस्। playback स्रोतसँग मिलोस् भनेर scene को FPS र timeline को अन्तिम frame `run.json` (`fps`, `n_frames`) अनुसार सेट गर्नुहोस्। भिडियो run लाई `videos/mixamo_character.mp4` सँग, र फोटो run लाई `images/mixamo_character.png` वा orbit क्लिपसँग तुलना गर्नुहोस्।
+`mixamo_character.glb` लाई Blender मा खोल्नुहोस्: File → Import → glTF 2.0 (.glb/.gltf)। क्यामेरा खाली ठाउँतिर फर्केको छ भने क्यारेक्टरको mesh छानेर View → Frame Selected प्रयोग गर्नुहोस्। टाउको र हातमा देखिने गोलाहरूको झुप्पा हड्डीको display हो, mesh होइन: Outliner मा **Icosphere** र **armature** लुकाउनुहोस्; skin गरिएको mesh देखिने नै राख्नुहोस्। playback स्रोतसँग र frame नम्बर `diagnostics.json` सँग मिलोस् भनेर scene को FPS `run.json` (`fps`) अनुसार र timeline लाई frame 0 देखि `n_frames` − 1 सम्म सेट गर्नुहोस्। भिडियो run लाई `videos/mixamo_character.mp4` सँग, र फोटो run लाई `images/mixamo_character.png` वा orbit क्लिपसँग तुलना गर्नुहोस्।
## लाइसेन्स
@@ -190,3 +206,13 @@ images/
कुनै समस्या आएमा, स्थानीय सेटअप पूरा गर्न सहयोग चाहिएमा, वा सहकार्यबारे कुरा गर्न चाहनुहुन्छ भने यो ठेगानामा इमेल गर्नुहोस्:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.nl.md b/docs/i18n/README.nl.md
index 20365fa..8cd3188 100644
--- a/docs/i18n/README.nl.md
+++ b/docs/i18n/README.nl.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
`--image` zonder pad gebruikt het bestand dat het laatst is toegevoegd aan `assets/image/`.
+### 6. Controleren op zelfdoorsnijding
+
+Elke run controleert het afgewerkte personage ook op **zelfdoorsnijding** — een lichaamsdeel dat in een ander gaat, zoals een hand in het hoofd — en schrijft `diagnostics.json`. De terminal toont één regel, bijv. `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`. De vloer wordt niet gecontroleerd.
+
+Om een run opnieuw te controleren, of om de problemen te bekijken:
+
+```bash
+m2mr diagnose outputs/<run> # diagnostics.json opnieuw schrijven
+m2mr diagnose outputs/<run> --visualize # ook diagnostics.html: bronvideo naast het personage, tijdlijn, klikbare lijst met problemen
+m2mr diagnose outputs/<run> --threshold-cm 2 # alleen doordringingen dieper dan 2 cm melden (standaard 1)
+```
+
+Elk probleem in `diagnostics.json` is een paar lichaamsdelen met de framebereiken waarin ze elkaar doorsnijden, het ergste frame en de diepte daarvan. Framenummers tellen vanaf 0, zoals de tijdlijn van Blender na een glTF-import. Delen die via een gewricht verbonden zijn (bovenarm en onderarm, romp en dij, …) worden niet vergeleken: hun huid overlapt rond het gewricht in elke pose. `diagnostics.html` bevat de bronvideo (vereist `ffmpeg`) en laadt three.js van een CDN, dus de 3D-weergave heeft een internetverbinding nodig.
+
## Uitvoer
-Elke `m2mr run` maakt een map aan die is genoemd naar **het tijdstip waarop het commando startte**. De vier bestanden in de hoofdmap zijn hetzelfde voor video en foto; alleen de previewmap verschilt.
+Elke `m2mr run` maakt een map aan die is genoemd naar **het tijdstip waarop het commando startte**. De bestanden in de hoofdmap zijn hetzelfde voor video en foto; alleen de previewmap verschilt.
```
outputs/20260829_193205_dance/ # of …_pose/ voor een foto
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # of …_pose/ voor een foto
├── skeleton_motion.npz # 3D-skelet van de persoon (hergebruik met --skeleton)
├── mixamo_rotations.npz # Mixamo-rotaties per bot
├── mixamo_character.glb # geskind personage, te importeren in Blender / Unity
+├── diagnostics.json # rapport over zelfdoorsnijding (zie Snel aan de slag, stap 6)
+├── diagnostics.html # alleen na `m2mr diagnose <run> --visualize`
└── videos/ of images/ # previews — afhankelijk van de invoer
```
@@ -176,7 +192,7 @@ images/
# rechts: orbit rond de rig in stappen van 10° (één volledige rondgang)
```
-Open `mixamo_character.glb` in Blender: File → Import → glTF 2.0 (.glb/.gltf). Als de camera op een lege ruimte gericht is, selecteer dan de mesh van het personage en gebruik View → Frame Selected. Het cluster bollen op het hoofd en de handen is de weergave van de botten, niet de mesh: verberg in de Outliner **Icosphere** en de **armature**; laat de geskinde mesh zichtbaar. Stel de FPS van de scène en het laatste frame van de tijdlijn in op basis van `run.json` (`fps`, `n_frames`), zodat het afspelen overeenkomt met de bron. Vergelijk een videorun met `videos/mixamo_character.mp4`, een fotorun met `images/mixamo_character.png` of de orbitclip.
+Open `mixamo_character.glb` in Blender: File → Import → glTF 2.0 (.glb/.gltf). Als de camera op een lege ruimte gericht is, selecteer dan de mesh van het personage en gebruik View → Frame Selected. Het cluster bollen op het hoofd en de handen is de weergave van de botten, niet de mesh: verberg in de Outliner **Icosphere** en de **armature**; laat de geskinde mesh zichtbaar. Stel de FPS van de scène in op basis van `run.json` (`fps`) en de tijdlijn op frames 0 tot en met `n_frames` − 1, zodat het afspelen overeenkomt met de bron en de framenummers met `diagnostics.json`. Vergelijk een videorun met `videos/mixamo_character.mp4`, een fotorun met `images/mixamo_character.png` of de orbitclip.
## Licentie
@@ -190,3 +206,13 @@ De code van deze repository valt onder Apache-2.0. De assets die je zelf downloa
Loop je tegen een probleem aan, heb je hulp nodig bij een lokale installatie of wil je praten over samenwerking, stuur dan een e-mail naar:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.pl.md b/docs/i18n/README.pl.md
index 9cf1499..d3756f0 100644
--- a/docs/i18n/README.pl.md
+++ b/docs/i18n/README.pl.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
`--image` bez ścieżki używa pliku ostatnio dodanego do `assets/image/`.
+### 6. Sprawdzanie samoprzenikania
+
+Każde uruchomienie sprawdza też gotową postać pod kątem **samoprzenikania** — gdy jedna część ciała wchodzi w inną, np. dłoń w głowę — i zapisuje `diagnostics.json`. Terminal wypisuje jedną linię, np. `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`. Podłoga nie jest sprawdzana.
+
+Aby ponownie sprawdzić uruchomienie albo zobaczyć problemy:
+
+```bash
+m2mr diagnose outputs/<run> # zapisz ponownie diagnostics.json
+m2mr diagnose outputs/<run> --visualize # także diagnostics.html: wideo źródłowe obok postaci, oś czasu, klikalna lista problemów
+m2mr diagnose outputs/<run> --threshold-cm 2 # zgłaszaj tylko przenikania głębsze niż 2 cm (domyślnie 1)
+```
+
+Każdy problem w `diagnostics.json` to para części ciała z zakresami klatek, w których się przenikają, najgorszą klatką i jej głębokością. Numery klatek liczone są od 0, tak jak na osi czasu Blendera po imporcie glTF. Części połączone stawem (ramię i przedramię, tułów i udo, …) nie są porównywane: ich skóra nachodzi na siebie przy stawie w każdej pozie. `diagnostics.html` osadza wideo źródłowe (wymaga `ffmpeg`) i wczytuje three.js z CDN, więc widok 3D wymaga połączenia z internetem.
+
## Wyniki
-Każde `m2mr run` tworzy katalog nazwany według **czasu uruchomienia polecenia**. Cztery pliki w katalogu głównym są takie same dla wideo i zdjęcia; zmienia się tylko folder z podglądem.
+Każde `m2mr run` tworzy katalog nazwany według **czasu uruchomienia polecenia**. Pliki w katalogu głównym są takie same dla wideo i zdjęcia; zmienia się tylko folder z podglądem.
```
outputs/20260829_193205_dance/ # lub …_pose/ dla zdjęcia
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # lub …_pose/ dla zdjęcia
├── skeleton_motion.npz # szkielet 3D człowieka (do ponownego użycia z --skeleton)
├── mixamo_rotations.npz # rotacje Mixamo dla każdej kości
├── mixamo_character.glb # postać ze skinningiem, do importu w Blenderze / Unity
+├── diagnostics.json # raport samoprzenikania (zob. Szybki start, krok 6)
+├── diagnostics.html # tylko po `m2mr diagnose <run> --visualize`
└── videos/ lub images/ # podglądy — zależnie od wejścia
```
@@ -176,7 +192,7 @@ images/
# prawo: obrót wokół riga co 10° (pełny obrót)
```
-Otwórz `mixamo_character.glb` w Blenderze: File → Import → glTF 2.0 (.glb/.gltf). Jeśli kamera patrzy w pustą przestrzeń, zaznacz mesh postaci i użyj View → Frame Selected. Skupisko kul na głowie i dłoniach to wyświetlanie kości, a nie mesh: w Outlinerze ukryj **Icosphere** i **armature**; pozostaw widoczny mesh ze skinningiem. Ustaw FPS sceny i ostatnią klatkę osi czasu zgodnie z `run.json` (`fps`, `n_frames`), aby odtwarzanie odpowiadało źródłu. Porównaj uruchomienie z wideo z `videos/mixamo_character.mp4`, a uruchomienie ze zdjęcia z `images/mixamo_character.png` lub klipem z obrotem.
+Otwórz `mixamo_character.glb` w Blenderze: File → Import → glTF 2.0 (.glb/.gltf). Jeśli kamera patrzy w pustą przestrzeń, zaznacz mesh postaci i użyj View → Frame Selected. Skupisko kul na głowie i dłoniach to wyświetlanie kości, a nie mesh: w Outlinerze ukryj **Icosphere** i **armature**; pozostaw widoczny mesh ze skinningiem. Ustaw FPS sceny zgodnie z `run.json` (`fps`), a oś czasu na klatki od 0 do `n_frames` − 1, aby odtwarzanie odpowiadało źródłu, a numery klatek — plikowi `diagnostics.json`. Porównaj uruchomienie z wideo z `videos/mixamo_character.mp4`, a uruchomienie ze zdjęcia z `images/mixamo_character.png` lub klipem z obrotem.
## Licencja
@@ -190,3 +206,13 @@ Kod tego repozytorium jest objęty licencją Apache-2.0. Zasoby, które pobieras
Jeśli napotkasz problem, potrzebujesz pomocy w lokalnej instalacji albo chcesz porozmawiać o współpracy, napisz na adres:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.ru.md b/docs/i18n/README.ru.md
index dafff82..06e11d9 100644
--- a/docs/i18n/README.ru.md
+++ b/docs/i18n/README.ru.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
`--image` без пути берёт файл, последним положенный в `assets/image/`.
+### 6. Проверка самопересечений
+
+Каждый запуск также проверяет готового персонажа на **самопересечения** — когда одна часть тела входит в другую, например рука в голову, — и записывает `diagnostics.json`. В терминал выводится одна строка, например `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`. Пол не проверяется.
+
+Чтобы перепроверить запуск или посмотреть на проблемы:
+
+```bash
+m2mr diagnose outputs/<run> # перезаписать diagnostics.json
+m2mr diagnose outputs/<run> --visualize # плюс diagnostics.html: исходное видео рядом с персонажем, таймлайн, кликабельный список проблем
+m2mr diagnose outputs/<run> --threshold-cm 2 # сообщать только о проникновениях глубже 2 см (по умолчанию 1)
+```
+
+Каждая проблема в `diagnostics.json` — это пара частей тела с диапазонами кадров, где они пересекаются, худшим кадром и его глубиной. Кадры нумеруются с 0, как на таймлайне Blender после импорта glTF. Части, соединённые суставом (плечо и предплечье, торс и бедро, …), не сравниваются: их кожа у сустава перекрывается в любой позе. `diagnostics.html` встраивает исходное видео (нужен `ffmpeg`) и загружает three.js с CDN, поэтому для 3D-вида нужен интернет.
+
## Результаты
-Каждый `m2mr run` создаёт каталог по **времени старта команды**. Четыре файла в корне одинаковы для видео и фото; меняется только папка превью.
+Каждый `m2mr run` создаёт каталог по **времени старта команды**. Файлы в корне одинаковы для видео и фото; меняется только папка превью.
```
outputs/20260829_193205_dance/ # для фото: …_pose/
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # для фото: …_pose/
├── skeleton_motion.npz # 3D-скелет человека (повторно с --skeleton)
├── mixamo_rotations.npz # вращения костей Mixamo
├── mixamo_character.glb # персонаж со скином, импорт в Blender / Unity
+├── diagnostics.json # отчёт о самопересечениях (см. шаг 6 «Быстрого старта»)
+├── diagnostics.html # только после `m2mr diagnose <run> --visualize`
└── videos/ или images/ # превью — зависит от входа
```
@@ -176,7 +192,7 @@ images/
# справа: орбита 10° вокруг рига (полный оборот)
```
-`mixamo_character.glb` в Blender: File → Import → glTF 2.0 (.glb/.gltf). Если камера смотрит в пустоту, выберите меш персонажа и View → Frame Selected. Скопление сфер на голове и руках — отображение костей, не меш: в Outliner спрячьте **Icosphere** и **armature**, оставьте видимым меш со скином. FPS сцены и конечный кадр таймлайна возьмите из `run.json` (`fps`, `n_frames`), чтобы длительность совпала с исходником. Видео-запуск сверяйте с `videos/mixamo_character.mp4`, фото-запуск — с `images/mixamo_character.png` или клипом орбиты.
+`mixamo_character.glb` в Blender: File → Import → glTF 2.0 (.glb/.gltf). Если камера смотрит в пустоту, выберите меш персонажа и View → Frame Selected. Скопление сфер на голове и руках — отображение костей, не меш: в Outliner спрячьте **Icosphere** и **armature**, оставьте видимым меш со скином. FPS сцены возьмите из `run.json` (`fps`), а таймлайн задайте с кадра 0 по `n_frames` − 1, чтобы длительность совпала с исходником, а номера кадров — с `diagnostics.json`. Видео-запуск сверяйте с `videos/mixamo_character.mp4`, фото-запуск — с `images/mixamo_character.png` или клипом орбиты.
## Лицензия
@@ -190,3 +206,13 @@ images/
Если возникла проблема, нужна помощь с локальной установкой или вы хотите обсудить сотрудничество, напишите на:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.th.md b/docs/i18n/README.th.md
index 88b3fc6..2356180 100644
--- a/docs/i18n/README.th.md
+++ b/docs/i18n/README.th.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
ถ้าใส่ `--image` โดยไม่ระบุพาธ จะใช้ไฟล์ที่เพิ่มล่าสุดใน `assets/image/`
+### 6. ตรวจการทะลุกันเอง
+
+ทุกการรันจะตรวจตัวละครที่ได้ว่ามี **การทะลุกันเอง** หรือไม่ — คือส่วนหนึ่งของร่างกายเข้าไปอยู่ในอีกส่วน เช่น มืออยู่ในหัว — แล้วเขียน `diagnostics.json` เทอร์มินัลจะพิมพ์หนึ่งบรรทัด เช่น `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm` ไม่ได้ตรวจพื้น
+
+หากต้องการตรวจการรันซ้ำ หรือดูว่าปัญหาอยู่ตรงไหน:
+
+```bash
+m2mr diagnose outputs/<run> # เขียน diagnostics.json ใหม่
+m2mr diagnose outputs/<run> --visualize # สร้าง diagnostics.html ด้วย: วิดีโอต้นฉบับข้างตัวละคร, timeline, รายการปัญหาที่คลิกได้
+m2mr diagnose outputs/<run> --threshold-cm 2 # รายงานเฉพาะการทะลุที่ลึกกว่า 2 cm (ค่าเริ่มต้น 1)
+```
+
+แต่ละปัญหาใน `diagnostics.json` คือคู่ส่วนของร่างกาย พร้อมช่วงเฟรมที่ทะลุกัน เฟรมที่หนักที่สุด และความลึก หมายเลขเฟรมนับจาก 0 เหมือน timeline ของ Blender หลังนำเข้า glTF ส่วนที่ต่อกันด้วยข้อต่อ (ต้นแขนกับปลายแขน ลำตัวกับต้นขา …) จะไม่ถูกเปรียบเทียบ เพราะผิวบริเวณข้อต่อซ้อนกันในทุกท่า `diagnostics.html` ฝังวิดีโอต้นฉบับไว้ (ต้องมี `ffmpeg`) และโหลด three.js จาก CDN ดังนั้นมุมมอง 3D ต้องเชื่อมต่ออินเทอร์เน็ต
+
## ผลลัพธ์
-การรัน `m2mr run` แต่ละครั้งจะสร้างไดเรกทอรีที่ตั้งชื่อตาม **เวลาที่คำสั่งเริ่มทำงาน** ไฟล์สี่ไฟล์ที่ระดับบนสุดเหมือนกันทั้งวิดีโอและภาพนิ่ง มีเพียงโฟลเดอร์พรีวิวที่ต่างกัน
+การรัน `m2mr run` แต่ละครั้งจะสร้างไดเรกทอรีที่ตั้งชื่อตาม **เวลาที่คำสั่งเริ่มทำงาน** ไฟล์ที่ระดับบนสุดเหมือนกันทั้งวิดีโอและภาพนิ่ง มีเพียงโฟลเดอร์พรีวิวที่ต่างกัน
```
outputs/20260829_193205_dance/ # หรือ …_pose/ สำหรับภาพนิ่ง
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # หรือ …_pose/ สำหรั
├── skeleton_motion.npz # skeleton 3D ของคน (ใช้ซ้ำด้วย --skeleton)
├── mixamo_rotations.npz # การหมุนของ Mixamo แยกตามกระดูก
├── mixamo_character.glb # ตัวละครที่ skin แล้ว นำเข้า Blender / Unity
+├── diagnostics.json # รายงานการทะลุกันเอง (ดูขั้นตอนที่ 6 ในเริ่มต้นอย่างรวดเร็ว)
+├── diagnostics.html # มีเฉพาะหลัง `m2mr diagnose <run> --visualize`
└── videos/ หรือ images/ # พรีวิว — ขึ้นกับอินพุต
```
@@ -176,7 +192,7 @@ images/
# ขวา: หมุนรอบ rig ทีละ 10° (ครบหนึ่งรอบ)
```
-เปิด `mixamo_character.glb` ใน Blender: File → Import → glTF 2.0 (.glb/.gltf) ถ้ากล้องหันไปที่พื้นที่ว่าง ให้เลือก mesh ของตัวละครแล้วใช้ View → Frame Selected กลุ่มทรงกลมที่หัวและมือคือการแสดงกระดูก ไม่ใช่ mesh: ใน Outliner ให้ซ่อน **Icosphere** และ **armature** แล้วปล่อยให้ mesh ที่ skin แล้วยังมองเห็นอยู่ ตั้งค่า FPS ของ scene และเฟรมสุดท้ายของ timeline ตาม `run.json` (`fps`, `n_frames`) เพื่อให้การเล่นตรงกับต้นฉบับ เปรียบเทียบการรันด้วยวิดีโอกับ `videos/mixamo_character.mp4` และการรันด้วยภาพนิ่งกับ `images/mixamo_character.png` หรือคลิปหมุนรอบ
+เปิด `mixamo_character.glb` ใน Blender: File → Import → glTF 2.0 (.glb/.gltf) ถ้ากล้องหันไปที่พื้นที่ว่าง ให้เลือก mesh ของตัวละครแล้วใช้ View → Frame Selected กลุ่มทรงกลมที่หัวและมือคือการแสดงกระดูก ไม่ใช่ mesh: ใน Outliner ให้ซ่อน **Icosphere** และ **armature** แล้วปล่อยให้ mesh ที่ skin แล้วยังมองเห็นอยู่ ตั้งค่า FPS ของ scene ตาม `run.json` (`fps`) และตั้ง timeline เป็นเฟรม 0 ถึง `n_frames` − 1 เพื่อให้การเล่นตรงกับต้นฉบับและหมายเลขเฟรมตรงกับ `diagnostics.json` เปรียบเทียบการรันด้วยวิดีโอกับ `videos/mixamo_character.mp4` และการรันด้วยภาพนิ่งกับ `images/mixamo_character.png` หรือคลิปหมุนรอบ
## สัญญาอนุญาต
@@ -190,3 +206,13 @@ images/
หากพบปัญหา ต้องการความช่วยเหลือในการตั้งค่าบนเครื่อง หรืออยากพูดคุยเรื่องความร่วมมือ ส่งอีเมลมาที่:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.tr.md b/docs/i18n/README.tr.md
index a51f71e..150e986 100644
--- a/docs/i18n/README.tr.md
+++ b/docs/i18n/README.tr.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
Yol verilmeden kullanılan `--image`, `assets/image/` içine en son eklenen dosyayı kullanır.
+### 6. Kendi içine geçmeyi kontrol edin
+
+Her çalıştırma, bitmiş karakterde **kendi içine geçme** olup olmadığını da kontrol eder — bir vücut parçasının diğerinin içine girmesi, örneğin elin başın içine girmesi — ve `diagnostics.json` yazar. Terminal tek bir satır yazdırır, örn. `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`. Zemin kontrol edilmez.
+
+Bir çalıştırmayı yeniden kontrol etmek veya sorunları görmek için:
+
+```bash
+m2mr diagnose outputs/<run> # diagnostics.json'u yeniden yazar
+m2mr diagnose outputs/<run> --visualize # ayrıca diagnostics.html: karakterin yanında kaynak video, timeline, tıklanabilir sorun listesi
+m2mr diagnose outputs/<run> --threshold-cm 2 # yalnızca 2 cm'den derin geçmeleri raporlar (varsayılan 1)
+```
+
+`diagnostics.json` içindeki her sorun bir vücut parçası çiftidir; iç içe geçtikleri kare aralıklarını, en kötü kareyi ve onun derinliğini içerir. Kare numaraları, glTF içe aktarımından sonraki Blender timeline'ı gibi 0'dan başlar. Bir eklemle bağlı parçalar (üst kol ve ön kol, gövde ve uyluk, …) karşılaştırılmaz: derileri her pozda eklem çevresinde üst üste biner. `diagnostics.html` kaynak videoyu gömer (`ffmpeg` gerekir) ve three.js'i bir CDN'den yükler; bu yüzden 3D görünümü internet bağlantısı ister.
+
## Çıktılar
-Her `m2mr run`, **komutun başladığı zamana** göre adlandırılmış bir dizin oluşturur. Kök dizindeki dört dosya video ve fotoğraf için aynıdır; yalnızca önizleme klasörü değişir.
+Her `m2mr run`, **komutun başladığı zamana** göre adlandırılmış bir dizin oluşturur. Kök dizindeki dosyalar video ve fotoğraf için aynıdır; yalnızca önizleme klasörü değişir.
```
outputs/20260829_193205_dance/ # fotoğraf için …_pose/
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # fotoğraf için …_pose/
├── skeleton_motion.npz # 3D insan iskeleti (--skeleton ile yeniden kullanın)
├── mixamo_rotations.npz # kemik başına Mixamo rotasyonları
├── mixamo_character.glb # skin'lenmiş karakter, Blender / Unity'ye aktarın
+├── diagnostics.json # kendi içine geçme raporu (Hızlı Başlangıç adım 6'ya bakın)
+├── diagnostics.html # yalnızca `m2mr diagnose <run> --visualize` sonrasında
└── videos/ veya images/ # önizlemeler — girdiye göre
```
@@ -176,7 +192,7 @@ images/
# sağ: rig etrafında 10°'lik adımlarla yörünge (tam bir tur)
```
-`mixamo_character.glb` dosyasını Blender'da açın: File → Import → glTF 2.0 (.glb/.gltf). Kamera boş bir alana bakıyorsa karakter mesh'ini seçip View → Frame Selected kullanın. Baş ve ellerdeki küre kümesi kemik gösterimidir, mesh değildir: Outliner'da **Icosphere** ve **armature**'ü gizleyin; skin'lenmiş mesh'i görünür bırakın. Oynatmanın kaynakla eşleşmesi için sahnenin FPS'ini ve timeline'ın son karesini `run.json` (`fps`, `n_frames`) değerlerine göre ayarlayın. Bir video çalıştırmasını `videos/mixamo_character.mp4` ile, bir fotoğraf çalıştırmasını `images/mixamo_character.png` ya da yörünge klibiyle karşılaştırın.
+`mixamo_character.glb` dosyasını Blender'da açın: File → Import → glTF 2.0 (.glb/.gltf). Kamera boş bir alana bakıyorsa karakter mesh'ini seçip View → Frame Selected kullanın. Baş ve ellerdeki küre kümesi kemik gösterimidir, mesh değildir: Outliner'da **Icosphere** ve **armature**'ü gizleyin; skin'lenmiş mesh'i görünür bırakın. Oynatmanın kaynakla, kare numaralarının da `diagnostics.json` ile eşleşmesi için sahnenin FPS'ini `run.json` (`fps`) değerine, timeline'ı da 0 ile `n_frames` − 1 arasındaki karelere ayarlayın. Bir video çalıştırmasını `videos/mixamo_character.mp4` ile, bir fotoğraf çalıştırmasını `images/mixamo_character.png` ya da yörünge klibiyle karşılaştırın.
## Lisans
@@ -190,3 +206,13 @@ Bu deponun kodu Apache-2.0 lisanslıdır. Kendi indirdiğiniz varlıkların kend
Bir sorunla karşılaşırsanız, yerel kurulumu tamamlamak için yardıma ihtiyacınız olursa ya da iş birliği hakkında konuşmak isterseniz şu adrese e-posta gönderin:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.vi.md b/docs/i18n/README.vi.md
index 09099d3..1da4174 100644
--- a/docs/i18n/README.vi.md
+++ b/docs/i18n/README.vi.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
`--image` không kèm đường dẫn sẽ dùng tệp được thêm vào gần nhất trong `assets/image/`.
+### 6. Kiểm tra tự giao cắt
+
+Mỗi lần chạy còn kiểm tra nhân vật hoàn chỉnh xem có **tự giao cắt** không — một bộ phận cơ thể đi vào bộ phận khác, như tay nằm trong đầu — và ghi `diagnostics.json`. Terminal in ra một dòng, ví dụ `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`. Sàn không được kiểm tra.
+
+Để kiểm tra lại một lần chạy, hoặc để xem các vấn đề:
+
+```bash
+m2mr diagnose outputs/<run> # ghi lại diagnostics.json
+m2mr diagnose outputs/<run> --visualize # thêm diagnostics.html: video nguồn cạnh nhân vật, timeline, danh sách vấn đề có thể bấm
+m2mr diagnose outputs/<run> --threshold-cm 2 # chỉ báo các chỗ xuyên sâu hơn 2 cm (mặc định 1)
+```
+
+Mỗi vấn đề trong `diagnostics.json` là một cặp bộ phận cơ thể, kèm các khoảng khung hình mà chúng giao cắt, khung hình tệ nhất và độ sâu của nó. Số khung hình đếm từ 0, giống timeline của Blender sau khi nhập glTF. Các bộ phận nối với nhau bằng khớp (cánh tay trên và cẳng tay, thân và đùi, …) không được so sánh: da của chúng chồng lên nhau quanh khớp ở mọi tư thế. `diagnostics.html` nhúng video nguồn (cần `ffmpeg`) và tải three.js từ CDN, nên chế độ xem 3D cần kết nối internet.
+
## Đầu ra
-Mỗi lần `m2mr run` tạo một thư mục được đặt tên theo **thời điểm lệnh bắt đầu**. Bốn tệp ở thư mục gốc giống nhau cho video và ảnh tĩnh; chỉ thư mục xem trước là khác.
+Mỗi lần `m2mr run` tạo một thư mục được đặt tên theo **thời điểm lệnh bắt đầu**. Các tệp ở thư mục gốc giống nhau cho video và ảnh tĩnh; chỉ thư mục xem trước là khác.
```
outputs/20260829_193205_dance/ # hoặc …_pose/ với ảnh tĩnh
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # hoặc …_pose/ với ảnh tĩnh
├── skeleton_motion.npz # khung xương người 3D (dùng lại với --skeleton)
├── mixamo_rotations.npz # góc xoay Mixamo theo từng xương
├── mixamo_character.glb # nhân vật đã skin, nhập vào Blender / Unity
+├── diagnostics.json # báo cáo tự giao cắt (xem bước 6 của Bắt đầu nhanh)
+├── diagnostics.html # chỉ có sau `m2mr diagnose <run> --visualize`
└── videos/ hoặc images/ # bản xem trước — tùy theo đầu vào
```
@@ -176,7 +192,7 @@ images/
# phải: quay quanh rig mỗi bước 10° (trọn một vòng)
```
-Mở `mixamo_character.glb` trong Blender: File → Import → glTF 2.0 (.glb/.gltf). Nếu camera đang hướng vào khoảng trống, hãy chọn mesh nhân vật rồi dùng View → Frame Selected. Cụm hình cầu trên đầu và tay là phần hiển thị xương, không phải mesh: trong Outliner, ẩn **Icosphere** và **armature**; giữ mesh đã skin ở trạng thái hiển thị. Đặt FPS của scene và khung hình cuối của timeline theo `run.json` (`fps`, `n_frames`) để phát lại khớp với nguồn. So sánh lần chạy video với `videos/mixamo_character.mp4`, lần chạy ảnh tĩnh với `images/mixamo_character.png` hoặc đoạn quay quanh.
+Mở `mixamo_character.glb` trong Blender: File → Import → glTF 2.0 (.glb/.gltf). Nếu camera đang hướng vào khoảng trống, hãy chọn mesh nhân vật rồi dùng View → Frame Selected. Cụm hình cầu trên đầu và tay là phần hiển thị xương, không phải mesh: trong Outliner, ẩn **Icosphere** và **armature**; giữ mesh đã skin ở trạng thái hiển thị. Đặt FPS của scene theo `run.json` (`fps`) và timeline từ khung hình 0 đến `n_frames` − 1 để phát lại khớp với nguồn và số khung hình khớp với `diagnostics.json`. So sánh lần chạy video với `videos/mixamo_character.mp4`, lần chạy ảnh tĩnh với `images/mixamo_character.png` hoặc đoạn quay quanh.
## Giấy phép
@@ -190,3 +206,13 @@ Mã nguồn của kho này theo giấy phép Apache-2.0. Các tài nguyên bạn
Nếu bạn gặp vấn đề, cần hỗ trợ hoàn tất cài đặt cục bộ, hoặc muốn trao đổi về hợp tác, hãy gửi email tới:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.zh-Hans.md b/docs/i18n/README.zh-Hans.md
index c41d712..9872b29 100644
--- a/docs/i18n/README.zh-Hans.md
+++ b/docs/i18n/README.zh-Hans.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
`--image` 不带路径时,用 `assets/image/` 里最后放进去的那一张。
+### 6. 检查穿模
+
+每次运行还会检查生成的角色有没有**穿模**——一个身体部位插进另一个部位里,比如手插进了头——并写出 `diagnostics.json`。终端会打印一行,例如 `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`。不检查和地面的穿插。
+
+想重新检查某次运行,或者直观地看问题在哪:
+
+```bash
+m2mr diagnose outputs/<run> # 重写 diagnostics.json
+m2mr diagnose outputs/<run> --visualize # 另外生成 diagnostics.html:原视频和角色并排、时间轴、可点击的问题列表
+m2mr diagnose outputs/<run> --threshold-cm 2 # 只报告深于 2 cm 的穿插(默认 1)
+```
+
+`diagnostics.json` 里每个问题是一对身体部位,附带它们穿插的帧范围、最严重的一帧和深度。帧号从 0 开始,和 glTF 导入 Blender 后的时间轴一致。由关节连着的部位(上臂和前臂、躯干和大腿……)不互相比较:无论什么姿势,关节附近的皮肤都会重叠。`diagnostics.html` 会嵌入原视频(需要 `ffmpeg`),three.js 从 CDN 加载,所以 3D 视图需要联网。
+
## 输出
-每次 `m2mr run` 按**命令启动时间**新建一个目录。根目录那四个文件视频和照片都一样,只有预览文件夹会变。
+每次 `m2mr run` 按**命令启动时间**新建一个目录。根目录的文件视频和照片都一样,只有预览文件夹会变。
```
outputs/20260829_193205_dance/ # 照片 run 则是 …_pose/
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # 照片 run 则是 …_pose/
├── skeleton_motion.npz # 人体 3D 骨架(可用 --skeleton 复用)
├── mixamo_rotations.npz # Mixamo 骨骼逐帧旋转
├── mixamo_character.glb # 带皮角色,Blender / Unity 可导入
+├── diagnostics.json # 穿模报告(见 Quick Start 第 6 步)
+├── diagnostics.html # 只在运行 `m2mr diagnose <run> --visualize` 之后才有
└── videos/ 或 images/ # 预览 — 取决于这次输入是视频还是照片
```
@@ -176,7 +192,7 @@ images/
# 右:10° 俯视绕角色转一圈
```
-`mixamo_character.glb` 用 Blender 打开:File → Import → glTF 2.0 (.glb/.gltf)。导入后若镜头对不准,选中角色网格,再 View → Frame Selected。头和手上那堆球是骨头的显示形状,不是模型:在 Outliner 里隐藏 **Icosphere** 和骨架(armature),留下带皮网格。时间轴 FPS 和结束帧按 `run.json` 里的 `fps` / `n_frames` 设置,播放才会和原片一样长。视频 run 对照 `videos/mixamo_character.mp4`,照片 run 对照 `images/mixamo_character.png` 或那条绕转视频。
+`mixamo_character.glb` 用 Blender 打开:File → Import → glTF 2.0 (.glb/.gltf)。导入后若镜头对不准,选中角色网格,再 View → Frame Selected。头和手上那堆球是骨头的显示形状,不是模型:在 Outliner 里隐藏 **Icosphere** 和骨架(armature),留下带皮网格。场景 FPS 按 `run.json` 里的 `fps` 设置,时间轴设为第 0 帧到第 `n_frames` − 1 帧,这样播放才会和原片一样长,帧号也和 `diagnostics.json` 对得上。视频 run 对照 `videos/mixamo_character.mp4`,照片 run 对照 `images/mixamo_character.png` 或那条绕转视频。
## 许可证
@@ -190,3 +206,13 @@ images/
若使用中遇到问题、需要协助完成本地部署,或希望洽谈合作,欢迎通过邮箱联系我:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/README.zh-Hant.md b/docs/i18n/README.zh-Hant.md
index 6269f8b..c3d0a50 100644
--- a/docs/i18n/README.zh-Hant.md
+++ b/docs/i18n/README.zh-Hant.md
@@ -139,9 +139,23 @@ m2mr run --image assets/image/pose.jpg --rig assets/mixamo/Vampire.fbx
`--image` 不加路徑時,會使用 `assets/image/` 中最後放進去的那一張。
+### 6. 檢查穿模
+
+每次執行還會檢查產生的角色有沒有**穿模**——一個身體部位穿進另一個部位,例如手穿進頭裡——並寫出 `diagnostics.json`。終端機會印出一行,例如 `diagnostics: 14 self-intersection(s) over 116 of 719 frames, deepest 7.87 cm`。不檢查與地面的穿插。
+
+想重新檢查某次執行,或直接看問題在哪裡:
+
+```bash
+m2mr diagnose outputs/<run> # 重寫 diagnostics.json
+m2mr diagnose outputs/<run> --visualize # 另外產生 diagnostics.html:原始影片與角色並排、時間軸、可點選的問題清單
+m2mr diagnose outputs/<run> --threshold-cm 2 # 只回報深度超過 2 cm 的穿插(預設 1)
+```
+
+`diagnostics.json` 中每個問題是一對身體部位,附上兩者穿插的影格範圍、最嚴重的影格及其深度。影格編號從 0 開始,與 glTF 匯入 Blender 後的時間軸一致。以關節相連的部位(上臂與前臂、軀幹與大腿……)不互相比較:不論什麼姿勢,關節附近的皮膚都會重疊。`diagnostics.html` 會嵌入原始影片(需要 `ffmpeg`),並從 CDN 載入 three.js,因此 3D 檢視需要網路連線。
+
## 輸出
-每次執行 `m2mr run` 都會依**指令開始執行的時間**建立一個新目錄。根目錄的四個檔案在影片和照片輸入時都相同,只有預覽資料夾會不同。
+每次執行 `m2mr run` 都會依**指令開始執行的時間**建立一個新目錄。根目錄的檔案在影片和照片輸入時都相同,只有預覽資料夾會不同。
```
outputs/20260829_193205_dance/ # 照片執行則是 …_pose/
@@ -149,6 +163,8 @@ outputs/20260829_193205_dance/ # 照片執行則是 …_pose/
├── skeleton_motion.npz # 人體 3D 骨架(可用 --skeleton 重複利用)
├── mixamo_rotations.npz # Mixamo 每根骨骼的旋轉
├── mixamo_character.glb # 已蒙皮角色,可匯入 Blender / Unity
+├── diagnostics.json # 穿模報告(見快速開始第 6 步)
+├── diagnostics.html # 只有執行 `m2mr diagnose <run> --visualize` 之後才有
└── videos/ 或 images/ # 預覽 — 取決於這次輸入的是影片還是照片
```
@@ -176,7 +192,7 @@ images/
# 右:每 10° 環繞角色一圈
```
-用 Blender 開啟 `mixamo_character.glb`:File → Import → glTF 2.0 (.glb/.gltf)。匯入後如果鏡頭沒有對準角色,請選取角色網格,再使用 View → Frame Selected。頭部和手上那一堆球是骨骼的顯示形狀,不是模型本身:在 Outliner 中隱藏 **Icosphere** 和骨架(armature),保留已蒙皮的網格。時間軸的 FPS 和結束影格請依照 `run.json` 中的 `fps` / `n_frames` 設定,播放長度才會和原始影片一致。影片執行請對照 `videos/mixamo_character.mp4`,照片執行請對照 `images/mixamo_character.png` 或那段環繞影片。
+用 Blender 開啟 `mixamo_character.glb`:File → Import → glTF 2.0 (.glb/.gltf)。匯入後如果鏡頭沒有對準角色,請選取角色網格,再使用 View → Frame Selected。頭部和手上那一堆球是骨骼的顯示形狀,不是模型本身:在 Outliner 中隱藏 **Icosphere** 和骨架(armature),保留已蒙皮的網格。場景 FPS 請依照 `run.json` 中的 `fps` 設定,時間軸設為第 0 影格到第 `n_frames` − 1 影格,播放長度才會和原始影片一致,影格編號也才會和 `diagnostics.json` 對得上。影片執行請對照 `videos/mixamo_character.mp4`,照片執行請對照 `images/mixamo_character.png` 或那段環繞影片。
## 授權
@@ -190,3 +206,13 @@ images/
如果在使用中遇到問題、需要協助完成本機環境建置,或希望洽談合作,歡迎透過電子郵件與我聯絡:
+
+## Star History
+
+<a href="https://star-history.com/#MaxLiu22/Motion2MixamoRig&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date&theme=dark" />
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=MaxLiu22/Motion2MixamoRig&type=Date" />
+ </picture>
+</a>
diff --git a/docs/i18n/user-guide.ar.md b/docs/i18n/user-guide.ar.md
index e7d63e8..9c6ec45 100644
--- a/docs/i18n/user-guide.ar.md
+++ b/docs/i18n/user-guide.ar.md
@@ -126,6 +126,13 @@ SMPL-X نموذج جسم مجاني تحتاج إليه الإضافة. رخصت
- **التقدم / النتيجة** (Progress / Result): التقدم، وأحدث سطور السجل، وبعد انتهاء المهمة
**استيراد الشخصية المولَّدة** (Import Generated Character)، و**فتح مجلد الناتج** (Open Output Folder)،
و**عرض السجل الكامل** (View Full Log).
+- **التشخيص** (Diagnostics): المواضع التي تدخل فيها أجزاء جسم الشخصية بعضها في
+ بعض (يد داخل الرأس، ذراعان متشابكتان). الخلايا الحمراء في الشريط إطارات فيها
+ مشكلة؛ انقر إحداها للانتقال إليها. يتبع المثلث أسفل الشريط الإطار الحالي،
+ وتحته الأجزاء المتداخلة ومدى عمقها. ينتقل **السابق** / **التالي** (Previous
+ / Next) بين المشكلات. يفتح **فتح تقرير HTML** (Open HTML Report) تقريرًا في
+ متصفح الويب يعرض الفيديو المصدر بجانب الشخصية (يستغرق إنشاؤه في المرة الأولى
+ نحو 15 ثانية).
تتحدث الإضافة 18 لغة. **تلقائي** (Auto) يتبع لغة Blender؛ غيّره في مربع
**إعداد** ضمن **لغة الواجهة** (UI Language).
diff --git a/docs/i18n/user-guide.de.md b/docs/i18n/user-guide.de.md
index 2a88345..557f364 100644
--- a/docs/i18n/user-guide.de.md
+++ b/docs/i18n/user-guide.de.md
@@ -129,6 +129,14 @@ es schnell. Deine installierte Version steht neben dem Add-on in **Get Extension
- **Fortschritt / Ergebnis** (Progress / Result): Fortschritt, aktuelles Log und nach einem Auftrag
**Erzeugten Charakter importieren** (Import Generated Character), **Ausgabeordner öffnen** (Open Output Folder),
**Vollständiges Protokoll** (View Full Log).
+- **Diagnose** (Diagnostics): Stellen, an denen Körperteile des Charakters
+ ineinander stecken (eine Hand im Kopf, verschränkte Arme). Rote Zellen im
+ Balken sind Frames mit einem Problem; ein Klick springt dorthin. Das Dreieck
+ unter dem Balken folgt dem aktuellen Frame, darunter stehen die betroffenen
+ Teile und wie tief sie ineinander stecken. **Zurück** / **Weiter** (Previous
+ / Next) springen zwischen den Problemen. **HTML-Bericht öffnen** (Open HTML
+ Report) öffnet im Webbrowser einen Bericht mit dem Quellvideo neben dem
+ Charakter (beim ersten Mal dauert das Erstellen etwa 15 Sekunden).
Das Add-on spricht 18 Sprachen. **Automatisch (Blender / System)** (Auto) folgt der Sprache von Blender;
ändern kannst du das im Bereich Einrichtung unter **UI-Sprache** (UI Language).
diff --git a/docs/i18n/user-guide.es-MX.md b/docs/i18n/user-guide.es-MX.md
index da1afc0..9c4ddc6 100644
--- a/docs/i18n/user-guide.es-MX.md
+++ b/docs/i18n/user-guide.es-MX.md
@@ -130,6 +130,14 @@ instalada aparece junto al complemento en **Get Extensions**.
- **Progreso / Resultado** (Progress / Result): progreso, registro reciente y, al
terminar un trabajo, **Importar personaje generado** (Import Generated Character),
**Abrir carpeta de salida** (Open Output Folder) y **Ver registro completo** (View Full Log).
+- **Diagnóstico** (Diagnostics): dónde las partes del cuerpo del personaje se
+ meten unas en otras (una mano dentro de la cabeza, brazos cruzados). Las
+ celdas rojas de la barra son frames con un problema; haz clic en una para ir
+ ahí. El triángulo bajo la barra sigue el frame actual, y debajo aparecen las
+ partes que se intersectan y qué tan profundo. **Anterior** / **Siguiente**
+ (Previous / Next) saltan entre problemas. **Abrir reporte HTML** (Open HTML
+ Report) abre en el navegador un reporte con el video fuente junto al
+ personaje (la primera vez tarda unos 15 segundos en generarse).
El complemento está disponible en 18 idiomas. **Automático (Blender / Sistema)**
(Auto (Blender / System)) sigue el idioma de Blender; cámbialo en la sección
diff --git a/docs/i18n/user-guide.fil.md b/docs/i18n/user-guide.fil.md
index 9a4f09a..f86485d 100644
--- a/docs/i18n/user-guide.fil.md
+++ b/docs/i18n/user-guide.fil.md
@@ -129,6 +129,15 @@ Makikita ang naka-install mong bersyon sa tabi ng add-on sa **Get Extensions**.
- **Progreso / Resulta** (Progress / Result): progress, recent log, at pagkatapos ng job,
**I-import ang Nagawang Character** (Import Generated Character), **Buksan ang
Output Folder** (Open Output Folder), **Tingnan ang Buong Log** (View Full Log).
+- **Diagnostics**: kung saan pumapasok sa isa't isa ang mga bahagi ng katawan
+ ng character (kamay sa loob ng ulo, nakakrus na braso). Ang mga pulang cell
+ sa bar ay mga frame na may problema; i-click ang isa para pumunta roon.
+ Sinusundan ng tatsulok sa ilalim ng bar ang kasalukuyang frame, at sa ibaba
+ nito ang mga bahaging nagsasalubong at kung gaano kalalim. Lumilipat sa
+ pagitan ng mga problema ang **Nauna** / **Susunod** (Previous / Next).
+ Binubuksan ng **Buksan ang HTML Report** (Open HTML Report) ang isang report
+ sa web browser na katabi ng character ang source video (sa unang beses, mga
+ 15 segundo bago ito mabuo).
Available ang add-on sa 18 wika. Sinusunod ng **Auto (sundan ang Blender / system)**
ang wika ng Blender; palitan ito sa Setup box sa **Wika ng UI** (UI Language).
diff --git a/docs/i18n/user-guide.fr.md b/docs/i18n/user-guide.fr.md
index 41783b0..8b7f039 100644
--- a/docs/i18n/user-guide.fr.md
+++ b/docs/i18n/user-guide.fr.md
@@ -129,6 +129,15 @@ version installée est indiquée à côté du module dans **Get Extensions**.
- **Progression / Résultat** (Progress / Result) : progression, journal récent et, après une tâche,
**Importer le personnage généré** (Import Generated Character), **Ouvrir le dossier de sortie** (Open Output Folder),
**Voir le journal complet** (View Full Log).
+- **Diagnostic** (Diagnostics) : les endroits où des parties du corps du
+ personnage entrent l’une dans l’autre (une main dans la tête, des bras
+ croisés). Les cases rouges de la barre sont des images avec un problème ;
+ cliquez sur l’une d’elles pour y aller. Le triangle sous la barre suit
+ l’image courante, et en dessous s’affichent les parties qui se chevauchent
+ et leur profondeur. **Précédent** / **Suivant** (Previous / Next) passent
+ d’un problème à l’autre. **Ouvrir le rapport HTML** (Open HTML Report) ouvre
+ dans le navigateur un rapport avec la vidéo source à côté du personnage (la
+ première fois, sa création prend environ 15 secondes).
Le module parle 18 langues. **Automatique (Blender / Système)** (Auto) suit la langue de Blender ;
vous pouvez la changer dans la zone Configuration, sous **Langue de l’interface** (UI Language).
diff --git a/docs/i18n/user-guide.id.md b/docs/i18n/user-guide.id.md
index a8f7805..0246008 100644
--- a/docs/i18n/user-guide.id.md
+++ b/docs/i18n/user-guide.id.md
@@ -126,6 +126,14 @@ terpasang ditampilkan di samping add-on di **Get Extensions**.
- **Progres / Hasil** (Progress / Result): progres, log terbaru, dan setelah proses selesai
**Impor Karakter Hasil** (Import Generated Character), **Buka Folder Output**
(Open Output Folder), **Lihat Log Lengkap** (View Full Log).
+- **Diagnostik** (Diagnostics): tempat bagian tubuh karakter saling masuk
+ (tangan di dalam kepala, lengan bersilang). Sel merah di bilah adalah frame
+ yang bermasalah; klik salah satunya untuk pergi ke sana. Segitiga di bawah
+ bilah mengikuti frame saat ini, dan di bawahnya tampil bagian yang saling
+ tembus serta seberapa dalam. **Sebelumnya** / **Berikutnya** (Previous /
+ Next) melompat antarmasalah. **Buka Laporan HTML** (Open HTML Report)
+ membuka laporan di browser dengan video sumber di samping karakter (pertama
+ kali butuh sekitar 15 detik untuk membuatnya).
Add-on ini tersedia dalam 18 bahasa. **Otomatis (ikut Blender / sistem)** (Auto)
mengikuti bahasa Blender; ubah di kotak Penyiapan pada **Bahasa Antarmuka** (UI Language).
diff --git a/docs/i18n/user-guide.ja.md b/docs/i18n/user-guide.ja.md
index 0ca7417..597ef33 100644
--- a/docs/i18n/user-guide.ja.md
+++ b/docs/i18n/user-guide.ja.md
@@ -126,6 +126,7 @@ SMPL-X はアドオンが必要とする無料のボディモデルです。ラ
- **進行状況 / 結果**(Progress / Result):進行状況、最近のログ。ジョブ完了後は
**生成したキャラクターをインポート**(Import Generated Character)、
**出力フォルダーを開く**(Open Output Folder)、**ログを表示**(View Full Log)。
+- **診断**(Diagnostics):キャラクターの体の部位がめり込んでいる箇所(手が頭に入り込む、腕を組んだときに腕同士がめり込むなど)。バーの赤いセルは問題のあるフレームで、クリックするとそこへ移動します。バーの下の三角は現在のフレームを示し、その下にこのフレームでめり込んでいる部位と深さが表示されます。**前へ** / **次へ**(Previous / Next)で問題間を移動します。**HTML レポートを開く**(Open HTML Report)は、元動画とキャラクターを並べたレポートをブラウザで開きます(初回は作成に約 15 秒かかります)。
アドオンは 18 言語に対応しています。**自動(Blender / システム)**(Auto (Blender / System))は
Blender の言語に従います。セットアップボックスの **UI 言語**(UI Language)で変更できます。
diff --git a/docs/i18n/user-guide.ko.md b/docs/i18n/user-guide.ko.md
index e733b36..2e03861 100644
--- a/docs/i18n/user-guide.ko.md
+++ b/docs/i18n/user-guide.ko.md
@@ -128,6 +128,11 @@ SMPL-X는 애드온에 필요한 무료 바디 모델입니다. 라이선스상
- **진행 / 결과** (Progress / Result): 진행 상황, 최근 로그, 그리고 작업 후에는
**생성된 캐릭터 가져오기** (Import Generated Character),
**출력 폴더 열기** (Open Output Folder), **전체 로그 보기** (View Full Log).
+- **진단**(Diagnostics): 캐릭터의 신체 부위가 서로 파고든 곳(손이 머리 안으로 들어가거나, 팔짱을 낄 때 팔끼리 겹치는
+ 경우 등). 막대의 빨간 칸은 문제가 있는 프레임이며, 클릭하면 그곳으로 이동합니다. 막대 아래의 삼각형은 현재 프레임을 따라가고, 그
+ 아래에 이 프레임에서 파고든 부위와 깊이가 표시됩니다. **이전** / **다음**(Previous / Next)으로 문제 사이를
+ 이동합니다. **HTML 보고서 열기**(Open HTML Report)는 원본 영상과 캐릭터를 나란히 보여 주는 보고서를 웹
+ 브라우저에서 엽니다(처음에는 만드는 데 약 15초 걸립니다).
애드온은 18개 언어를 지원합니다. **자동 (Blender / 시스템)** (Auto (Blender / System))은
Blender의 언어를 따릅니다. **설정** 상자의 **UI 언어** (UI Language)에서 바꿀 수
diff --git a/docs/i18n/user-guide.ne.md b/docs/i18n/user-guide.ne.md
index 8dd1295..3c8de34 100644
--- a/docs/i18n/user-guide.ne.md
+++ b/docs/i18n/user-guide.ne.md
@@ -127,6 +127,14 @@ SMPL-X एड-अनलाई चाहिने निःशुल्क बड
- **प्रगति / नतिजा** (Progress / Result): प्रगति, हालको लग, र काम सकिएपछि
**बनाइएको क्यारेक्टर import गर्नुहोस्** (Import Generated Character), **आउटपुट फोल्डर खोल्नुहोस्** (Open Output Folder),
**पूरा लग हेर्नुहोस्** (View Full Log)।
+- **निदान** (Diagnostics): क्यारेक्टरका शरीरका भागहरू एकअर्कामा पसेका ठाउँहरू
+ (टाउकोभित्र हात, बाँधिएका पाखुरा)। बारमा रातो कोठा समस्या भएका frame हुन्;
+ कुनै एकमा क्लिक गर्दा त्यहाँ पुगिन्छ। बारमुनिको त्रिकोणले हालको frame
+ पछ्याउँछ, र त्यसमुनि कुन भागहरू एकअर्कामा पसेका छन् र कति गहिरो भन्ने
+ देखिन्छ। **अघिल्लो** / **अर्को** (Previous / Next) ले समस्याहरूबीच जान्छ।
+ **HTML रिपोर्ट खोल्नुहोस्** (Open HTML Report) ले वेब ब्राउजरमा
+ क्यारेक्टरसँगै स्रोत भिडियो देखाउने रिपोर्ट खोल्छ (पहिलो पटक बनाउन करिब 15
+ सेकेन्ड लाग्छ)।
एड-अन 18 भाषामा चल्छ। **स्वतः** (Auto) ले Blender को भाषा पछ्याउँछ; यसलाई
**सेटअप** बक्सको **UI भाषा** (UI Language) मा बदल्नुहोस्।
diff --git a/docs/i18n/user-guide.nl.md b/docs/i18n/user-guide.nl.md
index 6ffb3bd..1e48f0d 100644
--- a/docs/i18n/user-guide.nl.md
+++ b/docs/i18n/user-guide.nl.md
@@ -128,6 +128,14 @@ Je geïnstalleerde versie staat naast de add-on in **Get Extensions**.
- **Voortgang / Resultaat** (Progress / Result): voortgang, recent log en na een taak
**Gegenereerd personage importeren** (Import Generated Character), **Uitvoermap openen** (Open Output Folder),
**Volledig log bekijken** (View Full Log).
+- **Diagnose** (Diagnostics): plekken waar lichaamsdelen van het personage in
+ elkaar zitten (een hand in het hoofd, gekruiste armen). Rode cellen in de
+ balk zijn frames met een probleem; klik erop om erheen te gaan. Het
+ driehoekje onder de balk volgt het huidige frame, en daaronder staat welke
+ delen elkaar doorsnijden en hoe diep. **Vorige** / **Volgende** (Previous /
+ Next) springen tussen problemen. **HTML-rapport openen** (Open HTML Report)
+ opent in de webbrowser een rapport met de bronvideo naast het personage (de
+ eerste keer duurt het maken ongeveer 15 seconden).
De add-on spreekt 18 talen. **Automatisch (Blender / Systeem)** (Auto) volgt de taal van Blender;
je wijzigt dit in het vak Instellen onder **Interfacetaal** (UI Language).
diff --git a/docs/i18n/user-guide.pl.md b/docs/i18n/user-guide.pl.md
index e544911..8bf0d07 100644
--- a/docs/i18n/user-guide.pl.md
+++ b/docs/i18n/user-guide.pl.md
@@ -127,6 +127,14 @@ jest widoczna obok dodatku w **Get Extensions**.
- **Postęp / wynik** (Progress / Result): postęp, ostatnie wpisy logu, a po
zakończeniu zadania **Importuj wygenerowaną postać** (Import Generated Character),
**Otwórz folder wyjściowy** (Open Output Folder) i **Pokaż pełny log** (View Full Log).
+- **Diagnostyka** (Diagnostics): miejsca, w których części ciała postaci
+ wchodzą w siebie (dłoń w głowie, skrzyżowane ręce). Czerwone komórki na
+ pasku to klatki z problemem; kliknij jedną, aby tam przejść. Trójkąt pod
+ paskiem podąża za bieżącą klatką, a pod nim widać, które części się
+ przenikają i jak głęboko. **Poprzedni** / **Następny** (Previous / Next)
+ przechodzą między problemami. **Otwórz raport HTML** (Open HTML Report)
+ otwiera w przeglądarce raport z wideo źródłowym obok postaci (za pierwszym
+ razem tworzenie trwa około 15 sekund).
Dodatek mówi w 18 językach. **Automatycznie (Blender / system)**
(Auto (Blender / System)) podąża za językiem Blendera; zmienisz to w sekcji
diff --git a/docs/i18n/user-guide.ru.md b/docs/i18n/user-guide.ru.md
index 450185e..3248626 100644
--- a/docs/i18n/user-guide.ru.md
+++ b/docs/i18n/user-guide.ru.md
@@ -127,6 +127,14 @@ SMPL-X — бесплатная модель тела, которая нужна
- **Прогресс / результат** (Progress / Result): ход работы, последние строки журнала, а после задачи —
**Импортировать персонажа** (Import Generated Character), **Открыть папку результатов** (Open Output Folder),
**Полный журнал** (View Full Log).
+- **Диагностика** (Diagnostics): места, где части тела персонажа входят друг в
+ друга (рука в голове, скрещённые руки). Красные ячейки на полосе — кадры с
+ проблемой; щелчок переносит туда. Треугольник под полосой следует за текущим
+ кадром, а ниже показано, какие части пересекаются и насколько глубоко.
+ **Назад** / **Вперёд** (Previous / Next) переходят между проблемами.
+ **Открыть HTML-отчёт** (Open HTML Report) открывает в браузере отчёт с
+ исходным видео рядом с персонажем (в первый раз он создаётся около 15
+ секунд).
Аддон говорит на 18 языках. **Авто** (Auto) следует языку Blender; изменить его
можно в блоке **Настройка** в пункте **Язык интерфейса** (UI Language).
diff --git a/docs/i18n/user-guide.th.md b/docs/i18n/user-guide.th.md
index 99c973d..4be71c6 100644
--- a/docs/i18n/user-guide.th.md
+++ b/docs/i18n/user-guide.th.md
@@ -126,6 +126,7 @@ add-on ใน **Get Extensions**
- **ความคืบหน้า / ผลลัพธ์** (Progress / Result): ความคืบหน้า บันทึกล่าสุด และหลังจบงาน
จะมี **นำเข้าตัวละครที่สร้าง** (Import Generated Character),
**เปิดโฟลเดอร์ผลลัพธ์** (Open Output Folder), **ดูบันทึกทั้งหมด** (View Full Log)
+- **การวินิจฉัย** (Diagnostics): จุดที่ส่วนต่าง ๆ ของร่างกายตัวละครทะลุเข้าหากัน (มืออยู่ในหัว แขนไขว้กัน) ช่องสีแดงในแถบคือเฟรมที่มีปัญหา คลิกเพื่อไปยังเฟรมนั้น สามเหลี่ยมใต้แถบจะตามเฟรมปัจจุบัน และด้านล่างแสดงว่าส่วนใดทะลุกันและลึกเท่าใด **ก่อนหน้า** / **ถัดไป** (Previous / Next) ใช้กระโดดระหว่างปัญหา **เปิดรายงาน HTML** (Open HTML Report) จะเปิดรายงานในเว็บเบราว์เซอร์ โดยแสดงวิดีโอต้นฉบับข้างตัวละคร (ครั้งแรกใช้เวลาสร้างประมาณ 15 วินาที)
add-on รองรับ 18 ภาษา **อัตโนมัติ (ตาม Blender / ระบบ)** (Auto (Blender / System))
จะใช้ภาษาตาม Blender เปลี่ยนได้ในกล่อง **ตั้งค่า** ที่ **ภาษาของอินเทอร์เฟซ** (UI Language)
diff --git a/docs/i18n/user-guide.tr.md b/docs/i18n/user-guide.tr.md
index f057c1d..0d584a8 100644
--- a/docs/i18n/user-guide.tr.md
+++ b/docs/i18n/user-guide.tr.md
@@ -130,6 +130,14 @@ Güncelleme, indirilmiş modelleri korur; bu yüzden hızlıdır. Kurulu sürüm
- **İlerleme / Sonuç** (Progress / Result): ilerleme, son günlük kayıtları ve bir iş
bittikten sonra **Üretilen Karakteri İçe Aktar** (Import Generated Character),
**Çıktı Klasörünü Aç** (Open Output Folder), **Tüm Günlüğü Göster** (View Full Log).
+- **Tanılama** (Diagnostics): karakterin vücut parçalarının birbirinin içine
+ girdiği yerler (başın içindeki el, kavuşturulmuş kollar). Çubuktaki kırmızı
+ hücreler sorunlu karelerdir; birine tıklayınca oraya gidilir. Çubuğun
+ altındaki üçgen geçerli kareyi izler; altında da hangi parçaların iç içe
+ geçtiği ve ne kadar derin olduğu görünür. **Önceki** / **Sonraki** (Previous
+ / Next) sorunlar arasında geçiş yapar. **HTML Raporunu Aç** (Open HTML
+ Report), kaynak videonun karakterin yanında gösterildiği bir raporu web
+ tarayıcısında açar (ilk seferde oluşturulması yaklaşık 15 saniye sürer).
Eklenti 18 dili destekler. **Otomatik (Blender / Sistem)** (Auto (Blender / System))
Blender'ın dilini izler; bunu Kurulum kutusundaki **Arayüz Dili** (UI Language)
diff --git a/docs/i18n/user-guide.vi.md b/docs/i18n/user-guide.vi.md
index fba9901..31c9dce 100644
--- a/docs/i18n/user-guide.vi.md
+++ b/docs/i18n/user-guide.vi.md
@@ -126,6 +126,13 @@ hiển thị bên cạnh add-on trong **Get Extensions**.
- **Tiến trình / Kết quả** (Progress / Result): tiến trình, nhật ký gần đây, và
sau mỗi tác vụ là **Nhập nhân vật đã tạo** (Import Generated Character),
**Mở thư mục đầu ra** (Open Output Folder), **Xem toàn bộ nhật ký** (View Full Log).
+- **Chẩn đoán** (Diagnostics): những chỗ các bộ phận cơ thể của nhân vật đâm
+ vào nhau (tay nằm trong đầu, hai tay khoanh lại). Ô đỏ trên thanh là khung
+ hình có vấn đề; bấm vào để nhảy tới đó. Tam giác dưới thanh đi theo khung
+ hình hiện tại, bên dưới là các bộ phận đang giao cắt và độ sâu. **Trước** /
+ **Tiếp** (Previous / Next) nhảy giữa các vấn đề. **Mở báo cáo HTML** (Open
+ HTML Report) mở trong trình duyệt một báo cáo có video nguồn bên cạnh nhân
+ vật (lần đầu mất khoảng 15 giây để tạo).
Add-on hỗ trợ 18 ngôn ngữ. **Tự động (theo Blender / hệ thống)** (Auto (Blender / System))
đi theo ngôn ngữ của Blender; bạn có thể đổi trong khung **Thiết lập**, tại
diff --git a/docs/i18n/user-guide.zh-Hans.md b/docs/i18n/user-guide.zh-Hans.md
index a1cd704..3e43b24 100644
--- a/docs/i18n/user-guide.zh-Hans.md
+++ b/docs/i18n/user-guide.zh-Hans.md
@@ -123,6 +123,7 @@ SMPL-X 是插件需要的一个免费人体模型。它的许可证不允许我
- **进度 / 结果**(Progress / Result):进度、最近的日志;任务完成后还有
**导入生成的角色**(Import Generated Character)、**打开输出文件夹**(Open Output Folder)、
**查看完整日志**(View Full Log)。
+- **诊断**(Diagnostics):角色身体部位互相穿插的地方(比如手插进头里、双臂交叉时穿进去)。条上的红格是有问题的帧,点一下就跳过去。条下面的三角跟着当前帧走,再下面列出这一帧哪些部位穿插、有多深。**上一个问题** / **下一个问题**(Previous / Next)在问题之间跳转。**打开 HTML 报告**(Open HTML Report)会在浏览器里打开一份报告,原视频和角色并排显示(第一次要生成,大约 15 秒)。
插件支持 18 种语言。**自动(跟随 Blender / 系统)**(Auto (Blender / System))会跟随
Blender 的语言;可以在设置框的 **界面语言**(UI Language)里修改。
diff --git a/docs/i18n/user-guide.zh-Hant.md b/docs/i18n/user-guide.zh-Hant.md
index f998208..8402dc7 100644
--- a/docs/i18n/user-guide.zh-Hant.md
+++ b/docs/i18n/user-guide.zh-Hant.md
@@ -123,6 +123,7 @@ SMPL-X 是外掛需要的一個免費人體模型。它的授權不允許我們
- **進度 / 結果**(Progress / Result):進度、最近的記錄;工作完成後還有
**匯入產生的角色**(Import Generated Character)、**開啟輸出資料夾**(Open Output Folder)、
**檢視完整記錄**(View Full Log)。
+- **診斷**(Diagnostics):角色身體部位互相穿插的地方(例如手穿進頭裡、雙臂交叉時穿進去)。條上的紅格是有問題的影格,點一下就會跳過去。條下方的三角形跟著目前影格移動,再下方列出這一格有哪些部位穿插、深度多少。**上一個問題** / **下一個問題**(Previous / Next)可在問題之間跳轉。**開啟 HTML 報告**(Open HTML Report)會在瀏覽器中開啟報告,原始影片與角色並排顯示(第一次需要產生,大約 15 秒)。
外掛支援 18 種語言。**自動(跟隨 Blender / 系統)**(Auto (Blender / System))會跟隨
Blender 的語言;可以在設定區塊的 **介面語言**(UI Language)中變更。