univector

univector brings UniVector’s Nim graphics engine to Python through its C ABI. It can parse or construct SVG-style paths, inspect and flatten their geometry, render solid fills into RGBA8 images, and produce SVG or PNG bytes.

The SVG support is deliberately path-focused: Path.parse_d() reads path data, and Path.to_svg() writes a minimal document containing one solid-filled path. It does not parse arbitrary SVG documents or preserve SVG scene structure, styles, transforms, strokes, gradients, text, or external resources.

Install

python -m pip install univector

Wheels are built for CPython 3.9–3.14 on Linux, macOS, and Windows. A source installation needs Nim and Nimble on PATH, a supported C compiler, and the platform's zlib development package because it compiles the vendored Nim engine and its PNG support:

python -m pip install --no-binary univector univector

For a repository checkout:

nimble pyLib
cd py
python -m pip install -e ".[test]"
python -m pytest -q

Draw once, emit SVG and PNG

import univector

path = univector.Path()
path.rounded_rect(8, 8, 48, 48, 6, 6, 6, 6)
path.circle(32, 32, 12)

color = univector.Color.parse("oklch(62% 0.17 255)")
image = univector.Image(64, 64)
image.fill(path, color, winding=univector.WINDING_EVEN_ODD)

png_bytes = image.encode_png()
svg_text = path.to_svg(color, 64, 64)

Image.pixels() returns a Python bytes copy in row-major RGBA order. encode_png() returns complete PNG bytes; to_svg() returns a standalone SVG string whose view box matches the raster dimensions.

Parse and inspect paths

path = univector.Path.parse_d("M 10 10 C 20 0 40 0 50 10 Z")

print(path.current)       # (10.0, 10.0), because Z closes the subpath
print(path.commands)      # [(kind, parameters), ...]
print(path.flatten(0.25)) # [((x0, y0), (x1, y1)), ...]
print(path.bounds(0.25))  # (x, y, width, height)

The tolerance is the subdivision threshold used against each curve span. A smaller value produces more segments and generally smoother edges at a higher cost. Passing 0.0 selects FLATTEN_TOLERANCE.

Geometry helpers

mid = univector.quad_point((0, 0), (1, 1), (2, 0), 0.5)
point = univector.cubic_point((0, 0), (0, 1), (1, 1), (1, 0), 0.25)

assert univector.is_relative(univector.PATH_REL_LINE)
assert univector.parameter_count(univector.PATH_CUBIC) == 6

quad_point and cubic_point require t in [0, 1]. Path command constants run from PATH_CLOSE through PATH_REL_ARC; each command returned by Path.commands uses one of those constants and contains only its meaningful parameters.

API summary

Path: move_to, line_to, bezier_curve_to, quadratic_curve_to, elliptical_arc_to, arc, arc_to, rect, rounded_rect, ellipse, circle, polygon, close_path, add_path, copy, parse_d, to_d, to_svg, flatten, bounds, current, start, and commands.
Image: width, height, channels, pixels, fill, and encode_png.
Color: parse, rgba, and to_svg.
Geometry: quad_point, cubic_point, and compute_bounds.
Command metadata: is_relative, parameter_count, and PATH_* constants.
Rendering constants: WINDING_NON_ZERO, WINDING_EVEN_ODD, BLEND_NORMAL, BLEND_OVERWRITE, GEOMETRIC_EPSILON, FLATTEN_TOLERANCE, MAX_FLATTEN_DEPTH, MAX_FLATTEN_SEGMENTS, and SUPERSAMPLE.
Runtime: version, abi_version, and strerror.

Errors and lifetime

Python objects own their native handles and release them during garbage collection. Returned Python strings and bytes own their data, so they remain valid after the originating object is deleted. Invalid geometry, malformed SVG path data, and unsupported arguments raise ValueError; allocation failures raise MemoryError; a concurrent mutation detected during a two-pass read raises RuntimeError. Do not use the same object concurrently from multiple threads without external synchronization.

UniVector is Apache-2.0 licensed.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

univector-1.0.0.tar.gz (238.8 kB view details)

Uploaded Aug 10, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

univector-1.0.0-cp314-cp314-win_amd64.whl (435.2 kB view details)

Uploaded Aug 10, 2026 CPython 3.14Windows x86-64

univector-1.0.0-cp314-cp314-manylinux_2_35_x86_64.whl (1.2 MB view details)

Uploaded Aug 10, 2026 CPython 3.14manylinux: glibc 2.35+ x86-64

univector-1.0.0-cp314-cp314-macosx_26_0_arm64.macosx_10_15_x86_64.whl (556.9 kB view details)

Uploaded Aug 10, 2026 CPython 3.14macOS 10.15+ x86-64macOS 26.0+ ARM64

univector-1.0.0-cp313-cp313-win_amd64.whl (424.3 kB view details)

Uploaded Aug 10, 2026 CPython 3.13Windows x86-64

univector-1.0.0-cp313-cp313-manylinux_2_35_x86_64.whl (1.2 MB view details)

Uploaded Aug 10, 2026 CPython 3.13manylinux: glibc 2.35+ x86-64

