Draft PointArray/it: Difference between revisions

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

<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
{{Docnav/it
{{Docnav/it|[[Draft_PathArray/it|Copie su tracciato]]|[[Draft_Clone/it|Clona]]|[[Draft_Module/it|Draft]]|IconL=Draft_PathArray.svg|IconC=Workbench_Draft.svg|IconR=Draft_Clone.svg}}
|[[Draft_PathArray/it|Serie su tracciato]]
|[[Draft_Clone/it|Clona]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_PathArray.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Clone.svg
}}
</div>
</div>


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
{{GuiCommand/it
{{GuiCommand/it
|Name=Draft PointArray
|Name=Draft_PointArray
|Name/it=Copie su punti
|Name/it=Serie su punti
|Icon=Draft_PointArray.svg
|Icon=Draft_PointArray.svg
|MenuLocation=Modificche → Strumenti serie → Serie su punti
|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Arch]]
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]
|MenuLocation=Draft → Copie su punti
|Version=0.18
|Version=0.18
|SeeAlso=[[Draft_OrthoArray/it|Serie ortogonale]], [[Draft_PolarArray/it|Serie polare]], [[Draft_CircularArray/it|Serie circolare]], [[Draft_PathArray/it|Serie su tracciato]], [[Draft_PathLinkArray/it|Serie di link su tracciato]], [[Draft_PointLinkArray/it|Serie di link su punti]], [[Draft_Clone/it|Clona]]
|SeeAlso=[[Draft Array/it|Schiera]], [[Draft PathArray/it|Copie su tracciato]]
}}
}}
</div>
</div>


==Descrizione==
==Descrizione==

Lo strumento Copie su punti posiziona le copie di una forma selezionata lungo vari punti selezionati.


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Lo strumento [[Image:Draft_PointArray.svg|16px]] Serie su punti posiziona le copie di una forma selezionata lungo vari punti selezionati.
Questo strumento può essere utilizzato su forme 2D create con [[Draft Workbench/it|Draft]] ma può anche essere utilizzato su molti tipi di oggetti 3D come quelli creati con [[Part Workbench/it|Part]] o [[PartDesign Workbench/it|PartDesign]] o [[Arch Workbench/it|Arch]].
</div>
</div>


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Questo strumento può essere utilizzato su qualsiasi oggetto che abbia una [[Part_TopoShape/it|Part TopoShape]], che significa forme 2D create con [[Draft_Workbench/it|Draft]], ma anche solidi 3D creati con altri ambienti, ad esempio [[Part_Workbench/it|Part]], [[PartDesign_Workbench/it|PartDesign]] o [[Arch_Workbench/it|Arch]].
Per posizionare le copie in una schiera ortogonale usare [[Draft Array/it|Matrice]]; per posizionare le copie su un percorso, utilizzare [[Draft PathArray/it|Schiera su percorso]]; per creare copie o cloni e posizionarli manualmente, utilizzare [[Draft Move/it|Sposta]], [[Draft Rotate/it|Ruota]] e [[Draft Clone/it|Clona]].
</div>
</div>


[[Image:Draft_PointArray_Example.png|400px]]
[[Image:Draft_PointArray_Example.png|400px]]
<div class="mw-translate-fuzzy">
{{Caption|Oggetto duplicato in punti specifici}}
{{Caption|Oggetto duplicato in punti specifici}}
</div>


== Utilizzo ==
==Utilizzo==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
# Selezionare un oggetto che si desidera distribuire.
# Selezionare un oggetto che si desidera distribuire.
# Selezionare un composto di punti.
# Selezionare un composto di punti.
# Premere il pulsante {{Button|[[Image:Draft_PointArray.svg|16px]] [[Draft PointArray/it|Copie su punti]]}}.
# Premere il pulsante {{Button|[[Image:Draft_PointArray.svg|16px]] [[Draft PointArray/it|Serie su punti]]}}.
</div>
</div>

==Point compound==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
L'oggetto composto di punti può essere creato in diversi modi.
Per creare un composto punto seleziona vari [[Draft Point/it|Punti]] e poi premere il pulsante {{Button|[[Image:Draft Upgrade.svg|16px]] [[Draft Upgrade/it|Promuovi]]}}.
* Creare vari {{Button|[[File:Draft_Point.svg|16px]] [[Draft_Point/it|punti Draft]]}} o {{Button|[[File:Part_Point.svg|16px]] [[Part_Point/it|punti Part]]}}, e poi premere {{Button|[[File:Part_Compound.svg|16px]] [[Part_Compound/it|Crea un composto]]}} per creare il composto .
* Creare i punti con il metodo precedente ma invece di creare un composto usare {{Button|[[Image:Draft_Upgrade.svg|16px]] [[Draft_Upgrade/it|Upgrade]]}} per creare un "Blocco".
* Creare uno {{Button|[[File:Sketcher_NewSketch.svg|16px]] [[Sketch/it|Schizzo]]}}, e dentro aggiungere vari punti.
</div>
</div>


