@volter/blender-engine 0.1.147 → 0.1.149

package/browser/addons/vrm/common/human_bone_mapper/__init__.py

@@ -0,0 +1 @@
+# SPDX-License-Identifier: MIT OR GPL-3.0-or-later

package/browser/addons/vrm/common/human_bone_mapper/biped_mapping.py

@@ -0,0 +1,84 @@
+# SPDX-License-Identifier: MIT OR GPL-3.0-or-later
+from collections.abc import Mapping
+
+from bpy.types import Object
+
+from ..logger import get_logger
+from ..vrm1.human_bone import HumanBoneSpecification, HumanBoneSpecifications
+
+_logger = get_logger(__name__)
+
+_biped_mapping = {
+    (None, "Pelvis"): HumanBoneSpecifications.HIPS,
+    (None, "Spine"): HumanBoneSpecifications.SPINE,
+    (None, "Spine2"): HumanBoneSpecifications.CHEST,
+    (None, "Neck"): HumanBoneSpecifications.NECK,
+    (None, "Head"): HumanBoneSpecifications.HEAD,
+    ("R", "Clavicle"): HumanBoneSpecifications.RIGHT_SHOULDER,
+    ("R", "UpperArm"): HumanBoneSpecifications.RIGHT_UPPER_ARM,
+    ("R", "Forearm"): HumanBoneSpecifications.RIGHT_LOWER_ARM,
+    ("R", "Hand"): HumanBoneSpecifications.RIGHT_HAND,
+    ("L", "Clavicle"): HumanBoneSpecifications.LEFT_SHOULDER,
+    ("L", "UpperArm"): HumanBoneSpecifications.LEFT_UPPER_ARM,
+    ("L", "Forearm"): HumanBoneSpecifications.LEFT_LOWER_ARM,
+    ("L", "Hand"): HumanBoneSpecifications.LEFT_HAND,
+    ("R", "Thigh"): HumanBoneSpecifications.RIGHT_UPPER_LEG,
+    ("R", "Calf"): HumanBoneSpecifications.RIGHT_LOWER_LEG,
+    ("R", "Foot"): HumanBoneSpecifications.RIGHT_FOOT,
+    ("R", "Toe0"): HumanBoneSpecifications.RIGHT_TOES,
+    ("L", "Thigh"): HumanBoneSpecifications.LEFT_UPPER_LEG,
+    ("L", "Calf"): HumanBoneSpecifications.LEFT_LOWER_LEG,
+    ("L", "Foot"): HumanBoneSpecifications.LEFT_FOOT,
+    ("L", "Toe0"): HumanBoneSpecifications.LEFT_TOES,
+    ("R", "Finger0"): HumanBoneSpecifications.RIGHT_THUMB_METACARPAL,
+    ("R", "Finger01"): HumanBoneSpecifications.RIGHT_THUMB_PROXIMAL,
+    ("R", "Finger02"): HumanBoneSpecifications.RIGHT_THUMB_DISTAL,
+    ("L", "Finger0"): HumanBoneSpecifications.LEFT_THUMB_METACARPAL,
+    ("L", "Finger01"): HumanBoneSpecifications.LEFT_THUMB_PROXIMAL,
+    ("L", "Finger02"): HumanBoneSpecifications.LEFT_THUMB_DISTAL,
+    ("R", "Finger1"): HumanBoneSpecifications.RIGHT_INDEX_PROXIMAL,
+    ("R", "Finger11"): HumanBoneSpecifications.RIGHT_INDEX_INTERMEDIATE,
+    ("R", "Finger12"): HumanBoneSpecifications.RIGHT_INDEX_DISTAL,
+    ("L", "Finger1"): HumanBoneSpecifications.LEFT_INDEX_PROXIMAL,
+    ("L", "Finger11"): HumanBoneSpecifications.LEFT_INDEX_INTERMEDIATE,
+    ("L", "Finger12"): HumanBoneSpecifications.LEFT_INDEX_DISTAL,
+    ("R", "Finger2"): HumanBoneSpecifications.RIGHT_MIDDLE_PROXIMAL,
+    ("R", "Finger21"): HumanBoneSpecifications.RIGHT_MIDDLE_INTERMEDIATE,
+    ("R", "Finger22"): HumanBoneSpecifications.RIGHT_MIDDLE_DISTAL,
+    ("L", "Finger2"): HumanBoneSpecifications.LEFT_MIDDLE_PROXIMAL,
+    ("L", "Finger21"): HumanBoneSpecifications.LEFT_MIDDLE_INTERMEDIATE,
+    ("L", "Finger22"): HumanBoneSpecifications.LEFT_MIDDLE_DISTAL,
+    ("R", "Finger3"): HumanBoneSpecifications.RIGHT_RING_PROXIMAL,
+    ("R", "Finger31"): HumanBoneSpecifications.RIGHT_RING_INTERMEDIATE,
+    ("R", "Finger32"): HumanBoneSpecifications.RIGHT_RING_DISTAL,
+    ("L", "Finger3"): HumanBoneSpecifications.LEFT_RING_PROXIMAL,
+    ("L", "Finger31"): HumanBoneSpecifications.LEFT_RING_INTERMEDIATE,
+    ("L", "Finger32"): HumanBoneSpecifications.LEFT_RING_DISTAL,
+    ("R", "Finger4"): HumanBoneSpecifications.RIGHT_LITTLE_PROXIMAL,
+    ("R", "Finger41"): HumanBoneSpecifications.RIGHT_LITTLE_INTERMEDIATE,
+    ("R", "Finger42"): HumanBoneSpecifications.RIGHT_LITTLE_DISTAL,
+    ("L", "Finger4"): HumanBoneSpecifications.LEFT_LITTLE_PROXIMAL,
+    ("L", "Finger41"): HumanBoneSpecifications.LEFT_LITTLE_INTERMEDIATE,
+    ("L", "Finger42"): HumanBoneSpecifications.LEFT_LITTLE_DISTAL,
+}
+
+
+def create_config(
+    armature: Object,
+) -> tuple[str, Mapping[str, HumanBoneSpecification]]:
+    mapping: dict[str, HumanBoneSpecification] = {}
+    for bone in armature.pose.bones:
+        for (bone_lr, bone_suffix), specification in _biped_mapping.items():
+            if (
+                bone.name.startswith("Bip001")
+                and bone.name.endswith(bone_suffix)
+                and (bone_lr is None or bone_lr in bone.name)
+            ):
+                mapping[bone.name] = specification
+
+    name = "Bip001"
+    for specification in HumanBoneSpecifications.all_human_bones:
+        if specification.requirement and specification not in mapping.values():
+            return (name, {})
+
+    return (name, mapping)

