# *************************************************************************** # * Copyright (c) 2009, 2010 Yorik van Havre * # * Copyright (c) 2009, 2010 Ken Cline * # * Copyright (c) 2020 FreeCAD Developers * # * * # * 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 * # * * # *************************************************************************** """Provides functions to move objects from one position to another.""" ## @package move # \ingroup draftfunctions # \brief Provides functions to move objects from one position to another. ## \addtogroup draftfunctions # @{ import FreeCAD as App from draftfunctions import join from draftmake import make_copy from draftmake import make_line from draftutils import groups from draftutils import gui_utils from draftutils import params from draftutils import utils def move(objectslist, vector, copy=False): """move(objects,vector,[copy]) Move the objects contained in objects (that can be an object or a list of objects) in the direction and distance indicated by the given vector. Parameters ---------- objectslist : list vector : Base.Vector Delta Vector to move the clone from the original position. copy : bool If copy is True, the actual objects are not moved, but copies are created instead. Return ---------- The objects (or their copies) are returned. """ utils.type_check([(vector, App.Vector), (copy,bool)], "move") if not isinstance(objectslist, list): objectslist = [objectslist] objectslist.extend(groups.get_movable_children(objectslist)) newobjlist = [] newgroups = {} objectslist = utils.filter_objects_for_modifiers(objectslist, copy) if copy: doc = App.ActiveDocument for obj in objectslist: if obj.isDerivedFrom("App::DocumentObjectGroup") \ and obj.Name not in newgroups: newgroups[obj.Name] = doc.addObject(obj.TypeId, utils.get_real_name(obj.Name)) for obj in objectslist: newobj = None # real_vector have been introduced to take into account # the possibility that object is inside an App::Part # TODO: Make Move work also with App::Link if hasattr(obj, "getGlobalPlacement"): v_minus_global = obj.getGlobalPlacement().inverse().Rotation.multVec(vector) real_vector = obj.Placement.Rotation.multVec(v_minus_global) else: real_vector = vector if obj.isDerivedFrom("App::DocumentObjectGroup"): if copy: newobj = newgroups[obj.Name] else: newobj = obj elif hasattr(obj, "Shape"): if copy: newobj = make_copy.make_copy(obj) else: newobj = obj pla = newobj.Placement pla.move(real_vector) elif obj.isDerivedFrom("App::Annotation"): if copy: newobj = make_copy.make_copy(obj) else: newobj = obj newobj.Position = obj.Position.add(real_vector) elif utils.get_type(obj) in ["Text", "DraftText"]: if copy: newobj = make_copy.make_copy(obj) else: newobj = obj newobj.Placement.Base = obj.Placement.Base.add(real_vector) elif utils.get_type(obj) in ["Dimension", "LinearDimension"]: if copy: newobj = make_copy.make_copy(obj) else: newobj = obj newobj.Start = obj.Start.add(real_vector) newobj.End = obj.End.add(real_vector) newobj.Dimline = obj.Dimline.add(real_vector) elif utils.get_type(obj) == "AngularDimension": if copy: newobj = make_copy.make_copy(obj) else: newobj = obj newobj.Center = obj.Center.add(real_vector) newobj.Dimline = obj.Dimline.add(real_vector) elif hasattr(obj, "Placement"): if copy: newobj = make_copy.make_copy(obj) else: newobj = obj pla = newobj.Placement pla.move(real_vector) if newobj is not None: newobjlist.append(newobj) if copy: for parent in obj.InList: if parent.isDerivedFrom("App::DocumentObjectGroup") \ and (parent in objectslist): newgroups[parent.Name].addObject(newobj) if utils.get_type(parent) == "Layer": parent.Proxy.addObject(parent ,newobj) if copy and params.get_param("selectBaseObjects"): gui_utils.select(objectslist) else: gui_utils.select(newobjlist) if len(newobjlist) == 1: return newobjlist[0] return newobjlist # Following functions are needed for SubObjects modifiers # implemented by Dion Moult during 0.19 dev cycle (works only with Draft Wire) def move_vertex(object, vertex_index, vector): """ Needed for SubObjects modifiers. Implemented by Dion Moult during 0.19 dev cycle (works only with Draft Wire). """ vector = object.getGlobalPlacement().inverse().Rotation.multVec(vector) points = object.Points points[vertex_index] = points[vertex_index].add(vector) object.Points = points moveVertex = move_vertex def move_edge(object, edge_index, vector): """ Needed for SubObjects modifiers. Implemented by Dion Moult during 0.19 dev cycle (works only with Draft Wire). """ move_vertex(object, edge_index, vector) if utils.isClosedEdge(edge_index, object): move_vertex(object, 0, vector) else: move_vertex(object, edge_index+1, vector) moveEdge = move_edge def copy_moved_edges(arguments): """ Needed for SubObjects modifiers. Implemented by Dion Moult during 0.19 dev cycle (works only with Draft Wire). """ copied_edges = [] for argument in arguments: copied_edges.append(copy_moved_edge(argument[0], argument[1], argument[2])) join.join_wires(copied_edges) copyMovedEdges = copy_moved_edges def copy_moved_edge(object, edge_index, vector): """ Needed for SubObjects modifiers. Implemented by Dion Moult during 0.19 dev cycle (works only with Draft Wire). """ vertex1 = object.getGlobalPlacement().multVec(object.Points[edge_index]).add(vector) if utils.isClosedEdge(edge_index, object): vertex2 = object.getGlobalPlacement().multVec(object.Points[0]).add(vector) else: vertex2 = object.getGlobalPlacement().multVec(object.Points[edge_index+1]).add(vector) return make_line.make_line(vertex1, vertex2) ## @}