Skip to content

components.Trigger

Megabyteceer edited this page Aug 13, 2021 · 20 revisions

Наследуется от Container, и включает в себя все его свойства.

Trigger - часто используемый, мощный инструмент Thing-Editor, который позволяет включать/выключать элементы игрового экрана, с настраиваемым эффектом анимации, и привязкой к некоторой переменной javascript. Триггер выступает как контейнер для объектов, которые нужно выключать/включать.

В том случае, когда alphaShift триггера установлено в -1, при выключении, триггер становится полностью невидимым, и для всех дочерних объектов триггера перестает вызываться метод update(), что полностью замораживает дочерние объекты. Анимация дочерних объектов останавливается. Подробнее: методы жизненного цикла компонентов. update

Редактируемые свойства:

state

Тип: Boolean

Поле отвечающее за текущее состояние триггера. Включен/выключен.


dataPath

Тип: data-path

Данное поля указывает путь к переменной javascript (либо путь к свойству объекта на экране), которая будет выступать в качестве динамического состояния триггера. При установке значения этому полю, триггер начинает следить за переменной указанной по этому пути, и включается/выключается в зависимости от значения данной переменной. Подробнее о путях к переменным: Data-Path редактор


invert

Тип: Boolean

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


pow

Тип: Number

Скорость анимации при переключении триггера. Чем меньше это значение, тем плавнее и медленнее будет переключаться триггер. Для моментального переключения триггера установите это значение в 1. Анимация триггера работает по формуле, широко используемой в Thing-Engine для анимации объектов. Подробнее физическая анимация объектов на основе силы и торможения


damp

Тип: Number

Сила торможения анимации при переключении триггера. Чем меньше это значение, том сильнее будет тормозиться анимация триггера и анимация будет иметь меньше инерции. Анимация триггера работает по формуле, широко используемой в Thing-Engine для анимации объектов. Подробнее физическая анимация объектов на основе силы и торможения


preset

Выпадающий список с заранее подготовлеными комбинациями для полей pow и damp. Данное поле имеет ту же логику, что и поле с пресетами для анимации SMOOTH полей на таймлайне.


alphaShift

Тип: Number

Задает насколько прозрачным будет триггер в выключенном состоянии. По умолчанию это значение равно -1, что делает триггер полностью невидимым. -0.5 сделает его полупрозрачным, а 0 - оставит прозрачность триггера как есть. Это значение прибавляется к исходному значению alpha при переходе триггера в выключенное состояние.


scaleShift

Тип: Number

Задает изменение размера триггера в выключенном состоянии. При переходе в выключенное состояние это значение будет прибавлено к исходным scale.x и scale.y триггера.


xShift

Тип: Number

Задает сдвиг триггера по оси x, при переходе в выключенное состояние. 0 - оставит триггер на месте. Это поле полезно при создании эффекта появления/скрытия некоторого объекта за край экрана.


yShift

Тип: Number

Задает сдвиг триггера по оси y, при переходе в выключенное состояние. 0 - оставит триггер на месте. Это поле полезно при создании эффекта появления/скрытия некоторого объекта за край экрана.


isApplyInteractivity

Тип: Boolean

Чаще всего триггер при выключении, требует чтобы его дочерние объекты стали неактивными для взаимодействия с пользователем. Однако, бывают случаи когда триггер используется лишь для изменения местоположения элемента, с сохранением его активного состояния. В этом случае isApplyInteractivity нужно установить в false. Thing-Editor выдает предупреждение для триггеров, которые имеют alphaShift поле равное нулю, и isApplyInteractivity равное true, так как отключение интерактивности объекта без изменения его прозрачности может вводить игрока в заблуждение, либо скорее всего такое сочетание свойств триггера является недосмотром со стороны разработчика.


onEnable

Тип: call

Поле, позволяющее привязать действие, которое будет вызываться при переходе данного триггера во включенное состояние. Это может быть вызов метода любого из присутствующих на сцене объектов, либо любой javascript метод, встроенный в Thing-editor, либо написанный разработчиком для конкретной игры. В javascript это поле имеет строковое значение, однако в редакторе свойств, оно имеет кнопки, позволяющие выбирать действие из списка доступных значений. Подробнее см. Callback редактор


onDisable

Тип: call

Поле, позволяющее привязать действие, которое будет вызываться при переходе данного триггера в выключенное состояние. Это может быть вызов метода любого из присутствующих на сцене объектов, либо любой javascript метод, встроенный в Thing-editor, либо написанный разработчиком для конкретной игры. В javascript это поле имеет строковое значение, однако в редакторе свойств, оно имеет кнопки, позволяющие выбирать действие из списка доступных значений. Подробнее см. Callback редактор


Методы:

applyInstantly()

Вызов этого метода немедленно приводит триггер к текущему состоянию, игнорируя анимацию.


show()

Вызов этого метода переключает триггер во включенное состояние. Вызов этого метода имеет смысл только для триггера, dataPath поле которого не задано.


hide()

Вызов этого метода переключает триггер в выключенное состояние. Вызов этого метода имеет смысл только для триггера, dataPath поле которого не задано.


toggle()

Вызов этого метода переключает триггер в состояние противоположное текущему. Вызов этого метода имеет смысл только для триггера, dataPath поле которого не задано.


Служебные поля:


Centralize

В редакторе свойств - это поле представляет из себя кнопку, для быстрой централизации объекта Trigger относительно его дочерних объектов. Добавлено для удобства при редактировании сцены. В javascript это поле не доступно.


Preview switched

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

<- Предыдущая страница Следующая страница ->

Связанные темы:

Data-Path редактор

Свойства, унаследованные от Container

Компоненты

Clone this wiki locally