FreeCAD / src /Mod /CAM /Path /Op /Engrave.py

Upload folder using huggingface_hub

985c397 verified 10 months ago

6.65 kB

# SPDX-License-Identifier: LGPL-2.1-or-later

# ***************************************************************************
# *   Copyright (c) 2014 Yorik van Havre <yorik@uncreated.net>              *
# *                                                                         *
# *   This program is free software; you can redistribute it and/or modify  *
# *   it under the terms of the GNU Lesser General Public License (LGPL)    *
# *   as published by the Free Software Foundation; either version 2 of     *
# *   the License, or (at your option) any later version.                   *
# *   for detail see the LICENCE text file.                                 *
# *                                                                         *
# *   This program is distributed in the hope that it will be useful,       *
# *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
# *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
# *   GNU Library General Public License for more details.                  *
# *                                                                         *
# *   You should have received a copy of the GNU Library General Public     *
# *   License along with this program; if not, write to the Free Software   *
# *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  *
# *   USA                                                                   *
# *                                                                         *
# ***************************************************************************

import FreeCAD
import Path
import Path.Op.Base as PathOp
import Path.Op.EngraveBase as PathEngraveBase
import PathScripts.PathUtils as PathUtils

from PySide.QtCore import QT_TRANSLATE_NOOP

__doc__ = "Class and implementation of CAM Engrave operation"

if False:
    Path.Log.setLevel(Path.Log.Level.DEBUG, Path.Log.thisModule())
    Path.Log.trackModule(Path.Log.thisModule())
else:
    Path.Log.setLevel(Path.Log.Level.INFO, Path.Log.thisModule())

# lazily loaded modules
from lazy_loader.lazy_loader import LazyLoader

Part = LazyLoader("Part", globals(), "Part")


class ObjectEngrave(PathEngraveBase.ObjectOp):
    """Proxy class for Engrave operation."""

    def __init__(self, obj, name, parentJob):
        super(ObjectEngrave, self).__init__(obj, name, parentJob)
        self.wires = []

    def opFeatures(self, obj):
        """opFeatures(obj) ... return all standard features and edges based geometries"""
        return (
            PathOp.FeatureTool
            | PathOp.FeatureDepths
            | PathOp.FeatureHeights
            | PathOp.FeatureStepDown
            | PathOp.FeatureBaseEdges
            | PathOp.FeatureCoolant
        )

    def setupAdditionalProperties(self, obj):
        if not hasattr(obj, "BaseShapes"):
            obj.addProperty(
                "App::PropertyLinkList",
                "BaseShapes",
                "Path",
                QT_TRANSLATE_NOOP("App::Property", "Additional base objects to be engraved"),
            )
        obj.setEditorMode("BaseShapes", 2)  # hide

    def initOperation(self, obj):
        """initOperation(obj) ... create engraving specific properties."""
        obj.addProperty(
            "App::PropertyInteger",
            "StartVertex",
            "Path",
            QT_TRANSLATE_NOOP("App::Property", "The vertex index to start the toolpath from"),
        )
        self.setupAdditionalProperties(obj)

    def opOnDocumentRestored(self, obj):
        # upgrade ...
        self.setupAdditionalProperties(obj)

    def opExecute(self, obj):
        """opExecute(obj) ... process engraving operation"""
        Path.Log.track()

        jobshapes = []

        if obj.Base:
            # user has selected specific subelements
            Path.Log.track(len(obj.Base))
            for base, subs in obj.Base:
                edges = []
                wires = []
                for feature in subs:
                    sub = base.Shape.getElement(feature)
                    if isinstance(sub, Part.Edge):
                        edges.append(sub)
                    elif sub.Wires:
                        wires.extend(sub.Wires)
                    else:
                        wires.append(Part.Wire(sub.Edges))

                for sortedEdges in Part.sortEdges(edges):
                    wires.append(Part.Wire(sortedEdges))

                jobshapes.append(Part.makeCompound(wires))

        elif obj.BaseShapes:
            # user added specific shapes
            jobshapes.extend([base.Shape for base in obj.BaseShapes])
        else:
            # process all objects in Job.Model.Group
            Path.Log.track(self.model)
            for base in self.model:
                Path.Log.track(base.Label)
                if base.isDerivedFrom("Part::Part2DObject"):
                    jobshapes.append(base.Shape)
                elif base.isDerivedFrom("Sketcher::SketchObject"):
                    jobshapes.append(base.Shape)
                elif hasattr(base, "ArrayType"):
                    jobshapes.append(base.Shape)

        if jobshapes:
            Path.Log.debug("processing {} jobshapes".format(len(jobshapes)))
            wires = []
            for shape in jobshapes:
                if isinstance(shape, Part.Edge):
                    shapeWires = [Part.Wire(shape)]
                else:
                    shapeWires = shape.Wires
                Path.Log.debug("jobshape has {} edges".format(len(shape.Edges)))
                self.commandlist.append(
                    Path.Command("G0", {"Z": obj.ClearanceHeight.Value, "F": self.vertRapid})
                )
                self.buildpathocc(obj, shapeWires, self.getZValues(obj))
                wires.extend(shapeWires)
            self.wires = wires
            Path.Log.debug("processing {} jobshapes -> {} wires".format(len(jobshapes), len(wires)))
        # the last command is a move to clearance, which is automatically added by PathOp
        if self.commandlist:
            self.commandlist.pop()

    def opUpdateDepths(self, obj):
        """updateDepths(obj) ... engraving is always done at the top most z-value"""
        job = PathUtils.findParentJob(obj)
        self.opSetDefaultValues(obj, job)


