Draft Polygon/de: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Created page with "* Ist die Option {{MenuCommand|Bearbeiten → Einstellungen... → Draft → Allgemein → Part-Grundkörper erstellen, wenn möglich}} aktiviert, wird ein Part-Regelmäßiges-Polygon anstelle eines Draft-Vielecks erstellt.")
 
(48 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/de|[[Draft_Ellipse|Ellipse]]|[[Draft_Rectangle|Rectangle]]|[[Draft_Module|Draft]]|IconL=Draft_Ellipse.svg |IconC=Workbench_Draft.svg|IconR=Draft_Rectangle.svg }}


{{Docnav/de
<div class="mw-translate-fuzzy">
|[[Draft_Rectangle/de|Rechteck]]
|[[Draft_BSpline/de|BSpline]]
|[[Draft_Workbench/de|Draft]]
|IconL=Draft_Rectangle.svg
|IconR=Draft_BSpline.svg
|IconC=Workbench_Draft.svg
}}

{{GuiCommand/de
{{GuiCommand/de
|Name=Draft Polygon|Name/de=Draft Polygon
|Name=Draft Polygon
|MenuLocation=Draft → Polygon
|Name/de=Draft Vieleck
|MenuLocation=Entwurf → Vieleck
|Workbenches=[[Draft Module/de|Draft]], [[Arch Module/de|Arch]]
|Workbenches=[[Draft_Workbench/de|Draft]], [[Arch_Workbench/de|Arch]]
|Shortcut={{KEY|P}} {{KEY|G}}
|Shortcut={{KEY|P}} {{KEY|G}}
|SeeAlso=[[Draft Circle/de|Draft Circle/de]]
|Version=0.7
|Version=0.7
}}
}}
</div>


<span id="Description"></span>
==Beschreibung====
==Beschreibung==
Das Polygonwerkzeug erstellt ein regelmäßiges Polygon, das in einen Umfang eingeschrieben ist, indem es zwei Punkte auswählt, den Mittelpunkt und den Radius. Es wird das [[Draft Linestyle/de]] verwendet, das auf dem [[Draft Tray/de]] eingestellt ist.

Das Werkzeug [[Image:Draft_Polygon.svg|24px]] '''Draft Vieleck''' erstellt ein regelmäßiges Vieleck (Polygon) auf der aktuellen [[Draft_SelectPlane/de|Arbeitsebene]] aus einem Mittelpunkt und einem Radius. Der Radius kann durch Indizieren eines Punktes festgelegt werden.

Ein Draft-Vieleck kann mit der {{PropertyData/de|Draw Mode}} von inscribed (mit Umkreis) auf circumscribed (mit Inkreis) umgeschaltet werden. Die Ecken eines Draft-Vielecks können mit Rundung (Fillet) oder Fase (Chamfer) versehen werden, indem seine {{PropertyData/de|Fillet Radius}} oder {{PropertyData/de|Chamfer Size}} geändert werden.


[[Image:Draft_polygon_example.jpg|400px]]
[[Image:Draft_polygon_example.jpg|400px]]
{{Caption|Regelmäßiges Polygon, das durch den Mittelpunkt und den Radius definiert ist}}
{{Caption|Ein durch zwei Punkte, den Mittelpunkt und den Radius, festgelegtes regelmäßiges Vieleck}}


<span id="Usage"></span>
==Anwendung==
==Anwendung==
# Drücke die Taste {{Button|[[Image:Draft Polygon.png|16px]] [[Draft Polygon]]}} oder drücke {{KEY|P}} dann {{KEY|G}} Tasten.
# Passe die gewünschte Anzahl von Seiten im Optionsdialog an.
# Klicke auf einen ersten Punkt in der 3D-Ansicht, oder gib eine [[Draft_Coordinates|coordinate]] und drücke die {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} Taste.
# Klicke auf einen anderen Punkt in der 3D-Ansicht oder gib einen Radiuswert ein, um den Polygonradius zu definieren.


Siehe auch: [[Draft_Tray/de|Draft Ablage]], [[Draft_Snap/de|Draft Einrasten]] und [[Draft_Constrain/de|Draft Beschränken]].
Das Polygon kann durch Doppelklick auf das Element in der Baumansicht oder durch Drücken der Taste {{Button|[[Image:Draft Edit.svg|16px]] [[Draft Edit/de]]}} bearbeitet werden. Dann kannst Du die Mittel- und Radiuspunkte auf eine neue Position verschieben.


# Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
Das Polygon wird in einem Kreis mit dem angegebenen Radius einbeschrieben; es kann nach der Erstellung durch Ändern seiner Zeichenmoduseigenschaften auf umschrieben umgeschaltet werden.
#* Die Schaltfläche {{Button|[[Image:Draft_Polygon.svg|16px]] [[Draft_Polygon/de|Vieleck]]}} drücken.
#* Den Menüeintrag {{MenuCommand|Drafting → [[Image:Draft_Polygon.svg|16px]] Vieleck}} auswählen.
#* Das Tastaturkürzel {{KEY|P}} dann {{KEY|G}}.
# Der Aufgabenbereich {{MenuCommand|Polygon}} wird geöffnet. Siehe [[#Optionen|Optionen]] für weitere Informationen.
# Die gewünschte Anzahl von Seiten ({{MenuCommand|Sides}}) eingeben.
# Den ersten Punkt, den Mittelpunkt des Vielecks, in der [[3D_view/de|3D-Ansicht]] auswählen, oder Die Koordinaten eingeben und die Schaltfläche {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} drücken.
# Den zweiten Punkt in der [[3D_view/de|3D-Ansicht]] auswählen, oder einen {{MenuCommand|Radius}} eingeben.


<span id="Options"></span>
Die Anzahl der Seiten des Polygons kann auch nach der Erstellung durch Ändern der Eigenschaft Flächenanzahl geändert werden.
==Optionen==


Die im Aufgaben-Bereich vorhandenen Einzelzeichen-Tastaturkürzel können geändert werden. Siehe [[Draft_Preferences/de|Draft Einstellungen]]. Die hier genannten Tastaturkürzel sind die voreingestellten Tastaturkürzel (für Version 0.22).
==Options==
* To enter coordinates manually, simply enter the numbers, then press {{KEY|Enter}} between each X, Y and Z component. You can press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button when you have the desired values to insert the point.
* Press {{KEY|T}} or click the checkbox to toggle ''continue'' mode. If continue mode is on, the Polygon tool will restart after you finish it, allowing you to draw another one without pressing the tool button again.
* Press {{KEY|L}} or click the checkbox to toggle ''filled'' mode. If filled mode is on, the polygon will create a filled face ({{PropertyData|Make Face}} {{TRUE}}); if not, the polygon will not make a face ({{PropertyData|Make Face}} {{FALSE}}).
* Hold {{KEY|Ctrl}} while drawing to force [[Draft_Snap|snapping]] your point to the nearest snap location, independently of the distance.
* Hold {{KEY|Shift}} while drawing to [[Draft_Constrain|constrain]] your second point horizontally or vertically in relation to the first one.
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the current command.


* Zum manuellen Eingeben von Koordinaten, werden die X-, Y- und Z-Komponenten jeweils mit abschließendem {{KEY|Enter}} eingegeben. Oder man drückt die Schaltfläche {{Button|[[Image:Draft_AddPoint.svg|16px]] Punkt eingeben}}, sobald alle gewünschten Werte eingegeben sind. Es ist ratsam, den Mauszeiger aus der [[3D_view/de|3D-Ansicht]] heraus zu bewegen, bevor Koordinaten eingegeben werden.
==Properties==
* {{KEY|G}} drücken oder die Checkbox {{MenuCommand|Global}} aktivieren, um den Global-Modus umzuschalten. Ist der Global-Modus aktiviert, beziehen sich Koordinaten auf das globale Koordinatensystem, andernfalls beziehen sie sich auf das Koordinatensystem der [[Draft_SelectPlane/de|Arbeitsebene]]. {{Version/de|0.20}}
* {{KEY|F}} drücken oder die Checkbox {{MenuCommand|Füllen}} aktivieren, um den Füllen-Modus umzuschalten. Ist der Füllen-Modus aktiviert, wird die {{PropertyData/de|Make Face}} des erstellten Vielecks auf {{TRUE}} gesetzt und es erhält eine gefüllte Fläche.
* {{KEY|N}} drücken oder die Checkbox {{MenuCommand|Fortsetzen}} aktivieren, um den Fortsetzen-Modus umzuschalten. Ist der Fortsetzen-Modus aktiviert, wird der Befehl nach dem Beenden erneut gestartet und ermöglicht so mit dem Erstellen von Vielecken fortzufahren.
* {{KEY|S}} drücken, um [[Draft_Snap/de|Draft Einrasten]] ein- bzw. auszuschalten.
* {{KEY|Esc}} oder die Schaltfläche {{Button|Schließen}} drücken, um den Befehl abzubrechen.


