Part JoinConnect/fr: Difference between revisions

From FreeCAD Documentation
mNo edit summary
No edit summary
 
(68 intermediate revisions by 5 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|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
}}
}}


{{GuiCommand/fr
{{GuiCommand/fr
|Name=Part JoinConnect
|Name=Part JoinConnect
|Name/fr=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|Connecter des objets]], [[Part_JoinEmbed/fr|Intégrer des objets]], [[Part_JoinCutout/fr|Découpe]], [[Part Booleans/fr|Opérations Booléennes]], [[Part Thickness/fr|Évidement ou coque]]}}
|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==
Outil de connexion pour joindre deux objets creux (par exemple deux tuyaux). Peut aussi joindre des coques et des fils.
Outil de connexion pour joindre deux objets creux (par exemple deux tuyaux). Peut aussi joindre des coques et des fils.


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


<span id="Usage"></span>
==Comment l'utiliser==
==Utilisation==
# Sélectionnez les objets à connecter. <br /> L'ordre de sélection n'a pas d'importance, l'action est symétrique. Il suffit de sélectionner un élément de chaque objet (par ex. leurs faces). Il est aussi possible de sélectionner un composé contenant toutes les formes à connecter, par ex. un [[Draft Array/fr|Réseau Draft]].
# Invoquez la commande Connecter des objets.


# 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]].
Un objet paramétrique Connect est créé. Les objets d'origine sont cachés et le résultat de l'intersection est affiché en 3D.
# 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 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]].

<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'éditeur de propriétés, mais seulement disponible en 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 préférences Conception de pièce.
* {{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]]).
==Exemple==
* {{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]].
# Créer un tuyau en appliquant un [[Part_Thickness/fr|évidement]] sur un [[Part_Cylinder/fr|cylindre]]: <br />[[image:JoinFeatures_Example_step1.png|320px]]
* {{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.
# Créer un autre tuyau plus petit, et le [[Placement/fr|placer]] pour qu'il perce le premier tuyau: <br />[[image:JoinFeatures_Example_step2.png|320px]]

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

# 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]]
# 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 Section Plane]], [[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 à l'[[Part Union/fr|union (booléenne)]] des objets.

* 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.
* 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.


<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 72: Line 94:
j.Objects = FreeCADGui.Selection.getSelection()
j.Objects = FreeCADGui.Selection.getSelection()
}}
}}
L'outil lui-même est implémenté en Python, voir /Mod/Part/BOPTools/JoinFeatures.py la 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é.
==Version==
Cet outil est inclus à FreeCAD depuis V0.16.5069


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


<div class="mw-translate-fuzzy">
{{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|Part]]
|[[Part_Workbench/fr|Atelier Part]]
|IconL=Part_JoinConnect.svg
|IconL=Part JoinConnect.png|IconC=Workbench_Part.svg|IconR=Part JoinEmbed.png}}
|IconR=Part_JoinEmbed.svg
</div>
|IconC=Workbench_Part.svg

}}
{{Part Tools navi/fr}}

{{Userdocnavi/fr}}


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

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é.