InnerCore/Анимации

InnerCore, в отличии от его предшественника CoreEngine, имеет встроенную поддержку анимаций. Это значит, что для того, чтобы в мире появилась какая-то моделька, не нужно создавать моба. Достаточно создать лишь простейшую анимацию. Всего существует два вида анимаций - базовые анимации и анимации предметов. Давайте рассмотрим их возможности подробнее:

Базовые анимации

Статичные анимации

Для создания базовой анимации используется класс Animation.Base, который создает новую анимацию на координатах x, y, z:

var animation = new Animation.Base(x, y, z);

Чтобы отобразить нашу модельку без анимации в мире, достаточно задать рендер анимации и загрузить её:

animation.describe({render: render.getId()});
animation.load();

Стоит отметить, что render может принимать любое значение нативного рендера, как кастомного (render.getId()), так и ванильного.

Динамичные анимации

Для создания динамичных анимаций используется функция loadCustom(callable). В качестве параметра эта функция принимает лишь функцию, в которой мы и будем производить наши изменения в модели. Чтобы изменить рендер, достаточно лишь изменить его объект Render и вызвать метод refresh(). Для изменения расположения будем использовать функцию setPos(x, y, z), которая устанавливает новые координаты объекта в мире. Поскольку часто возникает необходимость изменить координаты относительно текущих, текущие будем получать из объекта coords. Внимание! Не изменяйте объект coords, это не изменит реальное расположение анимации в мире!

И, конечно же, пример:

animation.loadCustom(function(){ 
    this.setPos(this.coords.x + 0.5, this.coords.y, this.coords.z - 0.5); 
    this.refresh(); 
});

Замечу, что this внутри функции обновления анимации будет указывать на саму анимацию, что и используется в этом примере. 

Прочие переменные и методы объекта Animation.Base

• load() - создает анимацию в игре
• loadCustom(callable) - создает динамичную анимацию в игре, используя функцию callable для изменения рендера и положения. 
• setPos(x, y, z) - устанавливает положение анимации в мире.
• coords - получает координаты анимации в мире.
• getAge() - возвращает 0. Вдруг кому пригодится. 
• refresh() - обновляет объект рендера анимации.
• destroy() - уничтожает анимацию в мире.
• describe(description) - задает настройки для анимации в следующем формате:

 

{
    render: render,
    skin: skin,
    scale: scale
}

При этом параметры skin и scale считаются устаревшими, поскольку являются частью объекта рендера, а не самой анимации. Их использовать не следует. 

Анимации предметов

Анимации предметов работают так же, как и базовые, но вместо объекта рендера принимают описание предмета (тип рендера ItemSprite, по-сути). Для создания используется следующий класс:

 var animation = new Animation.Item(x, y, z);

Для того, чтобы анимация появилась в мире, опишем и загрузим её 

animation.describeItem({
     id: 280,
     count: 1,
     data: 0,
     size: 1,
     rotation: [Math.PI / 2, 0, 0],
     notRandomize: true
});
animation.load();

Объясним подробнее предназначение каждого из параметров:

• id, count, data - стандартное описание предмета. Если count больше 1, будет отрисовано несколько предметов рядом, подобно дропу. 
• size - размер предмета. По умолчанию 0.5.
• rotation - позволяет изменить расположение предмета по трем осям. Задается в радианах. В примере Math.PI / 2 это 90°, поворачиваем анимацию вокруг оси x. 
• notRandomize - не делать случайных отступов между предметами, если их больше 1. Если не задан или выставлен в false, расстояние между краями каждого отдельного предмета будет случайным.

Данный тип анимации можно изменять динамически, так же, как и базовую.