Part BooleanFragments/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
 
(48 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/fr
{{Docnav/fr
|[[Part_CompSplittingTools/fr|Outils de division de formes]]
|[[Part_CompSplittingTools/fr|Outils de division de formes]]
|[[Part_SliceApart/fr|Trancher]]
|[[Part_SliceApart/fr|Séparer/exploser]]
|[[Part_Module/fr|Atelier Part]]
|[[Part_Workbench/fr|Atelier Part]]
|IconL=Part_CompSplittingTools.png
|IconL=Part_CompSplittingTools.png
|IconC=Workbench_Part.svg
|IconR=Part_SliceApart.svg
|IconR=Part_SliceApart.svg
|IconC=Workbench_Part.svg
}}
}}


Line 12: Line 13:
|Name=Part BooleanFragments
|Name=Part BooleanFragments
|Name/fr=Part Fragments booléens
|Name/fr=Part Fragments booléens
|MenuLocation=Pièce → Scinder → Fragments Booléens
|MenuLocation=Part → Scinder → Fragments booléens
|Workbenches=[[Part_Module/fr|Part]]
|Workbenches=[[Part_Workbench/fr|Part]]
|Version=0.17
|SeeAlso=[[Part_Slice/fr|Part Trancher]], [[Part_XOR/fr|Part XOR]], [[Part_CompJoinFeatures/fr|Part Joindre]], [[Part_Boolean/fr|Part Opérations booléennes]]
|SeeAlso=[[Part_Slice/fr|Part Scinder]], [[Part_XOR/fr|Part OU exclusif]], [[Part_CompJoinFeatures/fr|Part Joindre]], [[Part_Boolean/fr|Part Opérations booléennes]]
|Version=0.17.8053
}}
}}


==Description==
==Description==


Outil permettant de calculer tous les fragments pouvant résulter de l'application d'opérations booléennes entre des formes d'entrée. Par exemple, pour deux sphères entrecroisées, trois solides non chevauchants mais touchants sont générés.
Outil permettant de calculer tous les fragments pouvant résulter de l'application d'opérations booléennes entre des formes d'entrée. Par exemple, pour deux sphères entrecroisées, trois solides non chevauchants mais se touchant sont générés.


[[image:Part_BooleanFragments_Demo.png|600px]]
[[image:Part_BooleanFragments_Demo.png|600px]]


