Draft PointArray/de: Difference between revisions

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

{{Docnav/de
{{Docnav/de
|[[Draft_PathLinkArray/de|PfadVerknüpfungsanordnung]]
|[[Draft_PathArray/de|Pfad Anordnung]]
|[[Draft_PointLinkArray/de|PunktVerknüpfungsanordnung]]
|[[Draft_Clone/de|Klonen]]
|[[Draft_Module/de|Entwurf]]
|[[Draft_Workbench/de|Draft]]
|IconL=Draft_PathArray.svg
|IconL=Draft_PathLinkArray.svg
|IconR=Draft_PointLinkArray.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Clone.svg
}}
}}


{{GuiCommand/de
{{GuiCommand/de
|Name=Draft PointArray
|Name=Draft PointArray
|Name/de=Draft PunktAnordnung
|Icon=Draft_PointArray.svg
|MenuLocation=Änderung → Array tools → Punkt-Anordnung
|Workbenches=[[Draft Module/de|Draft]], [[Arch Module/de|Arch]]
|Workbenches=[[Draft_Workbench/de|Draft]], [[Arch_Workbench/de|Arch]]
|MenuLocation=Draft → PointArray
|Version=0.18
|Version=0.18
|SeeAlso=[[Draft_OrthoArray/de|Draft RechtwinkligeAnordnung]], [[Draft_PolarArray/de|Draft PolareAnordnung]], [[Draft_CircularArray/de|Draft KreisAnordnung]], [[Draft_PathArray/de|Draft PfadAnordnung]], [[Draft_PathLinkArray/de|Draft PfadVerknüpfungsanordnung]], [[Draft_PointLinkArray/de|Draft PunktVerknüpfungsanordnung]]
|SeeAlso=[[Draft Array/de|Draft Array]], [[Draft PathArray/de|Draft PathArray]]
}}
}}


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


Der Befehl [[Image:Draft_PointArray.svg|24px]] '''Draft Punkt-Anordnung''' erstellt eine regelmäßige Anordnung aus einem ausgewählten Basisobjekt, indem er Kopien auf den Punkten eines Punktobjekts positioniert. Der Befehl [[Draft_PointLinkArray/de|Draft PunktVerknüpfungsanordnung]] erstellt alternativ eine effizientere Verknüpfungsanordnung ([[App_Link/de|Link]]-Array). Außer der Art der Anordnung die erstellt wird, normale Anordnung oder Verknüpfungsanordnung, ist der Befehl [[Draft_PointLinkArray/de|Draft PunktVerknüpfungsanordnung]] identisch mit diesem Befehl.
Das {{Button|[[Image:Draft_PointArray.svg|16px]] [[Draft PointArray/de|Entwurf PunktAnordnung]]}}Werkzeug platziert Kopien einer ausgewählten Form entlang verschiedener ausgewählter Punkte.


Das PunktAnordnungswerkzeug kann auf 2D Formen verwendet werden, die mit der [[Draft Workbench/de|Draft Arbeitsbereich]] erstellt wurden, aber auch auf vielen Arten von 3D Objekten, wie sie mit der [[Part Workbench/de|Part Arbeitsbereich]], [[PartDesign Workbench/de|PartDesign Arbeitsbereich]], oder [[Arch Workbench/de|Arch Arbeitsbereich]]en erstellt wurden.
Das Basisobjekt kann ein 2D-Objekt sein, das mit den Arbeitsbereichen [[Draft_Workbench/de|Draft]] oder [[Sketcher_Workbench|Sketcher]] erstellt wurde, aber auch ein 3D-Objekt, das mit den Arbeitsbereichen [[Part_Workbench/de|Part]], [[PartDesign_Workbench/de|PartDesign]] oder [[Arch_Workbench/de|Arch]] erstellt wurde.


Das Punktobjekt kann ein beliebiges Objekt mit einer Form und Knotenpunkten sein (einschließlich einem [[Std_Part/de|Std Part]], das ein oder mehrere solcher Objekte enthält), ein [[Mesh_Workbench/de|Netz-Objekt]] oder eine [[Points_Workbench/de|Punktewolke]]. Doppelte Punkte im Punktobjekt werden herausgefiltert. {{Version/de|0.21}}
Um Kopien in einem orthogonalen Feld zu positionieren, verwende [[Draft Array/de|Entwurf Feld]]; um Kopien entlang eines Pfades zu positionieren, verwende [[Draft PathArray/de|Draft PathArray]]; um Kopien oder Klone zu erstellen und sie manuell zu platzieren, verwende [[Draft Move/de|Draft Move]], [[Draft Rotate/de|Draft Rotate]] und [[Draft Clone/de|Draft Clone]].

