Draft Array/it: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
(30 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/it
{{Docnav/it|[[Draft_Draft2Sketch/it|Da Draft a Sketch]]|[[Draft_PathArray/it|Schiera su tracciato]]|[[Draft_Module/it|Draft]]|IconL=Draft_Draft2Sketch.svg|IconC=Workbench_Draft.svg|IconR=Draft_PathArray.svg}}
|[[Draft_Draft2Sketch/it|Da Draft a Sketch]]
|[[Draft_LinkArray/it|Link Array]]
|[[Draft_Module/it|Draft]]
|IconL=Draft_Draft2Sketch.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_LinkArray.svg
}}


<div class="mw-translate-fuzzy">
{{GuiCommand/it|Name=Draft_Array|Name/it=Matrice|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Architettura]]|MenuLocation=Draft → Matrice|SeeAlso=[[Draft PathArray/it|Schiera su tracciato]], [[Draft PointArray/it|Schiera su punti]], [[Draft Clone/it|Clone]]}}
{{GuiCommand/it
|Name=Draft_Array
|Name/it=Schiera
|Workbenches=[[Draft Module/it|Draft]], [[Arch Module/it|Architettura]]
|MenuLocation=Draft → Schiera
|SeeAlso=[[Draft PathArray/it|Copie su tracciato]], [[Draft PointArray/it|Copie su punti]], [[Draft Clone/it|Clone]]
}}
</div>


<div class="mw-translate-fuzzy">
==Descrizione==
==Descrizione==
Lo strumento Matrice crea una schiera (array) ortogonale (3 assi) o polare utilizzando gli oggetti selezionati.
Lo strumento Schiera crea una schiera (array) ortogonale (3 assi) o polare utilizzando gli oggetti selezionati.
</div>


The [[Draft_Array|Draft Array]] tool creates an orthogonal (3-axes), polar, or circular array from a selected object.

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


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


To create [[App_Link|App Links]] instead of simple copies, use [[Draft_LinkArray|LinkArray]], [[Draft_PathLinkArray|Path LinkArray]], and the proper option with [[Draft_PolarArray|PolarArray]] and [[Draft_CircularArray|CircularArray]] .
[[Image:Draft_Array_example.jpg|400px]]

[[File:Draft_Array_example.png|x300px]] [[File:Draft_PolarArray_example.png|x300px]]
<div class="mw-translate-fuzzy">
{{Caption|Una schiera ortogonale e una schiera polare da un oggetto solido}}
{{Caption|Una schiera ortogonale e una schiera polare da un oggetto solido}}
</div>

<div class="mw-translate-fuzzy">
[[Image:Draft_CircularArray_example.png|200px]]
</div>

