95 lines
5.5 KiB
Markdown
95 lines
5.5 KiB
Markdown
# Minint
|
||
|
||
> Растровый редактор с собственным бинарным форматом `.minint`, поддержкой слоёв, анимации и палитровых эффектов.
|
||
|
||
## Что это
|
||
|
||
Desktop-приложение для создания и редактирования пиксельной графики. Изображения хранятся в собственном бинарном формате с палитровой моделью, где каждый документ (кадр) содержит свою палитру RGBA и набор слоёв. Контейнер объединяет несколько документов для анимации.
|
||
|
||
## Возможности
|
||
|
||
- **Собственный формат `.minint`** — самописная бинарная сериализация с валидацией, переменным размером индексов палитры (1–4 байта)
|
||
- **Слои** — добавление, удаление, переименование, порядок, видимость, прозрачность, дублирование
|
||
- **Документы/кадры** — несколько документов в одном контейнере, каждый со своей палитрой
|
||
- **Инструменты** — кисть, ластик (с регулируемым радиусом), заливка (flood fill), выделение + копирование/вставка
|
||
- **Холст** — pan (среднее колёсико / touchpad), zoom (Ctrl+колёсико), nearest-neighbor масштабирование, пиксельная сетка
|
||
- **Эффекты** — контрастность (A1), перевод в градации серого (A2) — применяются через палитру
|
||
- **Копирование фрагмента (A4)** — визуальное выделение на холсте, плавающая вставка с поддержкой смены документа/слоя
|
||
- **Генерация узоров (Б4)** — шахматка, градиент, полосы, концентрические круги, плитка
|
||
- **Анимация** — проигрывание документов как кадров с настраиваемым delay
|
||
- **Экспорт** — BMP (32-bit BGRA, самописный), GIF (анимированный, LZW, самописный)
|
||
|
||
## Стек
|
||
|
||
| Компонент | Технология |
|
||
|-----------|------------|
|
||
| Язык | C# / .NET 10 |
|
||
| UI | Avalonia 11.3.8 |
|
||
| MVVM | CommunityToolkit.Mvvm 8.2.1 |
|
||
| Тесты | xUnit |
|
||
| Сериализация | Полностью самописная (бинарная) |
|
||
| Экспорт BMP/GIF | Полностью самописный |
|
||
|
||
## Структура проекта
|
||
|
||
```
|
||
Minint.slnx
|
||
├── Minint.Core/ — Доменные модели, интерфейсы сервисов, чистая логика
|
||
├── Minint.Infrastructure/ — Сериализация .minint, экспорт BMP/GIF
|
||
├── Minint/ — Avalonia UI приложение
|
||
└── Minint.Tests/ — Unit-тесты (xUnit)
|
||
```
|
||
|
||
Core не зависит ни от каких внешних пакетов. Infrastructure зависит только от Core. UI зависит от Core + Infrastructure + Avalonia.
|
||
|
||
## Требования
|
||
|
||
- [.NET 10 SDK](https://dotnet.microsoft.com/download) или новее
|
||
|
||
## Сборка и запуск
|
||
|
||
```bash
|
||
dotnet build
|
||
dotnet run --project Minint
|
||
```
|
||
|
||
## Тесты
|
||
|
||
```bash
|
||
dotnet test
|
||
```
|
||
|
||
37 тестов покрывают: сериализацию (round-trip), композитинг, инструменты рисования, flood fill, эффекты (контраст, grayscale), генерацию паттернов, копирование фрагмента, экспорт BMP/GIF.
|
||
|
||
## Управление
|
||
|
||
| Действие | Управление |
|
||
|----------|------------|
|
||
| Зум | Ctrl + колёсико мыши |
|
||
| Перемещение (pan) | Среднее колёсико / touchpad scroll |
|
||
| Рисование | Левая кнопка мыши |
|
||
| Пиксельная сетка | Ctrl+G или View > Pixel Grid |
|
||
| Копирование фрагмента | Select tool → выделить → Ctrl+C → Ctrl+V → кликнуть для фиксации |
|
||
| Отмена вставки | Escape |
|
||
| Новый файл | Ctrl+N |
|
||
| Открыть | Ctrl+O |
|
||
| Сохранить | Ctrl+S |
|
||
|
||
## Формат `.minint`
|
||
|
||
Подробная спецификация формата — в файле [`FORMAT.md`](FORMAT.md).
|
||
|
||
Ключевые свойства:
|
||
- Little-endian
|
||
- Сигнатура `MININT`, версия формата
|
||
- Палитра RGBA на документ, индексы переменной ширины (1–4 байта)
|
||
- Полная валидация при чтении
|
||
|
||
## Ограничения
|
||
|
||
- **Undo/Redo** не реализовано (архитектура не запрещает добавление)
|
||
- **Размер контейнера** — все документы имеют одинаковые размеры (width × height на уровне контейнера)
|
||
- **GIF квантизация** — простая popularity-based (до 256 цветов), может терять оттенки
|
||
- **Максимальный размер** — 65536 × 65536 пикселей (ограничение формата)
|
||
- Имена документов/слоёв — максимум 255 UTF-8 байт
|