Draft PolarArray/de: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(46 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/de
{{Docnav/de
|[[Draft_OrthoArray/de|RechtwinkligeAnordnung]]
|[[Draft_Draft2Sketch/de|Entwurf zu Skizze]]
|[[Draft_PathArray/de|PfadAnordnung]]
|[[Draft_CircularArray/de|KreisAnordnung]]
|[[Draft_Workbench/de|Draft]]
|[[Draft_Module/de|Entwurf Arbeitsbereich]]
|IconL=Draft_Draft2Sketch.svg
|IconL=Draft_OrthoArray.svg
|IconR=Draft_CircularArray.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_PathArray.svg
}}
}}


{{GuiCommand/de
{{GuiCommand/de
|Name=Draft PolarAnordnung
|Name=Draft PolarArray
|Name/de=Draft PolareAnordnung
|MenuLocation=Entwurf → Polare Anordnung
|MenuLocation=Änderung → Array tools → Polare Anordnung
|Workbenches=[[Draft Module/de|Entwurf]]
|Workbenches=[[Draft_Workbench/de|Draft]], [[Arch_Workbench/de|Arch]]
|Version=0.19
|Version=0.19
|SeeAlso=[[Draft_Array/de|Anordnung]], [[Draft_CircularArray/de|KreisAnordnung]], [[Draft_PathArray/de|PfadAnordnung]], [[Draft_PointArray/de|Punkt Anordnung]], [[Draft_Clone/de|Klonen]]
|SeeAlso=[[Draft_OrthoArray/de|Draft RechtwinkligeAnordnung]], [[Draft_CircularArray/de|Draft KreisAnordnung]], [[Draft_PathArray/de|Draft PfadAnordnung]], [[Draft_PathLinkArray/de|Draft PfadVerknüpfungsanordnung]], [[Draft_PointArray/de|Draft Punktanordnung]], [[Draft_PointLinkArray/de|Draft PunktVerknüpfungsanordnung]]
}}
}}


<span id="Description"></span>
==Beschreibung==
==Beschreibung==


Das {{Button|[[File:Draft_PolarArray.svg|16px]] [[Draft_PolarArray/de|Entwurf PolarAnordnung]]}} Werkzeug erstellt eine Anordnung aus einem ausgewählten Objekt und platziert die Kopien entlang eines Umfangs.
Der Befehl [[Image:Draft_PolarArray.svg|24px]] '''Draft PolareAnordnung''' erstellt eine Anordnung aus einem ausgewählten Objekt, indem er Kopien entlang einer Kreisumfangslinie positioniert. Der Befehl kann wahlweise auch eine Verknüpfungsanordnung ([[App_Link/de|Link]]-Array,) erstellen, die effizienter ist, als eine normale Anordnung.


Dieses Werkzeug kann für 2D Formen verwendet werden, die mit dem [[Draft_Workbench/de|Entwurf Arbeitsbereich]] erstellt wurden, aber auch für viele Arten von 3D Objekten, wie sie mit der [[Part_Workbench/de|Part Arbeitsbereich]] oder [[PartDesign_Workbench/de|PartDesign Arbeitsbereich]] erstellt wurden.
Dieser Befehl kann für 2D-Objekte verwendet werden, die mit den Arbeitsbereichen [[Draft_Workbench/de|Draft]] oder [[Sketcher_Workbench/de|Sketcher]] erstellt wurden, aber auch für viele 3D-Objekte, die mit anderen Arbeitsbereichen wie [[Part_Workbench/de|Part]], [[PartDesign_Workbench/de|PartDesign]] oder [[Arch_Workbench/de|Arch]] erstellt wurden.

Zum Positionieren von Kopien in einem rechteckigen Raster verwende [[Draft_Array|Array]]; zum Positionieren in einem kreisförmigen Muster verwende [[Draft_CircularArray/de|KreisAnordnung]]; um Kopien entlang eines Pfades zu positionieren, verwende [[Draft_PathArray/de|PfadAnordnung]]; um Kopien an bestimmten Punkten zu positionieren, verwende [[Draft_PointArray/de|PunktAnordnung]]; um Kopien oder Klone zu erstellen und manuell zu platzieren, verwende [[Draft_Move/de|Bewegen]], [[Draft_Rotate/de|Drehen]] und [[Draft_Clone/de|Klonen]].


[[Image:Draft_PolarArray_example.png|400px]]
[[Image:Draft_PolarArray_example.png|400px]]
{{Caption|Draft PolareAnordnung}}