package/browser/addons/vrm/common/human_bone_mapper/cats_blender_plugin_fix_model_mapping.py

@@ -0,0 +1,63 @@
+# SPDX-License-Identifier: MIT OR GPL-3.0-or-later
+from collections.abc import Mapping
+from typing import Final
+
+from ..vrm1.human_bone import HumanBoneSpecification, HumanBoneSpecifications
+
+MAPPING: Final[Mapping[str, HumanBoneSpecification]] = {
+    "Hips": HumanBoneSpecifications.HIPS,
+    "Spine": HumanBoneSpecifications.SPINE,
+    "Chest": HumanBoneSpecifications.CHEST,
+    "Neck": HumanBoneSpecifications.NECK,
+    "Head": HumanBoneSpecifications.HEAD,
+    "Eye_R": HumanBoneSpecifications.RIGHT_EYE,
+    "Eye_L": HumanBoneSpecifications.LEFT_EYE,
+    "Right shoulder": HumanBoneSpecifications.RIGHT_SHOULDER,
+    "Right arm": HumanBoneSpecifications.RIGHT_UPPER_ARM,
+    "Right elbow": HumanBoneSpecifications.RIGHT_LOWER_ARM,
+    "Right wrist": HumanBoneSpecifications.RIGHT_HAND,
+    "Left shoulder": HumanBoneSpecifications.LEFT_SHOULDER,
+    "Left arm": HumanBoneSpecifications.LEFT_UPPER_ARM,
+    "Left elbow": HumanBoneSpecifications.LEFT_LOWER_ARM,
+    "Left wrist": HumanBoneSpecifications.LEFT_HAND,
+    "Right leg": HumanBoneSpecifications.RIGHT_UPPER_LEG,
+    "Right knee": HumanBoneSpecifications.RIGHT_LOWER_LEG,
+    "Right ankle": HumanBoneSpecifications.RIGHT_FOOT,
+    "Right toe": HumanBoneSpecifications.RIGHT_TOES,
+    "Left leg": HumanBoneSpecifications.LEFT_UPPER_LEG,
+    "Left knee": HumanBoneSpecifications.LEFT_LOWER_LEG,
+    "Left ankle": HumanBoneSpecifications.LEFT_FOOT,
+    "Left toe": HumanBoneSpecifications.LEFT_TOES,
+    "Thumb0_R": HumanBoneSpecifications.RIGHT_THUMB_METACARPAL,
+    "Thumb1_R": HumanBoneSpecifications.RIGHT_THUMB_PROXIMAL,
+    "Thumb2_R": HumanBoneSpecifications.RIGHT_THUMB_DISTAL,
+    "Thumb0_L": HumanBoneSpecifications.LEFT_THUMB_METACARPAL,
+    "Thumb1_L": HumanBoneSpecifications.LEFT_THUMB_PROXIMAL,
+    "Thumb2_L": HumanBoneSpecifications.LEFT_THUMB_DISTAL,
+    "IndexFinger1_R": HumanBoneSpecifications.RIGHT_INDEX_PROXIMAL,
+    "IndexFinger2_R": HumanBoneSpecifications.RIGHT_INDEX_INTERMEDIATE,
+    "IndexFinger3_R": HumanBoneSpecifications.RIGHT_INDEX_DISTAL,
+    "IndexFinger1_L": HumanBoneSpecifications.LEFT_INDEX_PROXIMAL,
+    "IndexFinger2_L": HumanBoneSpecifications.LEFT_INDEX_INTERMEDIATE,
+    "IndexFinger3_L": HumanBoneSpecifications.LEFT_INDEX_DISTAL,
+    "MiddleFinger1_R": HumanBoneSpecifications.RIGHT_MIDDLE_PROXIMAL,
+    "MiddleFinger2_R": HumanBoneSpecifications.RIGHT_MIDDLE_INTERMEDIATE,
+    "MiddleFinger3_R": HumanBoneSpecifications.RIGHT_MIDDLE_DISTAL,
+    "MiddleFinger1_L": HumanBoneSpecifications.LEFT_MIDDLE_PROXIMAL,
+    "MiddleFinger2_L": HumanBoneSpecifications.LEFT_MIDDLE_INTERMEDIATE,
+    "MiddleFinger3_L": HumanBoneSpecifications.LEFT_MIDDLE_DISTAL,
+    "RingFinger1_R": HumanBoneSpecifications.RIGHT_RING_PROXIMAL,
+    "RingFinger2_R": HumanBoneSpecifications.RIGHT_RING_INTERMEDIATE,
+    "RingFinger3_R": HumanBoneSpecifications.RIGHT_RING_DISTAL,
+    "RingFinger1_L": HumanBoneSpecifications.LEFT_RING_PROXIMAL,
+    "RingFinger2_L": HumanBoneSpecifications.LEFT_RING_INTERMEDIATE,
+    "RingFinger3_L": HumanBoneSpecifications.LEFT_RING_DISTAL,
+    "LittleFinger1_R": HumanBoneSpecifications.RIGHT_LITTLE_PROXIMAL,
+    "LittleFinger2_R": HumanBoneSpecifications.RIGHT_LITTLE_INTERMEDIATE,
+    "LittleFinger3_R": HumanBoneSpecifications.RIGHT_LITTLE_DISTAL,
+    "LittleFinger1_L": HumanBoneSpecifications.LEFT_LITTLE_PROXIMAL,
+    "LittleFinger2_L": HumanBoneSpecifications.LEFT_LITTLE_INTERMEDIATE,
+    "LittleFinger3_L": HumanBoneSpecifications.LEFT_LITTLE_DISTAL,
+}
+
+CONFIG = ("Cats Blender Plugin Fixed Model", MAPPING)

