Standard Teil

From FreeCAD Documentation
Jump to: navigation, search
This page is a translated version of the page Std Part and the translation is 8% complete.

Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎polski • ‎română • ‎Türkçe

Std Part.svg Std Baugruppe

Menüeintrag
None
Arbeitsbereich
All
Standardtastenkürzel
None
In der Version eingeführt
0.17
Siehe auch
Std Group, PartDesign Body


Beschreibung

Ein Teil ( engl. PART ) ist ein universeller Sammelbehälter, der eine Gruppe von Objekten zusammenhält, so dass sie als Einheit bewegt werden können. Das Teil kann die meisten, wenn nicht gar alle FreeCAD-Objekte enthalten, wie z.B. Teilekonstruktions (PartDesign) Körper, Arbeitsbereich Part Objekte, Mesh Objekte, usw.

Das Teil stellt ein eigenes Koordinatensystem zur Verfügung, an das Skizzen und andere Objekte angehängt werden können.

Although it is primarily intended for solid bodies, the Std Part can be used to manage any object that has a Placement property, so it can also contain Mesh Features, sketches, and other objects derived from App GeoFeature.

Das Teil befindet sich in der Struktur Werkzeugleiste, die in allen Arbeitsbereichen angezeigt wird.

To group objects in general use Std Group. This object does not affect the positions of the elements that it contains; it is essentially just a folder that is used to keep the tree view organized.

Std Part-tree.pngStd Part example.png

Lokales Koordinatensystem, definiert durch ein Teil

Anwendung

  • Drücken Sie die Schaltfläche Std Part.png]. Create part'[ in der Werkzeugleiste. Das Bauteil wird automatisch aktiv.
  • Doppelklicken Sie auf das Teil im Modellbaum, um es zu aktivieren oder zu deaktivieren.
  • Um Objekte zu einem Teil hinzuzufügen, ziehen Sie sie per Drag & Drop über das Teil im Modellbaum.
  • Um Objekte aus einem Teil zu entfernen, ziehen Sie sie per Drag & Drop aus dem Teil und auf das Dokumentenbeschriftung oben in der Modellbaum.

Notes

  • As of v0.19, a given object can only belong to a single Part.
  • Double-click the Part in the tree view or open the context menu (right-click) and select Toggle active part to activate or deactivate the Part. If another Part is active, it will be deactivated. See active status for more information.

Einschränkungen

  • Selbst wenn ein Teil aktiv ist, werden neu erstellte Objekte nicht innerhalb des Teils, sondern am unteren Rand des Baums platziert. Ziehen Sie sie einfach per Drag & Drop über das Teil.
  • Ein Teil hat keine Form. Es ist daher nicht möglich, die meisten 3D-Operationen auf ein Teil anzuwenden, wie z.B. Part Booleans.
  • Zu diesem Zeitpunkt funktionieren Draft Snaps nicht an ausgewählten Teilecontainern oder an Objekten innerhalb eines Bauteilcontainers.
  • Hinweis des Redakteurs: Zu diesem Zeitpunkt ist unklar, ob der aktive Status des Teils einen Zweck erfüllt.

Eigenschaften

A Std Part is internally called App Part (App::Part class), and is derived from an App GeoFeature (App::GeoFeature class), therefore it shares most of the latter's properties.

In addition to the properties described in App GeoFeature, the App Part class has some properties that help it manage information in the context of an assembly, for example, DataType, DataId, DataLicense, DataLicenseURL, DataColor, and DataGroup.

These are the properties available in the property editor. Hidden properties can be shown by using the Show all command in the context menu of the property editor.

Data

Base

  • Daten-EigenschaftId: ID (Teilenummer) für das Element. Dies ist optional.
  • Daten-EigenschaftLicense: die Lizenz, unter der das Teil freigegeben ist.
  • Daten-EigenschaftLicense URL: die Webadresse, unter der die Lizenzinformationen zu finden sind.
  • Daten-EigenschaftPlacement: gibt die Ausrichtung und Position des Teils im 3D-Raum an. Siehe Platzierung.
  • Daten-EigenschaftLabel: Die Beschriftung ist der Name, der dem Vorgang gegeben wird. Dieser Name kann nach Belieben geändert werden.
  • Daten-EigenschaftGroup: listet die referenzierten Objekte auf.

Hidden properties Data

  • DataMaterial (Map): map with material properties. By default, it is empty {}.
  • DataMeta (Map): map with additional meta information. By default, it is empty {}.
  • DataUid (UUID): the universally unique identifier (UUID) (128-bit number) of the object. This is assigned at creation time.
  • DataLabel2 (String): a longer, user editable description of this object, it is an arbitrary UTF8 string that may include newlines. By default, it is an empty string "".
  • DataExpression Engine (ExpressionEngine): a list of expressions. By default, it is empty [].
  • DataVisibility (Bool): whether to display the object or not.
  • DataOrigin (Link): the App Origin object that is the positional reference for all elements listed in DataGroup.
  • Data_ Group Touched (Bool): whether the group is touched or not.

View

The App Part only has the five properties of the basic App FeaturePython, and it does not have hidden properties.

Base

  • ViewDisplay Mode (Enumeration): Group.
  • ViewOn Top When Selected (Enumeration): Disabled (default), Enabled, Object, Element.
  • ViewSelection Style (Enumeration): Shape (default), BoundBox. If the option is Shape, the entire shape (vertices, edges, and faces) will be highlighted in the 3D view; if it is BoundBox only the bounding box will be highlighted.
  • ViewShow In Tree (Bool): if it is True, the object appears in the tree view. Otherwise, it is set as invisible.
  • ViewVisibility (Bool): if it is True, the object appears in the 3D view; otherwise it is invisible. By default this property can be toggled on and off by pressing the Space bar in the keyboard.