<span id="Notes"></span>
===Data===
==Hinweise==
* {{PropertyData|Radius}}: specifies the radius of the circle that defines the polygon.
* {{PropertyData|Draw Mode}}: specifies if the polygon is inscribed in a circle, or circumscribed around a circle.
* {{PropertyData|Faces Number}}: specifies the number of sides of the polygon.
* {{PropertyData|Chamfer Size}}: specifies the size of the chamfers (straight segments) created on the corners of the polygon.
* {{PropertyData|Fillet Radius}}: specifies the radius of the fillets (arc segments) created on the corners of the polygon.
* {{PropertyData|Make Face}}: specifies if the shape makes a face or not. If it is {{TRUE}} a face is created, otherwise only the perimeter is considered part of the object.


* Ein Draft-Vieleck kann mit dem Befehl [[Draft Edit/de|Draft Bearbeiten]] bearbeitet werden.
===View===
* {{PropertyView|Pattern}}: specifies a [[Draft Pattern]] with which to fill the face of the polygon. This property only works if {{PropertyData|Make Face}} is {{TRUE}}, and if {{PropertyView|Display Mode}} is "Flat Lines".
* {{PropertyView|Pattern Size}}: specifies the size of the [[Draft Pattern]].


<span id="Preferences"></span>
==Scripting==
==Einstellungen==
{{Emphasis|See also:}} [[Draft API]] and [[FreeCAD Scripting Basics]].


Siehe auch: [[Preferences_Editor/de|Voreinstellungseditor]] und [[Draft_Preferences/de|Draft Einstellungen]].
The Polygon tool can be used in [[macros]] and from the [[Python]] console by using the following function:

* Ist die Option {{MenuCommand|Bearbeiten → Einstellungen... → Draft → Allgemein → Part-Grundkörper erstellen, wenn möglich}} aktiviert, wird ein [[Part_Circle/de|Part-Regelmäßiges-Polygon]] anstelle eines Draft-Vielecks erstellt.

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

Siehe auch: [[Property_editor/de|Eigenschafteneditor]].

Ein Draft-Vieleck (Polygon-Objekt) wird von einem [[Part_Part2DObject/de|Part Part2DObject]] abgeleitet und erbt alle seine Eigenschaften. Außerdem hat es die folgenden zusätzlichen Eigenschaften:

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

{{TitleProperty|Draft}}

* {{PropertyData|Area|Area}}: (read-only) specifies the area of the face of the polygon. The value will be {{value|0.0}} if {{PropertyData|Make Face}} if {{FALSE}}.
* {{PropertyData|Chamfer Size|Length}}: specifies the length of the chamfers at the corners of the polygon.
* {{PropertyData|Draw Mode|Enumeration}}: specifies if the polygon is {{value|inscribed}} in a circle or {{value|circumscribed}} around a circle.
* {{PropertyData|Faces Number|Integer}}: specifies the number of sides of the polygon.
* {{PropertyData|Fillet Radius|Length}}: specifies the radius of the fillets at the corners of the polygon.
* {{PropertyData|Make Face|Bool}}: specifies if the polygon makes a face or not. If it is {{TRUE}} a face is created, otherwise only the perimeter is considered part of the object.
* {{PropertyData|Radius|Length}}: specifies the radius of the circle that defines the polygon.

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

{{TitleProperty|Draft}}

* {{PropertyView|Pattern|Enumeration}}: specifies the [[Draft_Pattern|Draft Pattern]] with which to fill the face of the polygon. This property only works if {{PropertyData|Make Face}} is {{TRUE}} and if {{PropertyView|Display Mode}} is {{value|Flat Lines}}.
* {{PropertyView|Pattern Size|Float}}: specifies the size of the [[Draft_Pattern|Draft Pattern]].

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

