Sketcher SketchObject/de: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
No edit summary
 
(31 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}


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


[[File:Sketcher_Sketch.svg|32px]]
[[File:Sketcher_Sketch.svg|32px]]


A [[Sketcher_SketchObject|Sketcher SketchObject]], or formally a {{incode|Sketcher::SketchObject}}, is the base element to create 2D objects with the [[Sketcher_Workbench|Sketcher Workbench]].
Ein [[Sketcher_SketchObject/de|Sketcher SketchObject]], oder formal ein {{incode|Sketcher::SketchObject}}, ist das Basiselement für die Erstellung von 2D-Objekten mit der Arbeitsumgebung [[Sketcher_Workbench/de|Sketcher]].


The {{incode|Sketcher::SketchObject}} is derived from [[Part_Part2DObject|Part Part2DObject]], which means it is a [[Part Feature|Part Feature]] object specialized for 2D geometry. Like Part2DObject, the SketchObject can be attached to planes and faces. In addition, the SketchObject can handle geometrical constraints of the lines and curves that are drawn within it.
Das {{incode|Sketcher::SketchObject}} ist vom [[Part_Part2DObject/de|Part Part2DObject]] abgeleitet, d.h. es ist ein [[Part Feature/de|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.


[[File:FreeCAD_core_objects.svg|800px]]
[[File:FreeCAD_core_objects.svg|800px]]


{{Caption|Vereinfachtes Diagramm der Beziehungen zwischen den Kernobjekten in FreeCAD}}
{{Caption|Simplified diagram of the relationships between the core objects in FreeCAD. The {{incode|Sketcher::SketchObject}} class is specialized for 2D shapes, and additionally it includes an extension to handle geometrical constraints of its elements.}}


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


# Switch to the [[Sketcher Workbench|Sketcher Workbench]].
Siehe [[Sketcher_NewSketch/de|Sketcher NeueSkizze]].
# Press {{Button|[[File:Sketcher_NewSketch.svg|16px]] [[Sketcher_NewSketch|Sketcher NewSketch]]}}.
# Select a {{MenuCommand|Sketch orientation}}: XY-plane, XZ-plane, or YZ-plane. Optionally also choose {{MenuCommand|Reverse direction}}, and give an {{MenuCommand|Offset}} value.
# Press {{Button|OK}}.


<span id="Properties"></span>
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.
==Eigenschaften==


Siehe [[Property/de|Eigenschaft]] für alle Eigenschaftstypen, die geskriptete Objekte haben können.
# Switch to the [[PartDesign Workbench|PartDesign Workbench]].
# Press {{Button|[[File:PartDesign_Body.svg|16px]] [[PartDesign_Body|PartDesign Body]]}}.
# Press {{Button|[[File:PartDesign_NewSketch.svg|16px]] [[PartDesign_NewSketch|PartDesign NewSketch]]}}.
# {{MenuCommand|Select feature}}: XY_Plane (Base plane), XZ_Plane (Base plane), or YZ_Plane (Base plane).
# Press {{Button|OK}}.


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.
== Properties ==


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.
See [[Property|Property]] for all property types that scripted objects can have.


<span id="Data"></span>
A [[Sketcher_SketchObject|Sketcher SketchObject]] ({{incode|Sketcher::SketchObject}} class) is derived from a [[Part_Part2DObject|Part Part2DObject]] ({{incode|Part::Part2DObject}} class), therefore it shares all the latter's properties.
=== Daten ===

In addition to the properties described in [[Part_Part2DObject|Part Part2DObject]], the basic Sketcher SketchObject has the following 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]].

=== Data ===

{{TitleProperty|Attachment}}
* {{PropertyData|Map Mode}}, {{PropertyData|Map Reversed}}, {{PropertyData|Attachment Offset}}: same as [[Part_Part2DObject|Part Part2DObject]]. See [[Part_EditAttachment|Part EditAttachment]] for more information on all attachment mapping modes.


{{TitleProperty|Sketch}}
{{TitleProperty|Sketch}}
* {{PropertyData|Constraints|}}: named constraints, if they exist; otherwise it is an empty list {{incode|[]}}.


* {{PropertyData/de|Geometry|GeometryList|Hidden}}: Eine Liste von Part-Geometrien die in der Skizze enthalten sind.
==== Hidden properties Data ====
* {{PropertyData/de|Constraints|}}: Benannte Randbedingungen, wenn welche vorhanden sind, andernfalls eine leere Liste {{incode|[]}}.
* {{PropertyData/de|External Geometry|LinkSubList}}: Eine Liste von Part-Geometrien außerhalb dieser Skizze, die als Referenz verwendet werden.
* {{PropertyData/de|Fully Constrained|Bool|Hidden}}: Nicht änderbar (read-only). Wird {{TRUE}} angezeigt, ist die Skizze vollständig bestimmt.


<span id="View"></span>
See [[Part_Part2DObject|Part Part2DObject]] for the rest of the hidden properties.
=== Ansicht ===

{{TitleProperty|Base}}

