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