panthera

ПАНТЕРА ВРЕМЕНИ

Panthera Runtime - библиотека Defold, предназначенная для интеграции анимации, созданной с помощью Panthera 2.0 Editor , универсального программного обеспечения для анимации, в проекты Defold. Эта библиотека времени выполнения упрощает процесс импорта и воспроизведения анимации Panthera, повышая визуальное качество и интерактивность игр и приложений Defold.

Функции

• Бесплатная интеграция анимации : импорт и используйте анимацию Panthera 2.0 непосредственно в Defold.
• Полная поддержка анимации : поддерживает все функции анимации, предоставленные Panthera 2.0, включая события, смешивание анимации, вложенные анимации и многое другое.
• Гибкое использование : совместимо как с игровыми объектами, так и с узлами графического интерфейса в Defold, что позволяет универсально применять для разных элементов игры.
• Анимационная курсор : предоставляет способ управлять анимацией вручную, позволяя точно контролировать воспроизведение и синхронизацию с помощью игровых событий.
• Горячая перезагрузка : перезагрузить анимации на лету во время разработки, обеспечивая быструю итерацию и тестирование анимационных активов.

Редактор Panthera 2.0

Прочитайте Руководство редактора Panthera 2.0 , чтобы узнать о редакторе Panthera 2.0, инновационном инструменте, разработанном с использованием двигателя Defold, предназначенного для упрощения и улучшения создания анимаций для проектов Defold.

Настраивать

Зависимость

Откройте файл game.project и добавьте следующие строки в поле зависимости в разделе проекта:

Defold Tweener

 https://github.com/Insality/defold-tweener/archive/refs/tags/3.zip

ПАНТЕРА ВРЕМЕНИ

 https://github.com/Insality/panthera/archive/refs/tags/runtime.4.zip

После этого выберите Project ▸ Fetch Libraries для обновления библиотечных зависимостей. Это происходит автоматически, когда вы открываете проект, поэтому вам нужно будет сделать это, только если зависимости изменятся без повторного открытия проекта.

Размер библиотеки

ПРИМЕЧАНИЕ. Размер библиотеки рассчитывается на основе отчета сборки на платформу

Платформа	Размер библиотеки
HTML5	12,42 КБ
Настольный компьютер / мобильный	21,35 КБ

Горячая перезагрузка анимации для разработки [необязательно]

Примечание: горячая перезагрузка предназначена только для использования в средах разработки. Горячая перезагрузка работает только для анимации из файлов JSON. Если вы используете таблицу LUA для анимации, горячая перезагрузка не будет работать.

Время выполнения Panthera поддерживает горячую перезагрузку анимации для более эффективного рабочего процесса разработки. Эта функция позволяет анимации быть автоматически перезагружена без перезапуска вашей игры Defold, облегчая быстрое итерацию на анимационных активах.

Чтобы включить горячую перезагрузку анимации, включите следующие настройки в вашу game.project .

 [panthera]
hotreload_animations = 1

Детали конфигурации:

• HotReload_animations : установите на 1 чтобы включить горячую перезагрузку. Эта функция активна только в режиме отладки.

Реализация горячей перезагрузки в Defold:

Чтобы использовать горячую перезагрузку, установите слушателя оконного события в своем сценарии Defold, который запускает panthera.reload_animation() , когда окно игры набирает фокус. Это гарантирует, что анимации обновляются автоматически во время разработки:

 local panthera = require ( " panthera.panthera " )

-- Reload animation when window is focused, only for debug and on desktop
window . set_listener ( function ( _ , event )
    if event == window . WINDOW_EVENT_FOCUS_GAINED then
        panthera . reload_animation ()
    end
end )

Ссылка на API

Быстрая ссылка на API

 panthera . create_gui ( animation_path_or_data , [ template ], [ nodes ])
panthera . create_go ( animation_path_or_data , [ collection_name ], [ objects ])
panthera . create ( animation_path_or_data , adapter , get_node )
panthera . clone_state ( animation_state )
panthera . play ( animation_state , animation_id , [ options ])
panthera . stop ( animation_state )
panthera . set_time ( animation_state , animation_id , time )
panthera . get_time ( animation_state )
panthera . get_duration ( animation_state , animation_id )
panthera . is_playing ( animation_state )
panthera . get_latest_animation_id ( animation_state )
panthera . set_logger ([ logger_instance ])
panthera . reload_animation ([ animation_path ])

