Part JoinConnect/fr: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(47 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/fr
{{Docnav/fr
|[[Part_CompJoinFeatures/fr|Jointure]]
|[[Part CompJoinFeatures/fr|Joindre des objets à paroi]]
|[[Part_JoinEmbed/fr|Intégrer un objet]]
|[[Part_JoinEmbed/fr|Intégrer]]
|[[Part_Module/fr|Atelier Part]]
|[[Part_Workbench/fr|Atelier Part]]
|IconL=Part_JoinConnect.svg
|IconL=Part_JoinConnect.svg
|IconC=Workbench_Part.svg
|IconR=Part_JoinEmbed.svg
|IconR=Part_JoinEmbed.svg
|IconC=Workbench_Part.svg
}}
}}


Line 12: Line 13:
|Name=Part JoinConnect
|Name=Part JoinConnect
|Name/fr=Part Connecter des objets
|Name/fr=Part Connecter des objets
|MenuLocation=Pièce → Joindre → Connecter des objets
|MenuLocation=Part → Joindre → Connecter des objets
|Workbenches=[[Part Module/fr|Part]]
|Workbenches=[[Part_Workbench/fr|Part]]
|Version=0.16
|SeeAlso=[[Part_JoinConnect/fr|Part Connecter des objets]], [[Part_JoinEmbed/fr|Part Intégrer des objets]], [[Part_JoinCutout/fr|Part Découpe]], [[Part Boolean/fr|Part Opérations Booléennes]], [[Part Thickness/fr|Part Évidement]]}}
|SeeAlso=[[Part_JoinEmbed/fr|Part Intégrer]], [[Part_JoinCutout/fr|Part Découper]], [[Part_Boolean/fr|Part Opération booléenne]], [[Part_Thickness/fr|Part Évider]]
}}


==Description==
==Description==
Line 22: Line 25:
[[image:JoinFeatures_Connect.png|600px]]
[[image:JoinFeatures_Connect.png|600px]]


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


# Sélectionnez les objets à connecter. <br/> L'ordre de sélection n'est pas important car l'action de l'outil est symétrique. Il suffit de sélectionner un élément de chaque objet (par ex. leurs faces). Vous pouvez également sélectionner un composé contenant toutes les formes à connecter, par ex. [[Draft Array/fr|Draft Réseau]].
# Sélectionnez les objets à connecter. <br/> L'ordre de sélection n'est pas important car l'action de l'outil est symétrique. Il suffit de sélectionner un élément de chaque objet (par ex. leurs faces). Vous pouvez également sélectionner un composé contenant toutes les formes à connecter, par ex. [[Draft_OrthoArray/fr|Draft Réseau orthogonal]].
# Appelez la commande Part JoinConnect de plusieurs manières:
# Lancez la commande Part Connecter des objets de plusieurs manières :
#* Appuyez sur le bouton [[Image:Part_JoinConnect.svg|24px]] [[Part_JoinConnect/fr|Connecter des objets]] dans la barre d'outils Pièce
#* Appuyez sur le bouton [[Image:Part_JoinConnect.svg|24px]] [[Part_JoinConnect/fr|Connecter des objets]] dans la barre d'outils Part
#* Utilisez l'entrée {{MenuCommand|Pièce → Joindre → Connecter des objets}} dans le menu Part
#* Utilisez l'entrée {{MenuCommand|Part → Joindre → Connecter des objets}} dans le menu Part


Un objet paramétrique Connect 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 Connect 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|Connect}}
{{TitleProperty|Connect}}
* {{PropertyData/fr|Objects}}: Liste les objets a connecter. En général deux objets suffisent, un compound d'objets fonctionne (Depuis V0.17, cette propriété n'est pas affichée dans l'[[Property editor/fr|éditeur de propriétés]] mais seulement disponible via [[#Script|Python]]).
* {{PropertyData/fr|Refine}}: choisir d'appliquer ou non un [[Part RefineShape/fr|Affinage de forme]] sur la forme finale. Par défaut cette valeur est déterminée par la case ''Affiner les modèles automatiquement après une opération booléenne'' dans les [[PartDesign Preferences/fr|PartDesign préférences]].
* {{PropertyData/fr|Tolerance}}: Valeur de "flou". 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 d'entrée.


