- •С чего начать
- •Переменные и присвоение им значений
- •Области видимости
- •Настойчивые переменные
- •Изменяемый тип переменных
- •Присвоение значения по ссылке
- •Выделение памяти и уборка мусора
- •Имена переменных
- •Числовые литералы
- •Строковые литералы
- •Литералы времени
- •Литералы имен объектов
- •Литералы
- •Литералы точек в двумерном и трехмерном пространстве
- •Литералы массивов
- •Выражения
- •Простые выражения
- •Математические выражения
- •Порядок выполнения операций в математических выражениях
- •Полиморфизм
- •Выражения сравнения
- •Логические операции
- •Сокращенное выполнение логических выражений
- •Позиционированные и именованные параметры
- •Приоритет вызова функций
- •Написание вызова функции в несколько строк
- •Другой способ вызова функций
- •Контекстные выражения
- •Комментарии
- •Обращение из одного скрипта к другим
- •Управление порядком выполнения операторов
- •Пропуск выполнения цикла
- •Собственная обработка ошибок
- •Оформление функций
- •Переменная, содержащая функцию
- •Параметры функций
- •Принудительное завершение функции
- •Определение структур
- •Создание функций, локальных внутри структуры
- •Базовые классы maxScript Класс Value
- •Операторы
- •Литералы
- •Операторы
- •Свойства
- •Операторы
- •Точка в трехмерном пространстве
- •Литералы
- •Конструкторы
- •Свойства
- •Операторы
- •Литерал
- •Конструкторы
- •Свойства
- •Произвольный поворот
- •Литералы
- •Конструкторы
- •Операторы
- •Свойства
- •Углы Эйлера
- •Операторы
- •Свойства
- •Прямоугольник
- •Литералы
- •Конструкторы
- •Свойства
- •Операторы
- •Функция
- •Массив_чисел
- •Вспомогательные методы Функция
- •Функция
- •Можно открыть зашифрованный файл, используя функцию
- •Свойства
- •Свойства
- •Особенности работы с ключами анимации
- •Массив параметров
- •Конструкторы
- •Свойства
- •Операторы
- •Множества
- •Шаблонные группы
- •Свойства
- •Операторы
- •Функции для работы с группами
- •Наборы объектов
- •Конструкторы
- •Свойства
- •Операторы
- •Функции, работающие с наборами
- •Дополнительные сведения
- •Конструкторы
- •Свойства
- •Операторы
- •Прочие функции
- •Операторы
- •Конструкторы
- •Свойства
- •Операторы
- •Операторы
- •Конструкторы
- •Конструкторы
- •Свойства
- •Свойства
- •Операторы
- •Литералы
- •Свойства
- •Операторы
- •Конструкторы
- •Свойства
- •Операторы
- •Конструкторы
- •Свойства
- •Операторы
- •Прочие функции
- •Скрипт-утилиты
- •Панель скрипт-утилиты
- •Составные части тела свитка
- •Создание перемещаемых окон
- •Видимость локальных переменных, структур, функций и компонент интерфейса из кода свитка
- •Доступ к локальным переменным и прочим элементам утилит и свитков из внешнего кода
- •Компоненты пользовательского интерфейса
- •Название_компонента Имя_переменной Символьная_строка
- •Общие свойства компонентов пользовательского интерфейса
- •Общие параметры компонентов пользовательского интерфейса
- •Типы компонентов пользовательского интерфейса Для примера рассмотрим утилиту, использующую все возможные компоненты пользовательского интерфейса
- •Битовая карта
- •Параметры
- •Свойства
- •События
- •Параметры
- •Параметры
- •Свойства
- •События
- •Параметры
- •Свойства
- •События
- •Выпадающий список
- •Параметры
- •Свойства
- •События
- •Свойства
- •События
- •Кнопка выбора текстурной карты
- •Параметры
- •Свойства
- •События
- •Кнопка выбора материала
- •Параметры
- •Свойства
- •События
- •Список с возможностью множественного выбора
- •Параметры
- •Свойства
- •События
- •Кнопка выбора объекта
- •Параметры
- •Свойства
- •События
- •Задатчик
- •Параметры
- •Свойства
- •События
- •Параметры
- •Свойства
- •События
- •Кнопки с картинками
- •Скрипт контекстного меню
- •Тело контекстного меню
- •Пункт меню
- •Разделитель
- •Подменю
- •Макро скрипты
- •Создание файлов с иконками
- •Средства работы с мышью
- •Остановить работу средства можно вызовом функции
- •Правила оформления средств работы с мышью
- •События
- •Скрипт плугины
- •Правила построения скрипт-плугина
- •Внесение изменений в плугин
- •Урок 1. Твердые тела
- •Создание набора твердых тел
- •Добавление тел к набору
Составные части тела свитка
Внутри тела свитка (или утилиты, как специального случая свитка) может содержаться строго определенный набор элементов, а именно
Локальные переменные, функции и определения структур.
Локальные переменные чаще всего используются для сохранения данных, ассоциированных со свитком, таких, как выбранные объекты или массив сгенерированных утилитой вершин. Правила видимости переменных и способы доступа к этим переменным обсуждаются далее. Глобальные переменные не могут быть объявлены внутри утилиты или свитка. Если Вы считаете их применение целесообразным, то их можно определить непосредственно перед кодом утилиты. При этом следует помнить, что переменные с такими же именами могут быть объявлены в других утилитах.
Средства работы с манипулятором “мышь”
Эти средства могут использоваться для описания действий пользователя в видовых окнах 3ds max, и будут рассматриваться позже.
Определения компонентов пользовательского интерфейса
Эти компоненты, такие как кнопки, задатчики, чек-боксы и т.д. будут размещаться в определяемом свитке. Несколько особняком стоят описания групп компонентов. Такое описание применяется для того, чтобы некоторая часть кнопок, задатчиков и проч. была обведена рамкой. Синтаксис такого описания следующий
group Символьная_строка
Далее следуют заключенные в круглые скобки определения компонентов интерфейса, входящих в эту группу. Заголовок, заданный символьной строкой, выводится в левом верхнем углу рамки. Например, панель утилиты, определенной следующим скриптом
utility GT "Group Testing"
( group "Group N 1"
( button but_1 "button N 1"
button but_2 "button N 2"
button but_3 "button N 3"
RadioButtons rb "Radio Buttons" labels:("N 1","N 2","N 3)
)
group "Group N 2
( checkbox cb_1 "Check box N 1"
checkbox cb_2 "Check box N 2"
checkbox cb_3 "Check box N 3"
)
)
выглядит так
В приведенной утилите, как видно на рисунке, две группы компонентов, озаглавленные Group N 1 и Group N 2.
Функции обработчики событий компонентов интерфейса
Данные функции описывают действия, предпринимаемые утилитой, если пользователь совершает какие-либо действия с компонентами интерфейса, например, нажимает кнопку или изменяет значение в задатчике.. Эти действия пользователя генерируют именованные события. Если Вы определили для этого события свою функцию обработчик, то код этой функции получит управление. Функция обработчик должна быть определена особым образом, а именно
on Переменная_компонента_интерфейса Название_события
Список_аргументов do
Далее следует выражение, часто, но не обязательно заключенное в круглые скобки, которое и будет выполняться при генерации события.
Переменная компонента интерфейса берется из определения того задачика, чек-бокса и т.д., для которого пишется функция обработчик. Имя события определяет его тип, например нажатие кнопки или изменение состояния чек-бокса. О том, какие события генерируются каждым из компонентов интерфейса, будет рассказано в описании соответствующего компонента.
Список аргументов так же свой для каждого события и будет приведен в его описании. Пока отметим только, что его может и не быть вовсе. К обработчику события можно обратиться и как к обычной функции. Например, если в свитке определен чек-бокс Check_1, то внутри свитка к обработчику события changed можно обратиться так
Check_1.changed true
Можно так же запомнить ссылку на эту функцию в любой переменной
FunCheck_1 = Check_1.changed
и в дальнейшем обращаться к обработчику через нее, например
FunCheck_1 false
Свойства, методы и события свитков и утилит
Свойства
Свитки и утилиты, как частный случай свитка имеют всего два свойства. Первое содержит состояние свитка
Свиток.open
и возвращает true, если свиток раскрыт, и false, если свернут. Второе свойство
Свиток.scrollPos
строго говоря, относится не к конкретному свитку, а ко всем свиткам, входящим в утилиту или размещенным на окне. Оно содержит вертикальное смещение свитка в окне или на панели Utilites, и имеет смысл, только если свитки не умещаются на панели или в окне. Оба свойства доступны как для чтения, так и для записи, причем запись в них приводит к тому, что свиток немедленно принимает вид, соответствующий новому значению. Бывает удобно сохранить эти свойства в переменную при закрытии окна или утилиты, а при открытии восстановить запомненные значения.
Методы
Открытие или закрытие утилиты можно вызывать программно, используя для этого функции
openUtility Утилита
и
closeUtility Утилита
В качестве параметра этим функциям передается переменная, указанная в определении утилиты.
Обработчики событий
Собственно для свитка или утилиты можно написать пять функций-обработчиков событий. Функция
on Свиток_или_утилита open do
будет вызвана при открытии утилиты или свитка, а
on Свиток_или_утилита close do
при их закрытии. Если Вам надо, чтобы утилита при каких-либо условиях не закрывалась, или, например, выдать при ее закрытии запрос на сохранение файла, используйте функцию
on Свиток_или_утилита oktoclose do
Выражение, составляющее тело такой функции, должно возвращать логическое значение. Если оно вернет значение true, то свиток или утилита закроются нормальным образом. Если же возвращаемым значением будет false, то все действия пользователя будут проигнорированы, и утилита останется открытой. Например, приведенная ниже утилита не закроется до тех пор, пока кнопка с надписью “OK To Close” не будет нажата
utility ui_oktoclose "OKToClose Test"
( checkbutton Cbut "OK To Close"
on ui_oktoclose oktoclose do Cbut.state
)
Если свиток находится на перемещаемом окне, а о том, как их создавать, смотри ниже, то при перемещении или изменении размеров этого окна будут вызываться следующие обработчики
on Свиток resized Имя_переменной do
Чтобы в теле функции-обработчика получить значение новых размеров окна, необходимо обратится к переменной, имя которой указано в заголовке. Например
on MyRollout resized MySize do
( …
format “Width = % Height = %\n” MySize.x MySize.y
…
)
Как видно из приведенного примера, параметр обработчика события resized представляет собой точку в двумерном пространстве, первая координата которой содержит ширину окна, а вторая – высоту. Примерно та же картина наблюдается и для обработчика перемещения
on Свиток moved Имя_переменной do
Параметр этого обработчика так же содержит точку в двумерном пространстве, которая определяет координаты левого верхнего угла окна на экране. Следует только отметить, что данные события генерируются только для одного свитка окна, того, который определен первым.