<span id="Usage"></span>
{{Caption|Eine polar Anordnung eines Objekts.}}
==Anwendung==


Siehe auch: [[Draft_Snap/de|Draft Fangen]].
== Verwendung ==


# Wahlweise ein Objekt auswählen.
# Wähleein Objekt aus, von dem du die Polaranordnung erstellen möchtest.
# Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
# Drücke die {{Button|[[File:Draft_PolarArray.svg|16px]] [[Draft_PolarArray|Polar Anordnung]]}} Schaltfläche. Wenn kein Objekt ausgewählt ist, wird das [[task_panel/de|Aufgabenpaneel]] geöffnet, aber du musst trotzdem ein Objekt auswählen, um fortzufahren.
#* Die Schaltfläche {{Button|[[Image:Draft_PolarArray.svg|16px]] [[Draft_PolarArray/de|Polare Anordnung]]}} drücken.
# Wähle den Polarwinkel, der bestimmt, wo sich das letzte Element der Anordnung befindet.
#* Den Menüeintrag {{MenuCommand|Änderung → Anordnungswerkzeuge → [[Image:Draft_PolarArray.svg|16px]] Polare Anordnung}} auswählen.
# Wähle die Anzahl der Elemente in der Anordnung. Minimum von 2, Maximum von 99.
# Der Aufgaben-Bereich {{MenuCommand|Polare Anordnung}} wird geöffnet. Siehe [[#Optionen|Optionen]] für wietere Informationen.
# Wähle das Zentrum der Rotationsachse. Du kannst auf die [[3D_view/de|3D Ansicht]] klicken, um gleichzeitig die Position des Rotationszentrums festzulegen und den Befehl abzuschließen.
# Wurde noch kein Objekt ausgewählt: Ein Objekt auswählen.
# Optional hake die verschmelzungs- oder Verknüpfungsoptionen an.
# Im Aufgaben-Bereich die erforderlichen Parameter eingeben.
# Drücke {{Button|OK}}, um den Befehl abzuschließen.
# Um den Befehl abzuschließen, gibt es folgende Möglichkeiten:

#* Einen Punkt für den {{MenuCommand|Drehmittelpunkt}} in der [[3D_view/de|3D-Ansicht]] auswählen.
Hinweise:
#* {{KEY|Enter}} drücken.
* Standardmäßig ist die Rotationsachse die positive Z Achse {{Value|(0, 0, 1)}}. Dies kann im [[property_editor/de|Eigenschaftseditor]] geändert werden, nachdem das Objekt erzeugt wurde.
#* Die Schaltfläche {{Button|OK}} drücken.
* Der Polarwinkel ist positiv im Gegenuhrzeigersinn und negativ im Uhrzeigersinn.
* Jedes Element in der Anordnung ist ein exakter Klon des ursprünglichen Objekts, aber die gesamte Anordnung wird in Bezug auf Eigenschaften und Aussehen als eine Einheit betrachtet.
* Mit diesem Befehl wird dasselbe Objekt erstellt, das mit den [[Draft_Array/de|Anordnung]] und [[Draft_CircularArray/de|KreisAnordnung]] Werkzeugen erstellt wurde. Daher kann die Anordnung einfach durch Ändern seiner Eigenschaften in orthogonal, polar oder zirkular umgewandelt werden.


<span id="Options"></span>
== Optionen ==
== Optionen ==