== Proprietà ==
Ogni elemento dell'array è un clone esatto dell'oggetto originale, ma l'intero array è considerato una singola unità in termini di proprietà e aspetto.


See also: [[property_editor|Property editor]].
== Opzioni ==


A Draft PointArray object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties (with the exception of some View properties that are not inherited by Link arrays). The following properties are additional unless otherwise stated:
Non ci sono opzioni per questo strumento. O funziona con l'oggetto selezionato o non funziona.


== Proprietà ==
===Data===

{{TitleProperty|Link}}

The properties in this group are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.

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

{{TitleProperty|Objects}}


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
{{TitleProperty|Objects}}
* {{PropertyData|Base}}: specifica l'oggetto da duplicare.
* {{PropertyData|Count}}: (sola lettura) specifica il numero di copie dell'oggetto di base. Questo numero dipende dal numero di [[Draft Point/it|Punti]] nel composto.
* {{PropertyData|Base|Link}}: l'oggetto da duplicare; deve avere una [[Part_TopoShape/it|Part TopoShape]].
* {{PropertyData|PointList}}: specifica un oggetto composto da oggetti punto che indicano dove verranno visualizzate le copie dell'oggetto {{PropertyData|Base}}.
* {{PropertyData|Count|Integer}}: (sola lettura) specifica il numero di copie nella serie. Questa proprietà è di sola lettura perché il numero di copie è determinato dal numero di punti all'interno di {{PropertyData|Point Object}}.
* {{PropertyData|Extra Placement|Placement}}: specifica un [[Placement/it|posizionamento]] aggiuntivo, traslazione e rotazione, che verrà applicato a ciascuna copia della serie. Ogni copia appare normalmente con la stessa rotazione dell'oggetto {{PropertyData|Base}}; con questa proprietà è possibile fornire una rotazione aggiuntiva o contrastare la rotazione originale e apportare piccole modifiche alla posizione delle copie. {{Version|0.19}}
L'oggetto composto deve avere un attributo {{PropertyData|Links}}, {{PropertyData|Componets}} o {{PropertyData|Geometry}}. Ciascuno degli oggetti all'interno del composto deve essere un [[Draft Point/it|Punto Draft]] con gli attributi {{PropertyData|X}}, {{PropertyData|Y}} e {{PropertyData|Z}}.
* {{PropertyData|Point Object|Link}}: specifica un oggetto composto di punti che indicano dove verranno visualizzate le copie dell'oggetto {{PropertyData|Base}}. L'oggetto composto deve avere una proprietà {{PropertyData|Links}}, {{PropertyData|Components}}, o {{PropertyData|Geometry}}, e contenere almeno un elemento con gli attributi {{PropertyData|X}}, {{PropertyData|Y}}, e {{PropertyData|Z}}.
I composti possono essere creati con [[Part MakeCompound/it|Crea composto di Part]] (attributo {{PropertyData|Links}} ) o con [[Draft Upgrade/it|Promuovi di Draft]] (attributo {{PropertyData|Componets}}).
</div>
</div>

===View===

{{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}}

The properties in this group are not inherited by Link arrays.

==Scripting==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 65: Line 138:


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Lo strumento PointArray può essere utilizzato nelle [[macros/it|macro]] e dalla [[FreeCAD_Scripting_Basics/it|console di Python]] tramite la seguente funzione:
Lo strumento PointArray può essere utilizzato nelle [[macros/it|macro]] e dalla [[Python/it|console di Python]] tramite la seguente funzione:
</div>
</div>

{{Code|code=
{{Code|code=
point_array = make_point_array(base_object, point_object, extra=None, use_link=True)
PointArray = makePointArray(base, ptlst)
}}
}}


<div class="mw-translate-fuzzy">
* Crea un oggetto {{incode|PointArray}} dall'oggetto base {{incode|base}}, posizionando le copie sulla {{incode|ptlst}}.
* {{incode|ptlst}} è un oggetto con gli attributi {{incode|Geometry}}, {{incode|Links}}, o {{incode|Components}} che definisce la posizione delle copie.
* Crea un oggetto {{incode|"PointArray"}} da un {{incode|base_object}}, posizionando le copie nei punti contenuti all'interno di {{incode|point_object}}.
** {{incode|point_object}} deve avere uno degli attributi {{incode|Geometry}}, {{incode|Links}} o {{incode|Components}} contenenti punti.
** Invece di un riferimento a un oggetto, {{incode|base_object}} e {{incode|point_object}} possono anche essere delle {{incode|Labels}} (stringhe) di oggetti esistenti nel documento corrente.
** {{incode|extra}} può essere un {{incode|App.Placement}} completo o solo un {{incode|App.Vector}} o {{incode|App.Rotation}}.
</div>

Esempio:


