kivy / kivy / 25338915925

59%

Build Type

push

github

Committed by web-flow

Commit Message

Add internal ThorVG Cython wrapper (kivy.lib.thorvg) (#9297)

* Add internal ThorVG Cython wrapper (kivy.lib.thorvg)

Introduce kivy/lib/thorvg/ as an internal Cython binding to ThorVG v1.0.4,
in preparation for replacing the external `thorvg-python` dependency used
by the unmerged SVG / SVG-image / Lottie feature branches. ThorVG is
linked statically on all desktop platforms; no separate kivy-deps wheel
is shipped.

Wrapper surface (minimal - only what the three providers need):

* Paint / Picture with ownership-aware __dealloc__ and set_opacity / id
* SwCanvas with zero-copy Python buffer protocol for GPU upload
  (Texture.blit_buffer consumes this directly - see bench below)
* Accessor for SVG element-id traversal using ThorVG 1.0.4's native
  accessible-mode API (removes the XML-fallback the feature branches
  previously carried)
* LottieAnimation with frame / segment / marker / slot / quality controls
* Engine initialised exactly once on module import (SW, threads=0)

Build wiring (setup.py):

* c_options['use_thorvg'], auto-enabled if headers+lib are discoverable
* determine_thorvg_flags() with KIVY_THORVG_{INCLUDE,LIB}_DIR env-var
  overrides and KIVY_DEPS_ROOT/dist fallback
* TVG_STATIC defined, C++ runtime linked on darwin / unix; compiled as
  C++ (language='c++')

Tests + benchmarks (skip-if-unavailable, no SDL3/GStreamer needed):

* kivy/tests/test_thorvg_wrapper.py - 23 unit tests covering engine
  version, canvas / picture / accessor / animation lifecycle, buffer
  allocation, ownership transfer on Canvas.add, and callback exception
  safety
* kivy/tests/bench_thorvg_wrapper.py - 6 micro-benchmarks; crucially a
  matched pair (memoryview vs bytes) that makes the ~45x zero-copy win
  of the buffer protocol visible and regression-guards against providers
  falling back to bytes(canvas) on the hot path

Lightweight CI gate (.github/workflows/test_thorvg_wrapper.yml) + helpers
(.ci/thorvg_wrapper_*.py): builds ThorVG v1.0.4 statically with
M... (continued)

Coverage Stats

3049 of 6223 branches covered (49.0%)

176 of 239 new or added lines in 3 files covered. (73.64%)

719 existing lines in 41 files now uncovered.

26075 of 45186 relevant lines covered (57.71%)

1.14 hits per line