svg-ultralight 0.30.1__py3-none-any.whl → 0.32.0__py3-none-any.whl

svg_ultralight/__init__.py

@@ -38,7 +38,12 @@ from svg_ultralight.string_conversion import (
     format_numbers,
     format_numbers_in_string,
 )
-from svg_ultralight.transformations import transform_element
+from svg_ultralight.transformations import (
+    mat_apply,
+    mat_dot,
+    mat_invert,
+    transform_element,
+)
 
 __all__ = [
     "BoundCollection",
@@ -52,6 +57,9 @@ __all__ = [
     "format_number",
     "format_numbers",
     "format_numbers_in_string",
+    "mat_apply",
+    "mat_dot",
+    "mat_invert",
     "new_bbox_union",
     "new_bound_union",
     "new_element",

svg_ultralight/import_svg.py

@@ -0,0 +1,50 @@
+"""Import an svg file as a BoundElement.
+
+:author: Shay Hill
+:created: 2024-05-28
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from lxml import etree
+
+from svg_ultralight.bounding_boxes.type_bound_element import BoundElement
+from svg_ultralight.bounding_boxes.type_bounding_box import BoundingBox
+from svg_ultralight.constructors import new_element
+
+if TYPE_CHECKING:
+    import os
+
+    from lxml.etree import _Element as EtreeElement  # type: ignore
+
+
+def _get_bounds_from_viewbox(root: EtreeElement) -> BoundingBox:
+    """Get the BoundingBox from the viewbox attribute of the root element.
+
+    :param root: The root element of the svg.
+    :return: The BoundingBox of the svg.
+    """
+    viewbox = root.attrib.get("viewBox")
+    if viewbox is None:
+        msg = "SVG file has no viewBox attribute. Failed to create BoundingBox."
+        raise ValueError(msg)
+    x, y, width, height = map(float, viewbox.split())
+    return BoundingBox(x, y, width, height)
+
+
+def import_svg(svg: str | os.PathLike[str]) -> BoundElement:
+    """Import an svg file as a BoundElement.
+
+    :param svg: The path to the svg file.
+    :return: The BoundElement representation of the svg.
+
+    The viewbox of the svg is used to create the BoundingBox of the BoundElement.
+    """
+    tree = etree.parse(svg)
+    root = tree.getroot()
+    bbox = _get_bounds_from_viewbox(root)
+    root_as_elem = new_element("g")
+    root_as_elem.extend(root)
+    return BoundElement(root_as_elem, bbox)

svg_ultralight/layout.py

@@ -99,7 +99,7 @@ def _infer_scale(
     * print_h == 0 / viewbox_h > 0
 
     The print area is invalid, but there is special handling for this. Interpret
-    viewbox units as print_w.native_unit and determe print area from viewbox area 1
+    viewbox units as print_w.native_unit and determine print area from viewbox area 1
     to 1.
 
         >>> _infer_scale(Measurement("in"), Measurement("in"), 1, 2)

svg_ultralight/transformations.py

@@ -59,6 +59,20 @@ def mat_apply(mat1: _Matrix, mat2: tuple[float, float]) -> tuple[float, float]:
     return mat1[0] * mat2[0] + mat1[4], mat1[3] * mat2[1] + mat1[5]
 
 
+def mat_invert(tmat: _Matrix) -> _Matrix:
+    """Invert a 2D transformation matrix in svg format."""
+    a, b, c, d, e, f = tmat
+    det = a * d - b * c
+    return (
+        d / det,
+        -b / det,
+        -c / det,
+        a / det,
+        (c * f - d * e) / det,
+        (b * e - a * f) / det,
+    )
+
+
 def get_transform_matrix(elem: EtreeElement) -> _Matrix:
     """Get the transformation matrix from an svg element.
 

{svg_ultralight-0.30.1.dist-info → svg_ultralight-0.32.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: svg-ultralight
-Version: 0.30.1
+Version: 0.32.0
 Summary: a sensible way to create svg files with Python
 Author-email: Shay Hill <shay_public@hotmail.com>
 License: MIT

{svg_ultralight-0.30.1.dist-info → svg_ultralight-0.32.0.dist-info}/RECORD

@@ -1,7 +1,8 @@
-svg_ultralight/__init__.py,sha256=5lSOJM2dshB_cG3uNZbCp0q114mJ6wgJ59Kg4TYiiBU,2070
+svg_ultralight/__init__.py,sha256=iuI06A3lFqv0L7EoUfaKqYDg-z0HUlxPATBavtOmexs,2181
 svg_ultralight/animate.py,sha256=fE-zRU_uFrZIL9W78fcGz7qmrts8fz5UoWEy7b4xb44,1144
+svg_ultralight/import_svg.py,sha256=TVLbinch2g0RN-OlWyGXoQEO6vc2I_LsMXpOchwTJzE,1548
 svg_ultralight/inkscape.py,sha256=M8yTxXOu4NlXnhsMycvEJiIDpnDeiZ_bZakJBM38ZoU,9152
-svg_ultralight/layout.py,sha256=TTETT_8WLBXnQxDGXdAeczCFN5pFo5kKY3Q6zv4FPX4,12238
+svg_ultralight/layout.py,sha256=RBFJl6cIN6BYqXea5powEl2A4ZIxUJ0mtVoURkSZy_E,12240
 svg_ultralight/main.py,sha256=6oNkZfD27UMdP-oYqp5agS_IGcYb8NkUZwM9Zdyb3SA,7287
 svg_ultralight/metadata.py,sha256=Mxgxrxe1Ar4kp2wTT29aadxgHNFaaNLABo29jStiWDg,4201
 svg_ultralight/nsmap.py,sha256=y63upO78Rr-JJT56RWWZuyrsILh6HPoY4GhbYnK1A0g,1244
@@ -9,7 +10,7 @@ svg_ultralight/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 svg_ultralight/query.py,sha256=_KQuk4IwhVVDgTT0GZm_gbqNUGp7lMEDM32b_CTTSUA,7320
 svg_ultralight/root_elements.py,sha256=pt9J6mPrnoTAZVF6vKTZoM_o947I8UCj6MbGcD2JUCk,2869
 svg_ultralight/string_conversion.py,sha256=WEmpf75RJmJ2lfJluagAz2wPsz6wM8XvTEwkq4U0vEc,7353
-svg_ultralight/transformations.py,sha256=CT43zaWSmEoWf-rQpFgP_1KX9wL6AzpR0cF8E1fIhAU,3625
+svg_ultralight/transformations.py,sha256=64BN_UupvOZk4nbiKLKv09P3j0TPFhH6mKro_3QBqeY,3945
 svg_ultralight/unit_conversion.py,sha256=g07nhzXdjPvGcJmkhLdFbeDLrSmbI8uFoVgPo7G62Bg,9258
 svg_ultralight/bounding_boxes/__init__.py,sha256=qUEn3r4s-1QNHaguhWhhaNfdP4tl_B6YEqxtiTFuzhQ,78
 svg_ultralight/bounding_boxes/bound_helpers.py,sha256=YMClhdekeYbzD_ijXDAer-H3moWKN3lUNnZs1UNFFKc,3458
@@ -22,7 +23,7 @@ svg_ultralight/constructors/__init__.py,sha256=YcnO0iBQc19aL8Iemw0Y452MBMBIT2AN5
 svg_ultralight/constructors/new_element.py,sha256=VtMz9sPn9rMk6rui5Poysy3vezlOaS-tGIcGbu-SXmY,3406
 svg_ultralight/strings/__init__.py,sha256=Zalrf-ThFz7b7xKELx5lb2gOlBgV-6jk_k_EeSdVCVk,295
 svg_ultralight/strings/svg_strings.py,sha256=RYKMxOHq9abbZyGcFqsElBGLrBX-EjjNxln3s_ibi30,1296
-svg_ultralight-0.30.1.dist-info/METADATA,sha256=j2bSJ8HE0Y3JZv7S5ur92kpmbMd7FVeDe56aB9o3VTU,8871
-svg_ultralight-0.30.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-svg_ultralight-0.30.1.dist-info/top_level.txt,sha256=se-6yqM_0Yg5orJKvKWdjQZ4iR4G_EjhL7oRgju-fdY,15
-svg_ultralight-0.30.1.dist-info/RECORD,,
+svg_ultralight-0.32.0.dist-info/METADATA,sha256=9WclLO21GeJDItp9VbWfeYHgzJ60q-w0-aEjjmnPf6A,8871
+svg_ultralight-0.32.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+svg_ultralight-0.32.0.dist-info/top_level.txt,sha256=se-6yqM_0Yg5orJKvKWdjQZ4iR4G_EjhL7oRgju-fdY,15
+svg_ultralight-0.32.0.dist-info/RECORD,,