¶ Огляд функціоналу
Це MEL-скрипт “Measure Tools”, який додає в Maya зручне вікно для вимірювання дистанції між вершинами, створення Distance Dimension-інструментів з обмеженням по осях (X/Y/Z/All), підрахунку кута між 3 вершинами, а також має вбудований конвертер одиниць (inch/feet/yards ↔ meter/cm/mm). Плюс меню “Options/Help” і невеликі утиліти (виділення локаторів distance tool, auto UV).
Нижче — структурований опис, що саме робить код.
¶ 1. Збережені налаштування (optionVar)
На старті скрипт ініціалізує optionVar, щоб пам’ятати стан UI і параметри відображення між запуском Maya:
¶ Перемикач Unit Convert
MTconvertUnitsToggle(0/1) — чи показана вкладка Units Convert.
Якщо змінна не існує — створюється зі значенням 0 (вкладка закрита).
¶ Кольори для distance tool та локаторів
Задаються дефолтні RGB для X/Y/Z/ALL (у вигляді float array):
- X (червоний):
distColor_xSet,locColor_xSet - Y (зелений):
distColor_ySet,locColor_ySet - Z (синій):
distColor_zSet,locColor_zSet - ALL (білий/сірий):
distColor_allSet,locColor_allSet
Це потім застосовується як overrideColorRGB на трансформах distanceMeasure і locator’ів.
¶ Масштаб локаторів
locScale_DSet— scale локаторів для “звичайного” distance tool (default 0.4)locScale_CSet— scale локаторів для distance tool з constraint’ами (default 0.05)
¶ Precision (точність) distanceDimShape
MTdistToolPrecVal— точність distance tool (precision) замість стандартних 6 знаків. Default = 2.
¶ Важлива системна опція Maya
selectPref -trackSelectionOrder true;
Скрипт вмикає Ordered Selection, бо він критично потрібен:- для правильного порядку вершин у вимірі кута
- для позиціонування distance tool (він бере вершини через
ls -os)
- Коли вікно закривається, closeCommand робить:
selectPref -trackSelectionOrder false;
¶ 2. Побудова UI (вікно “Measure Tools”)
Скрипт створює вікно UnitConvert (якщо є — видаляє і створює заново).
¶ Верхнє меню
Options
- “Locators Selection”
- Selected →
locFromSelected();(виділити локатори лише вибраних distanceMeasure) - Global →
locGlobalSelect();(виділити локатори всіх distanceMeasure у сцені)
- Selected →
- “Quick Auto UV” →
quickAutoUVLayout(); - “Preferences …” → підтягує інший файл
measurePreferencesUI.melі відкриває налаштування
Help
- Tutorial (YouTube)
- Gumroad
- Facebook / ArtStation
- Email (через warning, щоб його можна було скопіювати)
¶ 3. Блок “Measure Tools” (дистанція/кут/distance tools)
¶ Quick Distance (між 2 вершинами)
- UI:
distanceFiled(textField) - Кнопка з іконкою →
distanceToolSelVert();
distanceToolSelVert():
- Береться вибір вершин
ls -sl -fl pointPosition -w→ отримує позиції- Рахує векторну відстань через
mag - Обрізає до 3 знаків (
trunc(x*1000)/1000) - Виводить число у
distanceFiled
¶ Quick Angle (між 3 вершинами)
- UI:
angleFiled - Кнопка →
selectAngleSelected();
selectAngleSelected() має 2 режими:
- LMB: якщо вибрано рівно 3 вершини (в правильному порядку)
- бере O, U, V
- рахує кут між векторами
angle $U $V - переводить в градуси
rad_to_deg - округлює до 2 знаків
- пише в
angleFiled
- Shift+LMB: “convert as 360 degree”
- бере значення з поля
- робить
360 - value - записує назад
Важливо: цей інструмент прямо залежить від
trackSelectionOrder.
¶ Create Distance Tool
Кнопка → createDistanceTool();
Поруч є чекбокс constrainOnOff — включає “Point on Poly constraint”.
Також є radio кнопки для осей:
- ALL / X / Y / Z
і функціїchangeIconsAll/X/Y/Z()лише міняють іконки, щоб UI показував активний режим.
¶ Що робить createDistanceTool()
- Читає активну вісь (All/X/Y/Z) через
iconTextRadioButton -q -sl ... - Бере:
ls -hilite(щоб потім “повернути” режим/вибір)ls -os -fl(дві вершини у правильному порядку)
- Отримує world позиції вершин через
xform -q -t -ws - Створює distanceDimension спочатку у фіксованій позиції (
-sp 0 0 0 -ep 0 0 1)- це зроблено, щоб Maya не “переюзала” ті самі локатори при створенні
- Витягує потрібні ноди:
- знаходить distanceDimShape та трансформи через
listHistory+listRelatives -p
- знаходить distanceDimShape та трансформи через
- Ставить
precisiondistanceDimShape на значення з optionVarMTdistToolPrecVal - Розставляє локатори:
- якщо X: другий локатор отримує X від другої вершини, але YZ від першої
- якщо Y: змінюється тільки Y
- якщо Z: змінюється тільки Z
- якщо ALL: ставить повні позиції обох вершин
- Якщо
constrainOnOff == 1, робитьdoCreatePointOnPolyConstraintArgList- під’єднує локатори до вершин “Point on Poly”
- причому параметри constraint різні залежно від осі (щоб заморожувати/пропускати компоненти)
- Колір distance tool:
- вмикає
overrideEnabled+overrideRGBColors - застосовує колір залежно від осі, беручи RGB з optionVar (
distColor_*Set) - і перейменовує distanceMeasure transform у:
_X_distanceMeasure,_Y_distanceMeasure,_Z_distanceMeasure,_ALL_distanceMeasure
- вмикає
- Локатори:
- дістає scale та кольори з optionVar
- ставить scale:
- якщо constraints ON →
locScale_CSet - якщо constraints OFF →
locScale_DSet
- якщо constraints ON →
- колір локатора синхронізує з кольором distance tool (
locColor_*Set)
- В кінці чистить selection і повертає component selection режим.
¶ Clear кнопки
- Delete All →
clearAllDistanceTools();- збирає всі
distanceDimShape - знаходить їх трансформи та видаляє
- збирає всі
- Delete Selected →
clearSelectedDistance();- перевіряє, що вибрані тільки
*distanceMeasure* - знаходить підключені локатори через connections
- видаляє і distanceMeasure transform, і локатори
- перевіряє, що вибрані тільки
¶ 4. Locators Selection (меню Options)
locFromSelected()
- Очікує, що ти вибрав один або кілька
*_distanceMeasure* - Перевіряє валідність selection через
gmatch "*_distanceMeasure*" - Для кожного distance tool знаходить shape і його connections (локатори)
- Виділяє локатори і активує ScaleTool
locGlobalSelect()
- Збирає всі
distanceDimShapeв сцені - Знаходить підключені локатори через
listConnections -d 1 - Виділяє їх і вмикає ScaleTool
¶ 5. Quick Auto UV
quickAutoUVLayout()
- бере вибрані трансформи
- на кожному запускає
polyAutoProjection ... -ch 0 - повертає selection назад
- друкує info
Це утиліта “на швидко”, щоб перерозкласти UV після деформацій/констрейнтів.
¶ 6. Units Convert (вкладка, що ховається)
UI розділ “Units Convert” має:
- toggle-кнопку (вкл/викл)
- якщо увімкнено — блок конвертації
¶ Режими конвертації
Є 3 layout-режими:
mmLayout()— inch/feet/yards ↔ millimetercmLayout()— inch/feet/yards ↔ centimetermLayout()— inch/feet/yards ↔ meter
Кожен layout:
- міняє label (
Meter,Centimeter,Millimeter) - підмінює
-cccallback у floatField, щоб при зміні значення автоматично рахувалось у правильні одиниці - трішки підганяє позиції label у formLayout
¶ Реальні формули
Скрипт має окремі proc input...() для кожної пари:
- inches ↔ mm/cm/m
- feet ↔ mm/cm/m
- yards ↔ mm/cm/m
Наприклад:
- inches → meter:
* 0.0254 - meter → inches:
* 39.37007874 - feet → meter:
* 0.3048 - yards → mm:
* 914.4
¶ Toggle вкладки
toggleUnitConverUI():
- якщо було OFF → вмикає, створює
unitConvertUIlayout динамічно, зберігає optionVar=1 - якщо було ON → видаляє layout
deleteUI -layout unitConvertUI, ставить optionVar=0, зменшує висоту вікна