Part Intégrer

From FreeCAD Documentation
Revision as of 16:12, 15 February 2018 by Meme2704 (talk | contribs) (Created page with "==Example==")

Part JoinEmbed

Emplacement du menu
Part → Join → Embed Object
Ateliers
Part
Raccourci par défaut
Aucun
Introduit dans la version
-
Voir aussi
Connect, Embed, Cutout, Part Booleans, Part Thickness

Description

L'outil implante un objet valide dans un autre (par exemple tuyaux)

Comment l'utiliser

Sélection l'objet de base en premier, puis celui qui est implanté, l'ordre de sélection est important Choisir la commande Implantation

Un objet est créé, visible en vue 3D, les objet d'origine sont cachés

Proprotés

Base

  • Template:ProproteDonnees: Référence à l' objet de base . Cet objet doit être unique
  • Template:ProprieteDonnee: Référence à l'objet a implanter. Cet objet peu être un objet simple ou un ensemble.
  • Template:ProproprieteDonnee: Le mode opératoire, égal 'joindre' (le changement doit être effectué dans Part_JoinXXX). La valeur du 'bypass' peu être temporairement dissous (un composé de Base et outil peu être créé, ça peuêtre une opération plus rapide ).

Example

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. That largest solid is boolean-fused with Tool object.

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

Notes

  • If after step 1, the object remains in one piece, the result of Embed will be equivalent to union of Base and Tool, but taking longer to compute.
  • Now, the tool will produce unexpected result, if a compound is supplied as Base. This may be changed in the future.
  • Because the largest piece is determined by comparing volumes of pieces, the tool can only work with solids. This may be changed in the future.

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:

import JoinFeatures
j = JoinFeatures.makePartJoinFeature(name = 'Embed', mode = 'Embed' )
j.Base = FreeCADGui.Selection.getSelection()[0]
j.Tool = FreeCADGui.Selection.getSelection()[1]

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