package/browser/addons/vrm/common/human_bone_mapper/human_bone_mapper.py

@@ -0,0 +1,203 @@
+# SPDX-License-Identifier: MIT OR GPL-3.0-or-later
+import re
+from collections.abc import Mapping
+from functools import cache
+from typing import Final, Optional
+
+from bpy.types import Armature, Bone, Object
+
+from ..char import FULLWIDTH_ASCII_TO_ASCII_MAP
+from ..logger import get_logger
+from ..vrm1.human_bone import HumanBoneSpecification, HumanBoneSpecifications
+from . import (
+    biped_mapping,
+    cats_blender_plugin_fix_model_mapping,
+    microsoft_rocketbox_mapping,
+    mixamo_mapping,
+    mmd_mapping,
+    mpfb_mapping,
+    ready_player_me_mapping,
+    reallusion_mapping,
+    rigify_meta_rig_mapping,
+    unreal_mapping,
+    vrm_addon_mapping,
+    vroid_mapping,
+)
+from .structure_based_mapping import create_structure_based_mapping
+
+BONE_NAME_LOWER_TO_UPPER_REGEX_SUB: Final = (re.compile(r"([a-z])([A-Z])"), r"\1.\2")
+BONE_NAME_DIGIT_REGEX_SUB: Final = (re.compile(r"(\d+)"), r".\1.")
+BONE_NAME_COMPONENT_SPLIT_REGEX: Final = re.compile(r"[-._: (){}[\]<>]+")
+
+_logger = get_logger(__name__)
+
+
+@cache
+def _canonicalize_bone_name(bone_name: str) -> str:
+    bone_name = "".join(FULLWIDTH_ASCII_TO_ASCII_MAP.get(c, c) for c in bone_name)
+    bone_name = re.sub(*BONE_NAME_LOWER_TO_UPPER_REGEX_SUB, bone_name)
+    bone_name = bone_name.lower()
+    bone_name = "".join(" " if c.isspace() else c for c in bone_name)
+    bone_name = re.sub(*BONE_NAME_DIGIT_REGEX_SUB, bone_name).strip(".")
+    bone_name_components = re.split(BONE_NAME_COMPONENT_SPLIT_REGEX, bone_name)
+    for patterns, replacement in {
+        ("l", "左"): "left",
+        ("r", "右"): "right",
+    }.items():
+        bone_name_components = [
+            replacement if bone_name_component in patterns else bone_name_component
+            for bone_name_component in bone_name_components
+        ]
+    return ".".join(bone_name_components)
+
+
+def _match_bone_name(bone_name1: str, bone_name2: str) -> bool:
+    return _canonicalize_bone_name(bone_name1) == _canonicalize_bone_name(bone_name2)
+
+
+def _match_count(
+    armature: Armature, mapping: Mapping[str, HumanBoneSpecification]
+) -> int:
+    count = 0
+
+    mapping = {
+        bpy_name: specification
+        for bpy_name, specification in mapping.items()
+        if any(_match_bone_name(bpy_name, bone.name) for bone in armature.bones)
+    }
+
+    # Validate bone ordering
+    for bpy_name, specification in mapping.items():
+        bone = next(
+            (bone for bone in armature.bones if _match_bone_name(bpy_name, bone.name)),
+            None,
+        )
+        if not bone:
+            continue
+
+        parent_specification: Optional[HumanBoneSpecification] = None
+        search_parent_specification = specification.parent
+        while search_parent_specification:
+            if search_parent_specification in mapping.values():
+                parent_specification = search_parent_specification
+                break
+            search_parent_specification = search_parent_specification.parent
+
+        found = False
+        bone: Optional[Bone] = bone.parent
+        while bone:
+            search_specification = next(
+                (
+                    search_specification
+                    for bpy_name, search_specification in mapping.items()
+                    if _match_bone_name(bpy_name, bone.name)
+                ),
+                None,
+            )
+            if search_specification:
+                found = search_specification == parent_specification
+                break
+            bone = bone.parent
+
+        if found or not parent_specification:
+            count += 1
+            continue
+
+    return count
+
+
+def _match_counts(
+    armature: object, mapping: Mapping[str, HumanBoneSpecification]
+) -> tuple[int, int]:
+    if not isinstance(armature, Armature):
+        message = f"{type(armature)} is not an Armature"
+        raise TypeError(message)
+    required_mapping = {
+        bpy_name: required_specification
+        for bpy_name, required_specification in mapping.items()
+        if required_specification.requirement
+    }
+    return (_match_count(armature, required_mapping), _match_count(armature, mapping))
+
+
+def _sorted_required_first(
+    armature: Armature,
+    mapping: Mapping[str, HumanBoneSpecification],
+) -> dict[str, HumanBoneSpecification]:
+    bpy_bone_name_mapping: dict[str, HumanBoneSpecification] = {
+        bpy_bone_name: specification
+        for original_bone_name, specification in mapping.items()
+        if (
+            bpy_bone_name := next(
+                (
+                    bone.name
+                    for bone in armature.bones
+                    if _match_bone_name(original_bone_name, bone.name)
+                ),
+                None,
+            )
+        )
+    }
+    sorted_mapping: dict[str, HumanBoneSpecification] = {}
+    sorted_mapping.update(
+        {
+            bpy_name: specification
+            for bpy_name, specification in bpy_bone_name_mapping.items()
+            if specification.requirement
+        }
+    )
+    sorted_mapping.update(
+        {
+            bpy_name: specification
+            for bpy_name, specification in bpy_bone_name_mapping.items()
+            if not specification.requirement
+        }
+    )
+    return sorted_mapping
+
+
+def create_human_bone_mapping(
+    armature: Object,
+) -> dict[str, HumanBoneSpecification]:
+    armature_data = armature.data
+    if not isinstance(armature_data, Armature):
+        raise TypeError
+    ((required_count, _all_count), name, mapping) = max(
+        (_match_counts(armature_data, mapping), name, mapping)
+        for name, mapping in (
+            mmd_mapping.create_config(armature),
+            biped_mapping.create_config(armature),
+            mixamo_mapping.CONFIG,
+            mpfb_mapping.CONFIG_DEFAULT,
+            mpfb_mapping.CONFIG_GAME_ENGINE,
+            unreal_mapping.CONFIG,
+            ready_player_me_mapping.CONFIG,
+            reallusion_mapping.CONFIG,
+            cats_blender_plugin_fix_model_mapping.CONFIG,
+            microsoft_rocketbox_mapping.CONFIG_BIP01,
+            microsoft_rocketbox_mapping.CONFIG_BIP02,
+            rigify_meta_rig_mapping.CONFIG,
+            vroid_mapping.CONFIG,
+            vroid_mapping.CONFIG_SYMMETRICAL,
+            vrm_addon_mapping.CONFIG_VRM1,
+            vrm_addon_mapping.CONFIG_VRM0,
+        )
+    )
+    result = {}
+    wanted_required_count = sum(
+        1 for spec in HumanBoneSpecifications.all_human_bones if spec.requirement
+    )
+    if required_count < wanted_required_count:
+        structure_based_mapping = create_structure_based_mapping(armature)
+        structure_base_mapping_required_count = sum(
+            1 for spec in structure_based_mapping.values() if spec.requirement
+        )
+        if required_count < structure_base_mapping_required_count:
+            mapping = structure_based_mapping
+            name = "Structure Based Auto Detected"
+            required_count = structure_base_mapping_required_count
+    if required_count:
+        _logger.debug('Treat as "%s" bone mappings', name)
+        result = _sorted_required_first(armature_data, mapping)
+    _canonicalize_bone_name.cache_clear()
+    return result

