Draft Array/it: Difference between revisions

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

{{Docnav/it
{{Docnav/it
|
|[[Draft_Draft2Sketch/it|Da Draft a Sketch]]
|
|[[Draft_LinkArray/it|Link Array]]
|[[Draft_Module/it|Draft]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Draft2Sketch.svg
|IconL=
|IconR=
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_LinkArray.svg
}}
}}

{{VeryImportantMessage|QUESTO COMANDO È OBSOLETO<br>
Non è disponibile nella {{VersionPlus/it|0.21}}. Utilizzare piuttosto [[Draft_OrthoArray/it|Serie ortogonale]], [[Draft_PolarArray/it|Serie polare]] o [[Draft_CircularArray/it|Serie circolare]].}}


{{GuiCommand/it
{{GuiCommand/it
|Name=Draft_Array
|Name=Draft Array
|Name/it=Schiera
|Name/it=Serie
|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Architettura]]
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]
|SeeAlso=[[Draft_OrthoArray/it|Serie ortogonale]], [[Draft_PolarArray/it|Serie polare]], [[Draft_CircularArray/it|Serie circolare]]
|MenuLocation=Draft → Schiera
|SeeAlso=[[Draft PathArray/it|Copie su tracciato]], [[Draft PointArray/it|Copie su punti]], [[Draft Clone/it|Clone]]
}}
}}


<span id="Description"></span>
==Descrizione==
==Descrizione==
Lo strumento Schiera crea una schiera (array) ortogonale (3 assi) o polare utilizzando gli oggetti selezionati.


Il comando [[Image:Draft_Array.svg|24px]] '''Draft Array''' crea una serie ortogonale (3 assi) da un oggetto selezionato. La serie creata può essere trasformata in un [[Draft_PolarArray/it|array polare]] o in un [[Draft_CircularArray/it|array circolare]] modificando la sua proprietà {{PropertyData|Array Type}}.
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]].


Il comando può essere utilizzato su oggetti 2D creati con [[Draft_Workbench/it|Draft]] o [[Sketcher_Workbench/it|Sketcher]], ma anche su molti oggetti 3D come quelli creati con [[Part_Workbench/it|Part]], [[PartDesign_Workbench/it|PartDesign]] o [[Arch_Workbench/it|Arch]].
Per posizionare le copie lungo un percorso utilizzare [[Draft PathArray/it|Schiera su percorso]]; per posizionare le copie in punti specificati usare [[Draft PointArray/it|Schiera su punti]]; per creare copie o cloni e posizionarli manualmente usare [[Draft Move/it|Sposta]], [[Draft Rotate/it|Ruota]], e [[Draft Clone/it|Clona]].


Questo comando è ormai obsoleto. Utilizzare invece il comando [[Draft_OrthoArray/it|Serie ortogonale]], [[Draft_PolarArray/it|Serie polare]] o [[Draft_CircularArray/it|Serie circolare]].
[[Image:Draft_Array_example.jpg|400px]]
{{Caption|Una schiera ortogonale e una schiera polare da un oggetto solido}}

Schiera polare introdotta in FreeCAD 0.19

[[Image:Draft_CircularArray_example.png|200px]]