def SetupProperties():
    return ["StartVertex"]


def Create(name, obj=None, parentJob=None):
    """Create(name) ... Creates and returns an Engrave operation."""
    if obj is None:
        obj = FreeCAD.ActiveDocument.addObject("Path::FeaturePython", name)
    obj.Proxy = ObjectEngrave(obj, name, parentJob)
    return obj

	# SPDX-License-Identifier: LGPL-2.1-or-later

	# ***************************************************************************
	# * Copyright (c) 2014 Yorik van Havre <yorik@uncreated.net> *
	# * *
	# * This program is free software; you can redistribute it and/or modify *
	# * it under the terms of the GNU Lesser General Public License (LGPL) *
	# * as published by the Free Software Foundation; either version 2 of *
	# * the License, or (at your option) any later version. *
	# * for detail see the LICENCE text file. *
	# * *
	# * This program is distributed in the hope that it will be useful, *
	# * but WITHOUT ANY WARRANTY; without even the implied warranty of *
	# * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
	# * GNU Library General Public License for more details. *
	# * *
	# * You should have received a copy of the GNU Library General Public *
	# * License along with this program; if not, write to the Free Software *
	# * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 *
	# * USA *
	# * *
	# ***************************************************************************

	import FreeCAD
	import Path
	import Path.Op.Base as PathOp
	import Path.Op.EngraveBase as PathEngraveBase
	import PathScripts.PathUtils as PathUtils

	from PySide.QtCore import QT_TRANSLATE_NOOP

	__doc__ = "Class and implementation of CAM Engrave operation"

	if False:
	Path.Log.setLevel(Path.Log.Level.DEBUG, Path.Log.thisModule())
	Path.Log.trackModule(Path.Log.thisModule())
	else:
	Path.Log.setLevel(Path.Log.Level.INFO, Path.Log.thisModule())

	# lazily loaded modules
	from lazy_loader.lazy_loader import LazyLoader

	Part = LazyLoader("Part", globals(), "Part")


	class ObjectEngrave(PathEngraveBase.ObjectOp):
	"""Proxy class for Engrave operation."""

	def __init__(self, obj, name, parentJob):
	super(ObjectEngrave, self).__init__(obj, name, parentJob)
	self.wires = []

	def opFeatures(self, obj):
	"""opFeatures(obj) ... return all standard features and edges based geometries"""
	return (
	PathOp.FeatureTool
	\| PathOp.FeatureDepths
	\| PathOp.FeatureHeights
	\| PathOp.FeatureStepDown
	\| PathOp.FeatureBaseEdges
	\| PathOp.FeatureCoolant
	)

	def setupAdditionalProperties(self, obj):
	if not hasattr(obj, "BaseShapes"):
	obj.addProperty(
	"App::PropertyLinkList",
	"BaseShapes",
	"Path",
	QT_TRANSLATE_NOOP("App::Property", "Additional base objects to be engraved"),
	)
	obj.setEditorMode("BaseShapes", 2) # hide

	def initOperation(self, obj):
	"""initOperation(obj) ... create engraving specific properties."""
	obj.addProperty(
	"App::PropertyInteger",
	"StartVertex",
	"Path",
	QT_TRANSLATE_NOOP("App::Property", "The vertex index to start the toolpath from"),
	)
	self.setupAdditionalProperties(obj)

	def opOnDocumentRestored(self, obj):
	# upgrade ...
	self.setupAdditionalProperties(obj)

	def opExecute(self, obj):
	"""opExecute(obj) ... process engraving operation"""
	Path.Log.track()

	jobshapes = []

	if obj.Base:
	# user has selected specific subelements
	Path.Log.track(len(obj.Base))
	for base, subs in obj.Base:
	edges = []
	wires = []
	for feature in subs:
	sub = base.Shape.getElement(feature)
	if isinstance(sub, Part.Edge):
	edges.append(sub)
	elif sub.Wires:
	wires.extend(sub.Wires)
	else:
	wires.append(Part.Wire(sub.Edges))

	for sortedEdges in Part.sortEdges(edges):
	wires.append(Part.Wire(sortedEdges))

	jobshapes.append(Part.makeCompound(wires))

	elif obj.BaseShapes:
	# user added specific shapes
	jobshapes.extend([base.Shape for base in obj.BaseShapes])
	else:
	# process all objects in Job.Model.Group
	Path.Log.track(self.model)
	for base in self.model:
	Path.Log.track(base.Label)
	if base.isDerivedFrom("Part::Part2DObject"):
	jobshapes.append(base.Shape)
	elif base.isDerivedFrom("Sketcher::SketchObject"):
	jobshapes.append(base.Shape)
	elif hasattr(base, "ArrayType"):
	jobshapes.append(base.Shape)

	if jobshapes:
	Path.Log.debug("processing {} jobshapes".format(len(jobshapes)))
	wires = []
	for shape in jobshapes:
	if isinstance(shape, Part.Edge):
	shapeWires = [Part.Wire(shape)]
	else:
	shapeWires = shape.Wires
	Path.Log.debug("jobshape has {} edges".format(len(shape.Edges)))
	self.commandlist.append(
	Path.Command("G0", {"Z": obj.ClearanceHeight.Value, "F": self.vertRapid})
	)
	self.buildpathocc(obj, shapeWires, self.getZValues(obj))
	wires.extend(shapeWires)
	self.wires = wires
	Path.Log.debug("processing {} jobshapes -> {} wires".format(len(jobshapes), len(wires)))
	# the last command is a move to clearance, which is automatically added by PathOp
	if self.commandlist:
	self.commandlist.pop()

	def opUpdateDepths(self, obj):
	"""updateDepths(obj) ... engraving is always done at the top most z-value"""
	job = PathUtils.findParentJob(obj)
	self.opSetDefaultValues(obj, job)


	def SetupProperties():
	return ["StartVertex"]


	def Create(name, obj=None, parentJob=None):
	"""Create(name) ... Creates and returns an Engrave operation."""
	if obj is None:
	obj = FreeCAD.ActiveDocument.addObject("Path::FeaturePython", name)
	obj.Proxy = ObjectEngrave(obj, name, parentJob)
	return obj