thorvg-python 1.1.0__tar.gz → 1.1.2__tar.gz

{thorvg_python-1.1.0/src/thorvg_python.egg-info → thorvg_python-1.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thorvg-python
-Version: 1.1.0
+Version: 1.1.2
 Summary: A ctypes API for thorvg, a vector graphics engine supporting SVG and Lottie formats.
 Author-email: chaudominic <chaudominic2@gmail.com>
 License:                   GNU LESSER GENERAL PUBLIC LICENSE
@@ -532,7 +532,7 @@ Dynamic: license-file
 
 A ctypes API for thorvg, with additional functions for getting Pillow Image.
 
-The functions mostly follow [thorvg/src/bindings/capi/thorvg_capi.h](https://github.com/thorvg/thorvg/blob/v1.0.1/src/bindings/capi/thorvg_capi.h)
+The functions mostly follow [thorvg/src/bindings/capi/thorvg_capi.h](https://github.com/thorvg/thorvg/blob/v1.0.3/src/bindings/capi/thorvg_capi.h)
 
 Documentations: https://thorvg-python.readthedocs.io/en/latest/
 
@@ -546,7 +546,7 @@ Documentations: https://thorvg-python.readthedocs.io/en/latest/
 
 Note that thorvg is included in the wheel package, you need not install libthorvg.
 Version bundled is the version available on [Conan](https://conan.io/center/recipes/thorvg)
-(Currently 1.0.1)
+(Currently 1.0.3)
 
 To install, run the following:
 ```bash
@@ -568,15 +568,16 @@ canvas = tvg.SwCanvas(engine)
 canvas.set_target(512, 256)  # w, h
 
 rect = tvg.Shape(engine)
-rect.append_rect(10, 10, 64, 64, 10, 10)  # x, y, w, h, rx, ry
+rect.append_rect(10, 10, 64, 64, 10, 10, True)  # x, y, w, h, rx, ry, clockwise
 rect.set_fill_color(32, 64, 128, 100)  # r, g, b, a
-canvas.push(rect)
+canvas.add(rect)
 
 canvas.update()
 canvas.draw(True)
 canvas.sync()
 
 im = canvas.get_pillow()
+im.save("test.png")
 canvas.destroy()
 engine.term()
 ```

{thorvg_python-1.1.0 → thorvg_python-1.1.2}/README.md

@@ -2,7 +2,7 @@
 
 A ctypes API for thorvg, with additional functions for getting Pillow Image.
 
-The functions mostly follow [thorvg/src/bindings/capi/thorvg_capi.h](https://github.com/thorvg/thorvg/blob/v1.0.1/src/bindings/capi/thorvg_capi.h)
+The functions mostly follow [thorvg/src/bindings/capi/thorvg_capi.h](https://github.com/thorvg/thorvg/blob/v1.0.3/src/bindings/capi/thorvg_capi.h)
 
 Documentations: https://thorvg-python.readthedocs.io/en/latest/
 
@@ -16,7 +16,7 @@ Documentations: https://thorvg-python.readthedocs.io/en/latest/
 
 Note that thorvg is included in the wheel package, you need not install libthorvg.
 Version bundled is the version available on [Conan](https://conan.io/center/recipes/thorvg)
-(Currently 1.0.1)
+(Currently 1.0.3)
 
 To install, run the following:
 ```bash
@@ -38,15 +38,16 @@ canvas = tvg.SwCanvas(engine)
 canvas.set_target(512, 256)  # w, h
 
 rect = tvg.Shape(engine)
-rect.append_rect(10, 10, 64, 64, 10, 10)  # x, y, w, h, rx, ry
+rect.append_rect(10, 10, 64, 64, 10, 10, True)  # x, y, w, h, rx, ry, clockwise
 rect.set_fill_color(32, 64, 128, 100)  # r, g, b, a
-canvas.push(rect)
+canvas.add(rect)
 
 canvas.update()
 canvas.draw(True)
 canvas.sync()
 
 im = canvas.get_pillow()
+im.save("test.png")
 canvas.destroy()
 engine.term()
 ```

{thorvg_python-1.1.0 → thorvg_python-1.1.2}/pyproject.toml

@@ -8,7 +8,7 @@ authors = [{ "name" = "chaudominic", "email" = "chaudominic2@gmail.com" }]
 keywords = ["thorvg", "lottie", "svg", "ctypes", "python"]
 classifiers = ["Topic :: Multimedia :: Graphics"]
 dependencies = []
-version = "1.1.0"
+version = "1.1.2"
 
 [project.urls]
 Repository = "https://github.com/laggykiller/thorvg-python"

{thorvg_python-1.1.0 → thorvg_python-1.1.2}/setup.py

@@ -7,6 +7,7 @@ import sys
 from typing import Any, Dict, List
 
 from setuptools import find_packages, setup  # type: ignore
+from setuptools.command.build_py import build_py  # type: ignore
 
 CONAN_ARCHS = {
     "x86_64": ["amd64", "x86_64", "x64"],
@@ -90,18 +91,25 @@ def install_thorvg(arch: str) -> Dict[Any, Any]:
     if "thorvg_python" not in profiles:
         subprocess.run(["conan", "profile", "detect", "-f", "--name", "thorvg_python"])
 
-        if platform.architecture()[0] == "32bit" or platform.machine().lower() not in (
-            CONAN_ARCHS["armv8"] + CONAN_ARCHS["x86_64"]
-        ):
-            profile_path = (
-                subprocess.run(
-                    ["conan", "profile", "path", "thorvg_python"],
-                    stdout=subprocess.PIPE,
-                )
-                .stdout.decode()
-                .strip()
+        profile_path = (
+            subprocess.run(
+                ["conan", "profile", "path", "thorvg_python"],
+                stdout=subprocess.PIPE,
             )
+            .stdout.decode()
+            .strip()
+        )
 
+        with open(profile_path, "a+") as f:
+            # https://github.com/conan-io/conan/issues/19179#issuecomment-3472691734
+            f.write("\n")
+            f.write("[replace_requires]\n")
+            f.write("libjpeg-turbo/*: libjpeg-turbo/3.1.3")
+
+        if (
+            platform.architecture()[0] == "32bit"
+            or platform.machine().lower() not in (CONAN_ARCHS["x86_64"])
+        ):
             with open(profile_path, "a+") as f:
                 # https://github.com/conan-io/conan/issues/19179#issuecomment-3472691734
                 f.write("\n")
@@ -114,7 +122,7 @@ def install_thorvg(arch: str) -> Dict[Any, Any]:
         [
             "conan",
             "export",
-            "--version=1.0.1",
+            "--version=1.0.3",
             "thorvg_conan",
         ]
     )
@@ -133,7 +141,7 @@ def install_thorvg(arch: str) -> Dict[Any, Any]:
             "--deployer=direct_deploy",
             "--format=json",
             "--profile:all=thorvg_python",
-            "--requires=thorvg/1.0.1",
+            "--requires=thorvg/1.0.3",
         ],
         stdout=subprocess.PIPE,
     ).stdout.decode()
@@ -175,33 +183,38 @@ def fetch_thorvg(conan_info: Dict[Any, Any]) -> List[str]:
     return lib_paths
 
 
-def compile():
-    arch = get_arch()
-    print(f"Detected system architecture as {arch}")
-
-    if arch == "universal2":
-        conan_info = install_thorvg("x86_64")
-        lib_paths = fetch_thorvg(conan_info)
-        conan_info = install_thorvg("armv8")
-        lib_paths.extend(fetch_thorvg(conan_info))
-        print(f"{lib_paths=}")
-        subprocess.run(
-            [
-                "lipo",
-                "-create",
-                lib_paths[0],
-                lib_paths[1],
-                "-output",
-                "src/thorvg_python/libthorvg-1.dylib",
-            ]
-        )
-    else:
-        conan_info = install_thorvg(arch)
-        lib_paths = fetch_thorvg(conan_info)
-        print(f"{lib_paths=}")
-        for lib_path in lib_paths:
-            shutil.copy(lib_path, "src/thorvg_python/")
+class build_py_custom(build_py):
+    def run(self, *args: Any, **kwargs: Any):
+        arch = get_arch()
+        print(f"Detected system architecture as {arch}")
+
+        if arch == "universal2":
+            conan_info = install_thorvg("x86_64")
+            lib_paths = fetch_thorvg(conan_info)
+            conan_info = install_thorvg("armv8")
+            lib_paths.extend(fetch_thorvg(conan_info))
+            print(f"{lib_paths=}")
+            subprocess.run(
+                [
+                    "lipo",
+                    "-create",
+                    lib_paths[0],
+                    lib_paths[1],
+                    "-output",
+                    "src/thorvg_python/libthorvg-1.dylib",
+                ]
+            )
+        else:
+            conan_info = install_thorvg(arch)
+            lib_paths = fetch_thorvg(conan_info)
+            print(f"{lib_paths=}")
+            for lib_path in lib_paths:
+                shutil.copy(lib_path, "src/thorvg_python/")
 
+        super().run(*args, **kwargs)
+
+
+if __name__ == "__main__":
     setup(
         zip_safe=False,
         packages=find_packages(where="src"),
@@ -210,8 +223,7 @@ def compile():
         package_data={
             "thorvg_python": ["*.dll", "*.dylib", "*.so"],
         },
+        cmdclass={
+            "build_py": build_py_custom,
+        },
     )
-
-
-if __name__ == "__main__":
-    compile()

{thorvg_python-1.1.0 → thorvg_python-1.1.2}/src/thorvg_python/__init__.py

@@ -1,8 +1,9 @@
 #!/usr/bin/env python3
 """thorvg-python"""
 
-__version__ = "1.1.0"
+__version__ = "1.1.2"
 
+from .accessor import Accessor  # type: ignore  # noqa: F401
 from .animation import Animation  # type: ignore  # noqa: F401
 from .animation.lottie import LottieAnimation  # type: ignore  # noqa: F401
 from .base import BlendMethod  # type: ignore  # noqa: F401
@@ -10,6 +11,8 @@ from .base import Colorspace  # type: ignore  # noqa: F401
 from .base import ColorStop  # type: ignore  # noqa: F401
 from .base import EngineOption  # type: ignore  # noqa: F401
 from .base import FillRule  # type: ignore  # noqa: F401
+from .base import FilterMethod  # type: ignore  # noqa: F401
+from .base import GlyphMetrics  # type: ignore  # noqa: F401
 from .base import MaskMethod  # type: ignore  # noqa: F401
 from .base import Matrix  # type: ignore  # noqa: F401
 from .base import PathCommand  # type: ignore  # noqa: F401

{thorvg_python-1.1.0 → thorvg_python-1.1.2}/src/thorvg_python/accessor.py

@@ -112,4 +112,4 @@ class Accessor:
             ctypes.POINTER(name_char_type)
         ]
         self.thorvg_lib.tvg_accessor_generate_id.restype = ctypes.c_uint32
-        return self.thorvg_lib.tvg_accessor_generate_id(ctypes.pointer(name_char)).value
+        return self.thorvg_lib.tvg_accessor_generate_id(ctypes.pointer(name_char))

{thorvg_python-1.1.0 → thorvg_python-1.1.2}/src/thorvg_python/animation/lottie.py

@@ -189,7 +189,7 @@ class LottieAnimation(Animation):
         name = ctypes.c_char_p()
         self.thorvg_lib.tvg_lottie_animation_get_marker.argtypes = [
             AnimationPointer,
-            ctypes.POINTER(ctypes.c_uint32),
+            ctypes.c_uint32,
             ctypes.POINTER(ctypes.c_char_p),
         ]
         self.thorvg_lib.tvg_lottie_animation_get_marker.restype = Result
@@ -204,6 +204,50 @@ class LottieAnimation(Animation):
             _name = None
         return result, _name
 
+    def get_marker_info(self, idx: int) -> Tuple[Result, Optional[str], float, float]:
+        """Retrieves marker information by index
+
+        :param int idx: The zero-based index of the animation marker.
+
+        :return:
+            Result.INVALID_ARGUMENT if ``idx`` is out of range.
+            Result.INSUFFICIENT_CONDITION In case the animation is not loaded.
+        :rtype: Result
+        :return: The marker name.
+        :rtype: Optional[str]
+        :return: The marker's starting frame.
+        :rtype: float
+        :return: The marker's ending frame.
+        :rtype: float
+
+        .. seealso:: LottieAnimation.get_markers_cnt()
+        .. note::
+            Experimental API
+        """
+        name = ctypes.c_char_p()
+        begin = ctypes.c_float()
+        end = ctypes.c_float()
+        self.thorvg_lib.tvg_lottie_animation_get_marker_info.argtypes = [
+            AnimationPointer,
+            ctypes.POINTER(ctypes.c_uint32),
+            ctypes.POINTER(ctypes.c_char_p),
+            ctypes.POINTER(ctypes.c_float),
+            ctypes.POINTER(ctypes.c_float),
+        ]
+        self.thorvg_lib.tvg_lottie_animation_get_marker_info.restype = Result
+        result = self.thorvg_lib.tvg_lottie_animation_get_marker_info(
+            self._animation,
+            ctypes.c_uint32(idx),
+            ctypes.pointer(name),
+            ctypes.pointer(begin),
+            ctypes.pointer(end),
+        )
+        if name.value is not None:
+            _name = name.value.decode("utf-8")
+        else:
+            _name = None
+        return result, _name, begin.value, end.value
+
     def tween(self, _from: float, to: float, progress: float) -> Result:
         """Interpolates between two frames over a specified duration.
 

{thorvg_python-1.1.0 → thorvg_python-1.1.2}/src/thorvg_python/base.py

@@ -396,6 +396,20 @@ class FillRule(IntEnum):
         return int(obj)
 
 
+class FilterMethod(IntEnum):
+    """Defines the image filtering method used during image scaling or transformation.
+
+    .. note::
+        Experimental API
+    """
+
+    #: Smooth interpolation using surrounding pixels for higher quality.
+    BILINEAR = 0
+
+    #: Fast filtering using nearest-neighbor sampling.
+    NEAREST = 1
+
+
 class ColorStop(ctypes.Structure):
     """A data structure storing the information about the color and its relative position inside the gradient bounds."""
 
@@ -495,6 +509,19 @@ class TextMetrics(ctypes.Structure):
     advance: float  #: The total vertical advance between lines of text: ascent - descent + linegap (i.e., ascent + |descent| + linegap when descent is negative).
 
 
+class GlyphMetrics(ctypes.Structure):
+    _fields_ = [
+        ("advance", ctypes.c_float),
+        ("bearing", ctypes.c_float),
+        ("min", PointStruct),
+        ("max", PointStruct),
+    ]
+    advance: float  #: The advance distance along the baseline (inline) direction.
+    bearing: float  #: The bearing from the origin to the glyph’s visible bound along the inline-start direction.
+    min: PointStruct  #: The minimum point of the glyph bounding box in local space.
+    max: PointStruct  #: The maximum point of the glyph bounding box in local space.
+
+
 """Callback function type for resolving external assets.
 
 This callback is invoked when a Picture requires an external asset

{thorvg_python-1.1.0 → thorvg_python-1.1.2}/src/thorvg_python/paint/__init__.py

@@ -64,9 +64,9 @@ class Paint:
         self.thorvg_lib.tvg_paint_ref.restype = ctypes.c_uint16
         return self.thorvg_lib.tvg_paint_ref(
             self._paint,
-        ).value
+        )
 
-    def deref(self, free: bool) -> int:
+    def unref(self, free: bool) -> int:
         """Decrement the reference count for the PaintPointer object.
 
         This method decreases the reference count of the PaintPointer object by 1.
@@ -82,12 +82,12 @@ class Paint:
 
         .. versionadded:: 1.0
         """
-        self.thorvg_lib.tvg_paint_deref.argtypes = [
+        self.thorvg_lib.tvg_paint_unref.argtypes = [
             PaintPointer,
             ctypes.c_bool,
         ]
-        self.thorvg_lib.tvg_paint_deref.restype = ctypes.c_uint16
-        return self.thorvg_lib.tvg_paint_deref(self._paint, ctypes.c_bool(free)).value
+        self.thorvg_lib.tvg_paint_unref.restype = ctypes.c_uint16
+        return self.thorvg_lib.tvg_paint_unref(self._paint, ctypes.c_bool(free))
 
     def get_ref(self) -> int:
         """Retrieve the current reference count of the PaintPointer object.
@@ -108,7 +108,7 @@ class Paint:
         self.thorvg_lib.tvg_paint_get_ref.restype = ctypes.c_uint16
         return self.thorvg_lib.tvg_paint_get_ref(
             self._paint,
-        ).value
+        )
 
     def set_visible(self, visible: bool) -> Result:
         """Sets the visibility of the Paint object.
@@ -139,23 +139,15 @@ class Paint:
             self._paint, ctypes.c_bool(visible)
         )
 
-    def get_visible(self, visible: bool) -> Result:
-        """Sets the visibility of the Paint object.
-
-        This is useful for selectively excluding paint objects during rendering.
-
-        :param bool visible: A boolean flag indicating visibility. The default is ``true``.
-            - ``true``: the object will be rendered by the engine.
-            - ``false``: the object will be excluded from the drawing process.
+    def get_visible(self) -> Result:
+        """Gets the current visibility status of the Paint object..
 
-        .. note::
-            An invisible object is not considered inactive—it may still participate
-            in internal update processing if its properties are updated, but it will not
-            be taken into account for the final drawing output. To completely deactivate
-            a paint object, remove it from the canvas.
+        :return:
+            True if the object is visible and will be rendered.
+            False if the object is hidden and will not be rendered.
+        :rtype: bool
 
-        .. seealso:: Paint.get_visible()
-        .. seealso:: Canvas.remove()
+        .. seealso:: Paint.set_visible()
 
         .. versionadded:: 1.0
         """
@@ -165,7 +157,50 @@ class Paint:
         self.thorvg_lib.tvg_paint_get_visible.restype = ctypes.c_bool
         return self.thorvg_lib.tvg_paint_get_visible(
             self._paint,
-        ).value
+        )
+
+    def get_id(self) -> int:
+        """Gets the ID of the Paint object.
+
+        :return: The ID of the paint object, or 0 if the ID is not set.
+        :rtype: int
+
+        .. seealso:: Picture.get_paint()
+        .. seealso:: Accessor.generate_id()
+        .. seealso:: Paint.set_id()
+
+        .. note::
+            Experimental API
+        """
+        self.thorvg_lib.tvg_paint_get_id.argtypes = [
+            PaintPointer,
+        ]
+        self.thorvg_lib.tvg_paint_get_id.restype = ctypes.c_uint32
+        return self.thorvg_lib.tvg_paint_get_id(
+            self._paint,
+        )
+
+    def set_id(self, _id: int) -> Result:
+        """Sets the ID of the Paint object.
+
+        :param int _id: The ID to assign to the paint object.
+
+        .. seealso:: Picture.get_paint()
+        .. seealso:: Accessor.generate_id()
+        .. seealso:: Paint.get_id()
+
+        .. note::
+            Experimental API
+        """
+        self.thorvg_lib.tvg_paint_set_id.argtypes = [
+            PaintPointer,
+            ctypes.c_uint32,
+        ]
+        self.thorvg_lib.tvg_paint_set_id.restype = Result
+        return self.thorvg_lib.tvg_paint_set_id(
+            self._paint,
+            _id,
+        )
 
     def scale(self, factor: float) -> Result:
         """Scales the given PaintPointer object by the given factor.

{thorvg_python-1.1.0 → thorvg_python-1.1.2}/src/thorvg_python/paint/picture.py

@@ -2,7 +2,13 @@
 import ctypes
 from typing import Callable, Optional, Tuple
 
-from ..base import Colorspace, PaintPointer, PictureAssetResolverType, Result
+from ..base import (
+    Colorspace,
+    FilterMethod,
+    PaintPointer,
+    PictureAssetResolverType,
+    Result,
+)
 from ..engine import Engine
 from . import Paint
 
@@ -355,12 +361,12 @@ class Picture(Paint):
         .. seealso:: Engine.accessor_generate_id()
         .. versionadded: 1.0
         """
-        self.thorvg_lib.tvg_picture_get_size.argtypes = [
+        self.thorvg_lib.tvg_picture_get_paint.argtypes = [
             PaintPointer,
             ctypes.c_uint32,
         ]
-        self.thorvg_lib.tvg_picture_get_size.restype = PaintPointer
-        paint_struct = self.thorvg_lib.tvg_picture_get_size(
+        self.thorvg_lib.tvg_picture_get_paint.restype = PaintPointer
+        paint_struct = self.thorvg_lib.tvg_picture_get_paint(
             self._paint,
             ctypes.c_uint32(_id),
         )
@@ -368,3 +374,29 @@ class Picture(Paint):
             return Paint(self.engine, paint_struct)
         else:
             return None
+
+    def set_filter(self, method: FilterMethod) -> Result:
+        """Sets the image filtering method for rendering this picture.
+
+        Specifies how the image data should be filtered when it is scaled or transformed
+        during rendering. This affects the visual quality and performance of the output.
+
+        :param thorvg_python.base.FilterMethod method:
+            The filtering method to apply. Default is thorvg_python.base.FilterMethod.BILINEAR
+
+        :return: Result
+        :rtype: thorvg_python.base.Result
+
+        .. seealso:: FilterMethod
+        .. note::
+            Experimental API
+        """
+        self.thorvg_lib.tvg_picture_set_filter.argtypes = [
+            PaintPointer,
+            ctypes.c_uint8,
+        ]
+        self.thorvg_lib.tvg_picture_set_filter.restype = Result
+        result = self.thorvg_lib.tvg_picture_set_filter(
+            self._paint, ctypes.c_uint8(method)
+        )
+        return result

{thorvg_python-1.1.0 → thorvg_python-1.1.2}/src/thorvg_python/paint/text.py

@@ -2,7 +2,14 @@
 import ctypes
 from typing import Optional, Tuple
 
-from ..base import GradientPointer, PaintPointer, Result, TextMetrics, TextWrap
+from ..base import (
+    GlyphMetrics,
+    GradientPointer,
+    PaintPointer,
+    Result,
+    TextMetrics,
+    TextWrap,
+)
 from ..engine import Engine
 from ..gradient import Gradient
 from . import Paint
@@ -128,8 +135,9 @@ class Text(Paint):
 
         :param str utf8: The multi-byte text encoded with utf8 string to be rendered.
 
-        :rtyle: Result
+        :rtype: Result
 
+        .. seealso:: Text.get_text()
         .. versionadded: 1.0
         """
         utf8_bytes = utf8.encode() + b"\x00"
@@ -145,6 +153,29 @@ class Text(Paint):
             ctypes.pointer(text_arr),
         )
 
+    def get_text(self) -> str:
+        """Returns the currently assigned unicode text.
+
+        This function retrieves the unicode string that is currently set
+        for rendering. The returned text is encoded in UTF-8.
+
+        :return: The UTF-8 encoded multi-byte text string.
+        :rtype: str
+
+        .. seealso:: Text.set_text()
+
+        .. note::
+            Experimental API
+        """
+        self.thorvg_lib.tvg_text_set_text.argtypes = [
+            PaintPointer,
+        ]
+        self.thorvg_lib.tvg_text_set_text.restype = ctypes.c_char_p
+
+        return self.thorvg_lib.tvg_text_set_text(
+            self._paint,
+        ).decode("utf-8")
+
     def align(self, x: float, y: float) -> Result:
         """Sets text alignment or anchor per axis.
 
@@ -210,6 +241,7 @@ class Text(Paint):
         :param thorvg_python.base.TextWrap mode: The wrapping strategy to apply. Default is ``NONE``.
 
         .. seealso:: TextWrap
+        .. seealso:: Text.line_count()
         .. versionadded:: 1.0
         """
         self.thorvg_lib.tvg_text_wrap_mode.argtypes = [
@@ -222,6 +254,28 @@ class Text(Paint):
             mode,
         )
 
+    def line_count(self) -> int:
+        """Returns the number of text lines.
+
+        This function retrieves the number of lines generated after applying text layout and wrapping.
+        The returned value reflects the current wrapping configuration set by thorvg_python.Text.wrap_mode().
+        The line count is also increased by explicit line feed characters ('\n') contained in the text.
+
+        :return: The total number of lines
+        :rtype: int
+
+        .. seealso:: Text.wrap_mode()
+        .. note::
+            Experimental API
+        """
+        self.thorvg_lib.tvg_text_wrap_mode.argtypes = [
+            PaintPointer,
+        ]
+        self.thorvg_lib.tvg_text_wrap_mode.restype = ctypes.c_uint32
+        return self.thorvg_lib.tvg_text_wrap_mode(
+            self._paint,
+        )
+
     def spacing(self, letter: float, line: float) -> Result:
         """Set the spacing scale factors for text layout.
 
@@ -389,7 +443,7 @@ class Text(Paint):
             gradient._grad,  # type: ignore
         )
 
-    def get_metrics(self) -> Tuple[Result, TextMetrics]:
+    def get_text_metrics(self) -> Tuple[Result, TextMetrics]:
         """Retrieves the layout metrics of the text object.
 
         Fills the provided `TextMetrics` structure with the font layout values of this text object,
@@ -400,7 +454,7 @@ class Text(Paint):
 
         :return: A `TextMetrics` structure filled with the resulting values.
         :rtype: thorvg_python.base.TextMetrics
-        :return: TVG_RESULT_INSUFFICIENT_CONDITION if no font or size has been set yet.
+        :return: Result.INSUFFICIENT_CONDITION if no font or size has been set yet.
         :rtype: thorvg_python.base.Result
 
         .. seealso:: TextMetrics
@@ -408,13 +462,56 @@ class Text(Paint):
             Experimental API
         """
         metrics = TextMetrics()
-        self.thorvg_lib.tvg_text_get_metrics.argtypes = [
+        self.thorvg_lib.tvg_text_get_text_metrics.argtypes = [
             PaintPointer,
             ctypes.POINTER(TextMetrics),
         ]
-        self.thorvg_lib.tvg_text_get_metrics.restype = Result
-        result = self.thorvg_lib.tvg_text_get_metrics(
+        self.thorvg_lib.tvg_text_get_text_metrics.restype = Result
+        result = self.thorvg_lib.tvg_text_get_text_metrics(
+            self._paint,
+            ctypes.pointer(metrics),
+        )
+        return result, metrics
+
+    def get_glyph_metrics(self, ch: str) -> Tuple[Result, GlyphMetrics]:
+        """Retrieves the layout metrics of a glyph in the text object.
+
+        Fills the provided @ref Tvg_Glyph_Metrics structure with the horizontal layout values
+        of the specified glyph, such as advance, left-side bearing, and bounding box.
+
+        The returned values reflect the font size applied to the text object,
+        but do not include any transformations (e.g., scale, rotation, or translation).
+
+        The input character must be a single UTF-8 encoded character.
+
+        :return: A `GlyphMetrics` structure filled with the resulting values.
+        :rtype: thorvg_python.base.GlyphMetrics
+        :return:
+            Result.INSUFFICIENT_CONDITION if no font or size has been set yet.
+            RESULT.INVALID_ARGUMENT if the given character is invalid or not supported.
+        :rtype: thorvg_python.base.Result
+
+        .. seealso:: GlyphMetrics
+        .. note::
+            Currently, ThorVG only supports horizontal text layout.
+        .. note::
+            Experimental API
+        """
+        metrics = GlyphMetrics()
+
+        ch_bytes = ch.encode() + b"\x00"
+        ch_arr_type = ctypes.c_char * len(ch_bytes)
+        ch_arr = ch_arr_type.from_buffer_copy(ch_bytes)
+
+        self.thorvg_lib.tvg_text_get_glyph_metrics.argtypes = [
+            PaintPointer,
+            ctypes.POINTER(ch_arr_type),
+            ctypes.POINTER(GlyphMetrics),
+        ]
+        self.thorvg_lib.tvg_text_get_glyph_metrics.restype = Result
+        result = self.thorvg_lib.tvg_text_get_glyph_metrics(
             self._paint,
+            ctypes.pointer(ch_arr),
             ctypes.pointer(metrics),
         )
         return result, metrics

{thorvg_python-1.1.0 → thorvg_python-1.1.2/src/thorvg_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thorvg-python
-Version: 1.1.0
+Version: 1.1.2
 Summary: A ctypes API for thorvg, a vector graphics engine supporting SVG and Lottie formats.
 Author-email: chaudominic <chaudominic2@gmail.com>
 License:                   GNU LESSER GENERAL PUBLIC LICENSE
@@ -532,7 +532,7 @@ Dynamic: license-file
 
 A ctypes API for thorvg, with additional functions for getting Pillow Image.
 
-The functions mostly follow [thorvg/src/bindings/capi/thorvg_capi.h](https://github.com/thorvg/thorvg/blob/v1.0.1/src/bindings/capi/thorvg_capi.h)
+The functions mostly follow [thorvg/src/bindings/capi/thorvg_capi.h](https://github.com/thorvg/thorvg/blob/v1.0.3/src/bindings/capi/thorvg_capi.h)
 
 Documentations: https://thorvg-python.readthedocs.io/en/latest/
 
@@ -546,7 +546,7 @@ Documentations: https://thorvg-python.readthedocs.io/en/latest/
 
 Note that thorvg is included in the wheel package, you need not install libthorvg.
 Version bundled is the version available on [Conan](https://conan.io/center/recipes/thorvg)
-(Currently 1.0.1)
+(Currently 1.0.3)
 
 To install, run the following:
 ```bash
@@ -568,15 +568,16 @@ canvas = tvg.SwCanvas(engine)
 canvas.set_target(512, 256)  # w, h
 
 rect = tvg.Shape(engine)
-rect.append_rect(10, 10, 64, 64, 10, 10)  # x, y, w, h, rx, ry
+rect.append_rect(10, 10, 64, 64, 10, 10, True)  # x, y, w, h, rx, ry, clockwise
 rect.set_fill_color(32, 64, 128, 100)  # r, g, b, a
-canvas.push(rect)
+canvas.add(rect)
 
 canvas.update()
 canvas.draw(True)
 canvas.sync()
 
 im = canvas.get_pillow()
+im.save("test.png")
 canvas.destroy()
 engine.term()
 ```

{thorvg_python-1.1.0 → thorvg_python-1.1.2}/src/thorvg_python.egg-info/SOURCES.txt

@@ -7,7 +7,6 @@ src/thorvg_python/__init__.py
 src/thorvg_python/accessor.py
 src/thorvg_python/base.py
 src/thorvg_python/engine.py
-src/thorvg_python/libthorvg-1.so
 src/thorvg_python/py.typed
 src/thorvg_python/saver.py
 src/thorvg_python.egg-info/PKG-INFO

{thorvg_python-1.1.0 → thorvg_python-1.1.2}/tests/test_all.py

@@ -318,6 +318,18 @@ def test_paint():
     ]
     assert matrix_list == matrix_out_list
 
+    assert shape.get_ref() == 1
+    assert shape.ref() == 2
+    assert shape.unref(free=False) == 1
+
+    assert shape.set_visible(False) == tvg.Result.SUCCESS
+    assert shape.get_visible() is False
+    assert shape.set_visible(True) == tvg.Result.SUCCESS
+
+    assert shape.get_id() == 0
+    assert shape.set_id(1337) == tvg.Result.SUCCESS
+    assert shape.get_id() == 1337
+
     shape2 = tvg.Shape(engine)
     assert shape.set_mask_method(shape2, tvg.MaskMethod.DARKEN) == tvg.Result.SUCCESS
     result, method = shape.get_mask_method(shape2)
@@ -515,6 +527,7 @@ def _test_picture_load(test_file: str, ref: str):
         assert check_im_same(im, ref) is True
 
     assert picture.get_size() == (tvg.Result.SUCCESS, 256, 256)
+    assert isinstance(picture.get_paint(0), tvg.Paint)
 
     assert canvas.destroy() == tvg.Result.SUCCESS
     assert engine.term() == tvg.Result.SUCCESS

thorvg_python-1.1.2/thorvg_conan/conandata.yml

@@ -0,0 +1,4 @@
+sources:
+  "1.0.3":
+    url: "https://github.com/thorvg/thorvg/archive/refs/tags/v1.0.3.tar.gz"
+    sha256: "96bd73c9b3f063251404609757301197d63b6a75e22c1527889dcaab3d5827a0"

thorvg_python-1.1.0/thorvg_conan/conandata.yml

@@ -1,4 +0,0 @@
-sources:
-  "1.0.1":
-    url: "https://github.com/thorvg/thorvg/archive/refs/tags/v1.0.1.tar.gz"
-    sha256: "061343ed560f08ef2f7b48a7f6b684ae6bfd50b7904599d8581e466b2531844f"