{{Caption|Una matrice circolare da un oggetto solido, l'oggetto al centro}}


<span id="Usage"></span>
==Utilizzo==
==Utilizzo==
# Selezionare un oggetto con cui si desidera creare una schiera.
# Premere il pulsante {{Button|[[Image:Draft Array.svg|16px]] [[Draft Array/it|Schiera]]}}. Se nessun oggetto è selezionato, si viene invitati a selezionarne uno.
# L'oggetto Array viene creato immediatamente. È necessario modificare le proprietà della schiera per modificare il numero e la direzione delle copie create.


# Per utilizzare questo comando in FreeCAD versione 0.19 e successive è necessario aggiungere un pulsante ad una barra degli strumenti personalizzata. Vedere [[Interface_Customization/it|Personalizzazione dell'interfaccia]].
Ogni elemento della schiera è un clone esatto dell'oggetto originale, ma l'intera schiera è considerata una singola unità in termini di proprietà e aspetto.
# Facoltativamente seleziona un oggetto.

# Premere il pulsante {{Button|[[Image:Draft_Array.svg|16px]] [[Draft_Array/it|Serie]]}}.
== Opzioni ==
# Se non si è ancora selezionato un oggetto: selezionare un oggetto.

# La serie viene creata.
Non ci sono opzioni per questo strumento. O funziona con l'oggetto selezionato o non funziona.
# Eventualmente modificarne le [[Draft_OrthoArray/it#Proprietà|proprietà]].


<span id="Properties"></span>
== Proprietà ==
== Proprietà ==
* {{PropertyData/it|Base}}: specifica l'oggetto da duplicare nella schiera.
* {{PropertyData/it|Array Type}}: specifica il tipo di schiera da creare "ortho" o "polar".
* {{PropertyData/it|Fuse}}: se è {{TRUE}}, e le copie si intersecano tra loro, esse vengono fuse insieme in un'unica forma.

Per le schiere ortogonali:
* {{PropertyData/it|Interval X}}: intervallo tra ciascuna copia sull'asse X.
* {{PropertyData/it|Interval Y}}: intervallo tra ciascuna copia sull'asse Y.
* {{PropertyData/it|Interval Z}}: intervallo tra ciascuna copia sull'asse Z.
* {{PropertyData/it|Number X}}: il numero di copie sull'asse X.
* {{PropertyData/it|Number Y}}: il numero di copie sull'asse Y.
* {{PropertyData/it|Number Z}}: il numero di copie sull'asse Z.

Per le schiere polari:
* {{PropertyData/it|Axis}}: specifica la direzione normale del cerchio della schiera.
* {{PropertyData/it|Center}}: specifica il punto centrale del cerchio della schiera.
* {{PropertyData/it|Angle}}: specifica l'apertura dell'arco circolare da coprire con le copie; usare 360 per coprire un intero cerchio.
* {{PropertyData/it|Number Polar}}: specifica il numero di copie da inserire nella disposizione circolare.
* {{PropertyData/it|Interval Axis}}: specifica l'intervallo tra ciascuna copia nella direzione {{PropertyData/it|Axis}}.

Per matrice circolare:
* {{PropertyData/it|Number Circles}}:
* {{PropertyData/it|Radial distance}}:
* {{PropertyData/it|Symmetry}}:
* {{PropertyData/it|Tangential Distance}}:

Le proprietà Number, X, Y, Z o Polar, includono anche l'oggetto originale, quindi questo numero è almeno uno.

Un intervallo non è una semplice distanza, ma è un vettore (x, y, z). Se più di un valore è diverso da zero, la copia viene creata nella direzione principale, ma viene anche spostata nelle altre direzioni diverse da zero.

Per esempio, se {{PropertyData|Interval X}} è (2 m, 1 m, 1 m), e {{PropertyData|Number X}} è 3, vengono create 3 copies nella direzione X; la prima copia è nella posizione originale, la seconda è spostata di 2 m su X, 1 m su Y, e 1 m su Z; la terza copia è spostata di 4 m su X, 2 m su Y, e 2 m su Z. Ogni elemento dell'array è spostato leggermente su un lato (direzione Y) e verso l'alto (direzione Z) accanto alla direzione X principale.


Vedere [[Draft_OrthoArray/it#Proprietà|Serie ortogonale]].
La proprietà {{PropertyData|Interval Axis}} funziona allo stesso modo. Se la forma originale si trova sul piano XY, creando un array polare con {{PropertyData|Interval Axis}} (0, 0, z) permette di creare ordinamenti a spirale.


<span id="Scripting"></span>
==Script==
==Script==
{{Emphasis|Vedere anche:}} [[Arch API/it|API Arch]] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].


Vedere [[Draft_OrthoArray/it#Script|Serie Ortogonale]].
Lo strumento Array può essere utilizzato nelle [[macros/it|macro]] e dalla console [[Python/it|Python]] utilizzando due diverse funzioni, a seconda se si desidera ottenere delle copie autonome del proprio oggetto base o un oggetto array parametrico che rimane collegato all'oggetto originale.


=== Schiera semplice ===
La firma di base è la seguente:

{{Code|code=
array_list = array(objectslist, arg1, arg2, arg3, arg4=None, arg5=None, arg6=None)
}}

Per creare una matrice rettangolare, si usa in questo modo:

{{Code|code=
array_list = array(objectslist, xvector, yvector, xnum, ynum)
array_list = array(objectslist, xvector, yvector, zvector, xnum, ynum, znum)
}}

Per creare un array polare, si usa in questo modo:

{{Code|code=
array_list = array(objectslist, center, totalangle, totalnum)
}}

* Crea una schiera dagli oggetti contenuti in {{incode|objectslist}}, che può essere un singolo oggetto o un elenco di oggetti.
* Nel caso di una sschiera rettangolare, {{incode|xvector}}, {{incode|yvector}}, e {{incode|zvector}} determinano la distanza tra i punti base di ciascuna copia, nelle direzioni X, Y e Z.; e {{incode|xnum}}, {{incode|ynum}}, e {{incode|znum}} sono il numero di copie nella rispettiva direzione.
* Nel caso di una sschiera polae, {{incode|center}} definisce il centro del cerchio della schiera, {{incode|totalangle}} è l'angolo in gradi dell'arco da coprire con le copie, e {{incode|totalnum}} è il numero di copie da disporre attorno al cerchio, incluso l'oggetto originale.
* {{incode|array_list}} viene restituito con le nuove copie.
** {{incode|array_list}} è un singolo oggetto o un elenco di oggetti, a seconda dell'input {{incode|objectslist}}.

Questa funzione utilizza internamente {{incode|Draft.move()}} e {{incode|Draft.rotate()}} con <code>copy=True</code>.

Esempio:

{{Code|code=
import FreeCAD, Draft

Rect = Draft.makeRectangle(1500, 500)

array_list = Draft.array(Rect, FreeCAD.Vector(1600, 0, 0), FreeCAD.Vector(0, 600, 0), 3, 4)
}}

=== Schiera parametrica ===

La firma di base è la seguente:

{{Code|code=
Array = makeArray(baseobject, arg1, arg2, arg3, arg4=None, arg5=None, arg6=None, name="Array")
}}

Per creare una schiera rettangolare, si usa in questo modo:

{{Code|code=
Array = makeArray(baseobject, xvector, yvector, xnum, ynum, name="Array")
Array = makeArray(baseobject, xvector, yvector, zvector, xnum, ynum, znum, name="Array")
}}

Per creare un array polare, si usa in questo modo:

{{Code|code=
Array = makeArray(baseobject, center, totalangle, totalnum, name="Array")
}}

* Crea un oggetto {{incode|Array}} dal {{incode|baseobject}} dato.
* Nel caso di una schiera rettangolare, {{incode|xvector}}, {{incode|yvector}}, e {{incode|zvector}} determinano la distanza tra i punti base di ciascuna copia, nelle direzioni X, Y e Z.; e {{incode|xnum}}, {{incode|ynum}}, e {{incode|znum}} sono il numero di copie nella rispettiva direzione.
* Nel caso di una schiera polare, {{incode|center}} definisce il centro del cerchio della schiera, {{incode|totalangle}} è l'angolo in gradi dell'arco da coprire con le copie, e {{incode|totalnum}} è il numero di copie da disporre attorno al cerchio, incluso l'oggetto originale.

Esempio:
{{Code|code=
import FreeCAD, Draft

Rect = Draft.makeRectangle(1500, 500)
xvector = FreeCAD.Vector(1600, 0, 0)
yvector = FreeCAD.Vector(0, 600, 0)
Array = Draft.makeArray(Rect, xvector, yvector, 3, 4)

Tri = Draft.makePolygon(3, 600)
center = FreeCAD.Vector(-1600, 0, 0)
Array2 = Draft.makeArray(Tri, center, 360, 6)
}}


{{Docnav/it
{{Docnav/it
|
|[[Draft_Draft2Sketch/it|Da Draft a Sketch]]
|
|[[Draft_LinkArray/it|Link Array]]
|[[Draft_Module/it|Draft]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_Draft2Sketch.svg
|IconL=
|IconR=
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_LinkArray.svg
}}
}}


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

{{Userdocnavi/it}}

{{clear}}

Latest revision as of 07:06, 24 December 2023

QUESTO COMANDO È OBSOLETO
Non è disponibile nella versione 0.21 e superiori. Utilizzare piuttosto Serie ortogonale, Serie polare o Serie circolare.

Serie

Posizione nel menu
Nessuno
Ambiente
Draft, Arch
Avvio veloce
Nessuno
Introdotto nella versione
-
Vedere anche
Serie ortogonale, Serie polare, Serie circolare

Descrizione

Il comando Draft Array crea una serie ortogonale (3 assi) da un oggetto selezionato. La serie creata può essere trasformata in un array polare o in un array circolare modificando la sua proprietà DatiArray Type.

Il comando può essere utilizzato su oggetti 2D creati con Draft o Sketcher, ma anche su molti oggetti 3D come quelli creati con Part, PartDesign o Arch.

Questo comando è ormai obsoleto. Utilizzare invece il comando Serie ortogonale, Serie polare o Serie circolare.

Utilizzo

  1. Per utilizzare questo comando in FreeCAD versione 0.19 e successive è necessario aggiungere un pulsante ad una barra degli strumenti personalizzata. Vedere Personalizzazione dell'interfaccia.
  2. Facoltativamente seleziona un oggetto.
  3. Premere il pulsante Serie.
  4. Se non si è ancora selezionato un oggetto: selezionare un oggetto.
  5. La serie viene creata.
  6. Eventualmente modificarne le proprietà.

Proprietà

Vedere Serie ortogonale.

Script

Vedere Serie Ortogonale.