¶ Maya Tools Manager 2.0 Wiki
 |
|
¶ 🔷 Загальна архітектура
Твій плагін складається з 5 ключових частин:
Tools_Manager_Installer.py – автоінсталятор через .mod
userSetup.py – автозапуск при старті Maya
main_menu.py – ядро (створення меню з XML)
autopath.py – робота з шляхами
menu_items.xml – опис структури меню
p4.py – клієнт Perforce (окремий модуль, не пов'язаний із меню напряму)
¶ 🔷 1️⃣ Installer (Auto Module)
📄 Tools_Manager_Installer.py
Що робить:
Створює .mod файл у:
Documents/maya/modules/
Додає:
PYTHONPATH +:= .
MAYA_SCRIPT_PATH +:= .
Після встановлення:
додає tools_root в sys.path
імпортує main_menu
одразу запускає main_menu.main()
Це правильний сучасний спосіб встановлення через module system Maya.
✔ Добре зроблено
✔ Працює без ручного копіювання
✔ Підтримує автостарт
¶ 🔷 2️⃣ userSetup.py
📄 userSetup.py
import main_menu
importlib.reload(main_menu)
main_menu.main()
Це гарантує автозапуск меню при старті Maya, якщо tools_root у MAYA_SCRIPT_PATH.
✔ Простий
✔ Надійний
✔ Обгорнутий у try/except
¶ 🔷 3️⃣ autopath.py
📄
Функції:
getpath() → повертає папку tools
getsyspath() → повертає Maya/icons (для splash)
Це використовується в:
change_splash_screen(...)
Все логічно.
¶ 🔷 4️⃣ main_menu.py — Серце системи
Це найсильніша частина плагіна.
¶ ✅ Побудова меню з XML
Читає menu_items.xml
Підтримує:
- folder / unfolder
- divider
- url
- mel_commands
- command (python)
¶ ✅ Надпотужна система обробки шляхів
Реалізовано:
{TOOLS}заміну- нормалізацію старих шляхів
- виправлення legacy paths
- перерутинг неправильних абсолютних шляхів
- автоматичну конвертацію /tools/scripts → /sources/scripts
Це дуже професійний рівень.
¶ ✅ Безпечне виконання скриптів
Підтримує:
exec(open(...).read())
bare path .py
bare path .mel
чистий Python-код
mel.eval()
І головне — без проблем із кодуванням (utf-8, cp1251 fallback).
Це дуже круто.
¶ ✅ Help OptionBox
Ти правильно використовуєш:
cmds.menuItem(optionBox=True)
Maya-style help кнопка справа.
¶ ✅ Splash Screen
change_splash_screen()
Копіює файл у Maya/icons.
Працює, але є нюанс (про це нижче).
¶ 🔷 5️⃣ XML система
Меню повністю декларативне.
Це дуже правильний підхід.
Ти можеш:
- змінювати структуру без редагування Python
- керувати іконками
- додавати help
- додавати mel