Raster To SVG

Превращает растровую PNG-картинку в масштабируемый векторный SVG.

Загружай этот скилл когда нужно перевести растровое изображение в вектор: для логотипов, иконок, схем, README-ассетов или любого PNG, который должен масштабироваться без потери качества.

🎯 When to use

Use this skill when:

• Есть PNG-файл (логотип, иконка, схема) и нужен SVG для вставки в веб/документацию
• Просят «векторизировать картинку», «png в svg», «trace image», «convert png to svg»
• Нужна детерминированная трассировка без внешних зависимостей (только Python 3)
• Хочется стилизованный результат: контурную обводку или мозаику из примитивов

Do NOT use when:

• Исходник уже в векторе (SVG/PDF/EPS) — трассировка растра не нужна
• Нужна фотореалистичная векторизация сложных фото — лучше специализированный редактор
• Формат не PNG — CLI принимает только PNG на входе (в веб-интерфейсе JPG/JPEG/WEBP конвертируются автоматически в браузере)

📦 Files

• SKILL.md — этот файл
• scripts/raster_to_svg.py — конвертер PNG → SVG (Python 3 stdlib, без pip)
• scripts/raster_to_svg_server.py — локальный веб-сервер с UI (стандартный http.server)
• scripts/svg_export.py — конвертеры SVG → DXF R12 / EPS (слои по цвету заливки)
• scripts/raster_to_svg_mcp.py — опциональный MCP-сервер для AI-агентов
• examples/web/ — фронтенд (index.html + style.css + app.js): drag & drop (PNG/JPG/WEBP с локальной перекодировкой), sticky-превью с лупой ×4 на результате, 12 быстрых пресетов (плоский стиль, минимал, лайн-арт, иконка, логотип, фото-плоский, фото, дуотон, винтаж, чб, мозаика-постер, мозаика-круги) с меткой «ручные настройки» при ручном изменении, скрытие неактуальных групп настроек движка (vtracer/native/мозаика), подготовка фото (сглаживание + ступени цвета в браузере), прогресс-бар, код SVG, скачивание

🧰 Usage

# Базово: PNG → SVG с белым фоном:
python3 skills/raster-to-svg/scripts/raster_to_svg.py -i logo.png -o logo.svg --bg white

# Меньше цветов (нативный contour):
python3 raster_to_svg.py -i logo.png -o logo.svg --colors 4

# Мозаичный постер из примитивов:
python3 raster_to_svg.py -i icon.png -o icon.svg -m mosaic --cell 8 --shape auto

# Пайплайн stdin → stdout:
cat icon.png | python3 raster_to_svg.py -i - -o -

# Машиночитаемый отчёт:
python3 raster_to_svg.py -i logo.png -o logo.svg --json

# Принудительно нативный движок (без vtracer):
python3 raster_to_svg.py -i logo.png -o logo.svg --engine native

🌐 Веб-интерфейс

Запуск локального веб-сервера с UI (drag & drop, превью, код, скачивание, копирование):

python3 skills/raster-to-svg/scripts/raster_to_svg_server.py
# → http://127.0.0.1:8642/ (откроется в браузере автоматически)

Опции: --port N, --host, --no-browser, --max-mb N (лимит входного файла, по умолчанию 20 МБ).

• Конвертация полностью локальная — картинка никуда не отправляется.
• API: GET / — UI, GET /health — статус, GET /defaults — схема параметров (single source of truth), POST /convert?<параметры> с телом = raw PNG → {"svg", "report"}, POST /export (JSON {"svg","fmt","layers"}) → DXF/EPS, POST /zip (JSON {"files":[{"name","svg"}]}) → .zip для пакетной обработки.
• UI-фичи: редактор палитры (свотчи, перекраска, слияние цветов), экспорт DXF/EPS/PNG, пакетная обработка (очередь PNG → один .zip).
• Ошибки: 400 неверный параметр, 413 превышен лимит, 415 не-PNG, 500 сбой движка.

🧭 Движки и режимы

По умолчанию --engine auto: берётся vtracer, если он установлен, иначе native.

Режимы (-m):

• contour (по умолчанию): квантование цветов → контуры → квадратичные Bezier, поддерживает дырки (fill-rule="evenodd"). Тюнинг: --colors, --smooth, --corner, --seam, --bg.
• mosaic: сетка ячеек из примитивов (--shape rect|circle|triangle|auto), детерминированный микс по --seed, зазор --gap. Тюнинг: --cell, --shape, --gap, --seed.

vtracer-параметры: --vtracer-preset bw|poster|photo, --vtracer-mode spline|polygon, --vtracer-color-precision, --vtracer-filter-speckle.

⚡ Производительность движков (эмпирика, aug 2026)

Замер: contour, 8 цветов, macOS arm64. Фото = портрет 1024×1024.

Итог: для фото vtracer в 2–4× быстрее, легче и детальнее; native — выбор для простых изображений (логотипы, пиксель-арт, иконки): mce 0.0, один путь на цвет, полный офлайн. auto сам выбирает vtracer при наличии.

🔬 Проверка результата

• SVG всегда проходит XML-валидацию (round-trip через парсер) перед записью — файл корректен для вставки в HTML/Markdown.
• Детерминизм: один и тот же вход даёт байт-идентичный SVG при повторном запуске.
• Коды выхода: 0 — успех, 1 — ошибка ввода/использования, 2 — сбой движка. При ошибке причина пишется в stderr.

Boundaries

• Do not use for raster edits or arbitrary image generation; it only vectorizes existing raster input.

Evidence and completion gate

Run the documented command against the user’s actual input. Report the command, exit status, files changed or produced, and relevant stdout/stderr. Separate blocked or pre-existing failures from failures introduced by the current work. Do not call the result complete when the script was only described or when an artifact was not reopened and checked.