Siehe auch: [https://freecad.github.io/SourceDoc/ Autogenerierte API-Dokumentation] und [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]].

To create a Draft Polygon use the {{incode|make_polygon}} method ({{Version|0.19}}) of the Draft module. This method replaces the deprecated {{incode|makePolygon}} method.


{{Code|code=
{{Code|code=
Polygon = makePolygon(nfaces, radius=1, inscribed=True, placement=None, face=None, support=None)
polygon = make_polygon(nfaces, radius=1, inscribed=True, placement=None, face=None, support=None)
}}
}}
* Creates a {{incode|Polygon}} object with the given number of faces ({{incode|nfaces}}), and based on a circle of {{incode|radius}} in millimeters.
* Creates a {{incode|polygon}} object with the given number of faces ({{incode|nfaces}}), and based on a circle of {{incode|radius}} in millimeters.
* If {{incode|inscribed}} is {{incode|True}}, the polygon is inscribed in the circle, otherwise it will be circumscribed.
* If {{incode|inscribed}} is {{incode|True}}, the polygon is inscribed in the circle, otherwise it will be circumscribed.
** One of the vertices of the polygon will lie on the X axis if no other placement is given.
* If {{incode|placement}} is {{incode|None}} the polygon is created at the origin and one of its vertices will lie on the X axis.
* If a {{incode|placement}} is given, it is used; otherwise the shape is created at the origin.
* If {{incode|face}} is {{incode|True}}, the polygon will make a face, that is, it will appear filled.
* If {{incode|face}} is {{incode|True}}, the shape will make a face, that is, it will appear filled.


Beispiel:
Example:
{{Code|code=
{{Code|code=
import FreeCAD, Draft
import FreeCAD as App
import Draft


doc = App.newDocument()
Polygon1 = Draft.makePolygon(4, radius=500)
Polygon2 = Draft.makePolygon(5, radius=750)


polygon1 = Draft.make_polygon(4, radius=500)
ZAxis = FreeCAD.Vector(0, 0, 1)
polygon2 = Draft.make_polygon(5, radius=750)
p3 = FreeCAD.Vector(1000, 1000, 0)
place3 = FreeCAD.Placement(p3, FreeCAD.Rotation(ZAxis, 90))


zaxis = App.Vector(0, 0, 1)
Polygon3 = Draft.makePolygon(6, radius=1450, placement=place3)
p3 = App.Vector(1000, 1000, 0)
place3 = App.Placement(p3, App.Rotation(zaxis, 90))

Polygon3 = Draft.make_polygon(6, radius=1450, placement=place3)

doc.recompute()
}}
}}


{{Docnav|[[Draft_Ellipse|Ellipse]]|[[Draft_Rectangle|Rectangle]]|[[Draft_Module|Draft]]|IconL=Draft_Ellipse.svg |IconC=Workbench_Draft.svg|IconR=Draft_Rectangle.svg }}


{{Docnav/de
{{Draft Tools navi}}
|[[Draft_Rectangle/de|Rechteck]]
|[[Draft_BSpline/de|BSpline]]
|[[Draft_Workbench/de|Draft]]
|IconL=Draft_Rectangle.svg
|IconR=Draft_BSpline.svg
|IconC=Workbench_Draft.svg
}}


{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 14:13, 9 January 2024

Draft Vieleck

Menüeintrag
Entwurf → Vieleck
Arbeitsbereich
Draft, Arch
Standardtastenkürzel
P G
Eingeführt in Version
0.7
Siehe auch
Keiner

Beschreibung

Das Werkzeug Draft Vieleck erstellt ein regelmäßiges Vieleck (Polygon) auf der aktuellen Arbeitsebene aus einem Mittelpunkt und einem Radius. Der Radius kann durch Indizieren eines Punktes festgelegt werden.

Ein Draft-Vieleck kann mit der Daten-EigenschaftDraw Mode von inscribed (mit Umkreis) auf circumscribed (mit Inkreis) umgeschaltet werden. Die Ecken eines Draft-Vielecks können mit Rundung (Fillet) oder Fase (Chamfer) versehen werden, indem seine Daten-EigenschaftFillet Radius oder Daten-EigenschaftChamfer Size geändert werden.

Ein durch zwei Punkte, den Mittelpunkt und den Radius, festgelegtes regelmäßiges Vieleck

Anwendung

Siehe auch: Draft Ablage, Draft Einrasten und Draft Beschränken.

  1. Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
    • Die Schaltfläche Vieleck drücken.
    • Den Menüeintrag Drafting → Vieleck auswählen.
    • Das Tastaturkürzel P dann G.
  2. Der Aufgabenbereich Polygon wird geöffnet. Siehe Optionen für weitere Informationen.
  3. Die gewünschte Anzahl von Seiten (Sides) eingeben.
  4. Den ersten Punkt, den Mittelpunkt des Vielecks, in der 3D-Ansicht auswählen, oder Die Koordinaten eingeben und die Schaltfläche Enter point drücken.
  5. Den zweiten Punkt in der 3D-Ansicht auswählen, oder einen Radius eingeben.

Optionen

Die im Aufgaben-Bereich vorhandenen Einzelzeichen-Tastaturkürzel können geändert werden. Siehe Draft Einstellungen. Die hier genannten Tastaturkürzel sind die voreingestellten Tastaturkürzel (für Version 0.22).

  • Zum manuellen Eingeben von Koordinaten, werden die X-, Y- und Z-Komponenten jeweils mit abschließendem Enter eingegeben. Oder man drückt die Schaltfläche Punkt eingeben, sobald alle gewünschten Werte eingegeben sind. Es ist ratsam, den Mauszeiger aus der 3D-Ansicht heraus zu bewegen, bevor Koordinaten eingegeben werden.
  • G drücken oder die Checkbox Global aktivieren, um den Global-Modus umzuschalten. Ist der Global-Modus aktiviert, beziehen sich Koordinaten auf das globale Koordinatensystem, andernfalls beziehen sie sich auf das Koordinatensystem der Arbeitsebene. eingeführt mit Version 0.20
  • F drücken oder die Checkbox Füllen aktivieren, um den Füllen-Modus umzuschalten. Ist der Füllen-Modus aktiviert, wird die Daten-EigenschaftMake Face des erstellten Vielecks auf true gesetzt und es erhält eine gefüllte Fläche.
  • N drücken oder die Checkbox Fortsetzen aktivieren, um den Fortsetzen-Modus umzuschalten. Ist der Fortsetzen-Modus aktiviert, wird der Befehl nach dem Beenden erneut gestartet und ermöglicht so mit dem Erstellen von Vielecken fortzufahren.
  • S drücken, um Draft Einrasten ein- bzw. auszuschalten.
  • Esc oder die Schaltfläche Schließen drücken, um den Befehl abzubrechen.

Hinweise

Einstellungen

Siehe auch: Voreinstellungseditor und Draft Einstellungen.

  • Ist die Option Bearbeiten → Einstellungen... → Draft → Allgemein → Part-Grundkörper erstellen, wenn möglich aktiviert, wird ein Part-Regelmäßiges-Polygon anstelle eines Draft-Vielecks erstellt.

Eigenschaften

Siehe auch: Eigenschafteneditor.

Ein Draft-Vieleck (Polygon-Objekt) wird von einem Part Part2DObject abgeleitet und erbt alle seine Eigenschaften. Außerdem hat es die folgenden zusätzlichen Eigenschaften:

Daten

Draft

  • DatenArea (Area): (read-only) specifies the area of the face of the polygon. The value will be 0.0 if DatenMake Face if false.
  • DatenChamfer Size (Length): specifies the length of the chamfers at the corners of the polygon.
  • DatenDraw Mode (Enumeration): specifies if the polygon is inscribed in a circle or circumscribed around a circle.
  • DatenFaces Number (Integer): specifies the number of sides of the polygon.
  • DatenFillet Radius (Length): specifies the radius of the fillets at the corners of the polygon.
  • DatenMake Face (Bool): specifies if the polygon makes a face or not. If it is true a face is created, otherwise only the perimeter is considered part of the object.
  • DatenRadius (Length): specifies the radius of the circle that defines the polygon.

Ansicht

Draft

  • AnsichtPattern (Enumeration): specifies the Draft Pattern with which to fill the face of the polygon. This property only works if DatenMake Face is true and if AnsichtDisplay Mode is Flat Lines.
  • AnsichtPattern Size (Float): specifies the size of the Draft Pattern.

Skripten

Siehe auch: Autogenerierte API-Dokumentation und FreeCAD Grundlagen Skripten.

To create a Draft Polygon use the make_polygon method (introduced in version 0.19) of the Draft module. This method replaces the deprecated makePolygon method.

polygon = make_polygon(nfaces, radius=1, inscribed=True, placement=None, face=None, support=None)
  • Creates a polygon object with the given number of faces (nfaces), and based on a circle of radius in millimeters.
  • If inscribed is True, the polygon is inscribed in the circle, otherwise it will be circumscribed.
  • If placement is None the polygon is created at the origin and one of its vertices will lie on the X axis.
  • If face is True, the polygon will make a face, that is, it will appear filled.

Beispiel:

import FreeCAD as App
import Draft

doc = App.newDocument()

polygon1 = Draft.make_polygon(4, radius=500)
polygon2 = Draft.make_polygon(5, radius=750)

zaxis = App.Vector(0, 0, 1)
p3 = App.Vector(1000, 1000, 0)
place3 = App.Placement(p3, App.Rotation(zaxis, 90))

Polygon3 = Draft.make_polygon(6, radius=1450, placement=place3)

doc.recompute()