Этот проект входит в тройку моих самых масштабных и интересных. А началось всё с шуточного промпта: «Создай простой редактор пиксель-арта на Rust». Теперь, спустя четыре месяца разработки, я готов рассказать, что из этого получилось. Исходники можно посмотреть на GitHub. Ну а мы стартуем!

Тот самый промпт

Про промпт, кстати, я не шутил. Был июльский вечер, я спокойно сидел и работал над CYS, о которой тоже скоро напишу статью. И тут — не знаю, что мне пришло в голову, — я понял, что устал пользоваться Pixelorama и пора сделать свой редактор. Поэтому решил за вечер навайбкодить хоть какую-то кодовую основу, от которой можно было бы оттолкнуться. Вот что из этого получилось.

На что-то работающее это было похоже лишь отдалённо. Чтобы вы понимали: багов тут было немерено, я даже холст не мог нормально прокручивать. Интерфейс тоже красотой не блистал, а многих функций попросту не было. Но для демки, собранной за вечер, результат меня вполне устроил, и я решил развивать проект дальше.

Так как оно работает?

Первая версия была ужасной не только по части интерфейса и поведения, но и по коду. Основу проекта составляли — и составляют до сих пор — две библиотеки: eframe для создания окна и отрисовки интерфейса и image для загрузки и сохранения изображений. Есть ещё serde и rfd, но о них пока не будем.

В первой версии всё было свалено в main.rs: минимум отдельных функций, минимум комментариев и максимум поводов схватиться за голову. Создание интерфейса, обработка ввода и работа с изображениями — всё жило в одном файле, который в итоге разросся больше чем на тысячу строк.

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

pixesh/
├── src/
│   ├── main.rs                  — параметры окна и точка входа
│   ├── lib.rs                   — запуск приложения, встроенный шрифт и общий стиль egui
│   ├── constants.rs             — цвета темы, размеры, типы инструментов и панелей,
│   │                              палитра и вспомогательные функции
│   ├── color.rs                 — преобразование RGB/HSV и интерполяция цветов
│   ├── ui.rs                    — общие виджеты и загрузка текстур
│   └── app/
│       ├── mod.rs               — объявления модулей и реэкспорты
│       ├── config.rs            — настройки, их проверка и работа с хранилищем eframe
│       ├── effects.rs           — 17 эффектов, перенесённых из Pixelorama
│       ├── snow.rs              — анимация падающего снега поверх холста
│       ├── document/
│       │   ├── mod.rs           — слои, снимки состояния, документ и холст с маскотом
│       │   ├── anim.rs          — кадры, ячейки анимации и управление воспроизведением
│       │   ├── canvas.rs        — сведение слоёв, рисование кистью, заливка,
│       │   │                      зеркальное рисование и кеш текстур
│       │   ├── history.rs       — снимки состояния для отмены и повтора действий
│       │   ├── io.rs            — работа со слоями, импорт и экспорт PNG,
│       │   │                      изменение размера, масштабирование и сведение
│       │   ├── text.rs          — растровый шрифт 5×7 для инструмента «Текст»
│       │   └── tools.rs         — кисть, выделение, перемещение, заливка и буфер обмена
│       ├── state/
│       │   ├── mod.rs           — структура PixeshApp и её конструктор
│       │   ├── actions.rs       — состояние диалогов, подсказки, применение эффектов
│       │   │                      и воспроизведение анимации
│       │   ├── color.rs         — синхронизация цветов и история их выбора
│       │   ├── layout.rs        — расположение панелей, видимость и порядок отрисовки
│       │   ├── prefs.rs         — загрузка и сохранение настроек
│       │   ├── tabs.rs          — открытие и закрытие документов, перетаскивание файлов
│       │   └── update.rs        — цикл обновления eframe::App и диалог выхода
│       └── ui/
│           ├── mod.rs           — объявления модулей интерфейса
│           ├── canvas_view.rs   — отображение холста и вызов обработчиков инструментов
│           ├── drag.rs          — перетаскивание и закрепление панелей у краёв окна
│           ├── input.rs         — клавиатура, колесо мыши, перемещение стрелками
│           │                      и временное переключение на пипетку
│           ├── layers.rs        — панель слоёв и выбора цвета
│           ├── status.rs        — строка состояния
│           ├── timeline.rs      — временная шкала анимации
│           ├── toolbar.rs       — панель инструментов и вкладки документов
│           └── dialogs/
│               ├── mod.rs       — выбор и отображение диалогов
│               ├── effects.rs   — панель эффектов
│               ├── export.rs    — экспорт в PNG
│               ├── panels.rs    — управление видимостью панелей
│               ├── resize.rs    — изменение размера холста
│               ├── scale.rs     — масштабирование изображения
│               ├── settings.rs  — настройки
│               ├── text.rs      — параметры инструмента «Текст»
│               └── welcome.rs   — приветствие и быстрый старт
├── img/                         — логотип и изображения маскота
├── tex/                         — иконки инструментов и встроенный шрифт
└── docs/                        — документация по архитектуре и интерфейсу