* {{PropertyData|Objects}} : Liste les objets a connecter. En général deux objets suffisent, un compound d'objets fonctionne (Depuis V0.17, cette propriété n'est pas affichée dans l'[[Property_editor/fr|éditeur de propriétés]] mais seulement disponible via [[#Script|Python]]).
* {{PropertyData|Refine}} : choisir d'appliquer ou non un [[Part_RefineShape/fr|Affinage de forme]] sur la forme finale. Par défaut cette valeur est déterminée par la case ''Affiner les modèles automatiquement après une opération booléenne'' dans les [[PartDesign_Preferences/fr|PartDesign Préférences]].
* {{PropertyData|Tolerance}} : Valeur de "flou". 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 d'entrée.

<span id="Example"></span>
==Exemple==
==Exemple==


# Créer un tuyau en appliquant un [[Part_Thickness/fr|Part évidement]] sur un [[Part_Cylinder/fr|Part cylindre]]: <br/>[[image:JoinFeatures_Example_step1.png|320px]]
# Créer une conduite en appliquant un [[Part_Thickness/fr|Part évidement]] sur un [[Part_Cylinder/fr|Part cylindre]] : <br/>[[image:JoinFeatures_Example_step1.png|320px]]
# Créer un autre tuyau plus petit, et le [[Placement/fr|Part placer]] pour qu'il perce le premier tuyau: <br />[[image:JoinFeatures_Example_step2.png|320px]]
# Créer un autre tuyau plus petit, et le [[Placement/fr|Part placer]] pour qu'il perce le premier tuyau : <br />[[image:JoinFeatures_Example_step2.png|320px]]
# Sélectionner le premier tuyau puis le second, et cliquer sur l'option 'Connecter des objets' du menu déroulant Joindre des objets à paroi.<br/>[[image:JoinFeatures_Example_step3_Connect.png|320px]]
# Sélectionner le premier tuyau puis le second, et cliquer sur l'option 'Connecter des objets' du menu déroulant Joindre des objets à paroi.<br/>[[image:JoinFeatures_Example_step3_Connect.png|320px]]
# Utiliser divers outils de plan de coupe ([[Std_ToggleClipPlane/fr|Std Créer une section ...]], [[Arch_SectionPlane/fr|Arch Plan de section]], [[Arch_CutPlane/fr|Arch Couper selon un plan]]) pour voir l'intérieur. Dans l'image ci-dessous, Arch Section Plane est utilisé.<br/>[[image:JoinFeatures_Example_step4_Connect.png|320px]]
# Utiliser divers outils de plan de coupe ([[Std_ToggleClipPlane/fr|Std Couper selon des plans]], [[Arch_SectionPlane/fr|Arch Plan de coupe]], [[Arch_CutPlane/fr|Arch Couper selon un plan]]) pour voir l'intérieur. Dans l'image ci-dessous, un Arch Plan de coupe est utilisé.<br/>[[image:JoinFeatures_Example_step4_Connect.png|320px]]


