Властивості

Defold надає доступ до властивостей ігрових об’єктів (game object), компонентів (component) і вузлів GUI, які можна читати, встановлювати й анімувати. Існують такі типи властивостей:

• Визначені системою трансформації ігрових об’єктів (позиція, поворот і масштаб) та властивості, специфічні для компонентів (наприклад, розмір спрайта в пікселях або маса об’єкта колізій)
• Користувацькі властивості компонентів-скриптів, визначені у скриптах Lua (докладніше див. у документації з властивостей скриптів)
• Властивості вузлів GUI
• Константи шейдерів, визначені в шейдерах і файлах матеріалів (докладніше див. у документації з матеріалів)

Коли ви наводите вказівник на поле введення числової властивості, з’являється маркер перетягування. Ви можете збільшувати/зменшувати її значення, перетягуючи маркер праворуч/ліворуч або вгору/вниз відповідно.

Залежно від того, де міститься властивість, доступ до неї здійснюється через універсальну функцію або спеціалізовану функцію для цієї властивості. Багато властивостей можна анімувати автоматично. Наполегливо рекомендуємо анімувати властивості за допомогою вбудованої системи, а не змінювати їх самостійно (усередині функції update()), як із міркувань продуктивності, так і для зручності.

Складені властивості типу vector3, vector4 або quaternion також надають доступ до своїх складових (x, y, z і w). Ви можете звертатися до складових окремо, додаючи до назви властивості крапку (.) та назву складової. Наприклад, щоб задати складову x позиції ігрового об’єкта:

-- Set the x position of "game_object" to 10.
go.set("game_object", "position.x", 10)

Функції go.get(), go.set() і go.animate() приймають посилання як перший параметр та ідентифікатор властивості як другий. Посилання ідентифікує ігровий об’єкт або компонент і може бути рядком, хешем або URL. URL докладно пояснено в посібнику з адресації. Ідентифікатор властивості — це рядок або хеш із назвою властивості:

-- Set the x-scale of the sprite component
local url = msg.url("#sprite")
local prop = hash("scale.x")
go.set(url, prop, 2.0)

Для вузлів GUI сам вузол передається як перший параметр до спеціалізованої функції для властивості або до універсальних функцій gui.get() і gui.set():

-- Get the color of the button
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().

ВЛАСТИВОСТІ ІГРОВИХ ОБ’ЄКТІВ

ВЛАСТИВОСТІ КОМПОНЕНТА СПРАЙТА

ВЛАСТИВОСТІ КОМПОНЕНТА ОБ’ЄКТА КОЛІЗІЙ

ВЛАСТИВОСТІ КОМПОНЕНТА МОДЕЛІ (3D)

ВЛАСТИВОСТІ КОМПОНЕНТА НАПИСУ

Властивості вузлів GUI

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

Універсальні та спеціалізовані функції для властивостей не завжди використовують однакові типи значень. gui.get() повертає vector4 для властивостей position, scale, size і euler у повному складі, тоді як відповідні спеціалізовані функції повертають 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

Альфа-складова

ВЛАСТИВОСТІ ВУЗЛІВ GUI