Standard Teil

From FreeCAD Documentation
This page is a translated version of the page Std Part and the translation is 95% complete.

Std Teil

Menüeintrag
Keine
Arbeitsbereich
Alle
Standardtastenkürzel
Keiner
Eingeführt in Version
0.17
Siehe auch
Std Gruppe, PartDesign Körper

Beschreibung

Std Teil, intern App-Part genannt, ist ein Sammelbehälter zur allgemeinen Verwendung, der eine Gruppe von Objekten (Baugruppe) zusammenhält, so dass sie zusammen als Einheit in der 3D-Ansicht bewegt werden können.

Das 'Std Part'-Element wurde entwickelt, um als Grundbaustein zur Zusammenstellung von mechanischen Zusammenbauten (Baugruppen) zu dienen. Es dient zum Anordnen von Objekten, die eine Part TopoForm haben, wie Part Grundkörper, PartDesign Körper und andere Part Formelement. Das 'Std Part' stellt ein Ursprungsobjekt mit lokalen X-, Y- und Z-Achsen und Standardebenen zur Verfügung, die als Bezug für die Positionierung der enthaltenen Objekte dienen können. Zusätzlich können 'Std Parts' in andere 'Std Parts' eingebettet werden, um eine Gesamtbaugruppe aus kleineren Unterbaugruppen zu erstellen.

Obwohl es hauptsächlich für Festkörper gedacht ist, kann das 'Std Part' zur Handhabung aller Objekte verwendet werden, die die Eigenschaft Placement besitzen. Daher kann es auch Mesh Formelemente, Skizzen und andere Objekte enthalten, die von der Klasse App-GeoFeature abgeleitet werden.

Ein PartDesign Körper darf nicht mit einem Std Teil verwechselt werden. Das erste ist ein entsprechendes Objekt aus dem Arbeitsbereich PartDesign, zum Erstellen einteiliger, zusammenhängender Festkörper aus PartDesign Formelementen. Das Std Teil wird im Gegensatz dazu nicht zur Erstellung von Objekten verwendet, sondern um unterschiedliche Objekte im Raum anzuordnen, mit der Absicht Baugruppen zu erstellen.

Das Werkzeug Std Part wird nicht durch einen bestimmten Arbeitsbereich festgelegt, sondern durch das Grundsystem. Daher befindet es sich in der structure toolbar, die es in allen Arbeitsbereichen gibt. Mit der Schaltfläche Std Gruppe können Objekte in der Baumansicht frei gruppiert werden, ohne ihre Position zu berücksichtigen. Dieses Objekt beeinflußt die Positionen seiner Elemente nicht. Es ist im wesentlichen nur ein Ordner mit dem die Baumansicht geordnet werden kann.

Links: Elemente innerhalb eines Std Teils (Part-Objekt) in der Baumansicht. Rechts: Objekte im Raum positioniert, bezogen auf den Ursprung des Std Teils.

Anwendung

  1. Die Schaltfläche Baugruppe erstellen betätigen.
  2. Ein leeres Teil wird erzeugt und wird automatisch aktiv.
  3. In der Baumansicht Objekte wählen und durch Drag & Drop auf dieses Teil ziehen, um sie zum Teil hinzuzufügen.
  4. Um Objekte aus einem Teil zu entfernen, zieht man es per Drag & Drop aus dem Teil auf die Dokumentenbeschriftung oben in der Baumansicht.
  5. Objekte können durch Bearbeiten der Daten-EigenschaftGroup Teileigenschaft auch hinzugefügt oder entfernt werden.

Hinweise

  • Ein Objekt kann nur zu einem einzigen Std Teil (Baugruppe) gehören.
  • 3D-Bearbeitungen, wie Part Boolean können nicht auf Std Teile angewendet werden. Beispielsweise können keine zweit Std Teile markiert und Part Vereinigung oder Part Differenz angewendet werden.

Eigenschaften

Ein Std Teil wird intern App Part(Klasse App::Part) genannt und ist von einem App GeoFeature (Klasse App::GeoFeature) abgeleitet und erbt alle seiner Eigenschaften. Es hat weitere zusätzliche Eigenschaften, vor allem Eigenschaften die ihm helfen, Informationen im Zusammenhang mit Baugruppen/Zusammenbauten zu verwalten, z.B. die Daten-EigenschaftType, Daten-EigenschaftId, Daten-EigenschaftLicense, Daten-EigenschaftLicenseURL und Daten-EigenschaftGroup.

Diese Eigenschaften stehen im Eigenschafteneditor zur Verfügung. Versteckte Eigenschaften werden durch den Befehl Alle anzeigen im Kontextmenü des Eigenschafteneditors angezeigt.

