¶ Огляд функціоналу
QuickTool — це кастомне вікно з власним
shelfLayout, яке працює як міні-shelf усередині Maya.
Інструмент дозволяє користувачу вільно формувати набір інструментів через drag & drop і автоматично зберігає конфігурацію у файлshelf.mel.
Фактично це портативний shelf, який не прив’язаний до глобальних shelf Maya і може бути частиною пайплайн-інструменту.
¶ Основні можливості
¶ 1. Динамічне наповнення через Drag & Drop
Користувач може:
- перетягувати кнопки зі стандартних Maya shelf
- копіювати інструменти між вікнами
- змінювати порядок кнопок
- видаляти кнопки стандартними засобами Maya
QuickTool поводиться як звичайний shelfLayout, тому:
- не потрібні додаткові UI-кнопки
- немає кастомного “editor”
- використовується нативна поведінка Maya
¶ 2. Автоматичне збереження
Інструмент відстежує зміни shelfLayout у реальному часі:
Зберігаються:
- додавання кнопки
- видалення кнопки
- зміна порядку
- зміна команди
- зміна іконки
- зміна label / annotation
Збереження відбувається у файл: shelf.mel який лежить поруч із main.py.
Файл перезаписується автоматично при будь-якій зміні, без залежності від закриття вікна.
¶ 3. Автоматичне відновлення
При відкритті QuickTool:
- Зчитується
shelf.mel - Відтворюються всі кнопки з їх параметрами:
- label
- annotation
- image
- command
- sourceType
Таким чином інструмент завжди відкривається у стані останньої конфігурації.
¶ 4. Механізм відстеження змін
Оскільки Maya не має надійної події “Shelf Modified”, використовується внутрішній watcher:
- Працює через
scriptJob + idleEvent - Раз на ~0.7 секунди перевіряє стан shelf
- Якщо зміни виявлено — перезаписує
shelf.mel
Це гарантує стабільність навіть якщо:
- Maya не викликає close callbacks
- вікно закривається некоректно
- UI знищується нестандартним способом
¶ 5. Портативність
Шлях до shelf.mel визначається автоматично від розташування скрипта:
quick_tool/
├── main.py
└── shelf.mel
Інструмент працює навіть якщо запускається через:
compile(code_text, path, "exec")
(де __file__ недоступний)
¶ Типове застосування
QuickTool зручно використовувати як:
- shelf для рігерів
- shelf для технічних аніматорів
- набір студійних утиліт
- персональний shelf у пайплайні
¶ Висновок
QuickTool — це:
динамічний, автозберігаємий, портативний shelf, який використовує нативний UI Maya і не потребує окремого редакто