Documentation
Complete guide for quality profiles, advanced controls, similarity score, and batch conversion.
Quick Start
- Upload a PNG from the dropzone.
- Pick a quality profile (default is Ultra).
- Optionally enable advanced controls or smaller file mode.
- Review side-by-side preview and similarity score.
- Download a single SVG or convert multiple files as ZIP.
Production Feature Priority
If you are deciding what is essential in production, prioritize by actual user value.
| Feature | Priority | Why |
|---|---|---|
| Quality profile | Required | Simple defaults reduce user decision load and support most flows. |
| Advanced controls | Expert-only | Useful for edge cases and quality tuning, but too complex for most users. |
| Batch convert | Scenario-based | Critical for bulk asset workflows, optional for single-file usage. |
Quality Profiles
| Profile | Best Use | Tradeoff |
|---|---|---|
| Ultra | Maximum visual fidelity | Largest SVG size, slowest processing |
| Balanced | Everyday production usage | Slightly less detail than Ultra |
| Fast | Quick iteration and drafts | Lower quality and path detail |
| Pixel Art | Hard-edged pixel graphics | Not ideal for soft gradients/photos |
Advanced Controls
Enable manual overrides to tune output quality. Start with Ultra, then adjust one slider at a time.
| Control | Effect | Tip |
|---|---|---|
| Colors | Palette depth and gradient accuracy | Higher improves fidelity but increases file size |
| ltres / qtres | Line/curve fitting error thresholds | Lower keeps more detail |
| pathomit | Removes short tiny paths | Set 0 for max detail retention |
| roundcoords | Coordinate precision | Higher is more accurate, larger output |
| Quant / Blur | Color convergence and smoothing behavior | Keep blur low for sharp assets |
Best practice: start from `Ultra` or `Balanced`, then change one slider at a time and watch similarity + output size together.
Similarity Score
The app rasterizes both the original PNG and generated SVG, then compares pixel differences. This gives a practical percentage estimate, not a strict visual truth metric.
Guide: 98%+ near-identical, 94-97% very close, 90-93% good, below 90% needs tuning.
Batch ZIP
Use batch mode to process multiple PNG files with the current settings and download all generated SVG files in one ZIP archive.
Recommendation: finalize settings with one file first, then run batch for consistency.
Operational Notes
- PNG files are validated by extension, MIME type, and header signature.
- Preview SVG content is sanitized before rendering for safer client display.
- Similarity score is a practical approximation, not a perceptual quality oracle.
- For large batches, monitor browser memory and process in smaller chunks if needed.