<div class="mw-translate-fuzzy">
{{Caption|Una matrice circolare da un oggetto solido, l'oggetto al centro}}
</div>


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


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


== Opzioni ==
== Opzioni ==
Line 25: Line 60:
Non ci sono opzioni per questo strumento. O funziona con l'oggetto selezionato o non funziona.
Non ci sono opzioni per questo strumento. O funziona con l'oggetto selezionato o non funziona.


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


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


Per le schiere polari:
Per le schiere polari:
* {{PropertyData|Axis}}: specifica la direzione normale del cerchio della schiera.
* {{PropertyData/it|Axis}}: specifica la direzione normale del cerchio della schiera.
* {{PropertyData|Center}}: specifica il punto centrale del cerchio della schiera.
* {{PropertyData/it|Center}}: specifica il punto centrale del cerchio della schiera.
* {{PropertyData|Angle}}: specifica l'apertura dell'arco circolare da coprire con le copie; usare 360 per coprire un intero cerchio.
* {{PropertyData/it|Angle}}: specifica l'apertura dell'arco circolare da coprire con le copie; usare 360 per coprire un intero cerchio.
* {{PropertyData|Number Polar}}: specifica il numero di copie da inserire nella disposizione circolare.
* {{PropertyData/it|Number Polar}}: specifica il numero di copie da inserire nella disposizione circolare.
* {{PropertyData|Interval Axis}}: specifica l'intervallo tra ciascuna copia nella direzione {{PropertyData|Axis}}.
* {{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.
Le proprietà Number, X, Y, Z o Polar, includono anche l'oggetto originale, quindi questo numero è almeno uno.
Line 49: Line 92:
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.
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.


For example, if {{PropertyData|Interval X}} is (2 m, 1 m, 1 m), and {{PropertyData|Number X}} is 3, it will create 3 copies in the X direction; the first copy will be at the original position, the second will be displaced 2 m on X, 1 m on Y, and 1 m on Z; the third copy will be displaced 4 m on X, 2 m on Y, and 2 m on Z. Each array element will be moved slightly to one side (Y direction) and up (Z direction) beside the main X direction.
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.


The {{PropertyData|Interval Axis}} property works in the same way. If the original shape lies on the XY plane, creating a polar array with {{PropertyData|Interval Axis}} (0, 0, z) allows you to make spiral arrangements.
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.


==Script==
==Script==
Line 60: Line 103:
=== Schiera semplice ===
=== Schiera semplice ===
La firma di base è la seguente:
La firma di base è la seguente:

{{Code|code=
{{Code|code=
array_list = array(objectslist, arg1, arg2, arg3, arg4=None, arg5=None, arg6=None)
array_list = array(objectslist, arg1, arg2, arg3, arg4=None, arg5=None, arg6=None)
Line 65: Line 109:


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

{{Code|code=
{{Code|code=
array_list = array(objectslist, xvector, yvector, xnum, ynum)
array_list = array(objectslist, xvector, yvector, xnum, ynum)
Line 71: Line 116:


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

{{Code|code=
{{Code|code=
array_list = array(objectslist, center, totalangle, totalnum)
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.
<div class="mw-translate-fuzzy">
* 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.
* Crea una schiera di oggetti contenuti nella lista (che può essere di un oggetto o di un elenco di oggetti) con, in caso di matrice rettangolare, xnum di iterazioni nella direzione x, alla distanza xvector tra le iterazioni, e lo stesso per la direzione y, con yvector e ynum, e lo stesso vale per la direzione z con zvector e znum se viene usata tale versione. Nel caso di una serie polare, il centro è un vettore, totalangle è l'angolo a coprire (in gradi) e totalnum è il numero di oggetti, compreso l'originale.
* 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.
* Questa funzione produce copie indipendenti dell'oggetto(i) di base.
* {{incode|array_list}} viene restituito con le nuove copie.
</div>
** {{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>.
Questa funzione utilizza internamente {{incode|Draft.move()}} e {{incode|Draft.rotate()}} con <code>copy=True</code>.


Esempio:
Esempio:

{{Code|code=
{{Code|code=
import FreeCAD, Draft
import FreeCAD, Draft
Line 94: Line 142:


La firma di base è la seguente:
La firma di base è la seguente:

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


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

{{Code|code=
{{Code|code=
Array = makeArray(baseobject, xvector, yvector, xnum, ynum, name="Array")
Array = makeArray(baseobject, xvector, yvector, xnum, ynum, name="Array")
Line 105: Line 155:


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

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


* Crea un oggetto {{incode|Array}} dal {{incode|baseobject}} dato.
<div class="mw-translate-fuzzy">
* 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.
* Crea una schiera dall'oggetto dato con, in caso di matrice rettangolare, xnum di iterazioni nella direzione x alla distanza xvector tra le iterazioni, e lo stesso per la direzione y con yvector e ynum, e lo stesso vale per la direzione z con zvector e znum se viene usata tale versione. In caso di serie polare, il centro è un vettore, totalangle è l'angolo a coprire (in gradi) e totalnum è il numero di oggetti, compreso l'originale.
* 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.
* Il risultato di questa funzione è un oggetto Draft Array parametrico.
</div>


Esempio:
Esempio:
Line 128: Line 178:
}}
}}


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


{{Draft Tools navi/it}}
{{Draft Tools navi/it}}


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

{{clear}}
{{clear}}

Revision as of 09:22, 17 January 2020

Schiera

Posizione nel menu
Draft → Schiera
Ambiente
Draft, Architettura
Avvio veloce
Nessuno
Introdotto nella versione
-
Vedere anche
Copie su tracciato, Copie su punti, Clone

Descrizione

Lo strumento Schiera crea una schiera (array) ortogonale (3 assi) o polare utilizzando gli oggetti selezionati.

The Draft Array tool creates an orthogonal (3-axes), polar, or circular array from a selected object.

Questo strumento può essere utilizzato su forme 2D create con Draft ma può anche essere utilizzato su molti tipi di oggetti 3D come quelli creati con Part o PartDesign.

Per posizionare le copie lungo un percorso utilizzare Schiera su percorso; per posizionare le copie in punti specificati usare Schiera su punti; per creare copie o cloni e posizionarli manualmente usare Sposta, Ruota, e Clona.

To create App Links instead of simple copies, use LinkArray, Path LinkArray, and the proper option with PolarArray and CircularArray .

Una schiera ortogonale e una schiera polare da un oggetto solido

Una matrice circolare da un oggetto solido, l'oggetto al centro

Utilizzo

  1. Selezionare un oggetto con cui si desidera creare una schiera.
  2. Premere il pulsante Schiera. Se nessun oggetto è selezionato, si viene invitati a selezionarne uno.
  3. L'oggetto Array viene creato immediatamente. È necessario modificare le proprietà della schiera per modificare il numero e la direzione delle copie create.

Ogni elemento della schiera è un clone esatto dell'oggetto originale, ma l'intera schiera è considerata una singola unità in termini di proprietà e aspetto.

Opzioni

Non ci sono opzioni per questo strumento. O funziona con l'oggetto selezionato o non funziona.

Proprietà

  • DatiBase: specifica l'oggetto da duplicare nella schiera.
  • DatiArray Type: specifica il tipo di schiera da creare "ortho" o "polar".
  • DatiFuse: se è true, e le copie si intersecano tra loro, esse vengono fuse insieme in un'unica forma.

Per le schiere ortogonali:

  • DatiInterval X: intervallo tra ciascuna copia sull'asse X.
  • DatiInterval Y: intervallo tra ciascuna copia sull'asse Y.
  • DatiInterval Z: intervallo tra ciascuna copia sull'asse Z.
  • DatiNumber X: il numero di copie sull'asse X.
  • DatiNumber Y: il numero di copie sull'asse Y.
  • DatiNumber Z: il numero di copie sull'asse Z.

Per le schiere polari:

  • DatiAxis: specifica la direzione normale del cerchio della schiera.
  • DatiCenter: specifica il punto centrale del cerchio della schiera.
  • DatiAngle: specifica l'apertura dell'arco circolare da coprire con le copie; usare 360 per coprire un intero cerchio.
  • DatiNumber Polar: specifica il numero di copie da inserire nella disposizione circolare.
  • DatiInterval Axis: specifica l'intervallo tra ciascuna copia nella direzione DatiAxis.

Per matrice circolare:

  • DatiNumber Circles:
  • DatiRadial distance:
  • DatiSymmetry:
  • DatiTangential 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 DatiInterval X è (2 m, 1 m, 1 m), e DatiNumber 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.

La proprietà DatiInterval Axis funziona allo stesso modo. Se la forma originale si trova sul piano XY, creando un array polare con DatiInterval Axis (0, 0, z) permette di creare ordinamenti a spirale.

Script

Vedere anche: API Arch e Script di base per FreeCAD.

Lo strumento Array può essere utilizzato nelle macro e dalla console 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:

array_list = array(objectslist, arg1, arg2, arg3, arg4=None, arg5=None, arg6=None)

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

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:

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

Questa funzione utilizza internamente Draft.move() e Draft.rotate() con copy=True.

Esempio:

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:

Array = makeArray(baseobject, arg1, arg2, arg3, arg4=None, arg5=None, arg6=None, name="Array")

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

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:

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

Esempio:

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)