(sur l'image ci-dessus, les pièces ont été déplacées manuellement après, pour révéler la fragmentation)
{{Caption|Dans l'image ci-dessus, les pièces ont été déplacées manuellement pour révéler la fragmentation.}}


La forme de sortie est toujours un composé. Le contenu du composé dépend des types de forme et du mode opératoire. Cela signifie que vous n'avez pas immédiatement accès aux éléments individuels du résultat - ceux-ci restent regroupés. Les pièces individuelles peuvent être extraites en faisant exploser le composé ([[Draft_Downgrade/fr|Draft Rétrograder]]).
La forme résultante est toujours un composé. Le contenu du composé dépend des types de forme et du mode opératoire. Cela signifie que vous n'avez pas immédiatement accès aux éléments individuels du résultat. Ces éléments restent regroupés. Chaque élément peut être extrait en faisant exploser le composé ([[Draft_Downgrade/fr|Draft Désagréger]]).


L'outil comporte trois modes: "Standard", "Split" (fractionné) et "CompSolid" (composé de solides).
L'outil comporte trois modes : "Standard", "Split" (fractionné) et "CompSolid" (composé de solides).


"Standard" et "Split" diffèrent par l'action de l'outil sur les fils, les coques et les solides composés: pour "Split", ceux-ci sont séparés; Pour "Standard", ils sont conservés ensemble (on obtient des segments supplémentaires).
"Standard" et "Split" diffèrent par l'action de l'outil sur les polylignes, les coques et les solides composés. Pour "Split", ceux-ci sont séparés. Pour "Standard", ils sont maintenus ensemble (on obtient des segments supplémentaires).


La structure de composition en modes "Standard" et "Split" suit la structure de composition des entrées. Autrement dit, si vous introduisez deux composés, chacun contenant une sphère comme dans l'exemple ci-dessus, le résultat contiendra également deux composés, chacun contenant les parties de la sphère contenue à l'origine. Cela signifie que la pièce commune sera répétée deux fois dans le résultat. Ce n’est que si les sphères d’entrée ne sont pas dans des composés que le résultat contient la pièce commune une seule fois.
La structure de composition en modes "Standard" et "Split" suit la structure de composition des entrées. Autrement dit, si vous introduisez deux composés, chacun contenant une sphère comme dans l'exemple ci-dessus, le résultat contiendra également deux composés, chacun contenant les parties de la sphère contenue à l'origine. Cela signifie que la pièce commune sera répétée deux fois dans le résultat. Ce n’est que si les sphères d’entrée ne sont pas dans des composés que le résultat contient la pièce commune une seule fois.


En mode "CompSolid" (composé de solides), les solides sont combinés en un composé de solides (compsolid est constitué d'un groupe de solides reliés par des faces, ils se rapportent à des solides tels que des polylignes (fils) se rapportent à des arêtes, et des coques se rapportent à des faces; le nom est probablement l'abréviation de "solide composite"). La sortie est un composé compsolid non imbriqué.
En mode "CompSolid" (composé de solides), les solides sont combinés en un composé de solides (compsolid est constitué d'un groupe de solides reliés par des faces, ils se rapportent à des solides à l'instar des polylignes se rapportent à des arêtes, et des coques se rapportent à des faces; le nom est probablement l'abréviation de "solide composite"). Le résultat est un composé non imbriqué de compsolides.


<span id="Usage"></span>
==Utilisation==
==Utilisation==


# Sélectionnez les objets à intersecter. <br/> L'ordre de sélection n'est pas important, car l'action de l'outil est symétrique. Il suffit de sélectionner une sous-forme de chaque objet (par exemple, des visages). Vous pouvez également sélectionner un composé contenant toutes les formes à connecter, par ex. [[Draft Array/fr|Draft Réseau]].
# Sélectionnez les objets à intersecter. <br /> L'ordre de sélection n'est pas important, puisque l'action de l'outil est symétrique. Il suffit de sélectionner une sous-forme de chaque objet (par exemple, les faces). Vous pouvez également sélectionner un composé contenant toutes les formes à connecter, par exemple [[Draft_OrthoArray/fr|Draft Réseau orthogonal]].
# Lancement de la commande Part Fragments booléens de plusieurs manières:
# Lancez la commande Part Fragments booléens de plusieurs façons :
#* En appuyant sur le bouton [[Image:Part_BooleanFragments.svg|24px|link=Part_BooleanFragments]] dans la barre d'outils.
#* En appuyant sur le bouton [[Image:Part_BooleanFragments.svg|24px|link=Part_BooleanFragments/fr]] de la barre d'outils.
#* Utilisation de l'entrée {{MenuCommand|Pièce → Scinder → Boolean Fragments}} dans le menu Part.
#* En utilisant l'entrée {{MenuCommand|Part → Scinder → Fragments booléens}} dans le menu Part.


Un objet paramétrique Fragments Booléens est créé. Les objets d'origine sont cachés et le résultat de l'intersection est affiché dans la [[3D view/fr|vue 3D]]
Un objet paramétrique Fragments booléens est créé. Les objets d'origine sont cachés et le résultat de l'intersection est affiché dans la [[3D_view/fr|vue 3D]]


<span id="Properties"></span>
==Propriétés==
==Propriétés==


{{TitleProperty|Fragments Booléens}}
{{TitleProperty|Boolean Fragments}}
* {{PropertyData/fr|Objects}}: Liste des objets à fragmenter. Généralement, au moins deux objets sont nécessaires, mais un seul composé contenant les formes à fragmenter conviendra également. (à partir de FreeCAD v0.17.8053, cette propriété n'est pas affichée dans l'éditeur de propriétés et n'est accessible que via Python).
* {{PropertyData|Objects}} : liste des objets à fragmenter. Généralement, au moins deux objets sont nécessaires, mais un seul composé contenant les formes à fragmenter conviendra également. (à partir de FreeCAD v0.17.8053, cette propriété n'est pas affichée dans l'éditeur de propriétés et n'est accessible que via Python).
* {{PropertyData/fr|Mode}}: "Standard", "Split" ou "CompSolid". "Standard" est la valeur par défaut. Standard et Split diffèrent par l'action de l'outil sur les formes de type agrégation: si Split, celles-ci sont séparées; sinon, elles sont conservées ensemble (vous obtenez des segments supplémentaires).
* {{PropertyData|Mode}} : "Standard", "Split" ou "CompSolid". "Standard" est la valeur par défaut. Standard et Split diffèrent par l'action de l'outil sur les formes de type agrégation: si Split, celles-ci sont séparées; sinon, elles sont conservées ensemble (vous obtenez des segments supplémentaires).
* {{PropertyData/fr|Tolerance}}: valeur "floue". Il s'agit d'une tolérance supplémentaire à appliquer lors de la recherche d'intersections, en plus des tolérances stockées dans les formes en entrée.
* {{PropertyData|Tolerance}} : valeur "floue". Il s'agit d'une tolérance supplémentaire à appliquer lors de la recherche d'intersections, en plus des tolérances stockées dans les formes en entrée.


<span id="Implementation_details"></span>
== Détails d'implémentation==
== Détails de l'implémentation==
L'outil Fragments booléens en "Mode standard" est l'opérateur de fusion général (GFA) d'OpenCascade. Il accepte une combinaison de probablement tous les types de formes, et la logique de sortie est assez compliquée. Voir [https://www.opencascade.com/doc/occt-7.0.0/overview/html/occt_user_guides__boolean_operations.html Guide de l'utilisateur OpenCascade: Opérations booléennes].

L'outil Fragments booléens en "Standard mode" est l'opérateur de fusion général (GFA) d'OpenCascade. Il accepte une combinaison de probablement tous les types de formes et la logique de sortie est assez alambiquée. Voir [https://www.opencascade.com/doc/occt-7.0.0/overview/html/occt_user_guides__boolean_operations.html Guide de l'utilisateur OpenCascade : opérations booléennes].


Pour les modes "Split" et "CompSolid", FreeCAD effectue un post-traitement supplémentaire.
Pour les modes "Split" et "CompSolid", FreeCAD effectue un post-traitement supplémentaire.


<span id="Scripting"></span>
==Script==
==Script==


L'outil peut être utilisé dans une [[macros/fr|macros]] et à partir de la console python en utilisant la fonction suivante:
L'outil peut être utilisé dans des [[macros/fr|macros]] et à partir de la console Python en utilisant la fonction suivante :
'''BOPTools.SplitFeatures.makeBooleanFragments(name)'''
'''BOPTools.SplitFeatures.makeBooleanFragments(name)'''


Line 66: Line 72:


Fragments Booléens peut également être appliqué à des formes simples, sans avoir besoin d'un objet de document via :
Fragments Booléens peut également être appliqué à des formes simples, sans avoir besoin d'un objet de document via :

{{code|code=
{{code|code=
import BOPTools.SplitAPI
import BOPTools.SplitAPI
Line 77: Line 84:
}}
}}
Cela peut être utile pour créer des fonctionnalités de script personnalisées Python.
Cela peut être utile pour créer des fonctionnalités de script personnalisées Python.



Exemple :
Exemple :
Line 88: Line 94:
L'outil lui-même est implémenté en Python, voir /Mod/Part/BOPTools/SplitFeatures.py là où FreeCAD est installé.
L'outil lui-même est implémenté en Python, voir /Mod/Part/BOPTools/SplitFeatures.py là où FreeCAD est installé.


<span id="Notes"></span>
==Remarques==
==Remarques==


L'outil a été introduit dans FreeCAD v0.17.8053. FreeCAD doit être compilé avec OCC 6.9.0 ou version ultérieure, sinon l'outil n'est pas disponible.
L'outil a été introduit dans FreeCAD v0.17.8053. FreeCAD doit être compilé avec OCC 6.9.0 ou version ultérieure, sinon l'outil n'est pas disponible.



{{Docnav/fr
{{Docnav/fr
|[[Part_CompSplittingTools/fr|Outils de division de formes]]
|[[Part_CompSplittingTools/fr|Outils de division de formes]]
|[[Part_SliceApart/fr|Trancher]]
|[[Part_SliceApart/fr|Séparer/exploser]]
|[[Part_Module/fr|Atelier Part]]
|[[Part_Workbench/fr|Atelier Part]]
|IconL=Part_CompSplittingTools.png
|IconL=Part_CompSplittingTools.png
|IconC=Workbench_Part.svg
|IconR=Part_SliceApart.svg
|IconR=Part_SliceApart.svg
|IconC=Workbench_Part.svg
}}
}}



Latest revision as of 15:47, 26 January 2023

Part Fragments booléens

Emplacement du menu
Part → Scinder → Fragments booléens
Ateliers
Part
Raccourci par défaut
Aucun
Introduit dans la version
0.17
Voir aussi
Part Scinder, Part OU exclusif, Part Joindre, Part Opérations booléennes

Description

Outil permettant de calculer tous les fragments pouvant résulter de l'application d'opérations booléennes entre des formes d'entrée. Par exemple, pour deux sphères entrecroisées, trois solides non chevauchants mais se touchant sont générés.

Dans l'image ci-dessus, les pièces ont été déplacées manuellement pour révéler la fragmentation.

La forme résultante est toujours un composé. Le contenu du composé dépend des types de forme et du mode opératoire. Cela signifie que vous n'avez pas immédiatement accès aux éléments individuels du résultat. Ces éléments restent regroupés. Chaque élément peut être extrait en faisant exploser le composé (Draft Désagréger).

L'outil comporte trois modes : "Standard", "Split" (fractionné) et "CompSolid" (composé de solides).

"Standard" et "Split" diffèrent par l'action de l'outil sur les polylignes, les coques et les solides composés. Pour "Split", ceux-ci sont séparés. Pour "Standard", ils sont maintenus ensemble (on obtient des segments supplémentaires).

La structure de composition en modes "Standard" et "Split" suit la structure de composition des entrées. Autrement dit, si vous introduisez deux composés, chacun contenant une sphère comme dans l'exemple ci-dessus, le résultat contiendra également deux composés, chacun contenant les parties de la sphère contenue à l'origine. Cela signifie que la pièce commune sera répétée deux fois dans le résultat. Ce n’est que si les sphères d’entrée ne sont pas dans des composés que le résultat contient la pièce commune une seule fois.

En mode "CompSolid" (composé de solides), les solides sont combinés en un composé de solides (compsolid est constitué d'un groupe de solides reliés par des faces, ils se rapportent à des solides à l'instar des polylignes se rapportent à des arêtes, et des coques se rapportent à des faces; le nom est probablement l'abréviation de "solide composite"). Le résultat est un composé non imbriqué de compsolides.

Utilisation

  1. Sélectionnez les objets à intersecter.
    L'ordre de sélection n'est pas important, puisque l'action de l'outil est symétrique. Il suffit de sélectionner une sous-forme de chaque objet (par exemple, les faces). Vous pouvez également sélectionner un composé contenant toutes les formes à connecter, par exemple Draft Réseau orthogonal.
  2. Lancez la commande Part Fragments booléens de plusieurs façons :
    • En appuyant sur le bouton de la barre d'outils.
    • En utilisant l'entrée Part → Scinder → Fragments booléens dans le menu Part.

Un objet paramétrique Fragments booléens est créé. Les objets d'origine sont cachés et le résultat de l'intersection est affiché dans la vue 3D

Propriétés

Boolean Fragments

  • DonnéesObjects : liste des objets à fragmenter. Généralement, au moins deux objets sont nécessaires, mais un seul composé contenant les formes à fragmenter conviendra également. (à partir de FreeCAD v0.17.8053, cette propriété n'est pas affichée dans l'éditeur de propriétés et n'est accessible que via Python).
  • DonnéesMode : "Standard", "Split" ou "CompSolid". "Standard" est la valeur par défaut. Standard et Split diffèrent par l'action de l'outil sur les formes de type agrégation: si Split, celles-ci sont séparées; sinon, elles sont conservées ensemble (vous obtenez des segments supplémentaires).
  • DonnéesTolerance : valeur "floue". Il s'agit d'une tolérance supplémentaire à appliquer lors de la recherche d'intersections, en plus des tolérances stockées dans les formes en entrée.

Détails de l'implémentation

L'outil Fragments booléens en "Standard mode" est l'opérateur de fusion général (GFA) d'OpenCascade. Il accepte une combinaison de probablement tous les types de formes et la logique de sortie est assez alambiquée. Voir Guide de l'utilisateur OpenCascade : opérations booléennes.

Pour les modes "Split" et "CompSolid", FreeCAD effectue un post-traitement supplémentaire.

Script

L'outil peut être utilisé dans des macros et à partir de la console Python en utilisant la fonction suivante :

BOPTools.SplitFeatures.makeBooleanFragments(name)
  • Crée une fonction BooleanFragments vide. Les propriétés 'Objects' doivent être attribuées explicitement, par la suite.
  • Renvoie l'objet nouvellement créé.

Fragments Booléens peut également être appliqué à des formes simples, sans avoir besoin d'un objet de document via :

import BOPTools.SplitAPI
BOPTools.SplitAPI.booleanFragments(list_of_shapes, mode, tolerance = 0.0)

# OR, for Standard mode:

list_of_shapes = [App.ActiveDocument.Sphere.Shape, App.ActiveDocument.Sphere001.Shape]
pieces, map = list_of_shapes[0].generalFuse(list_of_shapes[1:], tolerance)
# pieces receives a compound of shapes; map receives a list of lists of shapes, defining list_of_shapes <--> pieces correspondence

Cela peut être utile pour créer des fonctionnalités de script personnalisées Python.

Exemple :

import BOPTools.SplitFeatures
j = BOPTools.SplitFeatures.makeBooleanFragments(name= 'BooleanFragments')
j.Objects = FreeCADGui.Selection.getSelection()

L'outil lui-même est implémenté en Python, voir /Mod/Part/BOPTools/SplitFeatures.py là où FreeCAD est installé.

Remarques

L'outil a été introduit dans FreeCAD v0.17.8053. FreeCAD doit être compilé avec OCC 6.9.0 ou version ultérieure, sinon l'outil n'est pas disponible.