Esempio:
{{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()
}}
}}



<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
{{Docnav/it
{{Docnav/it|[[Draft_PathArray/it|Copie su tracciato]]|[[Draft_Clone/it|Clona]]|[[Draft_Module/it|Draft]]|IconL=Draft_PathArray.svg|IconC=Workbench_Draft.svg|IconR=Draft_Clone.svg}}
|[[Draft_PathArray/it|Serie su tracciato]]
|[[Draft_Clone/it|Clona]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_PathArray.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Clone.svg
}}
</div>
</div>


{{Draft Tools navi/it}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

{{Userdocnavi/it}}
{{clear}}

Revision as of 09:46, 4 September 2021

Serie su punti

Posizione nel menu
Modificche → Strumenti serie → Serie su punti
Ambiente
Draft, Arch
Avvio veloce
Nessuno
Introdotto nella versione
0.18
Vedere anche
Serie ortogonale, Serie polare, Serie circolare, Serie su tracciato, Serie di link su tracciato, Serie di link su punti, Clona

Descrizione

Lo strumento Serie su punti posiziona le copie di una forma selezionata lungo vari punti selezionati.

Questo strumento può essere utilizzato su qualsiasi oggetto che abbia una Part TopoShape, che significa forme 2D create con Draft, ma anche solidi 3D creati con altri ambienti, ad esempio Part, PartDesign o Arch.

Oggetto duplicato in punti specifici

Utilizzo

  1. Selezionare un oggetto che si desidera distribuire.
  2. Selezionare un composto di punti.
  3. Premere il pulsante Serie su punti.

Point compound

L'oggetto composto di punti può essere creato in diversi modi.

  • Creare vari punti Draft o punti Part, e poi premere Crea un composto per creare il composto .
  • Creare i punti con il metodo precedente ma invece di creare un composto usare Upgrade per creare un "Blocco".
  • Creare uno Schizzo, e dentro aggiungere vari punti.

Proprietà

See also: Property editor.

A Draft PointArray object is derived from a Part Feature object and inherits all its properties (with the exception of some View properties that are not inherited by Link arrays). The following properties are additional unless otherwise stated:

Data

Link

The properties in this group are only available for Link arrays. See Std LinkMake for more information.

  • DatiScale (Float)
  • Dati (Hidden)Scale Vector (Vector)
  • DatiScale List (VectorList)
  • Dati (Hidden)Visibility List (BoolList)
  • Dati (Hidden)Placement List (PlacementList)
  • Dati (Hidden)Element List (LinkList)
  • Dati (Hidden)_ Link Touched (Bool)
  • Dati (Hidden)_ Child Cache (LinkList)
  • Dati (Hidden)Colored Elements (LinkSubHidden)
  • DatiLink Transform (Bool)

Objects

Objects

  • DatiBase (Link): l'oggetto da duplicare; deve avere una Part TopoShape.
  • DatiCount (Integer): (sola lettura) specifica il numero di copie nella serie. Questa proprietà è di sola lettura perché il numero di copie è determinato dal numero di punti all'interno di DatiPoint Object.
  • DatiExtra Placement (Placement): specifica un posizionamento aggiuntivo, traslazione e rotazione, che verrà applicato a ciascuna copia della serie. Ogni copia appare normalmente con la stessa rotazione dell'oggetto DatiBase; con questa proprietà è possibile fornire una rotazione aggiuntiva o contrastare la rotazione originale e apportare piccole modifiche alla posizione delle copie. introduced in version 0.19
  • DatiPoint Object (Link): specifica un oggetto composto di punti che indicano dove verranno visualizzate le copie dell'oggetto DatiBase. L'oggetto composto deve avere una proprietà DatiLinks, DatiComponents, o DatiGeometry, e contenere almeno un elemento con gli attributi DatiX, DatiY, e DatiZ.

View

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.

  • VistaDraw Style (Enumeration)
  • VistaLine Width (FloatConstraint)
  • VistaOverride Material (Bool)
  • VistaPoint Size (FloatConstraint)
  • VistaSelectable (Bool): this is an inherited property that appears in the Selection group for other arrays
  • VistaShape 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.

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

Display Options

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

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

Draft

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

Object style

The properties in this group are not inherited by Link arrays.

Scripting

Lo strumento PointArray può essere utilizzato nelle macro e dalla console di Python tramite la seguente funzione:

point_array = make_point_array(base_object, point_object, extra=None, use_link=True)
  • Crea un oggetto "PointArray" da un base_object, posizionando le copie nei punti contenuti all'interno di point_object.
    • point_object deve avere uno degli attributi Geometry, Links o Components contenenti punti.
    • Invece di un riferimento a un oggetto, base_object e point_object possono anche essere delle Labels (stringhe) di oggetti esistenti nel documento corrente.
    • extra può essere un App.Placement completo o solo un App.Vector o App.Rotation.

Esempio:

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