Part JoinEmbed/fr

Description
L'outil Intégrer un objet incorpore un objet à paroi (un tuyau, par exemple) dans un autre objet à paroi.



Utilisation

 * 1) Sélectionnez d'abord l'objet de base, puis l'objet à intégrer. L'ordre de sélection est important. Il suffit de sélectionner une sous-forme de chaque objet (par exemple, des faces).
 * 2) Lancez la commande Intégrer un objet.

Un objet Part Intégrer est créé, avec le mode défini sur 'Embed' (Intégré). Les objets originaux sont masqués et le résultat de l'intégration est affiché dand la vue 3D.

Propriétés

 * : Référence à l'objet de base (celui dans lequel l'autre objet doit être incorporé). L'objet doit être un seul solide.
 * : Référence à l'objet Insert (l'objet à incorporer). L'objet peut être un solide unique ou un composé valide de solides.
 * : Le mode opératoire est égal à 'Intégrer' (Changer ce qui transformera l'Insert en une autre Part_JoinXXX). La valeur 'bypass' peut être utilisée pour désactiver temporairement les calculs longs (un composé de Base et Insert sera créé, ce qui est une opération rapide).
 * : Définit si l'opération Affiner doit être appliquée ou non à la forme finale. La valeur par défaut est déterminée par une case à cocher "Affiner automatiquement la forme après l'opération booléenne" dans les préférences de PartDesign. Lorsque la propriété Mode est réglée sur "bypass", Affiner est ignoré (jamais appliqué).

Exemple

 * 1) Créez un tuyau en appliquant évidement (ou coque) à un cylindre : [[Image:JoinFeatures_Example_step1.png|320px]]
 * 2) Créez un autre tuyau de plus petit diamètre et placez-le de manière à ce qu'il perce la paroi du premier tuyau : [[image:JoinFeatures_Example_step2.png|320px]]
 * 3) Sélectionnez le premier tuyau, puis le second (l'ordre de sélection est important), puis cliquez sur l'option "Intégrer l'objet" dans le bouton de la barre d'outils déroulante Outils de jointure. [[image:JoinFeatures_Example_step3_Embed.png|320px]]
 * 4) Utilisez un outil de section (Std Créer une section ..., Arch Plan de section, Arch Couper selon un plan) pour afficher les éléments internes. Sur la photo ci-dessous, le plan de coupe Arch est utilisé. [[image:JoinFeatures_Example_step4_Embed.png|320px]]

Algorithme
Les algorithmes derrière les outils Joindre sont assez simples et leur compréhension est importante pour utiliser les outils correctement.

1. L'objet de base est soustraction booléenne avec l'objet Insert. La forme résultante est un ensemble (composé) de solides non sécants (généralement deux).

2. Le composé résultant est filtré : seul le plus grand solide est conservé.

3. Le plus grand solide est une Union avec l'objet Tool.

4. Si la propriété Affiner est vraie, la forme résultante est affinée.



Remarques

 * Si après l’étape 1, l’objet reste en un seul morceau, le résultat de l’intégration sera équivalent à une Part union de Base et de Tool, mais dont le calcul prendra plus de temps.
 * Actuellement, l'outil produira un résultat inattendu si un composé est fourni comme Base. Cela pourra être changé dans le futur.
 * Étant donné que la plus grande pièce est déterminée en comparant les volumes des pièces, l'outil ne peut fonctionner qu'avec des solides. Cela pourra être changé dans le futur.

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


 * Crée une fonction Intégration vide (ou une autre fonction de jointure, selon le mode transmis). Les propriétés Base et Insert doivent être affectées explicitement, après.
 * Renvoie l'objet nouvellement créé.

Exemple :

L'outil lui-même est implémenté en Python, voir (Github link) là où FreeCAD est installé.