<span id="Algorithm"></span>
==Algorithme==
==Algorithme==
Les algorithmes derrière les outils Joindre sont très simples, et les comprendre est important pour utiliser les outils correctement. L'algorithme de Connecter, en particulier, est plus complexe que les autres, mais il suffit généralement d'y penser comme d'une variante symétrique de l'[[Part_JoinEmbed/fr#Algorithme|algorithme Intégrer (Embed)]].


Les algorithmes derrière les outils Joindre sont très simples, et les comprendre est important pour utiliser les outils correctement. L'algorithme de Connecter, en particulier, est plus complexe que les autres, mais il suffit généralement d'y penser comme d'une variante symétrique de l'[[Part_JoinEmbed/fr#Algorithme|algorithme intégré]].
1. Chaque objet est coupé à l'intersection avec l'autre
(voir [[Part BooleanFragments/fr|Fragmentation booléenne]])


1. Chaque objet est coupé à l'intersection avec l'autre (voir [[Part_BooleanFragments/fr|Part Fragments booléens]]).
2. Parmi les morceaux d'un objet, seul le plus grand est conservé; tout le reste est jeté.

2. Parmi les morceaux d'un objet, seul le plus grand est conservé ; tout le reste est jeté.


3. Les pièces d'intersection qui touchent au moins deux objets sont ajoutées au résultat. Ensuite, les pièces sont jointes pour former le résultat de Connecter.
3. Les pièces d'intersection qui touchent au moins deux objets sont ajoutées au résultat. Ensuite, les pièces sont jointes pour former le résultat de Connecter.


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


* Si, à l'étape 1, chaque objet reste en un seul morceau, le résultat de Connecter sera équivalent à la [[Part_Fuse/fr|Part Union]] des objets.
<div class="mw-translate-fuzzy">
===Notes===
* Si, à l'étape 1, chaque objet reste en un seul morceau, le résultat de Connecter sera équivalent à l'[[Part Union/fr|union (booléenne)]] des objets.
* Actuellement, tous les composés fournis sont explosés avant la connexion. Cela signifie que les composés à intersection automatique, qui ne sont pas valides pour toutes les autres opérations booléennes, sont valables pour Connecter. (Cela pourra être changé à l'avenir.)
* Actuellement, tous les composés fournis sont explosés avant la connexion. Cela signifie que les composés à intersection automatique, qui ne sont pas valides pour toutes les autres opérations booléennes, sont valables pour Connecter. (Cela pourra être changé à l'avenir.)
* La "plus grande" pièce est celle qui a la plus grande masse. C'est-à-dire que pour les solides, les volumes sont comparés; pour les coques et les faces, les zones sont comparées, etc.
* La "plus grande" pièce est celle qui a la plus grande masse. C'est-à-dire que pour les solides, les volumes sont comparés; pour les coques et les faces, les zones sont comparées, etc.
* Depuis FreeCAD v0.17.8053, et si la version OCC est la version 6.9.0 et ultérieure, Connecter est presque aussi rapide que toutes les autres opérations booléennes. Pour les versions plus anciennes, Connecter est environ 5 fois plus lent qu'une opération booléenne normale et ne fonctionne que sur les solides.
* Depuis FreeCAD v0.17.8053, et si la version OCC est la version 6.9.0 et ultérieure, Connecter est presque aussi rapide que toutes les autres opérations booléennes. Pour les versions plus anciennes, Connecter est environ 5 fois plus lent qu'une opération booléenne normale et ne fonctionne que sur les solides.
</div>


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


L'outil Joindre peut être utilisé dans des [[macros/fr|macros]] à partir de la console Python en utilisant la fonction suivante:
L'outil Joindre peut être utilisé dans des [[Macros/fr|macros]] à partir de la [[Python_console/fr|console Python]] en utilisant la fonction suivante :

'''BOPTools.JoinFeatures.makeConnect(name)'''
'''BOPTools.JoinFeatures.makeConnect(name)'''

* Crée une fonction Connect vide. La propriété 'Objets' doit être attribuée explicitement par la suite.
* Crée une fonction Connect vide. La propriété 'Objets' doit être attribuée explicitement par la suite.
* Renvoie l'objet nouvellement créé.
* Renvoie l'objet nouvellement créé.


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

'''Part.BOPTools.JoinAPI.connect(list_of_shapes, tolerance = 0.0)'''
'''Part.BOPTools.JoinAPI.connect(list_of_shapes, tolerance = 0.0)'''

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 :

{{code|code=
{{code|code=
import Part
import Part
Line 82: Line 94:
j.Objects = FreeCADGui.Selection.getSelection()
j.Objects = FreeCADGui.Selection.getSelection()
}}
}}

L'outil lui-même est implémenté en Python, voir {{FileName|/Mod/Part/BOPTools/JoinFeatures.py}} ([https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/Part/BOPTools/JoinFeatures.py Github lien]) là où FreeCAD est installé.
L'outil lui-même est implémenté en Python, voir {{FileName|/Mod/Part/BOPTools/JoinFeatures.py}} ([https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/Part/BOPTools/JoinFeatures.py Github lien]) là où FreeCAD est installé.


== Histoire ==
* L'outil a été introduit dans FreeCAD v0.16.5069

*L'outil a été ré-implémenté pour fonctionner via generalFuse dans FreeCAD V0.17.8053


{{Docnav/fr
{{Docnav/fr
|[[Part_CompJoinFeatures/fr|Jointure]]
|[[Part CompJoinFeatures/fr|Joindre des objets à paroi]]
|[[Part_JoinEmbed/fr|Intégrer un objet]]
|[[Part_JoinEmbed/fr|Intégrer]]
|[[Part_Module/fr|Atelier Part]]
|[[Part_Workbench/fr|Atelier Part]]
|IconL=Part_JoinConnect.svg
|IconL=Part_JoinConnect.svg
|IconR=Part_JoinEmbed.svg
|IconC=Workbench_Part.svg
|IconC=Workbench_Part.svg
|IconR=Part_JoinEmbed.svg
}}
}}


{{Part Tools navi{{#translation:}}}}
{{Part Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 11:03, 26 November 2023

Part Connecter des objets

Emplacement du menu
Part → Joindre → Connecter des objets
Ateliers
Part
Raccourci par défaut
Aucun
Introduit dans la version
0.16
Voir aussi
Part Intégrer, Part Découper, Part Opération booléenne, Part Évider

Description

Outil de connexion pour joindre deux objets creux (par exemple deux tuyaux). Peut aussi joindre des coques et des fils.

Utilisation

  1. Sélectionnez les objets à connecter.
    L'ordre de sélection n'est pas important car l'action de l'outil est symétrique. Il suffit de sélectionner un élément de chaque objet (par ex. leurs faces). Vous pouvez également sélectionner un composé contenant toutes les formes à connecter, par ex. Draft Réseau orthogonal.
  2. Lancez la commande Part Connecter des objets de plusieurs manières :
    • Appuyez sur le bouton Connecter des objets dans la barre d'outils Part
    • Utilisez l'entrée Part → Joindre → Connecter des objets dans le menu Part

Un objet paramétrique Connect 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

Connect

  • DonnéesObjects : Liste les objets a connecter. En général deux objets suffisent, un compound d'objets fonctionne (Depuis V0.17, cette propriété n'est pas affichée dans l'éditeur de propriétés mais seulement disponible via Python).
  • DonnéesRefine : choisir d'appliquer ou non un Affinage de forme sur la forme finale. Par défaut cette valeur est déterminée par la case Affiner les modèles automatiquement après une opération booléenne dans les PartDesign Préférences.
  • DonnéesTolerance : Valeur de "flou". 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 d'entrée.

Exemple

  1. Créer une conduite en appliquant un Part évidement sur un Part cylindre :
  2. Créer un autre tuyau plus petit, et le Part placer pour qu'il perce le premier tuyau :
  3. Sélectionner le premier tuyau puis le second, et cliquer sur l'option 'Connecter des objets' du menu déroulant Joindre des objets à paroi.
  4. Utiliser divers outils de plan de coupe (Std Couper selon des plans, Arch Plan de coupe, Arch Couper selon un plan) pour voir l'intérieur. Dans l'image ci-dessous, un Arch Plan de coupe est utilisé.

Algorithme

Les algorithmes derrière les outils Joindre sont très simples, et les comprendre est important pour utiliser les outils correctement. L'algorithme de Connecter, en particulier, est plus complexe que les autres, mais il suffit généralement d'y penser comme d'une variante symétrique de l'algorithme intégré.

1. Chaque objet est coupé à l'intersection avec l'autre (voir Part Fragments booléens).

2. Parmi les morceaux d'un objet, seul le plus grand est conservé ; tout le reste est jeté.

3. Les pièces d'intersection qui touchent au moins deux objets sont ajoutées au résultat. Ensuite, les pièces sont jointes pour former le résultat de Connecter.

Remarques

  • Si, à l'étape 1, chaque objet reste en un seul morceau, le résultat de Connecter sera équivalent à la Part Union des objets.
  • Actuellement, tous les composés fournis sont explosés avant la connexion. Cela signifie que les composés à intersection automatique, qui ne sont pas valides pour toutes les autres opérations booléennes, sont valables pour Connecter. (Cela pourra être changé à l'avenir.)
  • La "plus grande" pièce est celle qui a la plus grande masse. C'est-à-dire que pour les solides, les volumes sont comparés; pour les coques et les faces, les zones sont comparées, etc.
  • Depuis FreeCAD v0.17.8053, et si la version OCC est la version 6.9.0 et ultérieure, Connecter est presque aussi rapide que toutes les autres opérations booléennes. Pour les versions plus anciennes, Connecter est environ 5 fois plus lent qu'une opération booléenne normale et ne fonctionne que sur les solides.

Script

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

BOPTools.JoinFeatures.makeConnect(name)
  • Crée une fonction Connect vide. La propriété 'Objets' doit être attribuée explicitement par la suite.
  • Renvoie l'objet nouvellement créé.

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

Part.BOPTools.JoinAPI.connect(list_of_shapes, tolerance = 0.0)

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

Exemple :

import Part
j = Part.BOPTools.JoinFeatures.makeConnect(name= 'Connect')
j.Objects = FreeCADGui.Selection.getSelection()

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