Ссылка на API

Прочитайте ссылочный файл API, чтобы просмотреть полную документацию API для модуля.

Примеры использования

Интегрируйте анимации Panthera в Defold с этими краткими примерами:

Пример 1: запустить анимацию в Go

Загрузите и воспроизводите файл анимации, используя адаптер GO.

 local panthera = require ( " panthera.panthera " )
local animation = require ( " path.to.panthera_animation " )

function init ( self )
    self . animation = panthera . create_go ( animation )
    panthera . play ( self . animation , " run " , { is_loop = true })
end

Этот пример применяет анимацию запуска к игровому объекту, когда игра запускается.

Пример 2: Начать анимацию в графическом интерфейсе

Загрузите и воспроизводите файл анимации с помощью адаптера GUI.

 local panthera = require ( " panthera.panthera " )
local animation = require ( " path.to.panthera_animation " )

function init ( self )
    self . animation = panthera . create_gui ( animation )
    panthera . play ( self . animation , " fade_in " )
end

Этот пример применяет анимацию затухания к узлу графического интерфейса, когда игра запускается

Пример 3: Проверьте, играет ли анимация

Проверьте, играет ли в настоящее время анимация, и получить текущий идентификатор анимации.

 local panthera = require ( " panthera.panthera " )

function init ( self )
    -- You can use JSON instead of Lua tables, but it should be accessible with sys.load_resource()
    self . animation = panthera . create_gui ( " /animations/animation.json " )
    local is_playing = panthera . is_playing ( self . animation )
    local animation_id = panthera . get_latest_animation_id ( self . animation )

    if is_playing then
        print ( " The animation is currently playing: " , animation_id )
    else
        print ( " The animation is not playing " )
    end
end

Идите ограничения на анимацию

При интеграции анимации Panthera 2.0 с Defold Game Objects (GOS) важно знать, какие свойства вы можете оживить:

По умолчанию Sprite Components использует свойство tint , а компоненты метки используют свойство color . Panthera Попробуйте использовать color свойство. Чтобы включить свойство color вы должны установить материал Sprite Component на /panthera/materials/sprite.material или использовать любой другой материал с color атрибутом.

• Положение : перемещать объекты.
• Вращение : вращение объектов.
• Шкала : масштабные объекты.
• Цвет : обновление цвета спрайта или текстового компонента.
• SLICE9 : Обновление SLICE9 Свойства Sprite Component.
• Размер : размер обновления компонента спрайта.
• Текст : Обновление текстового содержимого компонента метки.
• Текстура : переключатель текстур соперника спрайта.
• Включено : Объединение объекта включено/отключено.

Смешивание анимации

Прочитайте руководство по смешиванию анимации, чтобы узнать, как смешать несколько анимаций одновременно на одной и той же сущности, создавая сложные, многослойные анимации, которые улучшают визуальную верность и динамизм вашей игры.

Настройка вашего адаптера

В то время как Panthera Runtime предоставляет адаптер по умолчанию для игровых объектов и графического интерфейса, вам может потребоваться настроить ваш адаптер в зависимости от потребностей вашего проекта. Прочитайте настройку своего руководства по адаптеру, чтобы узнать, как картировать типы ослабления, обрабатывать пользовательские события и использовать свой пользовательский адаптер со временем выполнения Panthera.

Лицензия

Время выполнения Panthera лицензировано по лицензии MIT - для получения подробной информации см. Файл лицензии.

Проблемы и предложения

По любым вопросам, вопросам или предложениям, пожалуйста, создайте проблему.

Изменение

Читайте ChangeLog, чтобы узнать о последних обновлениях и функциях во время выполнения Panthera.

? Участники

❤ Поддерживать проект ❤

Ваша поддержка побуждает меня продолжать создавать и поддерживать проекты для Defold . Подумайте о поддержке, если вы найдете мои проекты полезными и ценными.