vtracerpy 0.1.0

Python binding for vtracer. image to svg.

vtracerpy

Python binding for vtracer.

Install

from pypi

pip install vtracerpy

from source

Install rust.

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"
rustup -V

Install maturin

pip install maturin

build

git clone https://github.com/orange0-jp/vtracerpy.git
cd vtracerpy
maturin build -i python3 --release
pip install .

Usage

from pathlib import Path
from vtracerpy import image_to_svg
import cv2
img = cv2.imread('test/mask.png')
result = image_to_svg(img)
Path("mask.svg").write_text(result, encoding="utf-8")

Args

Convert an image to SVG format with specified parameters.

Parameters:
- image: (np.ndarray)The input image with shape (H,W,3) to be converted to SVG format.
- colormode (str, optional): True color image `color` (default) or Binary image `bw`. Defaults to 'bw'.
- color_precision (int, optional): Number of significant bits to use in an RGB channel. Defaults to 8.
- layer_difference (int, optional): Color difference between gradient layers. Defaults to 16.
- hierarchical (str, optional): Hierarchical clustering. Can be `stacked` (default) or non-stacked `cutout`. Only applies to color mode.
- path_precision (int, optional): Parameter not described in provided options. Defaults to 8.
- mode (str, optional): Curve fitting mode. Can be `pixel`, `polygon`, `spline`. Defaults to 'spline'.
- corner_threshold (int, optional): Minimum momentary angle (degree) to be considered a corner. Defaults to 60.
- length_threshold (float, optional): Perform iterative subdivide smooth until all segments are shorter than this length. Defaults to 4.0.
- max_iterations (int, optional): Parameter not described in provided options. Defaults to 10.
- splice_threshold (int, optional): Minimum angle displacement (degree) to splice a spline. Defaults to 45.
- filter_speckle (int, optional): Discard patches smaller than X px in size. Defaults to 4.

Returns:
- str: The SVG representation of the input image.

Development

init maturin project

maturin new --name vtracerpy --mixed -b pyo3 vtracerpy

build

maturin develop
pip install .