package/browser/addons/vrm/common/human_bone_mapper/microsoft_rocketbox_mapping.py

@@ -0,0 +1,69 @@
+# SPDX-License-Identifier: MIT OR GPL-3.0-or-later
+from collections.abc import Mapping
+from typing import Final
+
+from ..vrm1.human_bone import HumanBoneSpecification, HumanBoneSpecifications
+
+MAPPING_TEMPLATE: Final[Mapping[str, HumanBoneSpecification]] = {
+    "Head": HumanBoneSpecifications.HEAD,
+    "REye": HumanBoneSpecifications.RIGHT_EYE,
+    "LEye": HumanBoneSpecifications.LEFT_EYE,
+    "MJaw": HumanBoneSpecifications.JAW,
+    "Spine2": HumanBoneSpecifications.CHEST,
+    "Spine1": HumanBoneSpecifications.SPINE,
+    "Pelvis": HumanBoneSpecifications.HIPS,
+    "R Clavicle": HumanBoneSpecifications.RIGHT_SHOULDER,
+    "R UpperArm": HumanBoneSpecifications.RIGHT_UPPER_ARM,
+    "R Forearm": HumanBoneSpecifications.RIGHT_LOWER_ARM,
+    "R Hand": HumanBoneSpecifications.RIGHT_HAND,
+    "L Clavicle": HumanBoneSpecifications.LEFT_SHOULDER,
+    "L UpperArm": HumanBoneSpecifications.LEFT_UPPER_ARM,
+    "L Forearm": HumanBoneSpecifications.LEFT_LOWER_ARM,
+    "L Hand": HumanBoneSpecifications.LEFT_HAND,
+    "R Thigh": HumanBoneSpecifications.RIGHT_UPPER_LEG,
+    "R Calf": HumanBoneSpecifications.RIGHT_LOWER_LEG,
+    "R Foot": HumanBoneSpecifications.RIGHT_FOOT,
+    "R Toe0": HumanBoneSpecifications.RIGHT_TOES,
+    "L Thigh": HumanBoneSpecifications.LEFT_UPPER_LEG,
+    "L Calf": HumanBoneSpecifications.LEFT_LOWER_LEG,
+    "L Foot": HumanBoneSpecifications.LEFT_FOOT,
+    "L Toe0": HumanBoneSpecifications.LEFT_TOES,
+    "R Finger0": HumanBoneSpecifications.RIGHT_THUMB_METACARPAL,
+    "R Finger01": HumanBoneSpecifications.RIGHT_THUMB_PROXIMAL,
+    "R Finger02": HumanBoneSpecifications.RIGHT_THUMB_DISTAL,
+    "R Finger1": HumanBoneSpecifications.RIGHT_INDEX_PROXIMAL,
+    "R Finger11": HumanBoneSpecifications.RIGHT_INDEX_INTERMEDIATE,
+    "R Finger12": HumanBoneSpecifications.RIGHT_INDEX_DISTAL,
+    "R Finger2": HumanBoneSpecifications.RIGHT_MIDDLE_PROXIMAL,
+    "R Finger21": HumanBoneSpecifications.RIGHT_MIDDLE_INTERMEDIATE,
+    "R Finger22": HumanBoneSpecifications.RIGHT_MIDDLE_DISTAL,
+    "R Finger3": HumanBoneSpecifications.RIGHT_RING_PROXIMAL,
+    "R Finger31": HumanBoneSpecifications.RIGHT_RING_INTERMEDIATE,
+    "R Finger32": HumanBoneSpecifications.RIGHT_RING_DISTAL,
+    "R Finger4": HumanBoneSpecifications.RIGHT_LITTLE_PROXIMAL,
+    "R Finger41": HumanBoneSpecifications.RIGHT_LITTLE_INTERMEDIATE,
+    "R Finger42": HumanBoneSpecifications.RIGHT_LITTLE_DISTAL,
+    "L Finger0": HumanBoneSpecifications.LEFT_THUMB_METACARPAL,
+    "L Finger01": HumanBoneSpecifications.LEFT_THUMB_PROXIMAL,
+    "L Finger02": HumanBoneSpecifications.LEFT_THUMB_DISTAL,
+    "L Finger1": HumanBoneSpecifications.LEFT_INDEX_PROXIMAL,
+    "L Finger11": HumanBoneSpecifications.LEFT_INDEX_INTERMEDIATE,
+    "L Finger12": HumanBoneSpecifications.LEFT_INDEX_DISTAL,
+    "L Finger2": HumanBoneSpecifications.LEFT_MIDDLE_PROXIMAL,
+    "L Finger21": HumanBoneSpecifications.LEFT_MIDDLE_INTERMEDIATE,
+    "L Finger22": HumanBoneSpecifications.LEFT_MIDDLE_DISTAL,
+    "L Finger3": HumanBoneSpecifications.LEFT_RING_PROXIMAL,
+    "L Finger31": HumanBoneSpecifications.LEFT_RING_INTERMEDIATE,
+    "L Finger32": HumanBoneSpecifications.LEFT_RING_DISTAL,
+    "L Finger4": HumanBoneSpecifications.LEFT_LITTLE_PROXIMAL,
+    "L Finger41": HumanBoneSpecifications.LEFT_LITTLE_INTERMEDIATE,
+    "L Finger42": HumanBoneSpecifications.LEFT_LITTLE_DISTAL,
+}
+
+
+def _prefixed_mapping(key_prefix: str) -> dict[str, HumanBoneSpecification]:
+    return {key_prefix + k: v for k, v in MAPPING_TEMPLATE.items()}
+
+
+CONFIG_BIP01: Final = ("Microsoft Rocketbox (Bip01)", _prefixed_mapping("Bip01 "))
+CONFIG_BIP02: Final = ("Microsoft Rocketbox (Bip02)", _prefixed_mapping("Bip02 "))

