Macro Overlap/fr: Difference between revisions

From FreeCAD Documentation
mNo edit summary
No edit summary
 
(22 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
{{Macro/fr|Icon=Macro_Overlap|Name=Boolean Overlap|Name/fr=Boolean Overlap|Description=Boolean tool in between [[Part Union/fr|Part Union]] and [[Part Common/fr|Part Common]]. Parametric.|Author=DeepSOIC|Version=0.1}}
{{Macro/fr
|Name=Boolean Overlap
|Icon=Macro_Overlap.png
|Description=Outil booléen entre [[Part_Fuse/fr|Part Union]] et [[Part_Common/fr|Part Common]]. Paramétrique.
|Author=DeepSOIC
|Version=0.2
|Date=2018-08-31
|FCVersion=Tous
|Download=[https://www.freecadweb.org/wiki/images/a/ac/Macro_Overlap.png Icone de la barre d'outils]
}}

[[File:Macro_Boolean_Overlap_Screenshot.png|1000px]]
[[File:Macro_Boolean_Overlap_Screenshot.png|1000px]]


Boolean Overlap construit une forme qui couvre l'espace occupé par des formes superposées. 'OverlapIndex' est une propriété qui peut être modifiée. La valeur 1 donne le même résultat que [[Part_Fuse/fr|Part Union]]. Une valeur égale au nombre de formes rend l'outil équivalent à [[Part_Common/fr|Part Intersection]]. La valeur par défaut est 2, ce qui signifie que le résultat va utiliser l'espace où il y a chevauchement.

Boolean Overlap construit une forme qui couvre l'espace occupé par des formes superposées. 'OverlapIndex' est une propriété qui peut être modifiée. La valeur 1 donne le même résultat que Part Union. Une valeur égale au nombre de formes rend les parties communes. La valeur par défaut est 2, ce qui signifie que le résultat va utiliser l'espace où il y a chevauchement.


Require FreeCAD v0.17+ built against OCC no less than 6.9.0 (tested on 7.0.0).
Require FreeCAD v0.17+ built against OCC no less than 6.9.0 (tested on 7.0.0).


==Installation: ==
==Installation: ==
téléchargez les deux macros et sauvez les dans votre répertoires de macros:
téléchargez MacroOverlap.py et sauvez la dans votre répertoires de macros:


https://github.com/DeepSOIC/FreeCAD-Macros/raw/master/Overlap/Overlap.FCMacro


https://github.com/DeepSOIC/FreeCAD-Macros/raw/master/Overlap/MacroOverlap.py
https://github.com/DeepSOIC/FreeCAD-Macros/raw/master/Overlap/MacroOverlap.py
Line 16: Line 25:
==Utilisation:==
==Utilisation:==
# Sélectionnez trois ou plus d'objets pour créer un objet superposé. Vous pouvez aussi sélectionner un composé contenant plusieurs shapes.
# Sélectionnez trois ou plus d'objets pour créer un objet superposé. Vous pouvez aussi sélectionner un composé contenant plusieurs shapes.
# Dans le menu: Macro -> Macros... -> double-cliquez sur Overlap.FCMacro . Un nouveau objet est créé.
# Dans le menu: Macro Macros... double-cliquez sur Overlap.FCMacro . Un nouveau objet est créé.
# Sélectionnez le nouvel objet, et modifiez les propriétés de 'Overlap Index' dans "Propriétés onglet (Data)", si nécessaire.
# Sélectionnez le nouvel objet, et modifiez les propriétés de 'Overlap Index' dans "Vue combinée → Propriétés onglet (Data)", si nécessaire.


* le travail sur deux formes fonctionne aussi feront aussi, mais l'action est équivalente aux outils Part Union et Part Fusion, il est alors préférable d'utiliser des outils Part dédiés à la place de cette macro.
<nowiki>*</nowiki> deux formes feront également l'affaire, mais l'action de l'outil sera équivalente à [[Part_Common/fr|Part Intersection]] ou [[Part_Fuse/fr|Part Union]] et il est donc recommandé d'utiliser les outils Part à la place.


==Script==


ToolBar Icon [[Image:Macro_Overlap.png|64px]]
{{clear}}
{{clear}}


MacroOverlap.py:
'''MacroOverlap.py'''

{{Code|code=
{{MacroCode|code=
#***************************************************************************
#* *
#* Copyright (c) 2016 - Victor Titov (DeepSOIC) *
#* <vv.titov@gmail.com> *
#* *
#* 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 *
#* *
#***************************************************************************

__Title__ = "Macro Overlap"
__Author__ = "DeepSOIC"
__Version__ = "0.2"
__Date__ = "31/08/2018"

__Comment__ = "Extension of Part Common boolean operation"
__Web__ = "http://forum.freecadweb.org/viewtopic.php?f=8&t=17755"
__Wiki__ = "http://www.freecadweb.org/wiki/index.php?title=Macro_Boolean_Overlap"
__Status__ = "experimental"
__Requires__ = "freecad 0.17.8053 with OCC 6.9.0+"
__Communication__ = "http://www.freecadweb.org/wiki/index.php?title=User:DeepSOIC"
__Help__ = '''
Macro Overlap.
Requires FreeCAD v0.17.8053+ and OCC 6.9.0+

Instructions:
Select three or more shapes to compute Overlap between. A single compound will do, too.
Then, run this macro. Parametric Overlap object is created.
'''

if __name__ == "__main__": #being run as a macro
import MacroOverlap
MacroOverlap.run()

import FreeCAD as App
import FreeCAD as App
if App.GuiUp:
if App.GuiUp:
Line 47: Line 106:


def execute(self,selfobj):
def execute(self,selfobj):
import BOPTools
import BOPTools.Utils as Utils
import BOPTools.Utils as Utils
from BOPTools.GeneralFuseResult import GeneralFuseResult
from BOPTools.GeneralFuseResult import GeneralFuseResult
Line 63: Line 123:
if len(gr.sourcesOfPiece(piece)) >= selfobj.OverlapIndex:
if len(gr.sourcesOfPiece(piece)) >= selfobj.OverlapIndex:
pieces_to_keep.append(piece)
pieces_to_keep.append(piece)
selfobj.Shape = Part.BOPTools.ShapeMerge.mergeShapes(pieces_to_keep)
selfobj.Shape = BOPTools.ShapeMerge.mergeShapes(pieces_to_keep)


class ViewProviderOverlap:
class ViewProviderOverlap:
Line 105: Line 165:
'MenuText': "Overlap",
'MenuText': "Overlap",
'Accel': "",
'Accel': "",
'ToolTip': "Macro_Overlap: alternative implementation of Part Overlap tool"}
'ToolTip': "Macro_Overlap: boolean overlap. Collects space filled by at least 2 shapes."}


def Activated(self):
def Activated(self):
Line 115: Line 175:
return False
return False


if App.GuiUp:
if App.GuiUp and __name__ != "__main__":
Gui.addCommand("Macro_Overlap", CommandMacroOverlap())
Gui.addCommand("Macro_Overlap", CommandMacroOverlap())


Line 141: Line 201:
mb.exec_()
mb.exec_()
}}
}}

