Part JoinCutout/de

Beschreibung
Das Part Ausschnitt für Objekt-Werkzeug erstellt einen Ausschnitt in einem ummauerten/dünnwandigen Object (z.B. einem Rohr), um ein anderes ummauerten/dünwandiges Objekt einzupassen.



Anwendung

 * 1) Wähle zuerst das Basisobjekt, dann das Objekt, um den Ausschnitt zu definieren. Die Reihenfolge der Auswahl ist wichtig. Es reicht aus, nur eine Teilform jedes Objekts (z.B. Flächen) auszuwählen.
 * 2) Der Part-Ausschnitt für Objekt-Befehl kann auf mehrere Arten aufgerufen werden:
 * 3) * Drücken der [[Image:Part_JoinCutout.svg|24px|link=Part_JoinCutout]] Part Ausschnitt für Objekt-Schaltfläche in der Part-Werkzeugleiste
 * 4) * Benutzen des -Eintrag im Part-Menü

A Part JoinFeature object is created, with Mode set to 'Cutout'. Original objects are hidden, and the result of cutting is shown in 3D view.

Eigenschaften

 * : Reference to base object (the one to make the cutout in). The object should be a single solid.
 * : Reference to tool object (the object that is to fit into the cutout). The object can be a single solid, or a valid compound of solids.
 * : The mode of operation, equals 'Cutout' (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).

Beispiel

 * 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 'Cutout for object' option from the Join tools dropdown toolbar button.

Algorithm
The algorithms behind Join tools are quite simple, and understanding them is important to use the tools correctly.

1. Base object is boolean-cut with Tool object. The resulting shape is a set (compound) of non-intersecting solids (typically, two).

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

3. 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:


 * Creates an empty Cutout 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 (Github link) under where FreeCAD is installed.