Надеюсь… Нет, мечтаю, что больше менять эту архитектуру не придётся. Ибо она прекрасна. По крайней мере, пока.

Больше, чем тестовый проект

К концу июля проект заметно вырос: появились новые функции, интерфейс стал приятнее, а код — чище. Вроде бы. То, что начиналось как эксперимент на один вечер, постепенно превращалось в редактор, который хотелось развивать дальше.

Выглядит уже заметно лучше. Прокрутка, правда, всё ещё неудобная, зато около 60% задуманных функций уже на месте. Оставалось кое-где подтянуть дизайн и исправить несколько багов в работе панели.

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

Забытый месяц

Август действительно можно назвать забытым месяцем для pixesh. За всё время я сделал всего пять-шесть коммитов: мотивация пропала, а внимание переключилось на другие проекты. Думал, что сентябрь будет поактивнее, но не тут-то было — к 26 сентября набралось ещё около четырёх коммитов.

И тут, под конец сентября, мотивация внезапно вернулась. Я снова взялся за pixesh и начал активно его развивать. С тех пор работа над проектом продолжается — надеюсь, без второго забытого месяца.

Что есть в pixesh сегодня

Итак, с историей разобрались. Теперь давайте посмотрим, во что превратился тот самый эксперимент на один вечер и что pixesh умеет сегодня.

Сейчас в pixesh есть всё, что мне нужно для удобной работы с пиксель-артом. Вот основные возможности редактора:

  • Базовые инструменты: кисть с круглой и квадратной маской, ластик, заливка и пипетка.

  • Работа с выделением: выделенную область можно перемещать, копировать и вставлять.

  • Инструмент для создания и редактирования текста.

  • Эффекты — большая часть их кода перенесена из Pixelorama.

  • Работа с цветом и слоями, в том числе сразу с несколькими холстами.

Остальные возможности спрятаны за горячими клавишами. Например, Ctrl + S открывает окно «Export PNG» для экспорта изображения, а Ctrl + L позволяет импортировать другое изображение. Через «Panel dialog» (Ctrl + W) можно управлять видимостью панелей, а в «Settings» (Ctrl + H) — настроить сам редактор. Полный список сочетаний клавиш и описание панелей можно найти в README проекта на GitHub.

Изюминка pixesh

А теперь, возможно, самое интересное: почему я называю pixesh «рисовалкой для вимеров»? Многие действия здесь уже можно выполнять без мыши — даже выбирать цвет. В будущем я хочу пойти дальше и добавить возможность рисовать с клавиатуры. Именно управление без мыши я и хочу сделать главной особенностью pixesh.

На этом всё! Если проект вам понравился, поддержите его звездой на GitHub. Спасибо, что дочитали, и до скорых встреч!