-
Notifications
You must be signed in to change notification settings - Fork 41
components.Container
компоненты : Container
Container - самый простой компонент в Thing-Editor. Container - это класс, напрямую взятый из pixi.js
Container невидим на экране, и используется для объединения других компонентов в группы (слои).
Тип: String
Название объекта. Используется для доступа к элементам сцены по имени из javascript кода, либо просто для удобства при навигации по дереву сцены в редакторе. В добавок, объекты которым задано имя становятся видимыми в редакторе путей для ссылочных полей.
Объекты, имя которых начинается с тройного подчеркивания ___ считаются вспомогательными объектами (направляющими) помогающими разметить сцену при редактировании. Такие объекты удаляются из игры при запуске. Это относится тек же, к именам всех ресурсов игры, включая префабы, сцены, звуки и изображения.
Объекты, имя которых начинается с двойного подчеркивания __ считаются отладочными объектами (например кнопки, включающие отладочные читы). Такие объекты удаляются из релизного билда игры, но сохраняются при запуске игры в редакторе и в отладочном билде игры. Это относится, тек же, к именам всех ресурсов игры, включая префабы, сцены, звуки и изображения.
Тип: Number
положение объекта по горизонтали.
Тип: Number
положение объекта по вертикали.
Тип: Number
поворот объекта в радианах.
Тип: Number
Прозрачность объекта.
Тип: Boolean
Делает объект видимым или невидимым.
Тип: Boolean
Кликабельность объекта. Подробнее в справке PIXI. По умолчанию, это поле отключено #### false#### у всех компонентов, кроме Button, поэтому, любой спрайт добавленный на сцену будет кликаться игроком на сквозь, и клик будет срабатывать на кнопке, которая скрыта под спрайтом. Для того чтобы сделать спрайт не пропускающим клик, установите свойство interactive в true. Обычный спрайт имеет кликабельную форму в виде прямоугольника. Для изменения кликабельной формы (HitArea) кнопки или спрайта используйте компонент Shape, как область клика
Тип: Boolean
служебное поле, которое делает элемент невыбираемым по клику на сцене в viewport. Значение этого поля сохраняется в файле сцены, но вырезается в релизной сборке игры, как и любое редактируемое поле, имя которого начинается с двойного подчеркивания. Подробнее.
Тип: Boolean
служебное поле, скрывающее дочерние объекты компонента в дереве сцены. Клик по такому объекту в Окне игрового экрана - выделяет это объект, а не один из его дочерних компонентов. Установка этого свойства в true позволяет "защитить" внутренности контейнера от случайного изменения, и скрывает излишнюю детализацию игровой сцены.
Тип: Number
служебное поле, введенное в целях облегчения отладки. Значение этого поля генерируется автоматически, и отображается в дереве сцены. Значение поля может меняться между запусками игры, при переходах между сценами, и сохраняет свое значение только в пределах запуска сцены на исполнение. В финальную сборку игры это поле не попадает. Значение этого поля временное, и не сохраняется в файле сцены, как и любое редактируемое поле, имя которого начинается с тройного подчеркивания подробнее.
Тип: Number
масштабирование объекта по горизонтали. 1 - значение по умолчанию, при котором объект имеет ширину как есть.
Поле scale.x является вложенным полем, для обеспечения совместимости с "плоским" редактором свойств, Thing-Editor добавляет компоненту псевдоним (геттер и сеттер) c именем #### scale.x#### подробнее.
Тип: Number
масштабирование объекта по вертикали. 1 - значение по умолчанию, при котором объект имеет высоту как есть.
Тип: Number
наклон объекта по горизонтали.
Тип: Number
наклон объекта по вертикали.
Тип: Number
смещение точки опоры по горизонтали. Точка опоры (pivot) это точка, относительно которой трансформируется объект и его дочерние объекты.
Тип: Number
смещение точки опоры по вертикали
Тип: Boolean
Свойство, доступное только для чтения, и только из javascript кода. Определяет, может ли объект быть нажатым игроком в данный момент. Это свойство проверяет interactive поле данного объекта, и interactiveChildren поля всех родительских объектов. Если interactiveChildren хотя бы одного родителя будет false, то свойство вернет false. К тому же это поле учитывает цикл жизни сцены. Сцена, находящаяся в состоянии закрытия, блокирует взаимодействие игрока с ее объектами. Свойство isCanBePressed широко используется в интерактивных компонентах, наследующихся от Container, таких как Button, ScrollLayer, и других.
Удаляет объект со сцены, и отправляет его и все его дочерние объекты в пул объектов. На место удаленного объекта добавляется невидимый объект - заглушка RemoveHolder, который временно удерживает место в children массиве родителя, чтобы избежать пропуск update у следующего дочернего объекта.
Удаляет объект со сцены, и отправляет его и все его дочерние объекты в пул объектов. Отличие от remove() заключается в том, что на место удаляемого объекта не добавляется временная заглушка RemoveHolder.
Отсоединяет объект от родителя.
Возвращаемый тип: DisplayObject
Рекурсивно ищет объект с заданным именем, среди всех дочерних объектов контейнера, включая вложенные.
В редакторе этот метод дополнительно содержит проверку на наличие более чем одного объекта с заданным именем, для избежания ошибок при разработке. Если более одного объекта будет найдено, будет выброшена ошибка 10006. В финальном билде игры такая проверка не производится.
Возвращаемый тип: Array<DisplayObject>
Рекурсивно ищет объекты c заданным именем, среди всех дочерних объектов контейнера, включая вложенные.
Возвращаемый тип: Array<DisplayObject>
Рекурсивно ищет объекты заданного типа, и типов, унаследованных от заданного, среди всех дочерних объектов контейнера, включая вложенные.
Возвращаемый тип: DisplayObject
Ищет родительский объект заданного типа.
Добавляет фильтр в filters объекта. Этот метод используется в Thing-Editor для добавления эффекта обводки выделенным объектам.
Удаляет фильтр из filters объекта.
Рекурсивно вызывает callback функцию для каждого дочернего элемента контейнера, включая вложенные.
Возвращаемый тип: Number
Возвращает абсолютный поворот объекта относительно game.stage контейнера.
getScenePosition(to : PIXI.Point, skipUpdate = false)
Возвращаемый тип: PIXI.Point
Возвращает абсолютное положение объекта относительно game.stage контейнера. Метод похож на унаследованный из PIXI getGlobalPosition. Однако, так как контейнер game.stage может оказаться повернут, на мобильном устройстве, в случае, когда настройки ориентации проекта не совпадает с текущей ориентацией мобильного экрана.
Возвращаемый тип: DisplayObject
Возвращает самый верхний родительский объект, до game.stage.
gotoLabelRecursive (labelName : String)
Метод, тесно связанный с MovieClip компонентом, поэтому его описание находится в разделе MovieClip
Дополнительно, компонент Container имеет несколько методов, вызов которых разработчиком не требуется, однако они доступны для переопределения в javascript. Эти методы описаны в разделе Разработка Custom компонентов.