Beispielanwendungen====

  • Als Montage Behälter, der einzeln hergestellte Objekte gruppiert und dann wie ein Holztisch verklebt oder verschraubt.
  • Beim Import einer STEP Baugruppe in FreeCAD sind die Hauptbaugruppe und ihre Unterbaugruppen sind Teilebehälter.
  • Ein Teil, das aus mehreren nicht zusammengefügten Komponenten besteht, wie beispielsweise ein Kugellager.

The Std Part is intended to be the basic building block to create assemblies. Unlike a PartDesign Body, an assembly is meant to be a collection of separate, distinguishable elements which are connected in some way in the physical world, for example, through pressure, screws, or glue.

Examples that could be Parts:

  • A wooden table that consists of individual wooden pieces (legs, top), which are put together by glue or metal screws.
  • A ball bearing that is composed of multiple steel balls, an inner ring, a retainer, a seal, and an outer ring.
  • An assembly of a screw with a washer, and a matching nut.

PartDesign Body contiguous separate.png PartDesign Body contiguous assembly.png

Left: three individual contiguous solids, each of them modelled by a PartDesign Body. Right: the individual Bodies put together inside a Std Part to create an assembly.


In general terms, when importing a STEP file into the program, the main assembly and its sub-assemblies will be imported as Part containers, each of them containing a simple Part Feature.

Detailed explanation

Aktiver Status====

Ein FreeCAD Dokument kann mehrere Teile enthalten. Es kann jeweils nur ein Teil aktiv sein. Ein aktives Teil wird in der Baumansicht mit einer hellblauen Hintergrundfarbe angezeigt.

An open document can contain multiple Parts. An active Part will be displayed in the tree view with the background color specified by the Active container value in the preferences editor (by default, light blue). An active part will also be shown in bold text.

To activate or de-activate a Part:

  • Double click on it on the tree view, or
  • Open the context menu (right click) and select Toggle active part.

Notes:

  • The active status of Parts was developed in v0.17 in parallel with the active status of PartDesign Bodies; however, as of v0.19 this status does not serve a real purpose for Parts.
  • Even when a Part is active, newly created objects are not placed inside of it automatically. In this case, simply drag these new objects, and drop them onto the desired Part.
  • Only a single Part can be active at a time.

Std Part active.png

Document with two Std Parts, of which the second one is active.


Usrprung

Der Ursprung besteht aus den drei Standardachsen (X, Y, Z) und drei Standardebenen (XY, XZ und YZ). An diese Ebenen können Skizzen angehängt werden. Alle Elemente innerhalb des Bauteils beziehen sich auf den Ursprung des Bauteils, d.h. das Bauteil kann in Bezug auf das globale Koordinatensystem bewegt und gedreht werden, ohne die Platzierung der Elemente innerhalb des Bauteils zu beeinflussen.

The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). Sketches and other objects can be attached to these elements when creating them.

Part Origin tree.png Part Origin view.png

Left: Part Origin in the tree view. Right: representation of the Origin elements in the 3D view.


Note: the Origin is an App Origin object (App::Origin class), while the axes and planes are objects of type App::Line and App::Plane respectively. Each of these elements can be hidden and unhidden individually with the Space bar; this is useful to choose the correct reference when creating other objects.

Note 2: all elements inside the Part are referenced to the Part's Origin which means that the Part can be moved and rotated in reference to the global coordinate system without affecting the placement of the elements inside.

Sichtbarkeits Verwaltung

Die Sichtbarkeit des Teils verdrängt die Sichtbarkeit jedes darin enthaltenen Objekts. Wenn das Teil ausgeblendet ist, werden auch die darin enthaltenen Objekte ausgeblendet, auch wenn ihre Sichtbarkeit auf wahr gesetzt ist. Mehrere Objekte innerhalb eines Teils können gleichzeitig sichtbar sein.

The Part's visibility supersedes the visibility of any object it contains. If the Part is hidden, the objects it contains will be hidden as well, even if their individual ViewVisibility property is set to True. If the Part is visible, then each object's ViewVisibility determines whether the object is shown or not.

Part Visibility off.png Part Visibility on.png

The visibility of the Std Part determines whether the objects grouped under it are shown in the 3D view or not. Left: the Part is hidden, so none of the objects will be shown in the 3D view. Right: the Part is visible, so each object controls its own visibility.


Inheritance

A Std Part is formally an instance of the class App::Part, whose parent is the basic App GeoFeature (App::GeoFeature class), and is augmented with an Origin extension.

FreeCAD core objects.svg

Simplified diagram of the relationships between the core objects in the program. The App::Part class is a simple container that has a position in 3D space, and has an Origin to control the placement of the objects grouped under it.


Scripting

See also: FreeCAD Scripting Basics, and scripted objects.

See Part Feature for the general information on adding objects to the document.

A Std Part (App Part) is created with the addObject() method of the document. Once a Part exists, other objects can be added to it with the addObject() or addObjects() methods of this Part.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::Part", "Part")

bod1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
bod2 = App.ActiveDocument.addObject("Part::Box", "Box")

obj.addObjects([bod1, bod2])
App.ActiveDocument.recompute()