¶ Огляд:
Скрипт створює UI-інструмент для швидкого генерування NURBS-контролерів (control shapes) у сцені Maya. Інструмент дозволяє обрати тип контролера (куб, коло, стрілки, кільце тощо), задати масштаб контролера через слайдер і, за потреби, автоматично прив’язати контролер до вибраного joint.
¶ Підтримуване середовище
- Autodesk Maya
- Python API через
maya.cmds - Використовує локальні PNG-іконки, що лежать поруч зі скриптом у підпапці
icons/
¶ Структура та компоненти
¶ 1. Визначення директорії скрипта
Функція get_script_dir() повертає абсолютний шлях до папки, де знаходиться файл скрипта. Передбачено кілька способів отримання шляху:
- через
__file__(якщо скрипт запущено як файл) - через
inspect.getsourcefile(...)(fallback) - через
cmds.internalVar(userScriptDir=True)як останній fallback
Шлях нормалізується під Maya (заміна \ на /) для коректного використання у image=....
¶ 2. Обробка виділення (root joint)
Функція get_selected():
- читає поточне виділення
cmds.ls(selection=True, type="joint") - якщо виділено хоча б один joint, повертає
(True, <ім’я_першого_joint>) - якщо ні —
(False, <порожньо>)
Скрипт орієнтується на перший виділений joint і використовує його як “ціль” для прив’язки.
¶ 3. Глобальний параметр масштабу
Глобальна змінна scl задає множник масштабу контролера.
- значення контролюється UI-слайдером (1..10)
- застосовується в кожній функції побудови контролера
- після масштабування викликається
makeIdentity(..., apply=True, scale=True)для “замороження” масштабу
Генерація контролерів (shape builders)
Кожна функція створення контролера виконує типову послідовність:
- Побудова кривої/набору shape-нудів (через poly primitives +
polyToCurve, або черезcurve, або через NURBS-примітиви) - Формування єдиного трансформ-нода
_ctrlз shape-нодами під ним - (Опційно) Масштабування відповідно до
scl - Створення
_jntта групи_grp - Якщо був обраний joint:
- перейменування
_ctrlу<joint>_ctrl - створення
<joint>_jnt - parenting
<joint>_jntпід<joint>_ctrl - групування в
<joint>_grp matchTransform(<joint>_ctrl, <joint>)parentConstraint(<joint>_jnt, <joint>)
- перейменування
- Виведення
inViewMessageпро завершення операції
Список доступних типів контролерів у UI
- Cube
- Circle
- Half Circle
- Sphere
- Arrow
- Single Arrow
- Double Arrow
- Four Arrow
- Pointer Arrow
- Square
- Ring
- Triangle
- Plus
- Locator
- Two Pin
- Quad Pin
Примітка: геометрія багатьох контролерів генерується через полігональні примітиви та вибір компонентів (edges/faces/verts), які конвертуються в криві. Це забезпечує контрольовану форму, але робить скрипт чутливим до імен за замовчуванням (див. “Обмеження”).
¶ Прив’язка до joint
Якщо перед створенням контролера виділено joint:
- контролер стає driver-об’єктом через зв’язку:
- joint створюється як child від контролера
- цей joint констрейнтить початковий (виділений) joint через
parentConstraint
¶ Таким чином:
- аніматор крутить/рухає контролер
- створений “проксі-joint” передає трансформації на оригінальний joint
¶ UI та керування
- Вікно:
build_ui()створює вікноwindow1_uiз назвою “Control Creator”.- вікно не масштабоване (
sizeable=False) - основний контейнер:
columnLayout - сітка кнопок:
gridLayout4×4, розмір клітинки 64×64
- вікно не масштабоване (
- Кнопки контролерів: Кожна кнопка —
cmds.iconTextButton(...):- використовує зображення з
get_script_dir() + '/icons/<name>.png' - викликає відповідну функцію генерації (Cube, Circle, …)
- використовує зображення з
- Слайдер масштабу: Після
gridLayoutдодаєтьсяrowLayoutз:- текстом
Control scale: <N> intSliderз діапазоном 1..10
- текстом
¶ Функція _on_slider_change(value):
- оновлює глобальну змінну
scl - оновлює підпис текстового поля з поточним значенням
¶ Поведінка при запуску, в кінці скрипта:
- друкується шлях до директорії скрипта (
print(get_script_dir())) - викликається
build_ui()і відкривається UI
¶ Використання
- (Опційно) Виділити joint, до якого потрібно прив’язати контролер.
- Запустити скрипт, щоб відкрити “Control Creator”.
- Встановити масштаб контролера слайдером (1..10).
- Натиснути кнопку потрібної форми.
- Отримати результат у сцені:
<joint>_ctrl/<joint>_grp/<joint>_jnt(якщо joint був виділений)- або
_ctrl/_grp/_jnt(якщо joint не виділений)
¶ Очікуваний результат у сцені
Варіант A: joint був виділений
<rootJoint>_ctrl— трансформ з shape-нодами контролера<rootJoint>_jnt— дочірній joint під контролером<rootJoint>_grp— група, що тримає контролер (для нульового офсета)- Констрейнт:
<rootJoint>_jnt→<rootJoint>(parentConstraint)
Варіант B: joint не був виділений
_ctrl,_jnt,_grpстворюються з дефолтними назвами
¶ Обмеження та ризики
- Чутливість до дефолтних імен Maya
Багато функцій використовують жорстко задані імена типу:pCube1,pPlane1,pCylinder1polyToCurve1,polyToCurveShape1curve1,curveShape1
Якщо в сцені вже є об’єкти з такими іменами або Maya згенерує інший індекс, операціїselect/rename/deleteможуть працювати некоректно.
- Використання компонентного selection
Створення форм черезselect('pCube1.e[...]')залежить від точної топології та індексації компонентів. Будь-які зміни у генерації примітива (subdivisions, smooth, історія) можуть змінити індекси. - Прив’язка через parentConstraint
Скрипт створює новий joint і використовує його як джерело констрейнта. Це робочий підхід, але:- може створювати додаткові “сервісні” суглоби в рігу
- не налаштовані maintainOffset/skip axes — використовується дефолтна поведінка Maya
- Іконки залежать від структури файлів
UI очікує наявністьicons/поруч зі скриптом. Якщо папка відсутня або шлях обчислено неправильно — кнопки будуть без зображень або з помилкою завантаження.
¶ Рекомендовані покращення (за потреби)
- Використовувати повернені значення команд (імена створених нод), а не жорстко задані
pCube1,polyToCurve1тощо. - Загорнути створення в
cmds.undoInfo(openChunk=True/closeChunk=True), щоб одна кнопка = один undo-крок. - Додати опцію “створювати тільки контролер без joint/constraint”.
- Додати параметри для maintainOffset та вибору типу констрейнта.
- Додати неймінг з префіксами/суфіксами під пайплайн (side, module, rig namespace).