Добавил:
Upload Опубликованный материал нарушает ваши авторские права? Сообщите нам.
Вуз: Предмет: Файл:
MAXScript help rus.doc
Скачиваний:
5
Добавлен:
01.05.2025
Размер:
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

Параметр этого обработчика так же содержит точку в двумерном пространстве, которая определяет координаты левого верхнего угла окна на экране. Следует только отметить, что данные события генерируются только для одного свитка окна, того, который определен первым.

Соседние файлы в предмете [НЕСОРТИРОВАННОЕ]