meerk40t 0.9.3001__py2.py3-none-any.whl → 0.9.7010__py2.py3-none-any.whl

meerk40t/core/elements/geometry.py

@@ -1,224 +1,473 @@
-"""
-This is a giant list of console commands that deal with and often implement the elements system in the program.
-"""
-
-from meerk40t.core.units import Angle, Length
-from meerk40t.svgelements import Matrix
-from meerk40t.tools.geomstr import Geomstr
-
-
-def plugin(kernel, lifecycle=None):
-    _ = kernel.translation
-    if lifecycle == "postboot":
-        init_commands(kernel)
-
-
-def init_commands(kernel):
-    self = kernel.elements
-
-    _ = kernel.translation
-
-    classify_new = self.post_classify
-
-    # ==========
-    # Geometry
-    # ==========
-
-    @self.console_command(
-        "node",
-        help=_("Convert any shapes to pathnodes"),
-        input_type="geometry",
-        output_type="elements",
-    )
-    def element_shape_convert(data, **kwargs):
-        param = None
-        if hasattr(data, "parameter_store"):
-            param = getattr(data, "parameter_store", None)
-            del data.parameter_store
-        node = self.elem_branch.add(
-            geometry=data,
-            stroke=self.default_stroke,
-            stroke_width=self.default_strokewidth,
-            type="elem path",
-        )
-        if param is not None:
-            node.functional_parameter = param
-
-        return "elements", [node]
-
-    @self.console_argument("copies", type=int)
-    @self.console_command(
-        "copies",
-        help=_("Convert any element nodes to paths"),
-        input_type="geometry",
-        output_type="geometry",
-    )
-    def geometry_copies(data: Geomstr, copies, **kwargs):
-        data.copies(copies)
-        return "geometry", data
-
-    @self.console_command(
-        "geometry",
-        help=_("Convert any element nodes to paths"),
-        input_type=(None, "elements"),
-        output_type="geometry",
-    )
-    def geometry_base(data=None, **kwargs):
-        path = Geomstr()
-        if data:
-            for node in data:
-                try:
-                    e = node.as_geometry()
-                except AttributeError:
-                    continue
-                path.append(e)
-        return "geometry", path
-
-    @self.console_command("validate", input_type="geometry", output_type="geometry")
-    def geometry_validate(channel, _, data=None, **kwargs):
-        try:
-            data.validate()
-            channel(_("Geometry is valid."))
-        except AssertionError:
-            channel(_("Geometry was not valid."))
-
-    @self.console_argument("x_pos", type=Length)
-    @self.console_argument("y_pos", type=Length)
-    @self.console_argument("r_pos", type=Length)
-    @self.console_command(
-        "circle",
-        help=_("circle <x> <y> <r>"),
-        input_type="geometry",
-        output_type="geometry",
-        all_arguments_required=True,
-    )
-    def element_circle(channel, _, x_pos, y_pos, r_pos, data=None, post=None, **kwargs):
-        data.append(Geomstr.circle(r_pos, x_pos, y_pos, slices=4))
-        return "geometry", data
-
-    @self.console_argument(
-        "x_pos",
-        type=Length,
-        help=_("x position for top left corner of rectangle."),
-    )
-    @self.console_argument(
-        "y_pos",
-        type=Length,
-        help=_("y position for top left corner of rectangle."),
-    )
-    @self.console_argument("width", type=Length, help=_("width of the rectangle."))
-    @self.console_argument("height", type=Length, help=_("height of the rectangle."))
-    @self.console_option("rx", "x", type=Length, help=_("rounded rx corner value."))
-    @self.console_option("ry", "y", type=Length, help=_("rounded ry corner value."))
-    @self.console_command(
-        "rect",
-        help=_("adds rectangle to geometry"),
-        input_type="geometry",
-        output_type="geometry",
-        all_arguments_required=True,
-    )
-    def element_rect(
-        channel,
-        _,
-        x_pos,
-        y_pos,
-        width,
-        height,
-        rx=None,
-        ry=None,
-        data=None,
-        post=None,
-        **kwargs,
-    ):
-        """
-        Draws a svg rectangle with optional rounded corners.
-        """
-        if rx is None:
-            rx = 0
-        if ry is None:
-            ry = 0
-        data.append(
-            Geomstr.rect(
-                x=float(x_pos),
-                y=float(y_pos),
-                width=float(width),
-                height=float(height),
-                rx=float(rx),
-                ry=float(ry),
-            )
-        )
-        return "geometry", data
-
-    @self.console_command(
-        "hull",
-        help=_("convex hull of the current selected elements"),
-        input_type="geometry",
-        output_type="geometry",
-    )
-    def geometry_hull(channel, _, data: Geomstr, **kwargs):
-        """
-        Provides the convex hull of the given geometry.
-        """
-        return "geometry", Geomstr.hull(data)
-
-    @self.console_argument("tx", type=Length, help=_("translate x value"))
-    @self.console_argument("ty", type=Length, help=_("translate y value"))
-    @self.console_command(
-        "translate",
-        help=_("translate <tx> <ty>"),
-        input_type="geometry",
-        output_type="geometry",
-    )
-    def element_translate(tx, ty, data: Geomstr, **kwargs):
-        data.translate(tx, ty)
-        return "geometry", data
-
-    @self.console_argument("scale", type=float, help=_("uniform scale value"))
-    @self.console_command(
-        "uscale",
-        help=_("scale <scale-factor>"),
-        input_type="geometry",
-        output_type="geometry",
-    )
-    def element_uscale(scale, data: Geomstr, **kwargs):
-        data.uscale(scale)
-        return "geometry", data
-
-    @self.console_argument("sx", type=float, help=_("Scale X value"))
-    @self.console_argument("sy", type=float, help=_("Scale Y value"))
-    @self.console_command(
-        "scale",
-        help=_("scale <scale-factor>"),
-        input_type="geometry",
-        output_type="geometry",
-    )
-    def element_scale(data: Geomstr, sx: float, sy: float, **kwargs):
-        data.transform(Matrix.scale(sx, sy))
-        return "geometry", data
-
-    @self.console_argument("angle", type=Angle, help=_("rotation angle"))
-    @self.console_command(
-        "rotate",
-        help=_("scale <scale-factor>"),
-        input_type="geometry",
-        output_type="geometry",
-    )
-    def element_translate(angle: Angle, data: Geomstr, **kwargs):
-        data.rotate(angle.radians)
-        return "geometry", data
-
-    @self.console_option("distance", "d", type=Length, default="1mm")
-    @self.console_option("angle", "a", type=Angle, default="0deg")
-    @self.console_command(
-        "hatch",
-        help=_("Add hatch geometry"),
-        input_type="geometry",
-        output_type="geometry",
-    )
-    def geometry_hatch(data: Geomstr, distance: Length, angle: Angle, **kwargs):
-        segments = data.segmented()
-        hatch = Geomstr.hatch(segments, angle=angle.radians, distance=float(distance))
-        data.append(hatch)
-        return "geometry", data
-
-    # --------------------------- END COMMANDS ------------------------------
+"""
+This module provides a set of console commands for managing geometric operations within the application.
+These commands allow users to convert shapes to path nodes, create geometric figures, and perform various geometric manipulations.
+
+Functions:
+- plugin(kernel, lifecycle=None): Initializes the plugin and sets up geometry commands.
+- init_commands(kernel): Initializes the geometry commands and defines the associated operations.
+- element_shape_convert(data, **kwargs): Converts any shapes to path nodes and adds them to the element branch.
+  Args:
+    data: The geometry data to convert.
+  Returns:
+    A tuple containing the type of elements and the newly created node.
+- geometry_copies(data: Geomstr, copies, **kwargs): Creates multiple copies of the specified geometry.
+  Args:
+    data: The geometry data to copy.
+    copies: The number of copies to create.
+  Returns:
+    A tuple containing the type of geometry and the modified data.
+- geometry_base(data=None, **kwargs): Converts any element nodes to paths and returns the resulting geometry.
+  Args:
+    data: The elements to convert.
+  Returns:
+    A tuple containing the type of geometry and the resulting path.
+- geometry_validate(channel, _, data=None, **kwargs): Validates the given geometry and reports its status.
+  Args:
+    channel: The communication channel for messages.
+    data: The geometry data to validate.
+  Returns:
+    A tuple containing the type of geometry and the validated data.
+- element_circle(channel, _, x_pos, y_pos, r_pos, data=None, post=None, **kwargs): Adds a circle to the geometry at the specified position with a given radius.
+  Args:
+    channel: The communication channel for messages.
+    x_pos: The x-coordinate for the center of the circle.
+    y_pos: The y-coordinate for the center of the circle.
+    r_pos: The radius of the circle.
+    data: The geometry data to modify.
+  Returns:
+    A tuple containing the type of geometry and the modified data.
+- element_rect(channel, _, x_pos, y_pos, width, height, rx=None, ry=None, data=None, post=None, **kwargs): Adds a rectangle to the geometry with optional rounded corners.
+  Args:
+    channel: The communication channel for messages.
+    x_pos: The x-coordinate for the top left corner of the rectangle.
+    y_pos: The y-coordinate for the top left corner of the rectangle.
+    width: The width of the rectangle.
+    height: The height of the rectangle.
+    rx: The rounded corner radius in the x-direction.
+    ry: The rounded corner radius in the y-direction.
+    data: The geometry data to modify.
+  Returns:
+    A tuple containing the type of geometry and the modified data.
+- geometry_hull(channel, _, data: Geomstr, **kwargs): Computes the convex hull of the given geometry.
+  Args:
+    channel: The communication channel for messages.
+    data: The geometry data to process.
+  Returns:
+    A tuple containing the type of geometry and the resulting hull.
+- geometry_two_opt(channel, _, data: Geomstr, max_passes=10, chunk=0, **kwargs): Performs a two-opt optimization on the current geometry.
+  Args:
+    channel: The communication channel for messages.
+    data: The geometry data to optimize.
+    max_passes: The maximum number of optimization passes.
+    chunk: The maximum forward-search for potential swaps.
+  Returns:
+    A tuple containing the type of geometry and the optimized data.
+- geometry_greedy(channel, _, data: Geomstr, no_flips=False, **kwargs): Performs a greedy optimization on the current geometry.
+  Args:
+    channel: The communication channel for messages.
+    data: The geometry data to optimize.
+    no_flips: Whether to allow segment flips during optimization.
+  Returns:
+    A tuple containing the type of geometry and the optimized data.
+- element_translate(tx, ty, data: Geomstr, **kwargs): Translates the geometry by the specified x and y values.
+  Args:
+    tx: The translation value in the x-direction.
+    ty: The translation value in the y-direction.
+    data: The geometry data to translate.
+  Returns:
+    A tuple containing the type of geometry and the modified data.
+- element_uscale(scale, data: Geomstr, **kwargs): Uniformly scales the geometry by the specified scale factor.
+  Args:
+    scale: The scale factor to apply.
+    data: The geometry data to scale.
+  Returns:
+    A tuple containing the type of geometry and the modified data.
+- element_scale(data: Geomstr, sx: float, sy: float, **kwargs): Scales the geometry by specified x and y factors.
+  Args:
+    data: The geometry data to scale.
+    sx: The scale factor in the x-direction.
+    sy: The scale factor in the y-direction.
+  Returns:
+    A tuple containing the type of geometry and the modified data.
+- element_rotate(angle: Angle, data: Geomstr, **kwargs): Rotates the geometry by the specified angle.
+  Args:
+    angle: The angle to rotate the geometry.
+    data: The geometry data to rotate.
+  Returns:
+    A tuple containing the type of geometry and the modified data.
+- geometry_hatch(data: Geomstr, distance: Length, angle: Angle, **kwargs): Adds hatch geometry to the specified data.
+  Args:
+    data: The geometry data to modify.
+    distance: The distance between hatch lines.
+    angle: The angle of the hatch lines.
+  Returns:
+    A tuple containing the type of geometry and the modified data.
+- element_cag_combine(data: Geomstr, **kwargs): Combines the current geometry into a single shape.
+  Args:
+    data: The geometry data to combine.
+  Returns:
+    A tuple containing the type of geometry and the combined data.
+- element_cag_union(subject: int, clip: int, data: Geomstr, **kwargs): Computes the union of two shapes in the geometry.
+  Args:
+    subject: The index of the subject shape.
+    clip: The index of the clipping shape.
+    data: The geometry data to process.
+  Returns:
+    A tuple containing the type of geometry and the resulting union.
+- element_cag_intersection(subject: int, clip: int, data: Geomstr, **kwargs): Computes the intersection of two shapes in the geometry.
+  Args:
+    subject: The index of the subject shape.
+    clip: The index of the clipping shape.
+    data: The geometry data to process.
+  Returns:
+    A tuple containing the type of geometry and the resulting intersection.
+- element_cag_xor(subject: int, clip: int, data: Geomstr, **kwargs): Computes the exclusive or (XOR) of two shapes in the geometry.
+  Args:
+    subject: The index of the subject shape.
+    clip: The index of the clipping shape.
+    data: The geometry data to process.
+  Returns:
+    A tuple containing the type of geometry and the resulting XOR.
+- element_cag_difference(subject: int, clip: int, data: Geomstr, **kwargs): Computes the difference between two shapes in the geometry.
+  Args:
+    subject: The index of the subject shape.
+    clip: The index of the clipping shape.
+    data: The geometry data to process.
+  Returns:
+    A tuple containing the type of geometry and the resulting difference.
+"""
+
+from meerk40t.core.units import Angle, Length
+from meerk40t.svgelements import Matrix
+from meerk40t.tools.geomstr import BeamTable, Geomstr
+
+
+def plugin(kernel, lifecycle=None):
+    _ = kernel.translation
+    if lifecycle == "postboot":
+        init_commands(kernel)
+
+
+def init_commands(kernel):
+    self = kernel.elements
+
+    _ = kernel.translation
+
+    # ==========
+    # Geometry
+    # ==========
+
+    @self.console_command(
+        "node",
+        help=_("Convert any shapes to pathnodes"),
+        input_type="geometry",
+        output_type="elements",
+    )
+    def element_shape_convert(data, **kwargs):
+        param = None
+        if hasattr(data, "parameter_store"):
+            param = getattr(data, "parameter_store", None)
+            del data.parameter_store
+        node = self.elem_branch.add(
+            geometry=data,
+            stroke=self.default_stroke,
+            stroke_width=self.default_strokewidth,
+            type="elem path",
+        )
+        if param is not None:
+            node.functional_parameter = param
+
+        return "elements", [node]
+
+    @self.console_argument("copies", type=int)
+    @self.console_command(
+        "copies",
+        help=_("Convert any element nodes to paths"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def geometry_copies(data: Geomstr, copies, **kwargs):
+        data.copies(copies)
+        return "geometry", data
+
+    @self.console_command(
+        "geometry",
+        help=_("Convert any element nodes to paths"),
+        input_type=(None, "elements"),
+        output_type="geometry",
+    )
+    def geometry_base(data=None, **kwargs):
+        path = Geomstr()
+        index = 0
+        if data:
+            for node in data:
+                try:
+                    e = node.as_geometry()
+                except AttributeError:
+                    continue
+                e.flag_settings(index)
+                index += 1
+                path.append(e)
+        return "geometry", path
+
+    @self.console_command("validate", input_type="geometry", output_type="geometry")
+    def geometry_validate(channel, _, data=None, **kwargs):
+        try:
+            data.validate()
+            channel(_("Geometry is valid."))
+        except AssertionError:
+            channel(_("Geometry was not valid."))
+
+    @self.console_argument("x_pos", type=Length)
+    @self.console_argument("y_pos", type=Length)
+    @self.console_argument("r_pos", type=Length)
+    @self.console_command(
+        "circle",
+        help=_("circle <x> <y> <r>"),
+        input_type="geometry",
+        output_type="geometry",
+        all_arguments_required=True,
+    )
+    def element_circle(channel, _, x_pos, y_pos, r_pos, data=None, post=None, **kwargs):
+        data.append(Geomstr.circle(r_pos, x_pos, y_pos, slices=4))
+        return "geometry", data
+
+    @self.console_argument(
+        "x_pos",
+        type=Length,
+        help=_("x position for top left corner of rectangle."),
+    )
+    @self.console_argument(
+        "y_pos",
+        type=Length,
+        help=_("y position for top left corner of rectangle."),
+    )
+    @self.console_argument("width", type=Length, help=_("width of the rectangle."))
+    @self.console_argument("height", type=Length, help=_("height of the rectangle."))
+    @self.console_option("rx", "x", type=Length, help=_("rounded rx corner value."))
+    @self.console_option("ry", "y", type=Length, help=_("rounded ry corner value."))
+    @self.console_command(
+        "rect",
+        help=_("adds rectangle to geometry"),
+        input_type="geometry",
+        output_type="geometry",
+        all_arguments_required=True,
+    )
+    def element_rect(
+        channel,
+        _,
+        x_pos,
+        y_pos,
+        width,
+        height,
+        rx=None,
+        ry=None,
+        data=None,
+        post=None,
+        **kwargs,
+    ):
+        """
+        Draws a svg rectangle with optional rounded corners.
+        """
+        if rx is None:
+            rx = 0
+        if ry is None:
+            ry = 0
+        data.append(
+            Geomstr.rect(
+                x=float(x_pos),
+                y=float(y_pos),
+                width=float(width),
+                height=float(height),
+                rx=float(rx),
+                ry=float(ry),
+            )
+        )
+        return "geometry", data
+
+    @self.console_command(
+        "hull",
+        help=_("convex hull of the current selected elements"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def geometry_hull(channel, _, data: Geomstr, **kwargs):
+        """
+        Provides the convex hull of the given geometry.
+        """
+        return "geometry", Geomstr.hull(data)
+
+    @self.console_option(
+        "chunk",
+        "c",
+        type=int,
+        help=_("Maximum forward-search for potential swaps"),
+        default=0,
+    )
+    @self.console_option(
+        "max_passes",
+        "m",
+        type=int,
+        help=_("Maximum number of optimizations passes"),
+        default=10,
+    )
+    @self.console_command(
+        "two-opt",
+        help=_("Perform two-opt on the current geometry"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def geometry_two_opt(channel, _, data: Geomstr, max_passes=10, chunk=0, **kwargs):
+        """
+        Provides a two-opt optimized version of the current data.
+        """
+        if max_passes < 0:
+            max_passes = None
+        data.two_opt_distance(max_passes=max_passes, chunk=0)
+        return "geometry", data
+
+    @self.console_option(
+        "no_flips",
+        "x",
+        type=bool,
+        action="store_true",
+        help=_("Do not allow segment flips"),
+        default=10,
+    )
+    @self.console_command(
+        "greedy",
+        help=_("Perform greedy optimization on the current geometry"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def geometry_greedy(channel, _, data: Geomstr, no_flips=False, **kwargs):
+        """
+        Provides a two-opt optimized version of the current data.
+        """
+        data.greedy_distance(0j, flips=not no_flips)
+        return "geometry", data
+
+    @self.console_argument("tx", type=Length, help=_("translate x value"))
+    @self.console_argument("ty", type=Length, help=_("translate y value"))
+    @self.console_command(
+        "translate",
+        help=_("translate <tx> <ty>"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def element_translate(tx, ty, data: Geomstr, **kwargs):
+        data.translate(tx, ty)
+        return "geometry", data
+
+    @self.console_argument("scale", type=float, help=_("uniform scale value"))
+    @self.console_command(
+        "uscale",
+        help=_("scale <scale-factor>"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def element_uscale(scale, data: Geomstr, **kwargs):
+        data.uscale(scale)
+        return "geometry", data
+
+    @self.console_argument("sx", type=float, help=_("Scale X value"))
+    @self.console_argument("sy", type=float, help=_("Scale Y value"))
+    @self.console_command(
+        "scale",
+        help=_("scale <scale-factor>"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def element_scale(data: Geomstr, sx: float, sy: float, **kwargs):
+        data.transform(Matrix.scale(sx, sy))
+        return "geometry", data
+
+    @self.console_argument("angle", type=Angle, help=_("rotation angle"))
+    @self.console_command(
+        "rotate",
+        help=_("scale <scale-factor>"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def element_rotate(angle: Angle, data: Geomstr, **kwargs):
+        data.rotate(angle.radians)
+        return "geometry", data
+
+    @self.console_option("distance", "d", type=Length, default="1mm")
+    @self.console_option("angle", "a", type=Angle, default="0deg")
+    @self.console_command(
+        "hatch",
+        help=_("Add hatch geometry"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def geometry_hatch(data: Geomstr, distance: Length, angle: Angle, **kwargs):
+        segments = data.segmented()
+        hatch = Geomstr.hatch(segments, angle=angle.radians, distance=float(distance))
+        data.append(hatch)
+        return "geometry", data
+
+    @self.console_command(
+        "combine",
+        help=_("Constructive Area Geometry, Combine"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def element_cag_combine(data: Geomstr, **kwargs):
+        bt = BeamTable(data)
+        data = bt.combine()
+        return "geometry", data
+
+    @self.console_argument("subject", type=int, help=_("Subject polygon shape"))
+    @self.console_argument("clip", type=int, help=_("Clipping polygon shape"))
+    @self.console_command(
+        "union",
+        help=_("Constructive Area Geometry, Union"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def element_cag_union(subject: int, clip: int, data: Geomstr, **kwargs):
+        bt = BeamTable(data)
+        data = bt.union(subject, clip)
+        return "geometry", data
+
+    @self.console_argument("subject", type=int, help=_("Subject polygon shape"))
+    @self.console_argument("clip", type=int, help=_("Clipping polygon shape"))
+    @self.console_command(
+        "intersection",
+        help=_("Constructive Area Geometry, intersection"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def element_cag_intersection(subject: int, clip: int, data: Geomstr, **kwargs):
+        bt = BeamTable(data)
+        data = bt.intersection(subject, clip)
+        return "geometry", data
+
+    @self.console_argument("subject", type=int, help=_("Subject polygon shape"))
+    @self.console_argument("clip", type=int, help=_("Clipping polygon shape"))
+    @self.console_command(
+        "xor",
+        help=_("Constructive Area Geometry, xor"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def element_cag_xor(subject: int, clip: int, data: Geomstr, **kwargs):
+        bt = BeamTable(data)
+        data = bt.xor(subject, clip)
+        return "geometry", data
+
+    @self.console_argument("subject", type=int, help=_("Subject polygon shape"))
+    @self.console_argument("clip", type=int, help=_("Clipping polygon shape"))
+    @self.console_command(
+        "difference",
+        help=_("Constructive Area Geometry, difference"),
+        input_type="geometry",
+        output_type="geometry",
+    )
+    def element_cag_difference(subject: int, clip: int, data: Geomstr, **kwargs):
+        bt = BeamTable(data)
+        data = bt.difference(subject, clip)
+        return "geometry", data
+
+    # --------------------------- END COMMANDS ------------------------------