Overlap.FCMacro:
{{Code|code=
__Title__ = "Macro Overlap"
__Author__ = "DeepSOIC"
__Version__ = "0.1"
__Date__ = "12/10/2016"

__Comment__ = "Extension of Part Common boolean operation"
__Web__ = "http://forum.freecadweb.org/viewtopic.php?f=8&t=17755"
__Wiki__ = "http://www.freecadweb.org/wiki/index.php?title=Macro_Boolean_Overlap"
__Status__ = "experimental"
__Requires__ = "freecad 0.17.8053 with OCC 6.9.0+"
__Communication__ = "http://www.freecadweb.org/wiki/index.php?title=User:DeepSOIC"
__Help__ = '''
Macro Overlap.
Requires FreeCAD v0.17.8053+ and OCC 6.9.0+

Instructions:
Select three or more shapes to compute Overlap between. A single compound will do, too.
Then, run this macro. Parametric Overlap object is created.
'''

import MacroOverlap
MacroOverlap.run()
}}

<languages/>

Latest revision as of 18:33, 14 December 2020

Other languages:

Boolean Overlap

Description
Outil booléen entre Part Union et Part Common. Paramétrique.

Version macro : 0.2
Date dernière modification : 2018-08-31
Version FreeCAD : Tous
Téléchargement : Icone de la barre d'outils
Auteur: DeepSOIC
Auteur
DeepSOIC
Téléchargement
Icone de la barre d'outils
Liens
Version Macro
0.2
Dernière modification
2018-08-31
Version(s) FreeCAD
Tous
Raccourci clavier
None
Voir aussi
None

Boolean Overlap construit une forme qui couvre l'espace occupé par des formes superposées. 'OverlapIndex' est une propriété qui peut être modifiée. La valeur 1 donne le même résultat que Part Union. Une valeur égale au nombre de formes rend l'outil équivalent à Part Intersection. La valeur par défaut est 2, ce qui signifie que le résultat va utiliser l'espace où il y a chevauchement.

Require FreeCAD v0.17+ built against OCC no less than 6.9.0 (tested on 7.0.0).

Installation:

téléchargez MacroOverlap.py et sauvez la dans votre répertoires de macros:


https://github.com/DeepSOIC/FreeCAD-Macros/raw/master/Overlap/MacroOverlap.py

Utilisation:

  1. Sélectionnez trois ou plus d'objets pour créer un objet superposé. Vous pouvez aussi sélectionner un composé contenant plusieurs shapes.
  2. Dans le menu: Macro → Macros... → double-cliquez sur Overlap.FCMacro . Un nouveau objet est créé.
  3. Sélectionnez le nouvel objet, et modifiez les propriétés de 'Overlap Index' dans "Vue combinée → Propriétés onglet (Data)", si nécessaire.

* deux formes feront également l'affaire, mais l'action de l'outil sera équivalente à Part Intersection ou Part Union et il est donc recommandé d'utiliser les outils Part à la place.

Script

ToolBar Icon

MacroOverlap.py

