AnAL (Русский)

AnAL (Animations And Love, русск. Анимации и любовь) — библиотека для замены анимаций версии 0.5.0 (удалённая в версии 0.6.0), с минимальными изменениями кода для лавера.

Изменения кода

  • love.graphics.newAnimation(...) превратился в newAnimation(...)
  • love.graphics.draw(anim, ...) превратился в anim:draw(...)
  • anim:setMode() использует строковые константы

Режим совместимости

Доступен режим совместимости, который добавляет love.graphics.newAnimation и изменяет love.graphics.draw.

Animations_legacy_support = true

Недостатком является то, что изменилось поведение love.graphics.draw, он вызывает отрисовку настраиваемого поля на всех пройденных таблицах.

Урок

Бесстыдно содран со старого урока версии 0.5.0 (на старой вики). И надеемся, что работает на версии 0.6.x.

Простой взрыв.

Это наше изображение, информация:

  • Размеры: 480x288 пикселей
  • Размер кадра: 96x96 пикселей
  • Кадров: 5x3 = 15


А теперь давайте посмотрим, как мы можем загрузить эту анимацию. Для начала нужно загрузить файл AnAL.lua отсюда. Положите этот файл в ZIP архив с главным файлом main.lua. Далее перед всем кодом вы должны написать:

dofile("AnAL.lua") -- Загрузка необходимого файла для работы анимации

Потом мы загружаем картинку анимации и создаём саму анимацию:

function love.load()
 
   -- Загрузка исходной части анимации.
   local img  = love.graphics.newImage("explosion.png")
 
   -- Создание анимации.
   anim = newAnimation(img, 96, 96, 0.1, 0)
 
end


Во-первых, нам нужно загрузить исходное изображение, используемое для анимации. Затем, мы создадим анимацию с помощью newAnimation(). Первый аргумент должен быть исходным изображением, которое мы загрузили ранее. Второй — ширина кадра, третий — высота кадра, а четвертый — задержка после каждого кадра (в секундах). Вам не нужно беспокоиться о размере изображения, или количестве кадров, все определится само, если вы укажете, что кадров 0.

Когда всё готово, останутся две задачи: ​​обновление анимации и её отображение. Обновление необходимо, потому что анимация должна знать, как много времени прошло, для смены кадра. Полный код для рабочей анимации, приведён ниже.

function love.load()
   local img  = love.graphics.newImage("explosion.png")
   anim = newAnimation(img, 96, 96, 0.1, 0)
end
 
function love.update(dt)
   -- Обновления анимации (включает смену кадра).
   anim:update(dt)   
end
 
function love.draw()
   -- Отрисовывает анимацию в координатах (100, 100).
   anim:draw(100, 100) 
end

Это должно отрисовать анимацию в координатах (100,100).


Переходим к режимам анимации. Есть три предустановленных режима анимации: цикл (loop), однократная (once), и отскок (bounce). Loop является поведением по умолчанию. В этом режиме, анимация будет начинаться с первого кадра, когда дойдёт до конца. В режиме once, она будет отыграна один раз, а затем остановиться. Наконец, при bounce, анимации отыграется в обратном направлении по достижении конца, что приведет к "пинг-понгу" между первым и последним кадром. Вы можете установить режим, как показано в блоке кода ниже.

function love.load()
   local img  = love.graphics.newImage("explosion.png")
   anim = newAnimation(img, 96, 96, 0.1, 0)
 
   -- Константы режима:
   -- loop
   -- bounce
   -- once
 
   -- Установить режим "bounce"
   anim:setMode("bounce")
 
end

Документация

Список функций

Ниже приводится список функций.

  • addFrame(x, y, w, h, задержка)
  • setMode(режим)
  • play()
  • stop()
  • reset()
  • seek(кадр)
  • getCurrentFrame()
  • getSize()
  • setDelay(кадр, задержка)
  • setSpeed(скорость)
  • getSpeed()
  • getWidth()
  • getHeight()
  • update(dt)

Описание

Для функции с аргументами здесь есть несколько описаний (другие говорят сами за себя).

addFrame

  • x: Положение кадров в изображении по оси X.
  • y: Положение кадров в изображении по оси y.
  • w: Ширина кадра.
  • h: Высота кадра
  • задержка: Сколько времени пройдёт перед переходом к следующему кадру.

setMode

  • режим: Режим, который может быть "once", "loop" (по умолчанию) или "bounce", подробную информацию читайте в уроке.

seek

  • кадр: Кадр для перехода в анимации.

setDelay

  • кадр: Задержка смены кадры.
  • задержка: Сколько времени пройдёт перед переходом к следующему кадру.

setSpeed

  • скорость: Скорость анимации, из них: 1 — реальное время, 2 — в два раза быстрее.

update

  • dt: Обновление анимации, для разрешения перехода к следующему кадру.

См. также

Bartbes — создатель и сопровождающий AnAL.

Обсуждение и ссылка для скачивания

В теме на форуме



Другие языки