* Den {{MenuCommand|Polarwinkel}} eingeben, um den Gesamtwinkel der Anordnung festzulegen. Der positive Winkel wird gegen den Uhrzeigersinn angegeben.
* Press {{Button|Reset point}} to set the center of rotation to the origin {{Value|(0, 0, 0)}}.
* Die {{MenuCommand|Anzahl der Elemente}} angeben; mindestens {{Value|2}}. Der größte Wert, der im Aufgaben-Bereich eingegeben werden kann ist {{Value|99}}, höhere Werte können aber durch Ändern der {{PropertyData/de|Number Polar}} der Anordnung gesetzt werden.
* If the {{MenuCommand|Fuse}} checkbox is ticked, the resulting objects in the array will be fused into a single shape, if they touch or intersect each other.
* Einen Punkt in der [[3D_view/de|3D-Ansicht]] auswählen (dies schließt auch den Befehl ab) oder dieKoordinaten für den for the {{MenuCommand|Drehmittelpunkt}} eingeben. Die Rotationsachse wird durch diesen Punkt verlaufen. Es ist ratsam, den Mauszeiger aus der [[3D_view/de|3D-Ansicht]] herauzubewegen, bevor die Koordinaten eingegeben werden.
* If the {{MenuCommand|Use Links}} checkbox is ticked, the resulting objects in the array will be [[App_Link|App Links]] instead of simple copies. This improves the memory usage of the array, as the App Link re-uses the [[Shape|shape]] of the original object, and does not create new shapes. If this option is used, the {{MenuCommand|Fuse}} checkbox has no effect.
* Die Schaltfläche {{MenuCommand|Punkt zurücksetzen}} drücken, um den {{MenuCommand|Drehmittelpunkt}} auf den Ursprung (zurück) zu setzen.
* Press {{KEY|Esc}} or the {{Button|Cancel}} button to abort the current command.
* Ist die Checkbox {{MenuCommand|Vereinigung}} aktiviert, werden überlappende elemente in der Anordnung vereinigt. dies funktioniert nicht mit Verknüpfungsanordnungen (Link-Arrays).
* Ist die Checkbox {{MenuCommand|Verknüpfungsanordnung}} aktiviert, wird eine Verknüpfungsanordnung anstelle einer normalen Anordnung erstellt. Eine Verknüpfungsanordnung ist effektiver, da ihre Elemente [[App_Link/de|App-Link]]-Objekte sind.
* {{KEY|Esc}} drücken oder die Schaltfäche {{Button|Cancel}}, um den Befehl abzubrechen.


<span id="Notes"></span>
== Properties ==
==Hinweise==


* Die Standarddrehachse der Anordnung ist die positive Z-Achse. Dies kann durch Anpassen ihrer {{PropertyData/de|Axis}} geändert werden.
An [[Draft_PolarArray|Array]] object is based on [[Part_Feature|Part Feature]] ({{incode|Part::Feature}} class), and thus shares all properties of the latter. In addition to the properties listed in [[Part_Feature|Part Feature]], the Array object has additional properties.
* Eine Draft PolareAnordnung kann in eine [[Draft_OrthoArray/de|Draft RechtwinkligeAnordnung]] oder eine [[Draft_CircularArray|Draft Kreisanordnung]] gewandelt werden, indem ihre {{PropertyData/de|Array Type}} geändert wird.
* Eine Verknüpfungsanordnung kann nicht in eine normale Anordnung gewandelt werden oder umgekehrt. Die Art der Anordnung muss zum Zeitpunkt der Erstellung entschieden werden.


<span id="Properties"></span>
See the {{Button|[[Image:Draft_Array.svg|16px]] [[Draft_OrthoArray|OrthoArray]]}} tool for the complete information.
==Eigenschaften==


Siehe [[Draft_OrthoArray/de#Eigenschaften|Draft RechtwinkligeAnordnung]].
== Scripting ==


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


Siehe auch: [https://freecad.github.io/SourceDoc/ Autogenerierte API Dokumentation] und [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]].
The Array tool can be used in [[macros|macros]] and from the [[Python_console|Python console]] by using the following function.

<span id="Parametric_array"></span>
===Parametrische Anordnung===

Zum Erstellen einer parametrischen polaren Anordnung wird die Methode {{incode|make_array}} des Draft-Moduls verwendet ({{Version/de|0.19}}). Diese Methode ersetzt die veraltete Methode {{incode|makeArray}}. Die Methode {{incode|make_array}} kann [[Draft_OrthoArray/de|Draft RechtwinkligeAnordnungen]], Draft PolareAnordnungen und [[Draft_CircularArray/de|Draft KreisAnordnungen]] erstellen. Für jede Anordnungsart stehen eine oder mehrere Wrapper-Methoden zur Verfügung.

Die Hauptmethode:


{{Code|code=
{{Code|code=
array = make_array(base_object, arg1, arg2, arg3, arg4=None, arg5=None, arg6=None, use_link=True)
array_list = make_polar_array(obj, center, angle, number, use_link)
}}
}}


Der Wrapper für polare Anordnungen ist:
* Creates an array from the objects contained in {{incode|obj}}, which can be a single object or a list of objects.

* The value of {{incode|center}} is a vector that defines the center of the array circle; {{incode|angle}} is the angle of the arc in degrees, and {{incode|number}} is the number of copies in the polar pattern, including the original object.
{{Code|code=
* If {{incode|use_link}} is {{TRUE}} the created copies will be [[App_Link|App Links]] and not regular copies.
array = make_polar_array(base_object,
* {{incode|array_list}} is returned with the new copies.
number=5, angle=360, center=App.Vector(0, 0, 0),
** {{incode|array_list}} is either a single object or a list of objects, depending on the input {{incode|obj}}.
use_link=True)
}}

* {{incode|base_object}} ist das Objekt, das angeordnet wird. Es kann auch das {{incode|Label}} (Benennung) eines Objekts im Dokument sein.
* {{incode|number}} ist die Anzahl der Elemente in dem Muster inklusive des Originalobjekts.
* {{incode|angle}} ist der Winkeldes polaren Bogens in Grad.
* {{incode|center}} ist der Vektor, der den Mittelpunkt des Musters festlegt.
* Ist {{incode|use_link}} auf {{incode|True}} gesetzt, sind die erstellten Elemente [[App_Link|App-Links]] anstatt normale Kopien.
* {{incode|array}} wird mit dem erstellten Anordnungsobjekt zurückgegeben.


Beispiel:
Beispiel:

{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App
import Draft
import Draft
import draftobjects.polararray as pa


doc = App.newDocument()
doc = App.newDocument()


tri = Draft.makePolygon(3, 600)
tri = Draft.make_polygon(3, 600)
center = App.Vector(-1600, 0, 0)
center = App.Vector(-1600, 0, 0)

arr = pa.make_polar_array(tri, center, 270, 8)
array = Draft.make_polar_array(tri, 8, 270, center)
App.ActiveDocument.recompute()
doc.recompute()
}}
}}

