mirror of
https://github.com/visioncortex/vtracer.git
synced 2026-09-28 23:11:21 -07:00
Chris Tsang
f76aed78b2
New crates/vtracer-py (pyo3 + maturin, abi3) wrapping the vtracer framework. Rather than a thin CLI-style wrapper, it exposes a mutable `Config` class with named properties and `bw`/`poster`/`photo` preset constructors, plus three input paths — `convert_file`, `convert_bytes` (encoded image, optional format), and `convert_pixels` (raw RGBA8) — available as `Config` methods and module-level functions. Palette is a list of `#rrggbb` strings; bad inputs raise ValueError. The core crate stays pure: image decoding lives here. The crate is excluded from the cargo workspace (pyo3 extension-module cdylibs don't link libpython, which breaks `cargo test` at the root) and is built with maturin. Ships a vtracer.pyi type stub. README updated.
56 lines
2.0 KiB
Python
56 lines
2.0 KiB
Python
from typing import Optional
|
|
|
|
__version__: str
|
|
|
|
class Config:
|
|
"""Conversion configuration. Construct with keyword arguments or a preset,
|
|
mutate via properties, then call one of the ``convert_*`` methods."""
|
|
|
|
def __init__(
|
|
self,
|
|
color_mode: str = "color", # "color" | "bw"
|
|
hierarchical: str = "stacked", # "stacked" | "cutout" (mosaic)
|
|
mode: str = "spline", # "pixel" | "polygon" | "spline"
|
|
filter_speckle: int = 4,
|
|
color_precision: int = 6,
|
|
layer_difference: int = 16,
|
|
corner_threshold: int = 60,
|
|
length_threshold: float = 4.0,
|
|
max_iterations: int = 10,
|
|
splice_threshold: int = 45,
|
|
path_precision: int = 2,
|
|
palette: Optional[list[str]] = None, # e.g. ["#112233", "#445566"]
|
|
max_colors: Optional[int] = None, # auto-quantize target
|
|
optimize: int = 1, # 0 | 1 | 2
|
|
) -> None: ...
|
|
|
|
@staticmethod
|
|
def bw() -> "Config": ...
|
|
@staticmethod
|
|
def poster() -> "Config": ...
|
|
@staticmethod
|
|
def photo() -> "Config": ...
|
|
|
|
color_mode: str
|
|
hierarchical: str
|
|
mode: str
|
|
filter_speckle: int
|
|
color_precision: int
|
|
layer_difference: int
|
|
corner_threshold: int
|
|
length_threshold: float
|
|
max_iterations: int
|
|
splice_threshold: int
|
|
path_precision: Optional[int]
|
|
palette: list[str]
|
|
max_colors: Optional[int]
|
|
optimize: int
|
|
|
|
def convert_file(self, input_path: str, output_path: str) -> None: ...
|
|
def convert_bytes(self, data: bytes, format: Optional[str] = None) -> str: ...
|
|
def convert_pixels(self, rgba: bytes, width: int, height: int) -> str: ...
|
|
|
|
def convert_file(input_path: str, output_path: str, config: Optional[Config] = None) -> None: ...
|
|
def convert_bytes(data: bytes, config: Optional[Config] = None, format: Optional[str] = None) -> str: ...
|
|
def convert_pixels(rgba: bytes, width: int, height: int, config: Optional[Config] = None) -> str: ...
|