#***************************************************************************
#*                                                                         *
#*   Copyright (c) 2016 - Victor Titov (DeepSOIC)                          *
#*                                               <vv.titov@gmail.com>      *  
#*                                                                         *
#*   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                                                                   *
#*                                                                         *
#***************************************************************************

__Title__ = "Macro Overlap"
__Author__ = "DeepSOIC"
__Version__ = "0.2"
__Date__    = "31/08/2018"

__Comment__ = "Extension of Part Common boolean operation"
__Web__ = "http://forum.freecadweb.org/viewtopic.php?f=8&t=17755"
__Wiki__ = "http://www.freecadweb.org/wiki/index.php?title=Macro_Boolean_Overlap"
__Status__ = "experimental"
__Requires__ = "freecad 0.17.8053 with OCC 6.9.0+"
__Communication__ = "http://www.freecadweb.org/wiki/index.php?title=User:DeepSOIC" 
__Help__ = '''
Macro Overlap.
Requires FreeCAD v0.17.8053+ and OCC 6.9.0+

Instructions:
Select three or more shapes to compute Overlap between. A single compound will do, too.
Then, run this macro. Parametric Overlap object is created.
'''

if __name__ == "__main__": #being run as a macro
    import MacroOverlap
    MacroOverlap.run()

import FreeCAD as App
if App.GuiUp:
    import FreeCADGui as Gui
import Part

def makeOverlapFeature():
    '''makeOverlapFeature(): makes a Overlap parametric feature object. Returns the new object.'''
    selfobj = App.ActiveDocument.addObject("Part::FeaturePython","Overlap")
    Overlap(selfobj)
    ViewProviderOverlap(selfobj.ViewObject)
    return selfobj

class Overlap:
    "The Overlap feature object"
    def __init__(self,selfobj):
        selfobj.addProperty("App::PropertyLinkList","Objects","Overlap","Input shape")
        selfobj.addProperty("App::PropertyInteger", "OverlapIndex", "Overlap", "minimum overlap order to output")
        selfobj.OverlapIndex = 2
        selfobj.Proxy = self

    def execute(self,selfobj):
        import BOPTools
        import BOPTools.Utils as Utils
        from BOPTools.GeneralFuseResult import GeneralFuseResult
        
        list_of_shapes = [obj.Shape for obj in selfobj.Objects]
        if len(list_of_shapes) == 1 and list_of_shapes[0].ShapeType == "Compound":
            list_of_shapes = list_of_shapes[0].childShapes()

        list_of_shapes = Utils.upgradeToAggregateIfNeeded(list_of_shapes)
        pieces, map = list_of_shapes[0].generalFuse(list_of_shapes[1:])
        gr = GeneralFuseResult(list_of_shapes, (pieces,map))
        gr.explodeCompounds()
        gr.splitAggregates()
        pieces_to_keep = []
        for piece in gr.pieces:
            if len(gr.sourcesOfPiece(piece)) >= selfobj.OverlapIndex:
                pieces_to_keep.append(piece)
        selfobj.Shape = BOPTools.ShapeMerge.mergeShapes(pieces_to_keep)

class ViewProviderOverlap:
    def __init__(self,vobj):
        vobj.Proxy = self
       
    def getIcon(self):
        return ":/icons/Part_Overlap.svg"

    def attach(self, vobj):
        self.ViewObject = vobj
        self.Object = vobj.Object
  
    def setEdit(self,vobj,mode):
        return False
    
    def unsetEdit(self,vobj,mode):
        return

    def __getstate__(self):
        return None

    def __setstate__(self,state):
        return None

    def claimChildren(self):
        return self.Object.Objects
        
    def onDelete(self, feature, subelements): # subelements is a tuple of strings
        try:
            for f in self.Object.Objects:
                f.ViewObject.show()
        except Exception as err:
            App.Console.PrintError("Error in onDelete: " + err.message)
        return True

class CommandMacroOverlap:
    "Command to create Overlap feature"
    def GetResources(self):
        return {'Pixmap'  : ":/icons/Part_Overlap.svg",
                'MenuText': "Overlap",
                'Accel': "",
                'ToolTip': "Macro_Overlap: boolean overlap. Collects space filled by at least 2 shapes."}

    def Activated(self):
        run()
    def IsActive(self):
        if App.ActiveDocument:
            return True
        else:
            return False

if App.GuiUp and __name__ != "__main__":
    Gui.addCommand("Macro_Overlap", CommandMacroOverlap())

def run():
    sel = Gui.Selection.getSelectionEx()
    try:
        if len(sel) < 1:
            raise Exception("Select two shapes to compute Overlap between, first! Then run this macro.")
        try:
            App.ActiveDocument.openTransaction("Macro Overlap")
            selfobj = makeOverlapFeature()
            selfobj.Objects = [it.Object for it in sel]
            for f in selfobj.Objects:
                f.ViewObject.hide()
            
            selfobj.Proxy.execute(selfobj)
        finally:
            App.ActiveDocument.commitTransaction()
    except Exception as err:
        from PySide import QtGui
        mb = QtGui.QMessageBox()
        mb.setIcon(mb.Icon.Warning)
        mb.setText(err.message)
        mb.setWindowTitle("Macro Overlap")
        mb.exec_()