package/browser/addons/vrm/common/human_bone_mapper/mixamo_mapping.py

@@ -0,0 +1,62 @@
+# SPDX-License-Identifier: MIT OR GPL-3.0-or-later
+from collections.abc import Mapping
+from typing import Final
+
+from ..vrm1.human_bone import HumanBoneSpecification, HumanBoneSpecifications
+
+MAPPING: Final[Mapping[str, HumanBoneSpecification]] = {
+    "mixamorig:Head": HumanBoneSpecifications.HEAD,
+    "mixamorig:Neck": HumanBoneSpecifications.NECK,
+    "mixamorig:Spine2": HumanBoneSpecifications.UPPER_CHEST,
+    "mixamorig:Spine1": HumanBoneSpecifications.CHEST,
+    "mixamorig:Spine": HumanBoneSpecifications.SPINE,
+    "mixamorig:Hips": HumanBoneSpecifications.HIPS,
+    "mixamorig:RightShoulder": HumanBoneSpecifications.RIGHT_SHOULDER,
+    "mixamorig:RightArm": HumanBoneSpecifications.RIGHT_UPPER_ARM,
+    "mixamorig:RightForeArm": HumanBoneSpecifications.RIGHT_LOWER_ARM,
+    "mixamorig:RightHand": HumanBoneSpecifications.RIGHT_HAND,
+    "mixamorig:LeftShoulder": HumanBoneSpecifications.LEFT_SHOULDER,
+    "mixamorig:LeftArm": HumanBoneSpecifications.LEFT_UPPER_ARM,
+    "mixamorig:LeftForeArm": HumanBoneSpecifications.LEFT_LOWER_ARM,
+    "mixamorig:LeftHand": HumanBoneSpecifications.LEFT_HAND,
+    "mixamorig:RightUpLeg": HumanBoneSpecifications.RIGHT_UPPER_LEG,
+    "mixamorig:RightLeg": HumanBoneSpecifications.RIGHT_LOWER_LEG,
+    "mixamorig:RightFoot": HumanBoneSpecifications.RIGHT_FOOT,
+    "mixamorig:RightToeBase": HumanBoneSpecifications.RIGHT_TOES,
+    "mixamorig:LeftUpLeg": HumanBoneSpecifications.LEFT_UPPER_LEG,
+    "mixamorig:LeftLeg": HumanBoneSpecifications.LEFT_LOWER_LEG,
+    "mixamorig:LeftFoot": HumanBoneSpecifications.LEFT_FOOT,
+    "mixamorig:LeftToeBase": HumanBoneSpecifications.LEFT_TOES,
+    "mixamorig:RightHandThumb1": HumanBoneSpecifications.RIGHT_THUMB_METACARPAL,
+    "mixamorig:RightHandThumb2": HumanBoneSpecifications.RIGHT_THUMB_PROXIMAL,
+    "mixamorig:RightHandThumb3": HumanBoneSpecifications.RIGHT_THUMB_DISTAL,
+    "mixamorig:RightHandIndex1": HumanBoneSpecifications.RIGHT_INDEX_PROXIMAL,
+    "mixamorig:RightHandIndex2": HumanBoneSpecifications.RIGHT_INDEX_INTERMEDIATE,
+    "mixamorig:RightHandIndex3": HumanBoneSpecifications.RIGHT_INDEX_DISTAL,
+    "mixamorig:RightHandMiddle1": HumanBoneSpecifications.RIGHT_MIDDLE_PROXIMAL,
+    "mixamorig:RightHandMiddle2": HumanBoneSpecifications.RIGHT_MIDDLE_INTERMEDIATE,
+    "mixamorig:RightHandMiddle3": HumanBoneSpecifications.RIGHT_MIDDLE_DISTAL,
+    "mixamorig:RightHandRing1": HumanBoneSpecifications.RIGHT_RING_PROXIMAL,
+    "mixamorig:RightHandRing2": HumanBoneSpecifications.RIGHT_RING_INTERMEDIATE,
+    "mixamorig:RightHandRing3": HumanBoneSpecifications.RIGHT_RING_DISTAL,
+    "mixamorig:RightHandPinky1": HumanBoneSpecifications.RIGHT_LITTLE_PROXIMAL,
+    "mixamorig:RightHandPinky2": HumanBoneSpecifications.RIGHT_LITTLE_INTERMEDIATE,
+    "mixamorig:RightHandPinky3": HumanBoneSpecifications.RIGHT_LITTLE_DISTAL,
+    "mixamorig:LeftHandThumb1": HumanBoneSpecifications.LEFT_THUMB_METACARPAL,
+    "mixamorig:LeftHandThumb2": HumanBoneSpecifications.LEFT_THUMB_PROXIMAL,
+    "mixamorig:LeftHandThumb3": HumanBoneSpecifications.LEFT_THUMB_DISTAL,
+    "mixamorig:LeftHandIndex1": HumanBoneSpecifications.LEFT_INDEX_PROXIMAL,
+    "mixamorig:LeftHandIndex2": HumanBoneSpecifications.LEFT_INDEX_INTERMEDIATE,
+    "mixamorig:LeftHandIndex3": HumanBoneSpecifications.LEFT_INDEX_DISTAL,
+    "mixamorig:LeftHandMiddle1": HumanBoneSpecifications.LEFT_MIDDLE_PROXIMAL,
+    "mixamorig:LeftHandMiddle2": HumanBoneSpecifications.LEFT_MIDDLE_INTERMEDIATE,
+    "mixamorig:LeftHandMiddle3": HumanBoneSpecifications.LEFT_MIDDLE_DISTAL,
+    "mixamorig:LeftHandRing1": HumanBoneSpecifications.LEFT_RING_PROXIMAL,
+    "mixamorig:LeftHandRing2": HumanBoneSpecifications.LEFT_RING_INTERMEDIATE,
+    "mixamorig:LeftHandRing3": HumanBoneSpecifications.LEFT_RING_DISTAL,
+    "mixamorig:LeftHandPinky1": HumanBoneSpecifications.LEFT_LITTLE_PROXIMAL,
+    "mixamorig:LeftHandPinky2": HumanBoneSpecifications.LEFT_LITTLE_INTERMEDIATE,
+    "mixamorig:LeftHandPinky3": HumanBoneSpecifications.LEFT_LITTLE_DISTAL,
+}
+
+CONFIG: Final = ("Mixamo", MAPPING)

