Part JoinEmbed/it

Descrizione
Lo strumento Incastra incorpora un oggetto internamente (ad esempio, un tubo) in un altro oggetto analogo.



Uso
L'ordine di selezione è importante. È sufficiente selezionare una qualsiasi sotto-forma di ciascun oggetto (ad esempio, delle facce).
 * 1) Selezionare prima l'oggetto di base, e poi l'oggetto da incastrare.
 * 1) Invocare il comando Incastra.

Viene creato un oggetto Parte JoinFeature, con la modalità, Mode, impostata su 'Embed'. Nella vista 3D viene mostrato il risultato, e gli oggetti originali sono nascosti.

Properties

 * : Reference to base object (the one the other object is to be embedded into). The object should be a single solid.
 * : Reference to tool object (the object to be embedded). The object can be a single solid, or a valid compound of solids.
 * : The mode of operation, equals 'Embed' (Changing that will transform the tool into another Part_JoinXXX). The value of 'bypass' can be used to temporarily disable the long computations (a compound of Base and Tool will be created, which is a fast operation).
 * : Sets whether to apply Refine operation or not, to the final shape. The default value is determined by a 'Automatically refine shape after boolean operation' checkbox in PartDesign preferences. When Mode property is 'bypass', Refine is ignored (never applied).

Example

 * 1) Create a pipe by applying thickness to a cylinder:
 * 1) Create another, smaller diameter pipe, and place it so that it pierces the wall of the first pipe:
 * 1) Select the first pipe, then the second pipe (order of selection is important), and click the 'Embed object' option from the Join tools dropdown toolbar button.
 * 1) Use some cross-section tool (Clipping plane, Arch Section Plane, Arch Cut Plane) to reveal internals. On the picture below, Arch Section Plane is used.

Algoritmo
Gli algoritmi sottostanti agli strumenti di Giunzione sono abbastanza semplici, ed è importante comprenderli per utilizzarli correttamente.

1. L'oggetto Base viene tagliato con l'oggetto Tool con una operazione booleana. La forma risultante è un insieme, un composto, di solidi non intersecanti (tipicamente, due).

2. The resulting compound is filtered: only the largest solid is kept.

3. That largest solid is boolean-fused with Tool object.

4. If Refine property is true, the resulting shape is refined.



Scripting
The Join tools can by used in macros and from the python console by using the following function: JoinFeatures.makePartJoinFeature(name = 'Embed', mode = 'Embed')
 * Creates an empty Embed feature (or other Join feature, depending on mode passed). The properties Base and Tool must be assigned explicitly, afterwards.
 * Returns the newly created object.

Example:

The tool itself is implemented in Python, see /Mod/Part/JoinFeatures.py under where FreeCAD is installed.

Version
The tool was introduced in FreeCAD v0.16.5069