univector-1.0.0-cp313-cp313-macosx_26_0_arm64.macosx_10_13_x86_64.whl (557.0 kB view details)

Uploaded Aug 10, 2026 CPython 3.13macOS 10.13+ x86-64macOS 26.0+ ARM64

univector-1.0.0-cp312-cp312-win_amd64.whl (424.2 kB view details)

Uploaded Aug 10, 2026 CPython 3.12Windows x86-64

univector-1.0.0-cp312-cp312-manylinux_2_35_x86_64.whl (1.2 MB view details)

Uploaded Aug 10, 2026 CPython 3.12manylinux: glibc 2.35+ x86-64

univector-1.0.0-cp312-cp312-macosx_26_0_arm64.macosx_10_13_x86_64.whl (558.1 kB view details)

Uploaded Aug 10, 2026 CPython 3.12macOS 10.13+ x86-64macOS 26.0+ ARM64

univector-1.0.0-cp311-cp311-win_amd64.whl (423.8 kB view details)

Uploaded Aug 10, 2026 CPython 3.11Windows x86-64

univector-1.0.0-cp311-cp311-manylinux_2_35_x86_64.whl (1.2 MB view details)

Uploaded Aug 10, 2026 CPython 3.11manylinux: glibc 2.35+ x86-64

univector-1.0.0-cp311-cp311-macosx_26_0_arm64.macosx_10_9_x86_64.whl (557.7 kB view details)

Uploaded Aug 10, 2026 CPython 3.11macOS 10.9+ x86-64macOS 26.0+ ARM64

univector-1.0.0-cp310-cp310-win_amd64.whl (424.6 kB view details)

Uploaded Aug 10, 2026 CPython 3.10Windows x86-64

univector-1.0.0-cp310-cp310-manylinux_2_35_x86_64.whl (1.2 MB view details)

Uploaded Aug 10, 2026 CPython 3.10manylinux: glibc 2.35+ x86-64

univector-1.0.0-cp310-cp310-macosx_26_0_arm64.macosx_10_9_x86_64.whl (558.2 kB view details)

Uploaded Aug 10, 2026 CPython 3.10macOS 10.9+ x86-64macOS 26.0+ ARM64

univector-1.0.0-cp39-cp39-win_amd64.whl (425.0 kB view details)

Uploaded Aug 10, 2026 CPython 3.9Windows x86-64

univector-1.0.0-cp39-cp39-manylinux_2_35_x86_64.whl (1.2 MB view details)

Uploaded Aug 10, 2026 CPython 3.9manylinux: glibc 2.35+ x86-64

univector-1.0.0-cp39-cp39-macosx_26_0_arm64.macosx_10_9_x86_64.whl (559.9 kB view details)

Uploaded Aug 10, 2026 CPython 3.9macOS 10.9+ x86-64macOS 26.0+ ARM64

File details

Details for the file univector-1.0.0.tar.gz.

File metadata

Download URL: univector-1.0.0.tar.gz
Upload date: Aug 10, 2026
Size: 238.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for univector-1.0.0.tar.gz
Algorithm	Hash digest
SHA256	`29fe16727b1a9df3d3d39a01f441232c85cad5af5080f378d7bb8636c7f73a8c`
MD5	`914bdfd6f8e706861716a8a0116e63e0`
BLAKE2b-256	`5a609480ddd535c9e069125113cc9acb357a4db8e7553007c05ab198f17ada44`

Algorithm	Hash digest
SHA256	`14e3b52d0162ddbecc49ecbaae8ee16e46b3606ab5f8cd86dc500de6f70c3670`
MD5	`f84a3fd9703e5029e091d6421382175b`
BLAKE2b-256	`5b8e9925eedfdca176fbff307138bf22bd127f148178c6c9eabdc9ea6ad6c432`

Algorithm	Hash digest
SHA256	`392619e880472b40d445180b071effe59e4c356f9796dd32081eaea3afa1c689`
MD5	`e2cef1cc95ce5d49dbece4f6f007dbe7`
BLAKE2b-256	`4be4d91046c8a0a0f1b3cb097db2063ee0cabcc1166b0482d4e46ae9aea6ed4d`

Algorithm	Hash digest
SHA256	`813fc87821e92f1e495bf783bfe297c6ff2dc2e33b7e3e3edfb09ca5a576dbb2`
MD5	`2b4380329e80c8a84152de1377097e58`
BLAKE2b-256	`d8bba29b13217819c4f5416b43dd263bf313b10fd78c7de6cb7341fb5e48b9dd`

Algorithm	Hash digest
SHA256	`bce2384876f5c1137cd7aaef720722376d41806a5d90bdb1551f9b366954b719`
MD5	`d3cb5e32ba66010dc4c35c2a076b60db`
BLAKE2b-256	`72f96eb48d5ae55292f163a08a158c43121e05523a286515033c1765332e0508`

Algorithm	Hash digest
SHA256	`681f88647b5de76e2129357ea9754be28d226556ca7671631a7411e3fd5418db`
MD5	`1b3fe12f280b6e2e72731771e4e5640e`
BLAKE2b-256	`19cef00b620d00df12a3e268ae97313b094d773df2f07ddd1ff678fd9508a898`

