vectorize · quantize · export

Raster to SVG
in C++, Python,
JavaScript & C

Img2Num is a cross-platform library that converts PNG/JPEG to clean, layered SVG paths. Built for speed, zero dependencies, and multi-language bindings.

Installation and Setup Changelog GitHub →

★ —stars

⑂ —forks

C++/C/Py/JSbindings

NASA/JPL (PIA01481) demo

Jupiter system montage raster image — raster input

Try Live Demo →

Use it anywhere

See all bindings →

C++17

Native speed

Quantisation, contour tracing, SVG writer. Add it as a submodule.

#include "img2num"
img2num::ImageToSvgConfig config;
config.kmeans.k = 32;
std::string svg {img2num::image_to_svg(img_data, width, height, config)};

C++ Docs C Docs

Python

pip install img2num

Numpy array in → SVG string out. Seamless integration.

import img2num

cfg = img2num.ImageToSvgConfig(kmeans = {"k": 16})
svg = img2num.image_to_svg(img, config=cfg)

npm i img2num

Browser / Node. Same C++ core compiled to WebAssembly.

import { imageToUint8ClampedArray, imageToSvg } from "img2num"

const { pixels, width, height } = await imageToUint8ClampedArray(file);
const svg = await imageToSvg({ pixels, width, height });

JsDoc