Phaser.js: всё об играх и разработке

О чем этот пример

Создание нелинейных траекторий движения — ключевой навык для оживления игровых миров. В этом примере мы разберем, как строить составные пути из сплайнов, дуг и кривых Безье, получать их границы и анимировать объекты с плавным движением вперед-назад. Этот подход полезен для патрулирования врагов, траекторий снарядов или декоративных анимаций.

Версия Phaser: код и демо в этой статье рассчитаны на Phaser 3.90.0.

Живой запуск

Ниже встроен рабочий билд примера. Оригинальный источник: GitHub.

Исходный код

class Example extends Phaser.Scene
{
    graphics;
    bounds;
    path;
    follower;

    create ()
    {
        this.graphics = this.add.graphics();

        this.follower = { t: 0, vec: new Phaser.Math.Vector2() };

        this.path = new Phaser.Curves.Path(50, 500);

        this.path.splineTo([ 164, 446, 274, 542, 412, 457, 522, 541, 664, 464 ]);

        this.path.lineTo(700, 300);

        this.path.lineTo(600, 350);

        this.path.ellipseTo(200, 100, 100, 250, false, 0);

        this.path.cubicBezierTo(222, 119, 308, 107, 208, 368);

        this.path.ellipseTo(60, 60, 0, 360, true);

        this.bounds = new Phaser.Geom.Rectangle();

        this.path.getBounds(this.bounds);

        this.tweens.add({
            targets: this.follower,
            t: 1,
            ease: 'Sine.easeInOut',
            duration: 4000,
            yoyo: true,
            repeat: -1
        });
    }

    update ()
    {
        this.graphics.clear();

        //  Draw the bounds
        this.graphics.lineStyle(1, 0x00ff00, 1).strokeRectShape(this.bounds);

        this.graphics.lineStyle(2, 0xffffff, 1);

        this.path.draw(this.graphics);

        this.path.getPoint(this.follower.t, this.follower.vec);

        this.graphics.fillStyle(0xff0000, 1);
        this.graphics.fillCircle(this.follower.vec.x, this.follower.vec.y, 12);
    }
}

const config = {
    type: Phaser.AUTO,
    width: 800,
    height: 600,
    backgroundColor: '#2d2d2d',
    parent: 'phaser-example',
    scene: Example
};

const game = new Phaser.Game(config);

Инициализация пути и объекта-последователя

В методе create() мы подготавливаем все необходимые объекты. Графика (Graphics) будет использоваться для отрисовки. Объект follower хранит текущую позицию на пути (от 0 до 1) и вектор для вычисления координат. Путь (Path) начинается с заданной точки.

this.graphics = this.add.graphics();
this.follower = { t: 0, vec: new Phaser.Math.Vector2() };
this.path = new Phaser.Curves.Path(50, 500);

Построение сложного составного пути

Кривая строится путем последовательного добавления сегментов. Метод splineTo создает плавный сплайн через массив точек. lineTo добавляет прямолинейный отрезок. ellipseTo и cubicBezierTo позволяют рисовать дуги эллипсов и сложные кривые Безье. Последний аргумент ellipseTo управляет направлением рисования (по/против часовой стрелки).

this.path.splineTo([ 164, 446, 274, 542, 412, 457, 522, 541, 664, 464 ]);
this.path.lineTo(700, 300);
this.path.lineTo(600, 350);
this.path.ellipseTo(200, 100, 100, 250, false, 0);
this.path.cubicBezierTo(222, 119, 308, 107, 208, 368);
this.path.ellipseTo(60, 60, 0, 360, true);

Получение границ и настройка анимации

Метод getBounds вычисляет ограничивающий прямоугольник всего пути и сохраняет его в объект bounds. Это полезно для отладки и проверки пересечений. Далее создается твин для объекта follower, который бесконечно меняет его свойство `tот 0 до 1 и обратно с эффектом плавного ускорения и замедления (Sine.easeInOut`).

this.bounds = new Phaser.Geom.Rectangle();
this.path.getBounds(this.bounds);
this.tweens.add({
    targets: this.follower,
    t: 1,
    ease: 'Sine.easeInOut',
    duration: 4000,
    yoyo: true,
    repeat: -1
});

Отрисовка и обновление кадра

В update() мы сначала очищаем холст от предыдущего кадра. Затем зеленым цветом рисуем прямоугольник границ (strokeRectShape). Белым цветом рисуем сам путь с помощью path.draw. Для получения текущих координат последователя используется метод path.getPoint, который принимает прогресс `t` и записывает результат в вектор. Красный круг рисуется в полученных координатах.

this.graphics.clear();
this.graphics.lineStyle(1, 0x00ff00, 1).strokeRectShape(this.bounds);
this.graphics.lineStyle(2, 0xffffff, 1);
this.path.draw(this.graphics);
this.path.getPoint(this.follower.t, this.follower.vec);
this.graphics.fillStyle(0xff0000, 1);
this.graphics.fillCircle(this.follower.vec.x, this.follower.vec.y, 12);

Что попробовать дальше

Составные пути в Phaser — мощный инструмент для создания сложных траекторий. Экспериментируйте: замените последователь на спрайт, добавьте вращение в направлении движения, используйте getTangent для ориентации, создайте цепь из нескольких путей или привяжите движение к физическому телу для реализации рельсовых механизмов.