package/browser/addons/vrm/common/human_bone_mapper/mmd_mapping.py

@@ -0,0 +1,115 @@
+# SPDX-License-Identifier: MIT OR GPL-3.0-or-later
+from collections.abc import Mapping, Sequence
+from typing import Final
+
+from bpy.types import Object
+
+from ..logger import get_logger
+from ..vrm1.human_bone import HumanBoneSpecification, HumanBoneSpecifications
+
+_logger = get_logger(__name__)
+
+# Mapping table for MMD (MikuMikuDance) bone names to VRM human bone specifications.
+# These Japanese bone names are standard MMD naming conventions and should be preserved.
+MMD_BONE_NAME_AND_HUMAN_BONE_SPECIFICATION_PAIRS: Final[
+    Sequence[tuple[str, HumanBoneSpecification]]
+] = [
+    ("頭", HumanBoneSpecifications.HEAD),
+    ("右目", HumanBoneSpecifications.RIGHT_EYE),
+    ("左目", HumanBoneSpecifications.LEFT_EYE),
+    ("首", HumanBoneSpecifications.NECK),
+    ("上半身2", HumanBoneSpecifications.CHEST),
+    ("上半身", HumanBoneSpecifications.SPINE),
+    ("センター", HumanBoneSpecifications.HIPS),
+    ("右肩", HumanBoneSpecifications.RIGHT_SHOULDER),
+    ("右腕", HumanBoneSpecifications.RIGHT_UPPER_ARM),
+    ("右ひじ", HumanBoneSpecifications.RIGHT_LOWER_ARM),
+    ("右手", HumanBoneSpecifications.RIGHT_HAND),
+    ("右手首", HumanBoneSpecifications.RIGHT_HAND),
+    ("右足", HumanBoneSpecifications.RIGHT_UPPER_LEG),
+    ("右ひざ", HumanBoneSpecifications.RIGHT_LOWER_LEG),
+    ("右足首", HumanBoneSpecifications.RIGHT_FOOT),
+    ("右つま先", HumanBoneSpecifications.RIGHT_TOES),
+    ("右足先EX", HumanBoneSpecifications.RIGHT_TOES),
+    ("左肩", HumanBoneSpecifications.LEFT_SHOULDER),
+    ("左腕", HumanBoneSpecifications.LEFT_UPPER_ARM),
+    ("左ひじ", HumanBoneSpecifications.LEFT_LOWER_ARM),
+    ("左手", HumanBoneSpecifications.LEFT_HAND),
+    ("左手首", HumanBoneSpecifications.LEFT_HAND),
+    ("左足", HumanBoneSpecifications.LEFT_UPPER_LEG),
+    ("左ひざ", HumanBoneSpecifications.LEFT_LOWER_LEG),
+    ("左足首", HumanBoneSpecifications.LEFT_FOOT),
+    ("左つま先", HumanBoneSpecifications.LEFT_TOES),
+    ("左足先EX", HumanBoneSpecifications.LEFT_TOES),
+    ("右親指０", HumanBoneSpecifications.RIGHT_THUMB_METACARPAL),
+    ("右親指１", HumanBoneSpecifications.RIGHT_THUMB_METACARPAL),
+    ("右親指１", HumanBoneSpecifications.RIGHT_THUMB_PROXIMAL),
+    ("右親指２", HumanBoneSpecifications.RIGHT_THUMB_PROXIMAL),
+    ("右親指２", HumanBoneSpecifications.RIGHT_THUMB_DISTAL),
+    ("右人指１", HumanBoneSpecifications.RIGHT_INDEX_PROXIMAL),
+    ("右人指２", HumanBoneSpecifications.RIGHT_INDEX_INTERMEDIATE),
+    ("右人指３", HumanBoneSpecifications.RIGHT_INDEX_DISTAL),
+    ("右中指１", HumanBoneSpecifications.RIGHT_MIDDLE_PROXIMAL),
+    ("右中指２", HumanBoneSpecifications.RIGHT_MIDDLE_INTERMEDIATE),
+    ("右中指３", HumanBoneSpecifications.RIGHT_MIDDLE_DISTAL),
+    ("右薬指１", HumanBoneSpecifications.RIGHT_RING_PROXIMAL),
+    ("右薬指２", HumanBoneSpecifications.RIGHT_RING_INTERMEDIATE),
+    ("右薬指３", HumanBoneSpecifications.RIGHT_RING_DISTAL),
+    ("右小指１", HumanBoneSpecifications.RIGHT_LITTLE_PROXIMAL),
+    ("右小指２", HumanBoneSpecifications.RIGHT_LITTLE_INTERMEDIATE),
+    ("右小指３", HumanBoneSpecifications.RIGHT_LITTLE_DISTAL),
+    ("左親指０", HumanBoneSpecifications.LEFT_THUMB_METACARPAL),
+    ("左親指１", HumanBoneSpecifications.LEFT_THUMB_METACARPAL),
+    ("左親指１", HumanBoneSpecifications.LEFT_THUMB_PROXIMAL),
+    ("左親指２", HumanBoneSpecifications.LEFT_THUMB_PROXIMAL),
+    ("左親指２", HumanBoneSpecifications.LEFT_THUMB_DISTAL),
+    ("左人指１", HumanBoneSpecifications.LEFT_INDEX_PROXIMAL),
+    ("左人指２", HumanBoneSpecifications.LEFT_INDEX_INTERMEDIATE),
+    ("左人指３", HumanBoneSpecifications.LEFT_INDEX_DISTAL),
+    ("左中指１", HumanBoneSpecifications.LEFT_MIDDLE_PROXIMAL),
+    ("左中指２", HumanBoneSpecifications.LEFT_MIDDLE_INTERMEDIATE),
+    ("左中指３", HumanBoneSpecifications.LEFT_MIDDLE_DISTAL),
+    ("左薬指１", HumanBoneSpecifications.LEFT_RING_PROXIMAL),
+    ("左薬指２", HumanBoneSpecifications.LEFT_RING_INTERMEDIATE),
+    ("左薬指３", HumanBoneSpecifications.LEFT_RING_DISTAL),
+    ("左小指１", HumanBoneSpecifications.LEFT_LITTLE_PROXIMAL),
+    ("左小指２", HumanBoneSpecifications.LEFT_LITTLE_INTERMEDIATE),
+    ("左小指３", HumanBoneSpecifications.LEFT_LITTLE_DISTAL),
+]
+
+
+def create_config(
+    armature: Object,
+) -> tuple[str, Mapping[str, HumanBoneSpecification]]:
+    mmd_bone_name_to_bpy_bone_name: dict[str, str] = {}
+    for bone in armature.pose.bones:
+        # https://github.com/UuuNyaa/blender_mmd_tools/blob/97861e3c32ba423833b6c5fc3432127b1ec1182a/mmd_tools/properties/__init__.py#L45-L46
+        mmd_bone = getattr(bone, "mmd_bone", None)
+        if not mmd_bone:
+            continue
+
+        # https://github.com/UuuNyaa/blender_mmd_tools/blob/97861e3c32ba423833b6c5fc3432127b1ec1182a/mmd_tools/properties/bone.py#L43-L48
+        name_j = getattr(mmd_bone, "name_j", None)
+        if not isinstance(name_j, str):
+            continue
+
+        mmd_bone_name_to_bpy_bone_name[name_j] = bone.name
+
+    mapping: dict[str, HumanBoneSpecification] = {}
+    for (
+        mmd_bone_name,
+        human_bone_specification,
+    ) in MMD_BONE_NAME_AND_HUMAN_BONE_SPECIFICATION_PAIRS:
+        bpy_bone_name = mmd_bone_name_to_bpy_bone_name.get(mmd_bone_name)
+        if not bpy_bone_name:
+            continue
+        if bpy_bone_name in mapping or human_bone_specification in mapping.values():
+            continue
+        mapping[bpy_bone_name] = human_bone_specification
+
+    name = "MikuMikuDance"
+    for specification in HumanBoneSpecifications.all_human_bones:
+        if specification.requirement and specification not in mapping.values():
+            return (name, {})
+
+    return (name, mapping)