In {{VersionMinus/de|0.20}} wird nur der Typ Drei-Punkt-Objekt unterstützt, siehe [[#Punkt-Objekt-Version_0.20_und_älter/de|Punkt-Objekt-Version 0.20 und älter]].


[[Image:Draft_PointArray_Example.png|400px]]
[[Image:Draft_PointArray_Example.png|400px]]
{{Caption|An bestimmten Stellen angeordnetes Objekt}}
{{Caption|Draft PunktAnordnung}}


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


# Wähle ein Objekt aus, das Du verteilen möchtest.
# Das Objekt auswählen, das angeordnet werden soll.
# Das Punkt-Objekt zur Auswahl hinzufügen.
# Wähle eine Punktverbindung aus.
# Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
# Drücke die Taste {{Button|[[Bild:Draft_PointArray.svg|16px]]. [[Draft PointArray|Draft PointArray]]}} Taste.
#* Die Schaltfläche {{Button|[[Image:Draft_PointArray.svg|16px]] [[Draft_PointArray/de|Punkt-Anordnung]]}} drücken.
#* Den Menüeintrag {{MenuCommand|Änderung → Anordnungswerkzeuge → [[Image:Draft_PointArray.svg|16px]] Punkt-Anordnung}} auswählen.
# Die Anordnung wird erstellt.
#Wahlweise die [[#Eigenschaften|Eigenschaften]] der Anordnung im [[Property_editor/de|Eigenschafteneditor]] anpassen.


<span id="Point_object_version_0.20_and_below"></span>
Um eine Punktverbindung zu erstellen, wähle verschiedene [[Draft Point|Entfwurfspunkt]]e aus und drücke dann die Taste {{Button|[[Image:Draft Upgrade.svg|16px]]. [[Draft Upgrade|Draft Upgrade]]}} Taste.
==Punkt-Objekt - Version 0.20 und älter==


Dies sind die unterstützten Punktobjekte in {{VersionMinus/de|0.20}} und wie sie erstellt werden können:
Jedes Element in der Anordnung ist ein genauer Klon des ursprünglichen Objekts, aber die gesamte Anordnung wird in Bezug auf Eigenschaften und Aussehen als eine einzige Einheit betrachtet.
* [[Part_Compound/de|Part Verbund]]: Erzeugen einen oder mehrere [[Draft_Point/de|Entwurf Punkte]] oder [[Part_Point/de|Part Punkte]], wähle diese aus und rufe den Befehl [[Part_Compound/de|Part Verbund]] auf.
* Zeichnungsblock: Erzeuge einen oder mehrere [[Draft_Point/de|Entwurf Punkte]] oder [[Part_Point/de|Part Punkte]], markiere diese und rufe den Befehl [[Draft_Upgrade/de|Entwurf Heraufstufen]] auf.
* [[Sketcher_NewSketch/de|Skizzierer Skizze]]: Erstelle eine [[Sketcher_NewSketch/de|Skizze]] und füge der Skizze einen oder mehrere [[Sketcher_CreatePoint/de|Skizzierer Punkte]] hinzu.


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


Siehe auch: [[property_editor/de|Eigenschafteneditor]].
Es gibt keine Optionen für dieses Werkzeug. Entweder funktioniert es mit den ausgewählten Objekten oder nicht.


Eine Punkt-Anordnung (PointArray-Objekt) ist von einem [[Part_Feature/de|Part-Formelement]] abgeleitet und erbt alle seine Eigenschaften (mit Ausnahme einiger Ansicht-Eigenschaften, die nicht an die Verknüpfungsanordnungen vererbt werden). Außerdem sind, wenn nicht anders angegeben, die folgenden zusätzlichen Eigenschaften vorhanden:
==Eigenschaften==


<span id="Data"></span>
* {{PropertyData|Base}}: the object to duplicate.
===Daten===
* {{PropertyData|Count}}: (read-only) specifies the number of copies of the base object. This number will depend on the number of [[Draft Point|Draft Point]]s in the compound.
* {{PropertyData|PointList}}: specifies a compound object with point objects that indicate where the copies of the {{PropertyData|Base}} object will appear.
The compound object needs to have a {{PropertyData|Links}}, {{PropertyData|Componets}}, or {{PropertyData|Geometry}} attribute. Each of the objects inside the compound should be [[Draft Point|Draft Points]] that have {{PropertyData|X}}, {{PropertyData|Y}}, and {{PropertyData|Z}} attributes.
The compounds could be created with [[Part Compound|Part Compound]] ({{PropertyData|Links}} attribute) or with [[Draft Upgrade|Draft Upgrade]] ({{PropertyData|Componets}} attribute).


{{TitleProperty|Link}}
==Scripting==

{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
Die Eigenschaften dieser Gruppe stehen nur für Verknüpfungsanordnungen zur Verfügung. Siehe [[Std_LinkMake/de#Eigenschaften|Std VerknüpfungErstellen]] für weitere Informationen.

* {{PropertyData/de|Scale|Float}}
* {{PropertyData/de|Scale Vector|Vector|Hidden}}
* {{PropertyData/de|Scale List|VectorList}}
* {{PropertyData/de|Visibility List|BoolList|Hidden}}
* {{PropertyData/de|Placement List|PlacementList|Hidden}}
* {{PropertyData/de|Element List|LinkList|Hidden}}
* {{PropertyData/de|_ Link Touched|Bool|Hidden}}
* {{PropertyData/de|_ Child Cache|LinkList|Hidden}}
* {{PropertyData/de|Colored Elements|LinkSubHidden|Hidden}}
* {{PropertyData/de|Link Transform|Bool}}

{{TitleProperty|Objects}}

* {{PropertyData|Base|Link}}: specifies the object to duplicate in the array.
* {{PropertyData|Count|Integer}}: (read-only) specifies the number of elements in the array. This number is determined by the number of points in the {{PropertyData|Point Object}}.
* {{PropertyData|Expand Array|Bool}}: specifies whether to expand the array in the [[Tree_view|Tree view]] to enable the selection of its individual elements. Only available for Link arrays.
* {{PropertyData|Extra Placement|Placement}}: : specifies an additional [[Placement|placement]], translation and rotation, for each element in the array.
* {{PropertyData|Fuse|Bool}}: specifies if overlapping elements in the array are fused or not. Not used for Link arrays. {{Version|0.22}}
* {{PropertyData|Point Object|Link}}: specifies the object whose points are used to position the elements in the array.

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

{{TitleProperty|Link}}

The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.

* {{PropertyView|Draw Style|Enumeration}}
* {{PropertyView|Line Width|FloatConstraint}}
* {{PropertyView|Override Material|Bool}}
* {{PropertyView|Point Size|FloatConstraint}}
* {{PropertyView|Selectable|Bool}}: this is an inherited property that appears in the Selection group for other arrays
* {{PropertyView|Shape Material|Material}}

{{TitleProperty|Base}}

The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.

* {{PropertyView|Child View Provider|PersistentObject|Hidden}}
* {{PropertyView|Material List|MaterialList|Hidden}}
* {{PropertyView|Override Color List|ColorList|Hidden}}
* {{PropertyView|Override Material List|BoolList|Hidden}}
* {{PropertyView|Proxy|PythonObject|Hidden}}: this is an inherited property.

{{TitleProperty|Display Options}}

The properties in this group are inherited properties. See [[Part_Feature#Properties|Part Feature]] for more information.

* {{PropertyView|Bounding Box|Bool}}: this property is not inherited by Link arrays.
* {{PropertyView|Display Mode|Enumeration}}: for Link arrays it can be {{value|Link}} or {{value|ChildView}}. For other arrays it can be: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} or {{value|Points}}
* {{PropertyView|Show In Tree|Bool}}
* {{PropertyView|Visibility|Bool}}

{{TitleProperty|Draft}}

* {{PropertyView|Pattern|Enumeration}}: not used.
* {{PropertyView|Pattern Size|Float}}: not used.

{{TitleProperty|Object style}}

Die Eigenschaften dieser Gruppe werden nicht an Verknüpfungsanordnungen vererbt.

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

Siehe auch: [https://www.freecadweb.org/api Autogenerierte API Dokumentation] und [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]].

Zum Erstellen einer Punktanordnung verwende die Methode {{incode|make_point_array}} ({{Version/de|0.19}}) des Entwurf Moduls. Diese Methode ersetzt die veraltete Methode {{incode|makePointArray}}.


The PointArray tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:
{{Code|code=
{{Code|code=
point_array = make_point_array(base_object, point_object, extra=None, use_link=True)
PointArray = makePointArray(base, ptlst)
}}
}}


* Creates a {{incode|PointArray}} object from the {{incode|base}} object, by placing the copies along {{incode|ptlst}}.
* {{incode|base_object}} is the object to be arrayed. It can also be the {{incode|Label}} (string) of an object in the current document.
* {{incode|ptlst}} is an object with {{incode|Geometry}}, {{incode|Links}}, or {{incode|Components}} attributes that define the position of the copies.
* {{incode|point_object}} is the object containing the points. It can also be the {{incode|Label}} (string) of an object in the current document. It should have a {{incode|Geometry}}, {{incode|Links}}, or {{incode|Components}} property containing points.
* {{incode|extra}} is an {{incode|App.Placement}}, an {{incode|App.Vector}} or an {{incode|App.Rotation}} that displaces each element.
* If {{incode|use_link}} is {{incode|True}} the created elements are [[App_Link|App Links]] instead of regular copies.

Beispiel:


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


doc = App.newDocument()
Polygon = Draft.makePolygon(3, radius=500.0)


p1 = Draft.makePoint(FreeCAD.Vector(1500, 0, 0))
polygon = Draft.make_polygon(3, radius=500.0)
p2 = Draft.makePoint(FreeCAD.Vector(2500, 0, 0))
p3 = Draft.makePoint(FreeCAD.Vector(2000, 1000, 0))


p1 = Draft.make_point(App.Vector(1500, 0, 0))
# Create a compound of points
addList, deleteList = Draft.upgrade([p1, p2, p3])
p2 = Draft.make_point(App.Vector(2500, 0, 0))
p3 = Draft.make_point(App.Vector(2000, 1000, 0))


compound = doc.addObject("Part::Compound", "Compound")
# Extract the compound from the list
compound = addList[0]
compound.Links = [p1, p2, p3]


PointArray = Draft.makePointArray(Polygon, compound)
point_array = Draft.make_point_array(polygon, compound)
doc.recompute()
}}
}}



{{Docnav/de
{{Docnav/de
|[[Draft_PathLinkArray/de|PfadVerknüpfungsanordnung]]
|[[Draft_PathArray/de|Pfad Anordnung]]
|[[Draft_PointLinkArray/de|PunktVerknüpfungsanordnung]]
|[[Draft_Clone/de|Klonen]]
|[[Draft_Module/de|Entwurf]]
|[[Draft_Workbench/de|Draft]]
|IconL=Draft_PathArray.svg
|IconL=Draft_PathLinkArray.svg
|IconR=Draft_PointLinkArray.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Clone.svg
}}
}}


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

Latest revision as of 09:06, 28 March 2024

Draft PunktAnordnung

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

Beschreibung

Der Befehl Draft Punkt-Anordnung erstellt eine regelmäßige Anordnung aus einem ausgewählten Basisobjekt, indem er Kopien auf den Punkten eines Punktobjekts positioniert. Der Befehl Draft PunktVerknüpfungsanordnung erstellt alternativ eine effizientere Verknüpfungsanordnung (Link-Array). Außer der Art der Anordnung die erstellt wird, normale Anordnung oder Verknüpfungsanordnung, ist der Befehl Draft PunktVerknüpfungsanordnung identisch mit diesem Befehl.

Das Basisobjekt kann ein 2D-Objekt sein, das mit den Arbeitsbereichen Draft oder Sketcher erstellt wurde, aber auch ein 3D-Objekt, das mit den Arbeitsbereichen Part, PartDesign oder Arch erstellt wurde.

Das Punktobjekt kann ein beliebiges Objekt mit einer Form und Knotenpunkten sein (einschließlich einem Std Part, das ein oder mehrere solcher Objekte enthält), ein Netz-Objekt oder eine Punktewolke. Doppelte Punkte im Punktobjekt werden herausgefiltert. eingeführt mit Version 0.21

In Version 0.20 und darunter wird nur der Typ Drei-Punkt-Objekt unterstützt, siehe Punkt-Objekt-Version 0.20 und älter.

Draft PunktAnordnung

Anwendung

  1. Das Objekt auswählen, das angeordnet werden soll.
  2. Das Punkt-Objekt zur Auswahl hinzufügen.
  3. Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:
    • Die Schaltfläche Punkt-Anordnung drücken.
    • Den Menüeintrag Änderung → Anordnungswerkzeuge → Punkt-Anordnung auswählen.
  4. Die Anordnung wird erstellt.
  5. Wahlweise die Eigenschaften der Anordnung im Eigenschafteneditor anpassen.

Punkt-Objekt - Version 0.20 und älter

Dies sind die unterstützten Punktobjekte in Version 0.20 und darunter und wie sie erstellt werden können:

Eigenschaften

Siehe auch: Eigenschafteneditor.

Eine Punkt-Anordnung (PointArray-Objekt) ist von einem Part-Formelement abgeleitet und erbt alle seine Eigenschaften (mit Ausnahme einiger Ansicht-Eigenschaften, die nicht an die Verknüpfungsanordnungen vererbt werden). Außerdem sind, wenn nicht anders angegeben, die folgenden zusätzlichen Eigenschaften vorhanden:

Daten

Link

Die Eigenschaften dieser Gruppe stehen nur für Verknüpfungsanordnungen zur Verfügung. Siehe Std VerknüpfungErstellen für weitere Informationen.

  • Daten-EigenschaftScale (Float)
  • Daten-Eigenschaft (versteckt)Scale Vector (Vector)
  • Daten-EigenschaftScale List (VectorList)
  • Daten-Eigenschaft (versteckt)Visibility List (BoolList)
  • Daten-Eigenschaft (versteckt)Placement List (PlacementList)
  • Daten-Eigenschaft (versteckt)Element List (LinkList)
  • Daten-Eigenschaft (versteckt)_ Link Touched (Bool)
  • Daten-Eigenschaft (versteckt)_ Child Cache (LinkList)
  • Daten-Eigenschaft (versteckt)Colored Elements (LinkSubHidden)
  • Daten-EigenschaftLink Transform (Bool)

Objects

  • DatenBase (Link): specifies the object to duplicate in the array.
  • DatenCount (Integer): (read-only) specifies the number of elements in the array. This number is determined by the number of points in the DatenPoint Object.
  • DatenExpand Array (Bool): specifies whether to expand the array in the Tree view to enable the selection of its individual elements. Only available for Link arrays.
  • DatenExtra Placement (Placement): : specifies an additional placement, translation and rotation, for each element in the array.
  • DatenFuse (Bool): specifies if overlapping elements in the array are fused or not. Not used for Link arrays. introduced in version 0.22
  • DatenPoint Object (Link): specifies the object whose points are used to position the elements in the array.

Ansicht

Link

The properties in this group, with the exception of the inherited property, are only available for Link arrays. See Std LinkMake for more information.

  • AnsichtDraw Style (Enumeration)
  • AnsichtLine Width (FloatConstraint)
  • AnsichtOverride Material (Bool)
  • AnsichtPoint Size (FloatConstraint)
  • AnsichtSelectable (Bool): this is an inherited property that appears in the Selection group for other arrays
  • AnsichtShape Material (Material)

Base

The properties in this group, with the exception of the inherited property, are only available for Link arrays. See Std LinkMake for more information.

  • Ansicht (Hidden)Child View Provider (PersistentObject)
  • Ansicht (Hidden)Material List (MaterialList)
  • Ansicht (Hidden)Override Color List (ColorList)
  • Ansicht (Hidden)Override Material List (BoolList)
  • Ansicht (Hidden)Proxy (PythonObject): this is an inherited property.

Display Options

The properties in this group are inherited properties. See Part Feature for more information.

  • AnsichtBounding Box (Bool): this property is not inherited by Link arrays.
  • AnsichtDisplay Mode (Enumeration): for Link arrays it can be Link or ChildView. For other arrays it can be: Flat Lines, Shaded, Wireframe or Points
  • AnsichtShow In Tree (Bool)
  • AnsichtVisibility (Bool)

Draft

  • AnsichtPattern (Enumeration): not used.
  • AnsichtPattern Size (Float): not used.

Object style

Die Eigenschaften dieser Gruppe werden nicht an Verknüpfungsanordnungen vererbt.

Skripten

Siehe auch: Autogenerierte API Dokumentation und FreeCAD Grundlagen Skripten.

Zum Erstellen einer Punktanordnung verwende die Methode make_point_array (eingeführt mit Version 0.19) des Entwurf Moduls. Diese Methode ersetzt die veraltete Methode makePointArray.

point_array = make_point_array(base_object, point_object, extra=None, use_link=True)
  • base_object is the object to be arrayed. It can also be the Label (string) of an object in the current document.
  • point_object is the object containing the points. It can also be the Label (string) of an object in the current document. It should have a Geometry, Links, or Components property containing points.
  • extra is an App.Placement, an App.Vector or an App.Rotation that displaces each element.
  • If use_link is True the created elements are App Links instead of regular copies.

Beispiel:

import FreeCAD as App
import Draft

doc = App.newDocument()

polygon = Draft.make_polygon(3, radius=500.0)

p1 = Draft.make_point(App.Vector(1500, 0, 0))
p2 = Draft.make_point(App.Vector(2500, 0, 0))
p3 = Draft.make_point(App.Vector(2000, 1000, 0))

compound = doc.addObject("Part::Compound", "Compound")
compound.Links = [p1, p2, p3]

point_array = Draft.make_point_array(polygon, compound)
doc.recompute()