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

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

Фильтры в Phaser 3 позволяют применять к игровым объектам различные визуальные эффекты в реальном времени, не редактируя исходные текстуры. В этой статье мы разберем пример добавления фильтра пикселизации к спрайту. Вы научитесь создавать динамические эффекты, управлять их состоянием и реагировать на действия игрока, что отлично подходит для стилизации графики, создания спецэффектов или визуальных переходов.

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

Живой запуск

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

Исходный код

class Example extends Phaser.Scene
{
    preload ()
    {
        this.load.setBaseURL('https://raw.githubusercontent.com/phaserjs/examples/master/public/');
        this.load.image('pic', 'assets/pics/neotokyo-ai.jpg');
    }

    create ()
    {
        const sprite = this.add.image(400, 300, 'pic');

        const fx = sprite.enableFilters().filters.internal.addPixelate(2);

        const text = this.add.text(10, 10, 'Click to toggle FX.Pixelate on/off').setResolution(window.devicePixelRatio);

        text.setShadow(2, 2);

        this.input.on('pointerdown', () => {

            fx.active = !fx.active;

        });
    }
}

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

const game = new Phaser.Game(config);

Настройка сцены и загрузка изображения

В методе preload мы загружаем изображение, которое будет использоваться в качестве спрайта. Обратите внимание на использование this.load.setBaseURL для задания базового пути — это удобно, если ваши ресурсы лежат в одной директории.

preload ()
{
    this.load.setBaseURL('https://raw.githubusercontent.com/phaserjs/examples/master/public/');
    this.load.image('pic', 'assets/pics/neotokyo-ai.jpg');
}

Создание спрайта и добавление фильтра

В методе create мы создаем спрайт с изображением по центру экрана. Ключевой момент — включение фильтров для этого спрайта. Метод sprite.enableFilters() активирует систему фильтров для объекта, после чего мы можем обращаться к коллекции filters.internal.

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

const sprite = this.add.image(400, 300, 'pic');
const fx = sprite.enableFilters().filters.internal.addPixelate(2);

Интерактивность: управление фильтром

Чтобы эффект можно было контролировать, мы добавляем текстовую подсказку и обработчик клика. Свойство fx.active управляет активностью фильтра: при true эффект применяется, при false — отключается. Это простой и эффективный способ переключать визуальные эффекты.

const text = this.add.text(10, 10, 'Click to toggle FX.Pixelate on/off').setResolution(window.devicePixelRatio);
text.setShadow(2, 2);
this.input.on('pointerdown', () => {
    fx.active = !fx.active;
});

Конфигурация игры

Это стандартная конфигурация для создания экземпляра Phaser.Game. Убедитесь, что в parent указан ID элемента DOM, в который будет встроен Canvas. Размеры и цвет фона можно настроить под ваши нужды.

const config = {
    type: Phaser.AUTO,
    width: 800,
    height: 600,
    backgroundColor: '#000000',
    parent: 'phaser-example',
    scene: Example
};
const game = new Phaser.Game(config);

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

Фильтр пикселизации — лишь один из многих доступных встроенных эффектов в Phaser 3. Экспериментируйте с другими фильтрами, такими как размытие (addBlur), свечение (addGlow) или цветовая коррекция, комбинируйте их и управляйте параметрами в реальном времени для создания уникальной графики. Попробуйте анимировать значение пикселизации с помощью Tween, чтобы сделать плавный переход в ретро-стиль.