<span id="Non-parametric_array"></span>
===Nichtparametrische Anordnung===

Zum Erstellen einer nichtparametrischen Anordnung wird die Methode {{incode|array}} des Draft-Moduls verwendet. Diese Methode gibt {{incode|None}} zurück.

{{Code|code=
array(objectslist, center, angle, number)
}}

Beispiel:

{{Code|code=
import FreeCAD as App
import Draft

doc = App.newDocument()

tri = Draft.make_polygon(3, 600)
center = App.Vector(-1600, 0, 0)

Draft.array(tri, center, 270, 8)
doc.recompute()
}}



{{Docnav/de
{{Docnav/de
|[[Draft_OrthoArray/de|RechtwinkligeAnordnung]]
|[[Draft_Draft2Sketch/de|Entwurf zu Skizze]]
|[[Draft_PathArray/de|PfadAnordnung]]
|[[Draft_CircularArray/de|KreisAnordnung]]
|[[Draft_Workbench/de|Draft]]
|[[Draft_Module/de|Entwurf Arbeitsbereich]]
|IconL=Draft_Draft2Sketch.svg
|IconL=Draft_OrthoArray.svg
|IconR=Draft_CircularArray.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_PathArray.svg
}}
}}


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

Latest revision as of 12:11, 7 January 2024

Draft PolareAnordnung

Menüeintrag
Änderung → Array tools → Polare Anordnung
Arbeitsbereich
Draft, Arch
Standardtastenkürzel
Keiner
Eingeführt in Version
0.19
Siehe auch
Draft RechtwinkligeAnordnung, Draft KreisAnordnung, Draft PfadAnordnung, Draft PfadVerknüpfungsanordnung, Draft Punktanordnung, Draft PunktVerknüpfungsanordnung

Beschreibung

Der Befehl Draft PolareAnordnung erstellt eine Anordnung aus einem ausgewählten Objekt, indem er Kopien entlang einer Kreisumfangslinie positioniert. Der Befehl kann wahlweise auch eine Verknüpfungsanordnung (Link-Array,) erstellen, die effizienter ist, als eine normale Anordnung.

Dieser Befehl kann für 2D-Objekte verwendet werden, die mit den Arbeitsbereichen Draft oder Sketcher erstellt wurden, aber auch für viele 3D-Objekte, die mit anderen Arbeitsbereichen wie Part, PartDesign oder Arch erstellt wurden.

Draft PolareAnordnung

Anwendung

Siehe auch: Draft Fangen.

  1. Wahlweise ein Objekt auswählen.
  2. Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
    • Die Schaltfläche Polare Anordnung drücken.
    • Den Menüeintrag Änderung → Anordnungswerkzeuge → Polare Anordnung auswählen.
  3. Der Aufgaben-Bereich Polare Anordnung wird geöffnet. Siehe Optionen für wietere Informationen.
  4. Wurde noch kein Objekt ausgewählt: Ein Objekt auswählen.
  5. Im Aufgaben-Bereich die erforderlichen Parameter eingeben.
  6. Um den Befehl abzuschließen, gibt es folgende Möglichkeiten:
    • Einen Punkt für den Drehmittelpunkt in der 3D-Ansicht auswählen.
    • Enter drücken.
    • Die Schaltfläche OK drücken.

Optionen

  • Den Polarwinkel eingeben, um den Gesamtwinkel der Anordnung festzulegen. Der positive Winkel wird gegen den Uhrzeigersinn angegeben.
  • Die Anzahl der Elemente angeben; mindestens 2. Der größte Wert, der im Aufgaben-Bereich eingegeben werden kann ist 99, höhere Werte können aber durch Ändern der Daten-EigenschaftNumber Polar der Anordnung gesetzt werden.
  • Einen Punkt in der 3D-Ansicht auswählen (dies schließt auch den Befehl ab) oder dieKoordinaten für den for the Drehmittelpunkt eingeben. Die Rotationsachse wird durch diesen Punkt verlaufen. Es ist ratsam, den Mauszeiger aus der 3D-Ansicht herauzubewegen, bevor die Koordinaten eingegeben werden.
  • Die Schaltfläche Punkt zurücksetzen drücken, um den Drehmittelpunkt auf den Ursprung (zurück) zu setzen.
  • Ist die Checkbox Vereinigung aktiviert, werden überlappende elemente in der Anordnung vereinigt. dies funktioniert nicht mit Verknüpfungsanordnungen (Link-Arrays).
  • Ist die Checkbox Verknüpfungsanordnung aktiviert, wird eine Verknüpfungsanordnung anstelle einer normalen Anordnung erstellt. Eine Verknüpfungsanordnung ist effektiver, da ihre Elemente App-Link-Objekte sind.
  • Esc drücken oder die Schaltfäche Cancel, um den Befehl abzubrechen.

Hinweise

  • Die Standarddrehachse der Anordnung ist die positive Z-Achse. Dies kann durch Anpassen ihrer Daten-EigenschaftAxis geändert werden.
  • Eine Draft PolareAnordnung kann in eine Draft RechtwinkligeAnordnung oder eine Draft Kreisanordnung gewandelt werden, indem ihre Daten-EigenschaftArray Type geändert wird.
  • Eine Verknüpfungsanordnung kann nicht in eine normale Anordnung gewandelt werden oder umgekehrt. Die Art der Anordnung muss zum Zeitpunkt der Erstellung entschieden werden.

Eigenschaften

Siehe Draft RechtwinkligeAnordnung.

Skripten

Siehe auch: Autogenerierte API Dokumentation und FreeCAD Grundlagen Skripten.

Parametrische Anordnung

Zum Erstellen einer parametrischen polaren Anordnung wird die Methode make_array des Draft-Moduls verwendet (eingeführt mit Version 0.19). Diese Methode ersetzt die veraltete Methode makeArray. Die Methode make_array kann Draft RechtwinkligeAnordnungen, Draft PolareAnordnungen und Draft KreisAnordnungen erstellen. Für jede Anordnungsart stehen eine oder mehrere Wrapper-Methoden zur Verfügung.

Die Hauptmethode:

array = make_array(base_object, arg1, arg2, arg3, arg4=None, arg5=None, arg6=None, use_link=True)

Der Wrapper für polare Anordnungen ist:

array = make_polar_array(base_object,
                         number=5, angle=360, center=App.Vector(0, 0, 0),
                         use_link=True)
  • base_object ist das Objekt, das angeordnet wird. Es kann auch das Label (Benennung) eines Objekts im Dokument sein.
  • number ist die Anzahl der Elemente in dem Muster inklusive des Originalobjekts.
  • angle ist der Winkeldes polaren Bogens in Grad.
  • center ist der Vektor, der den Mittelpunkt des Musters festlegt.
  • Ist use_link auf True gesetzt, sind die erstellten Elemente App-Links anstatt normale Kopien.
  • array wird mit dem erstellten Anordnungsobjekt zurückgegeben.

Beispiel:

import FreeCAD as App
import Draft

doc = App.newDocument()

tri = Draft.make_polygon(3, 600)
center = App.Vector(-1600, 0, 0)

array = Draft.make_polar_array(tri, 8, 270, center)
doc.recompute()

Nichtparametrische Anordnung

Zum Erstellen einer nichtparametrischen Anordnung wird die Methode array des Draft-Moduls verwendet. Diese Methode gibt None zurück.

array(objectslist, center, angle, number)

Beispiel:

import FreeCAD as App
import Draft

doc = App.newDocument()

tri = Draft.make_polygon(3, 600)
center = App.Vector(-1600, 0, 0)

Draft.array(tri, center, 270, 8)
doc.recompute()