Daten

Basis

  • Daten-EigenschaftType (String): eine Beschreibung für dieses Objekt. Standardmäßig ist es eine leere Zeichenfolge "".
  • Daten-EigenschaftMaterial (Link): das Material für dieses Objekt.
  • Daten-Eigenschaft (versteckt)Meta (Map): Zuordnung zusätzlicher Meta-Informationen. Standardmäßig ist sie leer {}.
  • Daten-EigenschaftId (String): eine Identifikations- oder Teilenummer für dieses Objekt. Standardmäßig ist es eine leere Zeichenfolge "".
  • Daten (Hidden)Uid (UUID): Die eindeutige Kennung (universally unique identifier, kurz UUID) (128-bit-Zahl) des Objekts. Diese wird zur Erstellungszeit vergeben.
  • Daten-EigenschaftLicense (String): ein Feld zur Angabe der Lizenz für dieses Objekt. Standardmäßig ist es eine leere Zeichenfolge "".
  • Daten-EigenschaftLicenseURL (String): ein Feld zur Angabe einer Webadresse zur Lizenz oder zum Vertrag für dieses Objekt. Standardmäßig ist es eine leere Zeichenfolge "".
  • Daten-EigenschaftColor (Color): ein Tupel von vier RGBA-Fließkommawerten (r,g,b,a) um die Farbe des Objekts festzulegen; standardmäßig ist es (1.0, 1.0, 1.0, 1.0), das als [255,255,255] zur Basis 255, white color angezeigt wird.
  • Daten-EigenschaftPlacement (Placement): die Position des Objekts in der 3D-Ansicht. Die Positionierung wird durch einen Punkt (Ortsvektor)Base und eine Drehung Rotation, bestehend aus Richtungsvektor (Axis) und Winkel (Angle), festgelegt. Siehe Positionierung.
    • Daten-EigenschaftAngle: der Drehwinkel um die Daten-EigenschaftAxis. Standardmäßig ist er (Null Grad).
    • Daten-EigenschaftAxis: der Einheitsvektor, der die Drehachse für die Positionierung festlegt. Jede Komponente ist eine Fließkommazahl zwischen 0 und 1. Wenn irgendein Wert über 1 liegt, wird der Vektor so normiert, dass der Betrag des Vektors 1 ist. Standardmäßig ist dies die positive Z Achse, (0, 0, 1).
    • Daten-EigenschaftPosition: ein Vektor mit den 3D-Koordinaten des Basispunkts (Ortsvektor). Standardmäßig ist dies der Ursprung (0, 0, 0).
  • DatenLabel (String): die vom Benutzer editierbare Bezeichnung dieses Objekts, sie ist eine beliebige UTF8-Zeichenfolge.
  • Daten-Eigenschaft (versteckt)Label2 (String): eine längere vom Benutzer editierbare Bezeichnung dieses Objekts, sie ist eine beliebige UTF8-Zeichenfolge, die Zeilenumbrüche enthalten kann. Standardmäßig ist sie eine leere Zeichenfolge "".
  • Daten-Eigenschaft (versteckt)Expression Engine (ExpressionEngine): eine Liste von Ausdrücken. Standardmäßig ist sie leer [].
  • Daten-Eigenschaft (versteckt)Visibility (Bool): legt fest, ob das Objekt angezeigt wird oder nicht.
  • Daten-Eigenschaft (versteckt)Origin (Link): das App Origin-Objekt, das als Positionierungsreferenz aller in der Daten-EigenschaftGroup enthaltenen Elemente dient.
  • Daten-EigenschaftGroup (LinkList): eine Liste der verknüpften Objekte. Standardmäßig ist sie leer [].
  • Daten-Eigenschaft (versteckt)_ Group Touched (Bool): legt fest, ob die Gruppe berührt(?) ist/wird oder nicht.

Ansicht

