usagi-picker 0.1.0__tar.gz

usagi_picker-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MF_ZOOL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

usagi_picker-0.1.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: usagi-picker
+Version: 0.1.0
+Summary: Animation picker for Autodesk Maya
+License: MIT
+Project-URL: Homepage, https://github.com/zool-rig/usagi-picker
+Project-URL: Repository, https://github.com/zool-rig/usagi-picker
+Project-URL: Documentation, https://github.com/zool-rig/usagi-picker/tree/main/python/bozon-ui
+Project-URL: Issues, https://github.com/zool-rig/usagi-picker/issues
+Keywords: animation,maya,picker,rig,usagi,anim
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Usagi Picker 🐇
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.7%2B-blue.svg)](https://www.python.org)
+[![Maya](https://img.shields.io/badge/Maya-2022%2B-green.svg)](https://www.autodesk.com/products/maya/overview)
+[![PyPI version](https://badge.fury.io/py/usagi-picker.svg)](https://badge.fury.io/py/usagi-picker)
+
+---
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Features](#features)
+- [Usage](#usage)
+- [Project Status](#project-status)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+Usagi is a modern open source animation picker for Autodesk Maya.
+
+![picker image](/doc/images/picker.png)
+
+## Installation
+
+Clone this repository and drop the `drag_n_drop_install.py` file in the maya's viewport.
+
+Or install it with pip
+
+```bash
+mayapy -m pip install usagi-picker
+```
+
+## Features
+
+* Create a picker for any rigs using maya objects as templates.
+
+![edit scene image](/doc/images/edit_scene.png)
+
+* Navigate in the picker like in a 2D scene.
+
+## Usage
+
+## Project Status
+
+## Contributing
+
+## License

usagi_picker-0.1.0/README.md

@@ -0,0 +1,49 @@
+# Usagi Picker 🐇
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.7%2B-blue.svg)](https://www.python.org)
+[![Maya](https://img.shields.io/badge/Maya-2022%2B-green.svg)](https://www.autodesk.com/products/maya/overview)
+[![PyPI version](https://badge.fury.io/py/usagi-picker.svg)](https://badge.fury.io/py/usagi-picker)
+
+---
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Features](#features)
+- [Usage](#usage)
+- [Project Status](#project-status)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+Usagi is a modern open source animation picker for Autodesk Maya.
+
+![picker image](/doc/images/picker.png)
+
+## Installation
+
+Clone this repository and drop the `drag_n_drop_install.py` file in the maya's viewport.
+
+Or install it with pip
+
+```bash
+mayapy -m pip install usagi-picker
+```
+
+## Features
+
+* Create a picker for any rigs using maya objects as templates.
+
+![edit scene image](/doc/images/edit_scene.png)
+
+* Navigate in the picker like in a 2D scene.
+
+## Usage
+
+## Project Status
+
+## Contributing
+
+## License

usagi_picker-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[project]
+name = "usagi-picker"
+version = "0.1.0"
+description = "Animation picker for Autodesk Maya"
+readme = "README.md"
+requires-python = ">=3.7"
+license = { text = "MIT" }
+keywords = ["animation", "maya", "picker", "rig", "usagi", "anim"]
+classifiers = [
+	"Development Status :: 3 - Alpha",
+	"Intended Audience :: End Users/Desktop",
+	"License :: OSI Approved :: MIT License",
+	"Programming Language :: Python :: 3",
+	"Programming Language :: Python :: 3 :: Only",
+	"Programming Language :: Python :: 3.7",
+	"Topic :: Multimedia :: Graphics",
+	"Topic :: Software Development :: User Interfaces",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/zool-rig/usagi-picker"
+Repository = "https://github.com/zool-rig/usagi-picker"
+Documentation = "https://github.com/zool-rig/usagi-picker/tree/main/python/bozon-ui"
+Issues = "https://github.com/zool-rig/usagi-picker/issues"
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+usagi_picker = [
+	"resources/styles/*.qss",
+	"resources/icons/*",
+	"resources/icons/**/*",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"**/__init__.py" = ["F401"]

usagi_picker-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

usagi_picker-0.1.0/src/usagi_picker/__init__.py

@@ -0,0 +1 @@
+from __future__ import annotations

usagi_picker-0.1.0/src/usagi_picker/constants.py

@@ -0,0 +1,119 @@
+from __future__ import annotations
+
+from typing import Any
+
+from usagi_picker.maya_utils.color import Color
+
+
+# Naming convention
+VALID_NAME_CHARS: str = r"^[a-zA-Z0-9_:]+$"
+SIDE_MIRROR_MAP: dict[str, str] = {
+    "L": "R",
+    "R": "L",
+    "C": "C"
+}
+
+# Suffixes
+ORIG_SUFFIX: str = "orig"
+GROUP_SUFFIX: str = "grp"
+PICKER_SUFFIX: str = "pkr"
+
+# Groups
+ROOT_GROUP: str = f"root__{GROUP_SUFFIX}"
+PICKER_GROUP: str = f"picker__{GROUP_SUFFIX}"
+SETTINGS_NODE = f"settings__{GROUP_SUFFIX}"
+
+# Attributes
+PICKER_DATA_ATTRIBUTE: str = "usagi_picker_data"
+IS_TAB_TAG: str = "usagi_picker_is_tab"
+IS_BACKDROP_TAG: str = "usagi_picker_is_backdrop"
+IS_SETTINGS_TAG: str = "usagi_picker_is_settings"
+IS_SELECT_SHAPE_TAG: str = "usagi_picker_is_select_shape"
+IS_BUTTON_TAG: str = "usagi_picker_is_button"
+IS_LABEL_TAG: str = "usagi_picker_is_label"
+IS_TOGGLE_TAG: str = "usagi_picker_is_toggle"
+IS_FOLDER_TAG: str = "usagi_picker_is_folder"
+ACTION_TAG: str = "usagi_picker_actions"
+TEXT_TAG: str = "usagi_picker_text"
+COLOR_TAG: str = "usagi_picker_color"
+OUTLINE_COLOR_TAG: str = "usagi_picker_outline_color"
+SELCTION_COLOR_TAG: str = "usagi_picker_selection_color"
+MIRROR_ATTRIBUTE = "mirror_behavior"
+
+# Misc
+PICKER_EXTENSION: str = ".upkr"
+IDENTITY_MATRIX: list[float] = [
+    1.0,
+    0.0,
+    0.0,
+    0.0,
+    0.0,
+    1.0,
+    0.0,
+    0.0,
+    0.0,
+    0.0,
+    1.0,
+    0.0,
+    0.0,
+    0.0,
+    0.0,
+    1.0,
+]
+SHAPE_DEFAULT_RADIUS: int = 30
+SHAPE_DEFAULT_COLOR: Color = Color(0, 1, 0)
+SELECT_SHAPE_DEFAULT_ACTIONS: dict[str, Any] = {
+    "1": {"name": "Select", "args": [[]], "mandatory": True},
+    "2": {
+        "name": "Context Menu",
+        "args": [
+            [],
+            [
+                "Toggle Nodes Visibility",
+                "Toggle Shapes Visibility",
+                "Separator",
+                "Reset All",
+                "Reset Translate",
+                "Reset Rotate",
+                "Reset Scale",
+                "Reset Customs",
+                "Separator",
+                "Mirror",
+                # "Select Opposite",
+                "Separator",
+                "Key All",
+                "Key Translate",
+                "Key Rotate",
+                "Key Scale",
+                "Key Customs",
+            ],
+        ],
+        "mandatory": False,
+    },
+    "67108866": {
+        "name": "Context Menu",
+        "args": [
+            [],
+            [
+                "Toggle Nodes Visibility",
+                "Toggle Shapes Visibility",
+                "Separator",
+                "Reset All",
+                "Reset Translate",
+                "Reset Rotate",
+                "Reset Scale",
+                "Reset Customs",
+                "Separator",
+                "Mirror",
+                # "Select Opposite",
+                "Separator",
+                "Key All",
+                "Key Translate",
+                "Key Rotate",
+                "Key Scale",
+                "Key Customs",
+            ],
+        ],
+        "mandatory": False,
+    },
+}

usagi_picker-0.1.0/src/usagi_picker/core/__init__.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from maya import cmds
+
+from usagi_picker.constants import PICKER_DATA_ATTRIBUTE
+
+from usagi_picker.core.picker_data_node import PickerDataNode
+from usagi_picker.core.graph import Graph
+
+
+def collect_pickers() -> list[PickerDataNode]:
+    picker_data_nodes = []
+    picker_data_plugs = cmds.ls(f"::*.{PICKER_DATA_ATTRIBUTE}")
+    for plug in sorted(picker_data_plugs):
+        namespace = plug.rpartition(":")[0]
+        data = cmds.getAttr(plug)
+        graph = Graph.loads(data)
+        picker_data_nodes.append(PickerDataNode(namespace, graph))
+    return picker_data_nodes

usagi_picker-0.1.0/src/usagi_picker/core/actions/__init__.py

@@ -0,0 +1,73 @@
+from json import JSONDecoder, JSONEncoder
+from typing import Any
+
+from usagi_picker.core.actions.abstract import AbstractAction
+from usagi_picker.core.actions.select import SelectAction
+from usagi_picker.core.actions.select_add import SelectAddAction
+from usagi_picker.core.actions.deselect import DeselectAction
+from usagi_picker.core.actions.context_menu import ContextMenuAction
+from usagi_picker.core.actions.reset_all import ResetAll
+from usagi_picker.core.actions.reset_translate import ResetTranslate
+from usagi_picker.core.actions.reset_rotate import ResetRotate
+from usagi_picker.core.actions.reset_scale import ResetScale
+from usagi_picker.core.actions.reset_customs import ResetCustoms
+from usagi_picker.core.actions.toggle_textures import ToggleTextures
+from usagi_picker.core.actions.toggle_smooth import ToggleSmooth
+from usagi_picker.core.actions.toggle_controllers import ToggleControllers
+from usagi_picker.core.actions.mirror import Mirror
+from usagi_picker.core.actions.select_opposite import SelectOpposite
+from usagi_picker.core.actions.key_all import KeyAll
+from usagi_picker.core.actions.key_translate import KeyTranslate
+from usagi_picker.core.actions.key_rotate import KeyRotate
+from usagi_picker.core.actions.key_scale import KeyScale
+from usagi_picker.core.actions.key_customs import KeyCustoms
+from usagi_picker.core.actions.toggle_asset import ToggleAsset
+from usagi_picker.core.actions.toggle_nodes_visibility import ToogleNodesVisibility
+from usagi_picker.core.actions.toggle_shapes_visibility import ToogleShapesVisibility
+from usagi_picker.core.actions.match_ik_fk import MatchIKFKAction
+
+ACTIONS = {
+    SelectAction.NAME: SelectAction,
+    SelectAddAction.NAME: SelectAddAction,
+    DeselectAction.NAME: DeselectAction,
+    ContextMenuAction.NAME: ContextMenuAction,
+    ResetAll.NAME: ResetAll,
+    ResetTranslate.NAME: ResetTranslate,
+    ResetRotate.NAME: ResetRotate,
+    ResetScale.NAME: ResetScale,
+    ResetCustoms.NAME: ResetCustoms,
+    ToggleTextures.NAME: ToggleTextures,
+    ToggleSmooth.NAME: ToggleSmooth,
+    ToggleControllers.NAME: ToggleControllers,
+    Mirror.NAME: Mirror,
+    SelectOpposite.NAME: SelectOpposite,
+    KeyAll.NAME: KeyAll,
+    KeyTranslate.NAME: KeyTranslate,
+    KeyRotate.NAME: KeyRotate,
+    KeyScale.NAME: KeyScale,
+    KeyCustoms.NAME: KeyCustoms,
+    ToggleAsset.NAME: ToggleAsset,
+    ToogleNodesVisibility.NAME: ToogleNodesVisibility,
+    ToogleShapesVisibility.NAME: ToogleShapesVisibility,
+    MatchIKFKAction.NAME: MatchIKFKAction,
+}
+
+
+class ActionEncoder(JSONEncoder):
+    def default(self, o: Any) -> Any:
+        if isinstance(o, AbstractAction):
+            return o.serialize()
+        return super().default(o)
+
+
+class ActionDecoder(JSONDecoder):
+    def __init__(self, *args, **kwargs) -> None:
+        super().__init__(object_hook=self.object_hook, *args, **kwargs)
+
+    def object_hook(self, data: dict[str, Any]) -> Any:
+        result = data
+        if "name" in data and data["name"] in ACTIONS:
+            result = ACTIONS[data["name"]].from_dict(data)
+        if isinstance(result, dict):
+            result = {int(k): v for k, v in result.items()}
+        return result

usagi_picker-0.1.0/src/usagi_picker/core/actions/abstract.py

@@ -0,0 +1,68 @@
+from __future__ import annotations
+
+from maya import cmds
+
+from typing import Any
+
+from usagi_picker.maya_utils.sets import get_sets_members
+
+
+class AbstractAction(object):
+    NAME = "Abstract"
+    ARGS_TYPES = ()
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any]) -> AbstractAction:
+        return cls(args=data["args"], mandatory=data["mandatory"])
+
+    def __init__(self, args: tuple[Any, ...], mandatory: bool = False) -> None:
+        self.args = args
+        self.mandatory = mandatory
+
+    def __call__(self, namespace: str) -> None:
+        raise NotImplementedError
+
+    def serialize(self) -> dict[str, Any]:
+        return {
+            "name": self.NAME,
+            "args": self.args,
+            "mandatory": self.mandatory,
+        }
+
+    @classmethod
+    def deserialize(cls, data: dict[str, Any]) -> AbstractAction:
+        return cls.from_dict(data)
+
+    def validate(self, namespace: str) -> bool:
+        return True
+
+
+class AbstractActionOnNodes(AbstractAction):
+    ARGS_TYPES = (("Nodes", "node_list"),)
+
+    def __init__(self, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        self.nodes = self.args[0]
+
+    def get_nodes(self, namespace: str) -> list[str]:
+        nodes = list()
+        if self.args and self.nodes:
+            nodes = cmds.ls([f"{namespace}:{node}" for node in self.nodes])
+            if not nodes:
+                cmds.warning(
+                    f"No objects found for {self.nodes} in namespace {namespace}"
+                )
+                return
+        else:
+            nodes = cmds.ls(selection=True, type="transform")
+            if not nodes:
+                cmds.warning("Nothing is selected, please select some controllers")
+                return
+
+        result = list()
+        for node in nodes:
+            if cmds.nodeType(node) == "objectSet":
+                result.extend(get_sets_members(node))
+            else:
+                result.append(node)
+        return result

usagi_picker-0.1.0/src/usagi_picker/core/actions/context_menu.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+
+from usagi_picker.qsagi.qt import QComboBox, QMenu
+from usagi_picker.qsagi.qt import QCursor
+from usagi_picker.qsagi.qt import qt_exec
+
+from functools import partial
+
+from usagi_picker.core.actions.abstract import AbstractAction
+from usagi_picker.qsagi.maya_utils import maya_main_window
+
+
+def _combobox_default_func(combo: QComboBox) -> None:
+    from usagi_picker.core.actions import ACTIONS
+
+    actions = ["Separator"]
+    for name, action_type in sorted(ACTIONS.items(), key=lambda x: x[0]):
+        if len(action_type.ARGS_TYPES) == 1 and action_type.ARGS_TYPES[0][0] == "Nodes":
+            actions.append(name)
+    combo.addItems(actions)
+
+
+class ContextMenuAction(AbstractAction):
+    NAME = "Context Menu"
+    ARGS_TYPES = (
+        ("Nodes", "node_list"),
+        (
+            "Menu Actions",
+            "list",
+            QComboBox,
+            "currentText",
+            "setCurrentText",
+            "currentIndexChanged",
+            _combobox_default_func,
+        ),
+    )
+
+    def __init__(self, *args, **kwargs) -> None:
+        super().__init__(*args, **kwargs)
+        self.nodes, self.menu_actions = self.args
+
+    def __call__(self, namespace: str) -> None:
+        from usagi_picker.core.actions import ACTIONS
+
+        menu = QMenu(parent=maya_main_window())
+        for action_name in self.menu_actions:
+            if action_name == "Separator":
+                menu.addSeparator()
+            else:
+                action = ACTIONS[action_name]([self.nodes])
+                if action.validate(namespace):
+                    menu.addAction(action_name).triggered.connect(
+                        partial(action, namespace)
+                    )
+        qt_exec(menu, QCursor.pos())

usagi_picker-0.1.0/src/usagi_picker/core/actions/deselect.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+from maya import cmds
+
+from usagi_picker.core.actions.abstract import AbstractAction
+
+
+class DeselectAction(AbstractAction):
+    NAME = "Deselect"
+    ARGS_TYPES = (("Nodes", "node_list"),)
+
+    def __call__(self, namespace: str) -> None:
+        if not self.args:
+            return
+        nodes = self.args[0]
+        if not nodes:
+            return
+        to_select = cmds.ls([f"{namespace}:{node}" for node in nodes])
+        if to_select:
+            cmds.select(to_select, deselect=True)
+        else:
+            cmds.warning(f"No objects found for {nodes} in namespace {namespace}")

usagi_picker-0.1.0/src/usagi_picker/core/actions/key_all.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from maya import cmds
+
+from usagi_picker.core.actions.abstract import AbstractActionOnNodes
+
+
+class KeyAll(AbstractActionOnNodes):
+    NAME = "Key All"
+
+    def __call__(self, namespace: str) -> None:
+        nodes = self.get_nodes(namespace)
+        if not nodes:
+            return
+        cmds.setKeyframe(nodes)

usagi_picker-0.1.0/src/usagi_picker/core/actions/key_customs.py

@@ -0,0 +1,20 @@
+from __future__ import annotations
+
+from maya import cmds
+
+from usagi_picker.core.actions.abstract import AbstractActionOnNodes
+
+
+class KeyCustoms(AbstractActionOnNodes):
+    NAME = "Key Customs"
+
+    def __call__(self, namespace: str) -> None:
+        nodes = self.get_nodes(namespace)
+        if not nodes:
+            return
+        for node in nodes:
+            custom_attributes = (
+                cmds.listAttr(node, userDefined=True, keyable=True) or []
+            )
+            if custom_attributes:
+                cmds.setKeyframe(nodes, attribute=custom_attributes)

usagi_picker-0.1.0/src/usagi_picker/core/actions/key_rotate.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from maya import cmds
+
+from usagi_picker.core.actions.abstract import AbstractActionOnNodes
+
+
+class KeyRotate(AbstractActionOnNodes):
+    NAME = "Key Rotate"
+
+    def __call__(self, namespace: str) -> None:
+        nodes = self.get_nodes(namespace)
+        if not nodes:
+            return
+        cmds.setKeyframe(nodes, attribute=("rx", "ry", "rz"))

usagi_picker-0.1.0/src/usagi_picker/core/actions/key_scale.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from maya import cmds
+
+from usagi_picker.core.actions.abstract import AbstractActionOnNodes
+
+
+class KeyScale(AbstractActionOnNodes):
+    NAME = "Key Scale"
+
+    def __call__(self, namespace: str) -> None:
+        nodes = self.get_nodes(namespace)
+        if not nodes:
+            return
+        cmds.setKeyframe(nodes, attribute=("sx", "sy", "sz"))

usagi_picker-0.1.0/src/usagi_picker/core/actions/key_translate.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from maya import cmds
+
+from usagi_picker.core.actions.abstract import AbstractActionOnNodes
+
+
+class KeyTranslate(AbstractActionOnNodes):
+    NAME = "Key Translate"
+
+    def __call__(self, namespace: str) -> None:
+        nodes = self.get_nodes(namespace)
+        if not nodes:
+            return
+        cmds.setKeyframe(nodes, attribute=("tx", "ty", "tz"))

usagi_picker-0.1.0/src/usagi_picker/core/actions/match_ik_fk.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+
+from usagi_picker.maya_utils.ik_fk import toggle_from_nodes
+from usagi_picker.core.actions.abstract import AbstractActionOnNodes
+
+
+class MatchIKFKAction(AbstractActionOnNodes):
+    NAME = "Match IK/FK"
+
+    def __call__(self, namespace: str) -> None:
+        nodes = self.get_nodes(namespace)
+        if not nodes:
+            return
+
+        toggle_from_nodes(nodes)

usagi_picker-0.1.0/src/usagi_picker/core/actions/mirror.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+
+from usagi_picker.core.actions.abstract import AbstractActionOnNodes
+from usagi_picker.maya_utils.mirror import has_mirror_value, mirror_transforms
+
+
+class Mirror(AbstractActionOnNodes):
+    NAME = "Mirror"
+
+    def validate(self, namespace: str) -> bool:
+        return all(has_mirror_value(f"{namespace}:{node}") for node in self.nodes)
+
+    def __call__(self, namespace: str) -> None:
+        nodes = self.get_nodes(namespace)
+        if not nodes:
+            return
+        for node in nodes:
+            mirror_transforms(node)