Add PoseRenderer.mod for Maya module installs

Registers the module as PoseRenderer 1.0.0, auto-adding plug-ins/ to
MAYA_PLUG_IN_PATH and python/ to PYTHONPATH. Verified end-to-end
(module discovery, load-by-short-name, python/ on sys.path,
functional smoke test) on both Maya 2022 and 2024. README documents
this as the recommended install path, with the plain
MAYA_PLUG_IN_PATH route kept as a fallback.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-14 09:05:53 +08:00
parent ec5f52c7c6
commit 417ff72850
2 changed files with 26 additions and 10 deletions
+2
View File
@@ -0,0 +1,2 @@
+ PoseRenderer 1.0.0 .
PYTHONPATH+:=python
+24 -10
View File
@@ -14,16 +14,30 @@ the exact same joint mapping; switching formats does not require remapping.
## Install
1. Copy (or symlink) this whole `PoseRenderer` folder somewhere on disk.
2. Add its `plug-ins` folder to `MAYA_PLUG_IN_PATH`, e.g. in
`Maya.env`:
```
MAYA_PLUG_IN_PATH = C:\path\to\PoseRenderer\plug-ins
```
(The plugin adds its own `python/` folder to `sys.path` automatically at
load time -- you do not need to set `PYTHONPATH` yourself.)
3. In Maya: **Windows > Settings/Preferences > Plug-in Manager**, find
`openposeRenderer.py`, and check *Loaded* (and *Auto load* if desired).
**Option A -- Maya module (recommended):** copy (or symlink) this whole
`PoseRenderer` folder somewhere on disk, then add its *parent* directory to
`MAYA_MODULE_PATH` (e.g. in `Maya.env`):
```
MAYA_MODULE_PATH = C:\path\to\parent\folder
```
`PoseRenderer.mod` (at the repo root) handles the rest: it registers the
module as `PoseRenderer`, adds `plug-ins/` to `MAYA_PLUG_IN_PATH` and
`python/` to `PYTHONPATH` automatically. In Maya: **Windows >
Settings/Preferences > Plug-in Manager**, find `openposeRenderer.py`, and
check *Loaded* (and *Auto load* if desired) -- it's now loadable by its
short name (`cmds.loadPlugin("openposeRenderer")`) from anywhere.
**Option B -- plug-in path only:** skip the module system and add
`plug-ins/` directly to `MAYA_PLUG_IN_PATH` instead:
```
MAYA_PLUG_IN_PATH = C:\path\to\PoseRenderer\plug-ins
```
The plugin adds its own `python/` folder to `sys.path` automatically at
load time either way (via `MFnPlugin.loadPath()`), so `PYTHONPATH` never
needs setting by hand for the plugin itself to work -- Option A's
`PYTHONPATH` entry only matters if you want `python/openpose_renderer` (or
the bundled `debugpy`) importable outside of loading the plugin, e.g. from
a shelf script.
## Usage