Optionen anzeigen (Display Options)

  • AnsichtDisplay Mode (Enumeration): Group.
  • AnsichtShow In Tree (Bool): if it is true, the object appears in the Tree view. Otherwise, it is set as invisible.
  • AnsichtVisibility (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.

Auswahl (Selection)

  • AnsichtOn Top When Selected (Enumeration): Disabled (default), Enabled, Object, Element.
  • AnsichtSelection 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.

Detaillierte Beschreibung

Aktiver Status

Ein geöffnetes Dokument kann mehrere Teile enthalten. Aber nur ein Teil kann aktiv sein. Das aktive Teil wird in der Baumansicht mit einer Hintergrundfarbe angezeigt, die mit dem Aktiver Behälter-Wert im Voreinstellungseditor angegeben wird. Der voreingestellte Wert ist hellblau. Es wird auch mit der Schrifteigenschaft 'fett' angezeigt.

Eine Zusammenstellung aktivieren oder deaktivieren:

  • Doppelklick auf die Zusammenstellung in der Baumansicht oder
  • das Kontextmenü mit einem Rechtsklick öffnen und Toggle active part wählen.

Dokument mit zwei Std Teilen, in der das zweite aktiv ist.

Ursprung

Der Ursprung besteht aus den drei Standardachsen (X, Y, Z) und drei Standardebenen (XY, XZ und YZ). An diese können Skizzen und andere Objekte angehängt werden, wenn sie erstellt werden.

Links: Teil Ursprung in der Baumansicht. Rechts: Ansicht der Ursprungselemente in der 3D-Ansicht.

Hinweis: der Ursprung ist ein App-Origin-Objekt (Klasse App::OriginGroupExtension), während die Achsen und Ebenen Objekte des Typs App::Line bzw. App::Plane sind. Jedes dieser Elemente kann mit der Leertaste individuell ausgeblendet und wieder angezeigt werden. Damit kann sicher die korrekte Referenz gewählt werden, wenn andere Objekte erzeugt werden.

Hinweis 2: alle Elemente innerhalb einer Baugruppe beziehen sich auf den Ursprung der Baugruppe. Das bedeutet, dass die Baugruppe bezogen auf das globale Koordinatensystem verschoben oder gedreht werden kann, ohne die Positionierung der Elemente innerhalb der Baugruppe zu beeinflussen.

Anzeigeverwaltung

Die Sichtbarkeit der Baugruppe überlagert die Sichtbarkeit jedes darin enthaltenen Objekts. Wenn die Baugruppe ausgeblendet ist, werden auch die darin enthaltenen Objekte ausgeblendet, auch wenn ihre jeweilige Ansicht EigenschaftSichtbarkeit auf true (wahr) gesetzt ist. Ist die Baugruppe sichtbar, entscheidet die Ansicht EigenschaftSichtbarkeit des jeweiligen Objekts, ob das Objekt angezeigt wird oder nicht.

Die Sichtbarkeit des Std Teils (Part-Objekt) bestimmt, ob die Objekte, die in der Baugruppe zusammengestellt sind, in der 3D-Ansicht angezeigt werden oder nicht. Links: die Baugruppe ist ausgeblendet und keines der Objekte wird in der 3D-Ansicht angezeigt. Rechts: die Baugruppe ist sichtbar und jedes Objekt bestimmt seine Sichtbarkeit selbst.

Skripten

Siehe auch: FreeCAD Grundlagen Skripten und Skriptgenerierte Objekte.

Siehe Part Formelement für allgemeine Informationen zum Hinzufügen von Objekten zu einem Dokument.

Ein Std Teil (App Part) wird mit der Methode addObject() des Dokuments erstellt. Sobald eine Baugruppe (Part-Objekt) existiert, können andere Objekte mit den Methoden addObject() oder addObjects() zur Baugruppe hinzugefügt werden.

import FreeCAD as App

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

obj1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
obj2 = App.ActiveDocument.addObject("Part::Box", "Box")

part.addObjects([obj1, obj2])
App.ActiveDocument.recompute()

Es kann kein skriptgeneriertes App::Part erstellt werden. Es kann aber das Verhalten eines App::Parts zu einem skriptgenerierten Part::FeaturePython-Objekt durch folgende Codes hinzugefügt werden:

class MyGroup(object):
    def __init__(self, obj=None):
        self.Object = obj
        if obj:
            self.attach(obj)

    def dumps(self):
        return

    def loads(self, _state):
        return

    def attach(self, obj):
        obj.addExtension("App::OriginGroupExtensionPython")
        obj.Origin = FreeCAD.ActiveDocument.addObject("App::Origin", "Origin")

    def onDocumentRestored(self, obj):
        self.Object = obj

class ViewProviderMyGroup(object):
    def __init__(self, vobj=None):
        if vobj:
            vobj.Proxy = self
            self.attach(vobj)
        else:
            self.ViewObject = None

    def attach(self, vobj):
        vobj.addExtension("Gui::ViewProviderOriginGroupExtensionPython")
        self.ViewObject = vobj

    def dumps(self):
        return None

    def loads(self, _state):
        return None

App.ActiveDocument.addObject("Part::FeaturePython",
                             "Group",
                             group.MyGroup(),
                             group.ViewProviderMyGroup(),
                             True)