Свойства

Defold предоставляет для игровых объектов, компонентов и GUI-нод свойства, которые можно считывать, устанавливать и анимировать. Существуют следующие типы свойств:

• Определенные системой трансформации игровых объектов (положение, вращение и масштаб) и специфические свойства компонентов (например, размер пикселя спрайта или масса объекта столкновения)
• Определяемые пользователем скриптовые свойства, задаваемые в Lua-скриптах (подробнее в руководстве по свойствам скрипта)
• Свойства GUI-нод
• Шейдерные константы, определенные в шейдерах и файлах материалов (подробнее в руководстве по материалам)

В зависимости от того, где находится свойство, доступ к нему осуществляется через общую функцию или функцию, специфичную для данного свойства. Многие свойства могут быть автоматически анимированы. Анимация свойств с помощью встроенной системы настоятельно рекомендуется вместо самостоятельного манипулирования свойствами (внутри функции update()), как по соображениям производительности, так и ради удобства.

Составные свойства типа vector3, vector4 или quaternion также раскрывают свои субкомпоненты (x, y, z и w). К этим компонентам можно обращаться по отдельности, дополняя имя точкой (.) и именем компонента. Например, чтобы установить х-компонент позиции игрового объекта:

-- Установите позицию по x для "game_object" в значение 10.
go.set("game_object", "position.x", 10)

Функции go.get(), go.set() и go.animate() принимают в качестве первого параметра ссылку, а в качестве второго — идентификатор свойства. Ссылка идентифицирует игровой объект или компонент и может быть строкой, хэшем или URL. URL-адреса подробно описаны в руководстве по адрессации. Идентификатор свойства — это строка или хэш, дающий свойству имя:

-- Установите масштаб по X для спрайта
local url = msg.url("#sprite")
local prop = hash("scale.x")
go.set(url, prop, 2.0)

Для GUI-нод сама нода передаётся первым параметром либо специализированной функции свойства, либо универсальным функциям gui.get() и gui.set():

-- Получить цвет кнопки
local node = gui.get_node("button")
local color = gui.get_color(node)
local same_color = gui.get(node, "color")
gui.set(node, "color.x", 1)

Свойства игровых объектов и компонентов

Все игровые объекты и некоторые типы компонентов имеют свойства, которые можно считывать и манипулировать ими во время выполнения. Считывать эти значения можно с помощью go.get(), а записывать — с помощью go.set(). В зависимости от типа значения свойства, значения можно анимировать с помощью go.animate(). Небольшой набор свойств доступен только для чтения.

get

С помощью go.get() можно считывать.

get+set

С помощью go.get() можно считывать, записывать — с помощью go.set(). Числовые значения можно анимировать с помощью go.animate().

СВОЙСТВА ИГРОВОГО ОБЪЕКТА

СВОЙСТВА КОМПОНЕНТА SPRITE

СВОЙСТВА КОМПОНЕНТА COLLISION OBJECT

СВОЙСТВА КОМПОНЕНТА MODEL (3D)

СВОЙСТВА КОМПОНЕНТА LABEL

Свойства GUI-ноды

Для свойств GUI-нод существуют специализированные функции чтения и записи, например gui.get_position() и gui.set_position(). Перечисленные ниже встроенные свойства также можно читать и изменять универсальными функциями gui.get(node, property) и gui.set(node, property, value). Для других значений ноды всё ещё могут требоваться специализированные функции. Константы материала GUI-нод также используют универсальные функции. Чтобы обратиться к отдельному компоненту векторного свойства, добавьте его имя, например gui.set(node, "color.x", 1).

Универсальные и специализированные функции не всегда используют одинаковые типы значений. Для полных свойств position, scale, size и euler функция gui.get() возвращает vector4, а соответствующие специализированные функции — vector3. gui.set() принимает для этих свойств и vector3, и vector4. Универсальное свойство rotation использует кватернион; для задания вращения в градусах используйте euler.

• position (или gui.PROP_POSITION)
• rotation (или gui.PROP_ROTATION)
• euler (или gui.PROP_EULER)
• scale (или gui.PROP_SCALE)
• color (или gui.PROP_COLOR)
• outline (или gui.PROP_OUTLINE)
• shadow (или gui.PROP_SHADOW)
• size (или gui.PROP_SIZE)
• fill_angle (или gui.PROP_FILL_ANGLE)
• inner_radius (или gui.PROP_INNER_RADIUS)
• leading (или gui.PROP_LEADING)
• tracking (или gui.PROP_TRACKING)
• slice9 (или gui.PROP_SLICE9)

Следует отметить, что все значения цвета кодируются в vector4, компоненты которого соответствуют значениям RGBA:

x

Компонент красного цвета

y

Компонент зеленого цвета

z

Компонент синего цвета

w

Компонент прозрачности (alpha)

СВОЙСТВА GUI-НОД