Sketcher SketchObject/de: Difference between revisions

From FreeCAD Documentation
(Created page with "==Eigenschaften==")
No edit summary
(23 intermediate revisions by 2 users not shown)
Line 2: Line 2:
{{TOCright}}
{{TOCright}}


<span id="Introduction"></span>
== Einleitung ==
== Einleitung ==


Line 12: Line 13:
[[File:FreeCAD_core_objects.svg|800px]]
[[File:FreeCAD_core_objects.svg|800px]]


{{Caption|Simplified diagram of the relationships between the core objects in FreeCAD}}
{{Caption|Vereinfachtes Diagramm der Beziehungen zwischen den Kernobjekten in FreeCAD}}


<span id="Usage"></span>
==Anwendung==
==Anwendung==


# Switch to the [[Sketcher Workbench|Sketcher Workbench]].
# Zum Arbeitsbereich [[Sketcher Workbench/de|Sketcher]] wechseln.
# Press {{Button|[[File:Sketcher_NewSketch.svg|16px]] [[Sketcher_NewSketch|Sketcher NewSketch]]}}.
# Die Schaltfläche {{Button|[[File:Sketcher_NewSketch.svg|16px]] [[Sketcher_NewSketch/de|Sketcher NeueSkizze]]}} drücken.
# Select a {{MenuCommand|Sketch orientation}}: XY-plane, XZ-plane, or YZ-plane. Optionally also choose {{MenuCommand|Reverse direction}}, and give an {{MenuCommand|Offset}} value.
# Eine {{MenuCommand|Skizzenorientierung}} auswählen: XY-Ebene, XZ-Ebene, oder YZ-Ebene. Wahlweise die {{MenuCommand|Umgekehrte Richtung}} aktivieren, und einen {{MenuCommand|Offset}}-Wert eingeben.
# Press {{Button|OK}}.
# {{Button|OK}} drücken.


Although the SketchObject can be used by itself to draw on a plane, it is most commonly used in conjunction with the [[PartDesign_Workbench|PartDesign Workbench]] to create extruded solids.
Auch wenn das Sketch-Objekt eigenständig verwendet werden kann, um auf einer Fläche zu zeichnen, wird es meistens in Verbindung mit dem Arbeitsbereich [[PartDesign_Workbench/de|PartDesign]] verwendet um extrudierte Volumenkörper zu erstellen.


# Switch to the [[PartDesign_Workbench|PartDesign Workbench]].
# Zum Arbeitsbereich [[Sketcher Workbench/de|Sketcher]] wechseln.
# Press {{Button|[[File:PartDesign_Body.svg|16px]] [[PartDesign_Body|PartDesign Body]]}}.
# Die Schaltfläche {{Button|[[File:PartDesign_Body.svg|16px]] [[PartDesign_Body/de|Körper erstellen]]}} drücken.
# Press {{Button|[[File:PartDesign_NewSketch.svg|16px]] [[PartDesign_NewSketch|PartDesign NewSketch]]}}.
# Die Schaltfläche {{Button|[[File:PartDesign_NewSketch.svg|16px]] [[PartDesign_NewSketch/de|PartDesign Skizze erstellen]]}} drücken.
# {{MenuCommand|Select feature}}: XY_Plane (Base plane), XZ_Plane (Base plane), or YZ_Plane (Base plane).
# {{MenuCommand|Element auswählen}}: XY_Plane (Basis-Ebene), XZ_Plane (Basis-Ebene), oder YZ_Plane (Basis-Ebene).
# Press {{Button|OK}}.
# {{Button|OK}} drücken.


<span id="Properties"></span>
==Eigenschaften==
==Eigenschaften==


See [[Property|Property]] for all property types that scripted objects can have.
Siehe [[Property/de|Eigenschaft]] für alle Eigenschaftstypen, die geskriptete Objekte haben können.


The [[Sketcher_SketchObject|Sketcher SketchObject]] ({{incode|Sketcher::SketchObject}} class) is derived from the [[Part_Part2DObject|Part Part2DObject]] ({{incode|Part::Part2DObject}} class) and inherits all its properties.
Das [[Sketcher_SketchObject/de|Sketcher Sketch-Objekt]] ({{incode|Sketcher::SketchObject}}-Klasse) ist von dem [[Part_Part2DObject/de|Part Part2DObject]] ({{incode|Part::Part2DObject}}-Klasse) abgeleitet und erbt all seine Eigenschaften.


The Sketcher SketchObject also has the following additional properties in the [[Property_editor|property editor]]. Hidden properties can be shown by using the {{MenuCommand|Show all}} command in the context menu of the [[Property_editor|property editor]].
Das Sketcher Sketch-Objekt hat außerdem die folgenden zusätzlichen Eigenschaften im [[Property_editor/de|Eigenschafteneditor]]. Ausgeblendete Eigenschaften können mit dem Befehl {{MenuCommand|Alle anzeigen}} im Kontextmenü des [[Property_editor|Eigenschafteneditors]] angezeigt werden.


<span id="Data"></span>
=== Data ===
=== Daten ===


{{TitleProperty|Sketch}}
{{TitleProperty|Sketch}}


* {{PropertyData|Geometry|GeometryList|Hidden}}: a list of Part geometries that exist inside the sketch.
* {{PropertyData/de|Geometry|GeometryList|Hidden}}: Eine Liste von Part-Geometrien die in der Skizze enthalten sind.
* {{PropertyData|Constraints|}}: named constraints, if they exist; otherwise it is an empty list {{incode|[]}}.
* {{PropertyData/de|Constraints|}}: Benannte Randbedingungen, wenn welche vorhanden sind, andernfalls eine leere Liste {{incode|[]}}.
* {{PropertyData|External Geometry|LinkSubList}}: a list of Part geometries outside this Sketch that are used for reference.
* {{PropertyData/de|External Geometry|LinkSubList}}: Eine Liste von Part-Geometrien außerhalb dieser Skizze, die als Referenz verwendet werden.
* {{PropertyData|Fully Constrained|Bool|Hidden}}: (read-only) if {{TRUE}} the sketch is fully constrained.
* {{PropertyData/de|Fully Constrained|Bool|Hidden}}: Nicht änderbar (read-only). Wird {{TRUE}} angezeigt, ist die Skizze vollständig bestimmt.


<span id="View"></span>
=== View ===
=== Ansicht ===


{{TitleProperty|Auto Constraints}}
{{TitleProperty|Auto Constraints}}


* {{PropertyView|Autoconstraints|Bool}}: if {{TRUE}} constraints are automatically added when geometry is drawn.
* {{PropertyView/de|Autoconstraints|Bool}}: Wenn {{TRUE}}, werden Randbedingungen automatisch hinzugefügt, während Geometrien gezeichnet werden.
* {{PropertyView|Avoid Redundant|Bool}}: if {{TRUE}} redundant auto-constraints are avoided.
* {{PropertyView/de|Avoid Redundant|Bool}}: Wenn {{TRUE}}, werden überflüssige automatische Randbedingungen vermieden.


{{TitleProperty|Grid}}
{{TitleProperty|Grid}}


* {{PropertyView|Grid Auto Size|Bool|Hidden}}: if {{TRUE}} the grid is resized based on the boundingbox of the geometry of the sketch.
* {{PropertyView/de|Grid Auto Size|Bool|Hidden}}: Wenn {{TRUE}}, wird die Größe eines Rasters auf Basis der Boundingbox der Geometrie einer Skizze angepasst.
* {{PropertyView|Grid Size|Length}}: the size of the spacing of the local grid lines in the [[3D_view|3D view]]; it defaults to {{value|10 mm}}.
* {{PropertyView/de|Grid Size|Length}}: Der Wert für den Abstand der lokalen Rasterlinien in der [[3D_view/de|3D-Ansicht]]; Standardwert ist {{value|10 mm}}.
* {{PropertyView|Grid Snap|Bool}}: if {{TRUE}} the grid can be used to snap points.
* {{PropertyView/de|Grid Snap|Bool}}: Wenn {{TRUE}}, kann das Raster zum Fangen von Punkten verwendet werden.
* {{PropertyView|Grid Style|Enumeration}}: the style of the grid lines; {{value|Dashed}} (default) or {{value|Light}}.
* {{PropertyView/de|Grid Style|Enumeration}}: Linienart der Rasterlinien; {{value|Dashed}} (Standard) oder {{value|Light}}.
* {{PropertyView|Show Grid|Bool}}: if {{TRUE}} a grid local to the object will be displayed in the [[3D_view|3D view]]. This grid is independent of the [[Draft_ToggleGrid|Draft Grid]].
* {{PropertyView/de|Show Grid|Bool}}: Wenn {{TRUE}}, wird in der [[3D_view/de|3D-Ansicht]] örtlich am Objekt ein Raster angezeigt. Dieses Raster ist unabhängig vom [[Draft_ToggleGrid/de|Draft Raster]].
* {{PropertyView|Show Only In Edit Mode|Bool}}: if {{TRUE}} the grid is only displayed while the sketch is being edited.
* {{PropertyView/de|Show Only In Edit Mode|Bool}}: Wenn {{TRUE}}, wird das Raster nur angezeigt, während die Skizze bearbeitet wird.
* {{PropertyView|Tight Grid|Bool}}: if {{TRUE}} the local grid will be localized around the origin of the shape, otherwise it will extend itself more.
* {{PropertyView/de|Tight Grid|Bool}}: Wenn {{TRUE}}, wird das örtliche Raster nur in der nähe des Ursprungs der Form dargestellt, andernfalls wird es weiter ausgedehnt.
* {{PropertyView|max Number Of Lines|Integer}}: the maximum number of lines in the grid.
* {{PropertyView/de|max Number Of Lines|Integer}}: Die maximale Anzahl an Linien in einem Raster.


{{TitleProperty|Visibility automation}}
{{TitleProperty|Visibility automation}}


* {{PropertyView|Editing Workbench|String}}: name of the workbench to activate when editing the sketch; it defaults to {{value|SketcherWorkbench}}.
* {{PropertyView/de|Editing Workbench|String}}: Name des Arbeitsbereiches, der aktiviert wird, wenn eine Skizze bearbeitet wird; Standardwert ist {{value|SketcherWorkbench}}.
* {{PropertyView|Force Ortho|Bool}}: if {{TRUE}} the camera will be forced to [[Std_OrthographicCamera|orthographic view mode]] when the sketch is opened.
* {{PropertyView/de|Force Ortho|Bool}}: Wenn {{TRUE}}, wird die Kamera in den Modus [[Std_OrthographicCamera/de|Orthoggonale Ansicht]] gezwungen, wenn die Skizze geöffnet wird.
* {{PropertyView|Hide Dependent|Bool}}: if {{TRUE}} all objects that depend on the sketch are hidden when the sketch is opened.
* {{PropertyView/de|Hide Dependent|Bool}}: Wenn {{TRUE}}, werden alle Objekte ausgeblendet, die von dieser Skizze abhängen, wenn die Skizze geöffnet wird.
* {{PropertyView|Restore Camera|Bool}}: if {{TRUE}} the camera position is saved before opening the sketch, and is restored after closing it.
* {{PropertyView/de|Restore Camera|Bool}}: Wenn {{TRUE}}, wird die Kameraposition gesichert, bevor die Skizze geöffnet wird und wiederhergestellt, nachdem die Skizze geschlossen wurde.
* {{PropertyView|Section View|Bool}}: if {{TRUE}} only (parts of) objects behind the sketch plane are visible while the sketch is being edited.
* {{PropertyView/de|Section View|Bool}}: Wenn {{TRUE}}, sind nur (Teile von) Objekte(n) hinter der Skizzenebene sichtbar, während die Skizze bearbeitet wird.
* {{PropertyView|Show Links|Bool}}: if {{TRUE}} all objects used in links to external geometry are shown when the sketch is opened.
* {{PropertyView/de|Show Links|Bool}}: Wenn {{TRUE}}, werden alle Objekte angezeigt, die zur Verknüpfung mit externer Geometrie verwendet werden, wenn die Skizze geöffnet wird.
* {{PropertyView|Show Support|Bool}}: if {{TRUE}} all objects this sketch is attached to are shown when the sketch is opened.
* {{PropertyView/de|Show Support|Bool}}: Wenn {{TRUE}}, werden alle Objekte dargestellt, mit denen diese Skizze verknüpft ist, wenn die Skizze geöffnet wird.
* {{PropertyView|Tempo Vis|PythonObject|Hidden}}: a custom class associated with this object, that handles hiding and showing other objects when opening and closing the sketch.
* {{PropertyView/de|Tempo Vis|PythonObject|Hidden}}: Eine mit diesem Objekt verbundene angepasste Klasse, die das Ein- und Ausblenden anderer Objekte regelt, während die Skizze geöffnet oder geschlossen wird.


== Scripting ==
<span id="Scripting"></span>
== Skripten ==


{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]] and [[Scripted_objects|scripted objects]].
{{Emphasis|Siehe auch:}} [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]] und [[Scripted_objects/de|Skriptgenerierte Objekte]].


See [[Part_Feature|Part Feature]] for the general information on adding objects to the document.
Siehe [[Part_Feature/de|Part Formelement]] für allgemeine Informationen zum Hinzufügen von Objekten zu einem Dokument.


A SketchObject is created with the {{incode|addObject()}} method of the document.
Ein Sketch-Objekt wird mit der {{incode|addObject()}} Methode des Dokuments erstellt.


{{Code|code=
{{Code|code=
Line 91: Line 97:
}}
}}


For [[Python|Python]] subclassing you should create the {{incode|Sketcher::SketchObjectPython}} object.
Für die Instanziierung von Unterklassen mit [[Python/de|Python]] sollte ein {{incode|Sketcher::SketchObjectPython}}-Objekt erstellt werden.


{{Code|code=
{{Code|code=

Revision as of 14:54, 3 February 2023

Einleitung

Ein Sketcher SketchObject, oder formal ein Sketcher::SketchObject, ist das Basiselement für die Erstellung von 2D-Objekten mit der Arbeitsumgebung Sketcher.

Das Sketcher::SketchObject ist vom Part Part2DObject abgeleitet, d.h. es ist ein Part Feature-Objekt spezialisiert auf 2D-Geometrie. Wie das Part2DObject, kann das SketchObject Ebenen und Flächen zugeordnet werden. Zusätzlich kann das SketchObject mit geometrischen Randbedingungen arbeiten.

Vereinfachtes Diagramm der Beziehungen zwischen den Kernobjekten in FreeCAD

Anwendung

  1. Zum Arbeitsbereich Sketcher wechseln.
  2. Die Schaltfläche Sketcher NeueSkizze drücken.
  3. Eine Skizzenorientierung auswählen: XY-Ebene, XZ-Ebene, oder YZ-Ebene. Wahlweise die Umgekehrte Richtung aktivieren, und einen Offset-Wert eingeben.
  4. OK drücken.

Auch wenn das Sketch-Objekt eigenständig verwendet werden kann, um auf einer Fläche zu zeichnen, wird es meistens in Verbindung mit dem Arbeitsbereich PartDesign verwendet um extrudierte Volumenkörper zu erstellen.

  1. Zum Arbeitsbereich Sketcher wechseln.
  2. Die Schaltfläche Körper erstellen drücken.
  3. Die Schaltfläche PartDesign Skizze erstellen drücken.
  4. Element auswählen: XY_Plane (Basis-Ebene), XZ_Plane (Basis-Ebene), oder YZ_Plane (Basis-Ebene).
  5. OK drücken.

Eigenschaften

Siehe Eigenschaft für alle Eigenschaftstypen, die geskriptete Objekte haben können.

Das Sketcher Sketch-Objekt (Sketcher::SketchObject-Klasse) ist von dem Part Part2DObject (Part::Part2DObject-Klasse) abgeleitet und erbt all seine Eigenschaften.

Das Sketcher Sketch-Objekt hat außerdem die folgenden zusätzlichen Eigenschaften im Eigenschafteneditor. Ausgeblendete Eigenschaften können mit dem Befehl Alle anzeigen im Kontextmenü des Eigenschafteneditors angezeigt werden.

Daten

Sketch

  • Daten-Eigenschaft (versteckt)Geometry (GeometryList): Eine Liste von Part-Geometrien die in der Skizze enthalten sind.
  • Daten-EigenschaftConstraints: Benannte Randbedingungen, wenn welche vorhanden sind, andernfalls eine leere Liste [].
  • Daten-EigenschaftExternal Geometry (LinkSubList): Eine Liste von Part-Geometrien außerhalb dieser Skizze, die als Referenz verwendet werden.
  • Daten-Eigenschaft (versteckt)Fully Constrained (Bool): Nicht änderbar (read-only). Wird true angezeigt, ist die Skizze vollständig bestimmt.

Ansicht

Auto Constraints

  • Ansicht-EigenschaftAutoconstraints (Bool): Wenn true, werden Randbedingungen automatisch hinzugefügt, während Geometrien gezeichnet werden.
  • Ansicht-EigenschaftAvoid Redundant (Bool): Wenn true, werden überflüssige automatische Randbedingungen vermieden.

Grid

  • Ansicht-Eigenschaft (versteckt)Grid Auto Size (Bool): Wenn true, wird die Größe eines Rasters auf Basis der Boundingbox der Geometrie einer Skizze angepasst.
  • Ansicht-EigenschaftGrid Size (Length): Der Wert für den Abstand der lokalen Rasterlinien in der 3D-Ansicht; Standardwert ist 10 mm.
  • Ansicht-EigenschaftGrid Snap (Bool): Wenn true, kann das Raster zum Fangen von Punkten verwendet werden.
  • Ansicht-EigenschaftGrid Style (Enumeration): Linienart der Rasterlinien; Dashed (Standard) oder Light.
  • Ansicht-EigenschaftShow Grid (Bool): Wenn true, wird in der 3D-Ansicht örtlich am Objekt ein Raster angezeigt. Dieses Raster ist unabhängig vom Draft Raster.
  • Ansicht-EigenschaftShow Only In Edit Mode (Bool): Wenn true, wird das Raster nur angezeigt, während die Skizze bearbeitet wird.
  • Ansicht-EigenschaftTight Grid (Bool): Wenn true, wird das örtliche Raster nur in der nähe des Ursprungs der Form dargestellt, andernfalls wird es weiter ausgedehnt.
  • Ansicht-Eigenschaftmax Number Of Lines (Integer): Die maximale Anzahl an Linien in einem Raster.

Visibility automation

  • Ansicht-EigenschaftEditing Workbench (String): Name des Arbeitsbereiches, der aktiviert wird, wenn eine Skizze bearbeitet wird; Standardwert ist SketcherWorkbench.
  • Ansicht-EigenschaftForce Ortho (Bool): Wenn true, wird die Kamera in den Modus Orthoggonale Ansicht gezwungen, wenn die Skizze geöffnet wird.
  • Ansicht-EigenschaftHide Dependent (Bool): Wenn true, werden alle Objekte ausgeblendet, die von dieser Skizze abhängen, wenn die Skizze geöffnet wird.
  • Ansicht-EigenschaftRestore Camera (Bool): Wenn true, wird die Kameraposition gesichert, bevor die Skizze geöffnet wird und wiederhergestellt, nachdem die Skizze geschlossen wurde.
  • Ansicht-EigenschaftSection View (Bool): Wenn true, sind nur (Teile von) Objekte(n) hinter der Skizzenebene sichtbar, während die Skizze bearbeitet wird.
  • Ansicht-EigenschaftShow Links (Bool): Wenn true, werden alle Objekte angezeigt, die zur Verknüpfung mit externer Geometrie verwendet werden, wenn die Skizze geöffnet wird.
  • Ansicht-EigenschaftShow Support (Bool): Wenn true, werden alle Objekte dargestellt, mit denen diese Skizze verknüpft ist, wenn die Skizze geöffnet wird.
  • Ansicht-Eigenschaft (versteckt)Tempo Vis (PythonObject): Eine mit diesem Objekt verbundene angepasste Klasse, die das Ein- und Ausblenden anderer Objekte regelt, während die Skizze geöffnet oder geschlossen wird.

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 Sketch-Objekt wird mit der addObject() Methode des Dokuments erstellt.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Sketcher::SketchObject", "Sketch")
obj.Label = "Custom label"

Für die Instanziierung von Unterklassen mit Python sollte ein Sketcher::SketchObjectPython-Objekt erstellt werden.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Sketcher::SketchObjectPython", "CustomSketch")
obj.Label = "Custom label"