RasterTracer: руководство пользователя

RasterTracer переводит растровые изображения — логотипы, сканы, рисунки, фотографии — в векторный формат SVG. Обработка идёт на вашем компьютере: изображения никуда не отправляются.

Быстрый старт

1. Откройте изображение: кнопка «Открыть», Ctrl+O или перетащите файл в окно.
2. Выберите режим трассировки на панели инструментов: «Чёрно-белый», «Цветной» или «Цветной HQ».
3. Выберите пресет в правой колонке — готовый набор настроек под типовую задачу.
4. Сравните результат с оригиналом и при необходимости подвигайте ползунки.
5. Сохраните результат: «Экспорт SVG» или Ctrl+S.

Предпросмотр считается на уменьшенной копии, чтобы ползунки отзывались сразу. Экспорт всегда выполняется в полном разрешении исходного файла.

Читаются форматы PNG, JPEG, BMP, TIFF, WebP, GIF, PPM и PGM. Имя файла и путь могут быть на любом языке.

Режимы трассировки

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

Цветной. Изображение раскладывается на цветные области (движок VTracer). Считается быстрее остальных режимов. Подходит для иллюстраций, плоской графики и фотографий.

Цветной HQ. Палитра сокращается до заданного числа цветов, и каждый цвет трассируется отдельно тем же движком, что и чёрно-белый режим. Считается дольше, но контуры получаются чище. Подходит для логотипов и иллюстраций с небольшим числом цветов. На панели — «Цветной HQ».

Сравнение с оригиналом

Режим показа переключается кнопками на панели или клавишами 1–4:

• Оригинал — только исходное изображение.
• Шторка — оригинал и вектор в одном кадре; границу между ними можно перетаскивать мышью.
• Рядом — оригинал слева, вектор справа, масштаб и положение общие.
• Вектор — только результат.

Колесо мыши меняет масштаб под курсором, перетаскивание двигает изображение, двойной щелчок вписывает его в окно.

Порог (клавиша B) показывает вместо оригинала маску бинаризации — ровно то, что получает движок в чёрно-белом режиме. Если на маске мусор или пропали тонкие линии, исправлять нужно параметры подготовки, а не кривых.

Параметры и пресеты

Правая колонка содержит параметры текущего режима. Наведите курсор на название параметра, чтобы увидеть подсказку. Двойной щелчок по названию возвращает значение по умолчанию.

Флажок «Показать дополнительные параметры» открывает редко нужные настройки.

Пресет — сохранённый набор настроек. Встроенные пресеты покрывают типовые задачи: «Логотип и силуэт», «Скан документа», «Скетч карандашом», «Штамп и печать», «Плоские заливки», «Цветная иллюстрация», «Фотография». Свой набор сохраняется через кнопку «⋯» рядом со списком — «Сохранить как пресет…». Пользовательские пресеты хранятся в профиле пользователя и переживают обновление и переустановку программы.

Кнопка «Авто» включает пересчёт предпросмотра при каждом изменении параметров. Если изображение большое и пересчёт мешает, выключите её и обновляйте предпросмотр клавишей F5.

Сохранение результата

• Экспорт SVG (Ctrl+S) трассирует изображение в полном разрешении и сохраняет файл. На большом изображении это занимает больше времени, чем предпросмотр.
• Копировать (Ctrl+C) кладёт в буфер обмена SVG предпросмотра — для быстрой вставки в графический редактор.

В строке состояния показаны число путей, число цветов и размер SVG. Чем меньше путей, тем легче файл и проще его правка в редакторе.

Горячие клавиши

Советы

• Мелкий мусор на скане убирает параметр подавления крапа; неровный фон — адаптивная бинаризация (пресет «Скан документа»).
• Ступенчатые края обычно означают слишком маленький исходник. Увеличение изображения перед трассировкой помогает больше, чем сглаживание кривых.
• Фотография в векторе всегда выглядит как постер. Чем меньше цветов и крупнее области, тем аккуратнее результат и легче файл.
• Для логотипа с двумя-пятью цветами режим «Цветной HQ» обычно даёт более чистые контуры, чем «Цветной».

Обновление программы

Раз в сутки при запуске программа запрашивает с сайта apps.scrumweb.ru номер последней версии. В запросе нет сведений о вас и вашем компьютере, изображения не передаются. Если сервер недоступен, программа работает как обычно.

Когда выходит новая версия, программа показывает, что изменилось, и спрашивает разрешения. По кнопке «Обновить» она загружает инсталлятор, сверяет его контрольную сумму, закрывается, устанавливает новую версию и запускается снова. Настройки и пресеты сохраняются. Без вашего согласия ничего не загружается и не устанавливается.

• Проверить вручную: «Справка» → «Проверить обновления…».
• Отключить автоматическую проверку: «Справка» → «Проверять обновления при запуске».
• «Пропустить версию» — больше не напоминать об этой версии; о следующей программа сообщит.

Обновить программу можно и вручную: скачайте новый инсталлятор со страницы программы и запустите его. Он найдёт установленную копию и обновит её.

Версия без установки (один файл .exe) себя не обновляет: она сообщает о новой версии и открывает страницу загрузки.

Командная строка

Собранная программа принимает путь к изображению первым аргументом:

RasterTracer.exe logo.png

Пакетная обработка без окна доступна при работе из исходных текстов — сценарий cli.py принимает те же параметры, что и интерфейс, и умеет обрабатывать файлы по маске.

Проверка целостности установленной программы:

RasterTracer.exe --selftest report.txt

О программе и разработчике

Разработчик — Валерий Завольский.

Страница программы и новые версии: https://apps.scrumweb.ru/rastertracer/

Другие программы: https://apps.scrumweb.ru/

Возможна разработка на заказ: настольные и веб-приложения, сайты, оптимизация и продвижение сайтов. Подробнее — https://scrumweb.ru/

Программа бесплатна для личного некоммерческого использования. Использование в коммерческих целях требует согласования с автором: info@scrumweb.ru. Полный текст условий — файл TERMS.txt в каталоге программы.

В программе использованы potrace (Peter Selinger, GPLv2, запускается как отдельная программа), VTracer (MIT), Qt и PySide6 (LGPL v3), OpenCV, NumPy и Pillow. Тексты лицензий лежат в каталоге программы.