* {{PropertyData|Proxy|PythonObject}}: a custom class associated with this object. This only exists for the [[Python|Python]] version. See [[Sketcher_SketchObject#Scripting|Scripting]].

{{TitleProperty|Sketch}}

* {{PropertyData|Geometry|GeometryList}}: a list of Part geometries that exist inside the sketch.
* {{PropertyData|External Geometry|LinkSubList}}: a list of Part geometries outside this Sketch that are used for reference.

=== View ===


{{TitleProperty|Auto Constraints}}
{{TitleProperty|Auto Constraints}}
* {{PropertyView|Autoconstraints|Bool}}: if {{TRUE}} it will try setting constraints when the geometry is drawn.


* {{PropertyView/de|Autoconstraints|Bool}}: Wenn {{TRUE}}, werden Randbedingungen automatisch hinzugefügt, während Geometrien gezeichnet werden.
{{TitleProperty|Visibility automation}}
* {{PropertyView/de|Avoid Redundant|Bool}}: Wenn {{TRUE}}, werden überflüssige automatische Randbedingungen vermieden.
* {{PropertyView|Editing Workbench|String}}: name of the workbench to activate when editing the sketch; it defaults to {{value|SketcherWorkbench}}.
* {{PropertyView|Hide Dependent|Bool}}: if {{TRUE}} all objects that depend on the sketch are hidden when opening the sketch.
* {{PropertyView|Restore Camera|Bool}}: if {{TRUE}} the camera position is saved before opening the sketch, and is restored after closing it.
* {{PropertyView|Show Links|Bool}}: if {{TRUE}} all objects used in links to external geometry are shown when opening the sketch.
* {{PropertyView|Show Support|Bool}}: if {{TRUE}} all objects this sketch is attached to are shown when opening the sketch.


{{TitleProperty|Grid}}
==== Hidden properties View ====


* {{PropertyView/de|Grid Auto|Bool}}: Wenn {{TRUE}}, wird die Größe eines Rasters auf Basis der Boundingbox der Geometrie einer Skizze angepasst.
{{TitleProperty|Base}}
* {{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/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|Proxy|PythonObject}}: a custom view provider class associated with this object. This only exists for the [[Python|Python]] version. See [[Sketcher_SketchObject#Scripting|Scripting]].


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


* {{PropertyView/de|Editing Workbench|String}}: Name des Arbeitsbereiches, der aktiviert wird, wenn eine Skizze bearbeitet wird; Standardwert ist {{value|SketcherWorkbench}}.
* {{PropertyView|Tempo Vis|PythonObject}}: a custom class associated with this object, that handles hiding and showing other objects when opening and closing the sketch.
* {{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/de|Hide Dependent|Bool}}: Wenn {{TRUE}}, werden alle Objekte ausgeblendet, die von dieser Skizze abhängen, wenn die Skizze geöffnet wird.
* {{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/de|Section View|Bool}}: Wenn {{TRUE}}, sind nur (Teile von) Objekte(n) hinter der Skizzenebene sichtbar, während die Skizze bearbeitet wird.
* {{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/de|Show Support|Bool}}: Wenn {{TRUE}}, werden alle Objekte dargestellt, mit denen diese Skizze verknüpft ist, wenn die Skizze geöffnet wird.
* {{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.


<span id="Scripting"></span>
All other view properties, including hidden properties, are those of the base [[Part_Feature|Part Feature]] object.
== Skripten ==


{{Emphasis|Siehe auch:}} [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]] und [[Scripted_objects/de|Skriptgenerierte Objekte]].
== Scripting ==


Siehe [[Part_Feature/de|Part Formelement]] für allgemeine Informationen zum Hinzufügen von Objekten zu einem Dokument.
{{Emphasis|See also:}} [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]], and [[scripted objects|scripted objects]].


Ein Sketch-Objekt wird mit der {{incode|addObject()}} Methode des Dokuments erstellt.
See [[Part_Feature|Part Feature]] for the general information on adding objects to the document.


A SketchObject is created with the {{incode|addObject()}} method of the document.
{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App
Line 96: Line 81:
}}
}}


Für die Instanziierung von Unterklassen mit [[Python/de|Python]] sollte ein {{incode|Sketcher::SketchObjectPython}}-Objekt erstellt werden.
This basic {{incode|Sketcher::SketchObject}} doesn't have a Proxy object so it can't be fully used for sub-classing.

Therefore, for [[Python|Python]] subclassing, you should create the {{incode|Sketcher::SketchObjectPython}} object.


{{Code|code=
{{Code|code=
Line 109: Line 92:




{{Sketcher Tools navi{{#translation:}}}}
{{Sketcher_Tools_navi{{#translation:}}}}
{{Document_objects_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Document objects navi{{#translation:}}}}
{{clear}}

Latest revision as of 06:49, 15 May 2024

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

Siehe Sketcher NeueSkizze.

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-EigenschaftGrid Auto (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-EigenschaftShow Grid (Bool): Wenn true, wird in der 3D-Ansicht örtlich am Objekt ein Raster angezeigt. Dieses Raster ist unabhängig vom Draft 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"