Algorithm	Hash digest
SHA256	`5ec603f3e5715becfe6d19051a4ecfee6c7cf8b1a22a40ab54d4a06c9905e5b3`
MD5	`3fd7271478abf609626ecc531f222cc4`
BLAKE2b-256	`1694187ae2de176920b3db487dc91f9212c334f68491c9144fc4b0848a18a8ee`

Algorithm	Hash digest
SHA256	`6729b154df4e6f99cd31c1ec4b1aed702e49bd8b2a102b9c85293cf4a1d9358b`
MD5	`e427242c8cdd133061dd878081c98958`
BLAKE2b-256	`d15c5965878865e8c3a301721c0b46bf41ddd3819a66c0883594bf7d3d55f8e9`

Algorithm	Hash digest
SHA256	`911dd055d86906e4628722549d92c11445be6ecdb3ada4e922c1ce03cede7eae`
MD5	`2a5d3e2672e174db57a2cbb02bb56b3d`
BLAKE2b-256	`0aa44cc082907e8056b9afdf51c362b493a8d6feb65c7c71a9d07d20ecf0d9b1`

Algorithm	Hash digest
SHA256	`757a0df2da1b42373c042de2b7d1740962f6b6cd36b922cdd903b0e0bf1a8353`
MD5	`25db92aaf0a22b817a50963fa197158d`
BLAKE2b-256	`c7e77c24d688047967a54d64c1c062f9b954487dd132ca4aa81ae3bff1bf79a0`

Algorithm	Hash digest
SHA256	`8c8297630ace4093d5d6b612b8a42e8b400f7c79a0fe8ca2398e941bd747cdf9`
MD5	`a30c68dbb0b7e7d3e46c8ea3daaa3f92`
BLAKE2b-256	`3cb17fdd549300b644fc02289e9b62dfc520e79655648b5da6ae419b844fc37b`

Algorithm	Hash digest
SHA256	`8eca1229313413238ac0778b01c03afe6fd4a572d3e0afe99ec48e5a4df85c0c`
MD5	`25ebca4f64784e2e57724f6a03a2bad3`
BLAKE2b-256	`41d0c20de201ab507221568f57c91e0d93df01d4401732c1cdc68f3210dad3ed`

Algorithm	Hash digest
SHA256	`0ce36b80adc952c7e96b1c02a60323a2a782359d045eca9281c75ff756835e9b`
MD5	`b6f72020e65890c8a08e30a6f194bf4c`
BLAKE2b-256	`5a3ddba35837836fd79b65c035127f28dbb67a9ab3aa22325fa7f92ca1c84cb7`

Algorithm	Hash digest
SHA256	`5ede389ab146bd90e9cf2d76deac3bd40322d208a4b0d6f9bd93dc0b150a6aff`
MD5	`6e51dd71281f2282fbf959cb4c8ced59`
BLAKE2b-256	`de1b050b72b76ff56a024fe7b0e87de67f8d575ec74a93ec44f5039d48fa3ea6`

Algorithm	Hash digest
SHA256	`27628be2573b05e069472b4bbc3725028333326bbe8bddde6c19026adcd59208`
MD5	`f65d0c62c97148a711aa1a56b5ee51c0`
BLAKE2b-256	`13a611b853018f0c2f64ffac3b108ef0440d83c89c0b8efd11af4905ad6a7d22`

Algorithm	Hash digest
SHA256	`40f9cebc8d6486a564e9ec5c3bfaa1a16ba8970bc315c60b713e7e3ef0f00783`
MD5	`bca11550246e2e9d0da22c27ce9ea937`
BLAKE2b-256	`a7937b90e1dd380908258e37ff29e9e7d159e62bc0f3f1f571812149bc47bfb4`

Algorithm	Hash digest
SHA256	`673e9aaacb6218bcbb649589f4f82b5972973450b96e11a44cda164a0209c3dd`
MD5	`462e35b8f0f72a903feaa441f087c3f7`
BLAKE2b-256	`48a44d34e0eee3b389ba88ee6d85ac2b7f0881b4a01ff5ce0b1cb711e75bc345`

Algorithm	Hash digest
SHA256	`ac06d7f17ab662d94bb7160ee1cc13f79eaa5aa9d5559ffc05e9c2086f1d7b4a`
MD5	`7ab7cfb20bafc61e03112134013db328`
BLAKE2b-256	`4b79e3f1972895d7a2f6c2db7bd5837558e2092bd51c6fe75aa1237bd6c3a6a1`

Algorithm	Hash digest
SHA256	`7620becb763d69e9caa0bc03a0405bd9639cffdc06811e970ea4b9859e8df657`
MD5	`1783b93b6c0a591798e413cc6c69b49b`
BLAKE2b-256	`782be5e96ea719de7ad90bcbcbcb5a90f276efc2c0c90fb0fa6469c8ca6b5bf3`

univector 1.0.0

univector

Install

Draw once, emit SVG and PNG

Parse and inspect paths

Geometry helpers

API summary

Errors and lifetime

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes