Draft PolarArray/de: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
Line 9: Line 9:
}}
}}


<div class="mw-translate-fuzzy">
{{GuiCommand/de
{{GuiCommand/de
|Name=Draft PolarAnordnung
|Name=Draft PolarAnordnung
Line 16: Line 17:
|SeeAlso=[[Draft_Array/de|Anordnung]], [[Draft_CircularArray/de|KreisAnordnung]], [[Draft_PathArray/de|PfadAnordnung]], [[Draft_PointArray/de|Punkt Anordnung]], [[Draft_Clone/de|Klonen]]
|SeeAlso=[[Draft_Array/de|Anordnung]], [[Draft_CircularArray/de|KreisAnordnung]], [[Draft_PathArray/de|PfadAnordnung]], [[Draft_PointArray/de|Punkt Anordnung]], [[Draft_Clone/de|Klonen]]
}}
}}
</div>


==Beschreibung==
==Beschreibung==
Line 21: Line 23:
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.
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.


<div class="mw-translate-fuzzy">
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.
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.
</div>


<div class="mw-translate-fuzzy">
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]].
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]].
</div>


[[Image:Draft_PolarArray_example.png|400px]]
[[Image:Draft_PolarArray_example.png|400px]]
Line 31: Line 37:
==Anwendung==
==Anwendung==


<div class="mw-translate-fuzzy">
# Wähleein Objekt aus, von dem du die Polaranordnung erstellen möchtest.
# Wähleein Objekt aus, von dem du die Polaranordnung erstellen möchtest.
# 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.
# 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.
Line 38: Line 45:
# Optional hake die verschmelzungs- oder Verknüpfungsoptionen an.
# Optional hake die verschmelzungs- oder Verknüpfungsoptionen an.
# Drücke {{Button|OK}}, um den Befehl abzuschließen.
# Drücke {{Button|OK}}, um den Befehl abzuschließen.
</div>


<div class="mw-translate-fuzzy">
Hinweise:
Hinweise:
* 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.
* 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.
Line 44: Line 53:
* 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.
* 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.
* 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.
</div>


== Optionen ==
== Optionen ==


These are the options displayed in the [[task_panel|task panel]].

<div class="mw-translate-fuzzy">
* Drücke {{Button|Reset point}} um das Drehzentrum auf den Ursprung zu setzen {{Value|(0, 0, 0)}}.
* Drücke {{Button|Reset point}} um das Drehzentrum auf den Ursprung zu setzen {{Value|(0, 0, 0)}}.
* Wenn das Kontrollkästchen {{MenuCommand|Fuse}} aktiviert ist, werden die resultierenden Objekte in der Anordnung zu einer einzigen Form verschmolzen, wenn sie einander berühren oder schneiden.
* Wenn das Kontrollkästchen {{MenuCommand|Fuse}} aktiviert ist, werden die resultierenden Objekte in der Anordnung zu einer einzigen Form verschmolzen, wenn sie einander berühren oder schneiden.
* Wenn das Kontrollkästchen {{MenuCommand|Use Links}} markiert ist, werden die resultierenden Objekte in der Anordnung nicht als einfache Kopien, sondern als [[App_Link/de|App Verknüpfungen]] erstellt. Dies verbessert die Speichernutzung der Anordnung, da die App Verknüpfung die [[Shape/de|Form]] des Originalobjekts wiederverwendet und keine neuen Formen erstellt. Wenn diese Option verwendet wird, hat das {{MenuCommand|Fuse}} Kontrollkästchen keine Wirkung.
* Wenn das Kontrollkästchen {{MenuCommand|Use Links}} markiert ist, werden die resultierenden Objekte in der Anordnung nicht als einfache Kopien, sondern als [[App_Link/de|App Verknüpfungen]] erstellt. Dies verbessert die Speichernutzung der Anordnung, da die App Verknüpfung die [[Shape/de|Form]] des Originalobjekts wiederverwendet und keine neuen Formen erstellt. Wenn diese Option verwendet wird, hat das {{MenuCommand|Fuse}} Kontrollkästchen keine Wirkung.
* Drücke {{KEY|Esc}} oder die {{Button|Cancel}} Schaltfläche, um den aktuellen Befehl abzubrechen.
* Drücke {{KEY|Esc}} oder die {{Button|Cancel}} Schaltfläche, um den aktuellen Befehl abzubrechen.
</div>

{{Emphasis|Note:}} if a Link array is created, this object cannot be converted to a regular array. And similarly, a regular array cannot be converted to a Link array. Therefore, you must choose the type of array that you want at creation time.


==Eigenschaften==
==Eigenschaften==


<div class="mw-translate-fuzzy">
Ein [[Draft_PolarArray/de|Anordnungs]] Objekt basiert auf [[Part_Feature/de|Part Formelement]] ({{incode|Part::Feature}} Klasse), und teilt somit alle Eigenschaften der letzteren. Zusätzlich zu den unter [[Part_Feature/de|Part Formelement]] aufgeführten Eigenschaften verfügt das Anordnungsobjekt über weitere Eigenschaften.
Ein [[Draft_PolarArray/de|Anordnungs]] Objekt basiert auf [[Part_Feature/de|Part Formelement]] ({{incode|Part::Feature}} Klasse), und teilt somit alle Eigenschaften der letzteren. Zusätzlich zu den unter [[Part_Feature/de|Part Formelement]] aufgeführten Eigenschaften verfügt das Anordnungsobjekt über weitere Eigenschaften.
</div>


<div class="mw-translate-fuzzy">
Siehe das {{Button|[[Image:Draft_Array.svg|16px]] [[Draft_OrthoArray|OrthoAnordnung]]}} Werkzeug für die vollständige Information.
Siehe das {{Button|[[Image:Draft_Array.svg|16px]] [[Draft_OrthoArray|OrthoAnordnung]]}} Werkzeug für die vollständige Information.
</div>


== Skripten==
== Skripten==
Line 62: Line 82:
{{Emphasis|Siehe auch:}} [[Draft API/de|Draft API]] und [[FreeCAD Scripting Basics/de|FreeCAD Grundlagen Skripten]].
{{Emphasis|Siehe auch:}} [[Draft API/de|Draft API]] und [[FreeCAD Scripting Basics/de|FreeCAD Grundlagen Skripten]].


<div class="mw-translate-fuzzy">
Das Anordnungswerkzeug kann in [[macros/de|Makros]] und von der [[Python/de|Python]] Konsole aus mit folgender Funktion verwendet werden:
Das Anordnungswerkzeug kann in [[macros/de|Makros]] und von der [[Python/de|Python]] Konsole aus mit folgender Funktion verwendet werden:
</div>


Older call:
{{Code|code=
{{Code|code=
array_list = make_polar_array(obj, center, angle, number, use_link)
array = makeArray(baseobject, center, totalangle, totalnum, use_link=False)
}}
}}


New call:
{{Code|code=
array = make_polar_array(base_object,
number=5, angle=360, center=App.Vector(0, 0, 0),
use_link=True)
}}

<div class="mw-translate-fuzzy">
* Erstellt eine Anordnung aus den in {{incode|obj}} enthaltenen Objekten, die ein einzelnes Objekt oder eine Liste von Objekten sein kann.
* Erstellt eine Anordnung aus den in {{incode|obj}} enthaltenen Objekten, die ein einzelnes Objekt oder eine Liste von Objekten sein kann.
* Der Wert von {{incode|center}} ist ein Vektor, der den Mittelpunkt des Anordnungkreises definiert; {{incode|angle}} ist der Winkel des Bogens in Grad, und {{incode|number}} ist die Anzahl der Kopien im Kreismuster, einschließlich des Originalobjekts.
* Der Wert von {{incode|center}} ist ein Vektor, der den Mittelpunkt des Anordnungkreises definiert; {{incode|angle}} ist der Winkel des Bogens in Grad, und {{incode|number}} ist die Anzahl der Kopien im Kreismuster, einschließlich des Originalobjekts.
Line 73: Line 104:
* {{incode|array_list}} wird mit den neuen Kopien zurückgegeben.
* {{incode|array_list}} wird mit den neuen Kopien zurückgegeben.
** {{incode|array_list}} ist entweder ein einzelnes Objekt oder eine Liste von Objekten, abhängig von der Eingabe {{incode|obj}}.
** {{incode|array_list}} ist entweder ein einzelnes Objekt oder eine Liste von Objekten, abhängig von der Eingabe {{incode|obj}}.
</div>


Beispiel:
Beispiel:
Line 78: Line 110:
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()
}}

== Scripting, non-parametric array ==

When using the {{Button|[[Image:Draft_PolarArray.svg|16px]] [[Draft_PolarArray|PolarArray]]}} tool, a parametric {{incode|"Array"}} object is created. This can be scripted as described in the previous section.

However, to obtain standalone copies of the base object, the simple {{incode|Draft.array}} function can be used. This will create simple copies, not a new parametric object.

To create a polar array, use it like this:
{{Code|code=
array_list = array(objectslist, center, angle, number)
}}

* Creates an array from the objects contained in {{incode|objectslist}}, which can be a single object or a list of objects.
** In case of a polar array, {{incode|center}} defines the center of the array circle, {{incode|angle}} is the angle of the arc in degrees to cover with copies, and {{incode|number}} is the number of copies to arrange on the circular arc, not including the original object.
** {{incode|array_list}} is returned with the new copies. It is either a single object or a list of objects, depending on the input {{incode|objectslist}}.

This function internally uses {{incode|Draft.rotate()}} with <code>copy=True</code>.

Example:

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

doc = App.newDocument()

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

array_list = Draft.array(tri, center, 180, 5)
doc.recompute()
}}
}}



Revision as of 20:48, 1 July 2020

Draft PolarAnordnung

Menüeintrag
Entwurf → Polare Anordnung
Arbeitsbereich
Entwurf
Standardtastenkürzel
Keiner
Eingeführt in Version
0.19
Siehe auch
Anordnung, KreisAnordnung, PfadAnordnung, Punkt Anordnung, Klonen

Beschreibung

Das Entwurf PolarAnordnung Werkzeug erstellt eine Anordnung aus einem ausgewählten Objekt und platziert die Kopien entlang eines Umfangs.

Dieses Werkzeug kann für 2D Formen verwendet werden, die mit dem Entwurf Arbeitsbereich erstellt wurden, aber auch für viele Arten von 3D Objekten, wie sie mit der Part Arbeitsbereich oder PartDesign Arbeitsbereich erstellt wurden.

Zum Positionieren von Kopien in einem rechteckigen Raster verwende Array; zum Positionieren in einem kreisförmigen Muster verwende KreisAnordnung; um Kopien entlang eines Pfades zu positionieren, verwende PfadAnordnung; um Kopien an bestimmten Punkten zu positionieren, verwende PunktAnordnung; um Kopien oder Klone zu erstellen und manuell zu platzieren, verwende Bewegen, Drehen und Klonen.

Eine polar Anordnung eines Objekts.

Anwendung

  1. Wähleein Objekt aus, von dem du die Polaranordnung erstellen möchtest.
  2. Drücke die Polar Anordnung Schaltfläche. Wenn kein Objekt ausgewählt ist, wird das Aufgabenpaneel geöffnet, aber du musst trotzdem ein Objekt auswählen, um fortzufahren.
  3. Wähle den Polarwinkel, der bestimmt, wo sich das letzte Element der Anordnung befindet.
  4. Wähle die Anzahl der Elemente in der Anordnung. Minimum von 2, Maximum von 99.
  5. Wähle das Zentrum der Rotationsachse. Du kannst auf die 3D Ansicht klicken, um gleichzeitig die Position des Rotationszentrums festzulegen und den Befehl abzuschließen.
  6. Optional hake die verschmelzungs- oder Verknüpfungsoptionen an.
  7. Drücke OK, um den Befehl abzuschließen.

Hinweise:

  • Standardmäßig ist die Rotationsachse die positive Z Achse (0, 0, 1). Dies kann im Eigenschaftseditor geändert werden, nachdem das Objekt erzeugt wurde.
  • 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 Anordnung und KreisAnordnung Werkzeugen erstellt wurde. Daher kann die Anordnung einfach durch Ändern seiner Eigenschaften in orthogonal, polar oder zirkular umgewandelt werden.

Optionen

These are the options displayed in the task panel.

  • Drücke Reset point um das Drehzentrum auf den Ursprung zu setzen (0, 0, 0).
  • Wenn das Kontrollkästchen Fuse aktiviert ist, werden die resultierenden Objekte in der Anordnung zu einer einzigen Form verschmolzen, wenn sie einander berühren oder schneiden.
  • Wenn das Kontrollkästchen Use Links markiert ist, werden die resultierenden Objekte in der Anordnung nicht als einfache Kopien, sondern als App Verknüpfungen erstellt. Dies verbessert die Speichernutzung der Anordnung, da die App Verknüpfung die Form des Originalobjekts wiederverwendet und keine neuen Formen erstellt. Wenn diese Option verwendet wird, hat das Fuse Kontrollkästchen keine Wirkung.
  • Drücke Esc oder die Cancel Schaltfläche, um den aktuellen Befehl abzubrechen.

Note: if a Link array is created, this object cannot be converted to a regular array. And similarly, a regular array cannot be converted to a Link array. Therefore, you must choose the type of array that you want at creation time.

Eigenschaften

Ein Anordnungs Objekt basiert auf Part Formelement (Part::Feature Klasse), und teilt somit alle Eigenschaften der letzteren. Zusätzlich zu den unter Part Formelement aufgeführten Eigenschaften verfügt das Anordnungsobjekt über weitere Eigenschaften.

Siehe das OrthoAnordnung Werkzeug für die vollständige Information.

Skripten

Siehe auch: Draft API und FreeCAD Grundlagen Skripten.

Das Anordnungswerkzeug kann in Makros und von der Python Konsole aus mit folgender Funktion verwendet werden:

Older call:

array = makeArray(baseobject, center, totalangle, totalnum, use_link=False)

New call:

array = make_polar_array(base_object,
                         number=5, angle=360, center=App.Vector(0, 0, 0),
                         use_link=True)
  • Erstellt eine Anordnung aus den in obj enthaltenen Objekten, die ein einzelnes Objekt oder eine Liste von Objekten sein kann.
  • Der Wert von center ist ein Vektor, der den Mittelpunkt des Anordnungkreises definiert; angle ist der Winkel des Bogens in Grad, und number ist die Anzahl der Kopien im Kreismuster, einschließlich des Originalobjekts.
  • Wenn use_link true ist, handelt es sich bei den erstellten Kopien um App Verknüpfungen und nicht um reguläre Kopien.
  • array_list wird mit den neuen Kopien zurückgegeben.
    • array_list ist entweder ein einzelnes Objekt oder eine Liste von Objekten, abhängig von der Eingabe obj.

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()

Scripting, non-parametric array

When using the PolarArray tool, a parametric "Array" object is created. This can be scripted as described in the previous section.

However, to obtain standalone copies of the base object, the simple Draft.array function can be used. This will create simple copies, not a new parametric object.

To create a polar array, use it like this:

array_list = array(objectslist, center, angle, number)
  • Creates an array from the objects contained in objectslist, which can be a single object or a list of objects.
    • In case of a polar array, center defines the center of the array circle, angle is the angle of the arc in degrees to cover with copies, and number is the number of copies to arrange on the circular arc, not including the original object.
    • array_list is returned with the new copies. It is either a single object or a list of objects, depending on the input objectslist.

This function internally uses Draft.rotate() with copy=True.

Example:

import FreeCAD as App
import Draft

doc = App.newDocument()

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

array_list = Draft.array(tri, center, 180, 5)
doc.recompute()