Анімація властивостей

Усі числові властивості (numbers, vector3, vector4 та кватерніони) і константи шейдерів можна анімувати за допомогою вбудованої системи анімації, використовуючи функцію go.animate(). Рушій автоматично інтерполюватиме властивості відповідно до заданих режимів відтворення та функцій згладжування (easing). Також можна задавати власні функції згладжування.

Анімація властивостей

Щоб анімувати властивість ігрового об’єкта (game object) або компонента (component), використовуйте функцію go.animate(). Для властивостей вузлів GUI відповідною функцією є gui.animate().

-- Set the position property y component to 200
go.set(".", "position.y", 200)
-- Then animate it
go.animate(".", "position.y", go.PLAYBACK_LOOP_PINGPONG, 100, go.EASING_OUTBOUNCE, 2)

Щоб зупинити всі анімації певної властивості, викличте go.cancel_animations(), а для вузлів GUI — gui.cancel_animations():

-- Stop euler z rotation animation on the current game object
go.cancel_animations(".", "euler.z")

Якщо скасувати анімацію складеної властивості, наприклад position, усі анімації її складових (position.x, position.y і position.z) також буде скасовано.

У посібнику з властивостей наведено всі доступні властивості ігрових об’єктів, компонентів і вузлів GUI.

Анімація властивостей вузлів GUI

Майже всі властивості вузлів GUI можна анімувати. Наприклад, можна зробити вузол невидимим, задавши повну прозорість у його властивості color, а потім поступово зробити його видимим, анімуючи зміну кольору на білий (тобто без тонування).

local node = gui.get_node("button")
local color = gui.get_color(node)
-- Animate the color to white
gui.animate(node, gui.PROP_COLOR, vmath.vector4(1, 1, 1, 1), gui.EASING_INOUTQUAD, 0.5)
-- Animate the outline red color component
gui.animate(node, "outline.x", 1, gui.EASING_INOUTQUAD, 0.5)
-- And move to x position 100
gui.animate(node, hash("position.x"), 100, gui.EASING_INOUTQUAD, 0.5)

Зворотні виклики після завершення

Функції анімації властивостей go.animate() і gui.animate() підтримують необов’язкову функцію зворотного виклику Lua як останній аргумент. Цю функцію буде викликано, коли анімація відтвориться до кінця. Функція ніколи не викликається для циклічних анімацій, а також коли анімацію скасовано вручну за допомогою go.cancel_animations() або gui.cancel_animations(). Зворотний виклик можна використовувати для запуску подій після завершення анімації або для об’єднання кількох анімацій у послідовність.

Згладжування

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

Для go.animate() допустимі такі значення згладжування:

Для gui.animate() допустимі такі значення згладжування:

Власне згладжування

Ви можете створювати власні криві згладжування, визначивши vector із набором значень, а потім передати цей вектор замість однієї з наведених вище констант згладжування. Значення вектора задають криву від початкового значення (0) до цільового (1). Середовище виконання вибирає значення з вектора та використовує лінійну інтерполяцію для обчислення значень між точками, заданими у векторі.

Наприклад, вектор:

local values = { 0, 0.4, 0.2, 0.2, 0.5, 1 }
local my_easing = vmath.vector(values)

задає таку криву:

У наведеному нижче прикладі позиція ігрового об’єкта за віссю y стрибкоподібно змінюється між поточною позицією та 200 відповідно до прямокутної кривої:

local values = { 0, 0, 0, 0, 0, 0, 0, 0,
                 1, 1, 1, 1, 1, 1, 1, 1,
                 0, 0, 0, 0, 0, 0, 0, 0,
                 1, 1, 1, 1, 1, 1, 1, 1,
                 0, 0, 0, 0, 0, 0, 0, 0,
                 1, 1, 1, 1, 1, 1, 1, 1,
                 0, 0, 0, 0, 0, 0, 0, 0,
                 1, 1, 1, 1, 1, 1, 1, 1 }
local square_easing = vmath.vector(values)
go.animate("go", "position.y", go.PLAYBACK_LOOP_PINGPONG, 200, square_easing, 2.0)