Этот проект входит в тройку моих самых масштабных и интересных. А началось всё с шуточного промпта: «Создай простой редактор пиксель‑арта на 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. Спасибо, что дочитали, и до скорых встреч!

Комментарии (0)