Draft PointArray/it: Difference between revisions

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

{{Docnav/it
{{Docnav/it
|[[Draft_PathArray/it|Copie su tracciato]]
|[[Draft_PathLinkArray/it|Serie di link su tracciato]]
|[[Draft_PointLinkArray/it|Serie di link su punti]]
|[[Draft_Clone/it|Clona]]
|[[Draft_Module/it|Draft]]
|[[Draft_Workbench/it|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/it
{{GuiCommand/it
|Name=Draft PointArray
|Name=Draft_PointArray
|Name/it=Copie su punti
|Name/it=Serie su punti
|MenuLocation=Modifiche → Strumenti serie → Serie su punti
|Icon=Draft_PointArray.svg
|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]]
|SeeAlso=[[Draft Array/it|Schiera]], [[Draft PathArray/it|Copie su tracciato]]
}}
}}


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


Il comando [[Image:Draft_PointArray.svg|24px]] '''Serie su punti''' crea una serie (array) regolare da un oggetto base selezionato posizionando copie nei punti da un oggetto punto. Utilizzare invece il comando [[Draft_PointLinkArray/it|Serie di link su punti]] per creare una serie [[App_Link/it|Link]] più efficiente. Fatta eccezione per il tipo di matrice creata, Serie di link o Serie normale, il comando [[Draft_PointLinkArray/it|Serie di link su punti]] è identico a questo comando.
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]].
L'oggetto di base può essere un oggetto 2D creato con [[Draft_Workbench/it|Draft]] o [[Sketcher_Workbench/it|Sketcher]], ma anche un oggetto 3D come quelli creati con [[Part_Workbench/it|Part]], [ [PartDesign_Workbench/it|PartDesign]] o [[Arch_Workbench/it|Arch]].


L'oggetto punto può essere qualsiasi oggetto con una forma e vertici (inclusa una [[Std_Part/it|Parte]] contenente uno o più di tali oggetti), così come un [[Mesh_Workbench/it|mesh]] e un [[Points_Workbench/it|nuvola di punti]]. I punti duplicati nell'oggetto punto vengono filtrati. {{Version/it|0.21}}
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]].

In {{VersionMinus/it|0.20}} sono supportati solo tre tipi di oggetto punto, vedere [[#Oggetto punto versione 0.20 e precedenti|Oggetto punto versione 0.20 e precedenti]].


[[Image:Draft_PointArray_Example.png|400px]]
[[Image:Draft_PointArray_Example.png|400px]]
{{Caption|Oggetto duplicato in punti specifici}}
{{Caption|Serie su punti}}


<span id="Usage"></span>
<div class="mw-translate-fuzzy">
== Utilizzo ==
==Utilizzo==
</div>


# Selezionare un oggetto che si desidera distribuire.
# Selezionare l'oggetto che si desidera allineare.
# Aggiungere l'oggetto punto alla selezione.
# Selezionare un composto di punti.
# Esistono diversi modi per invocare il comando:
# 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]]}}.
#* Selezionare l'opzione {{MenuCommand|Modifiche → Strumenti serie→ [[Image:Draft_PointArray.svg|16px]] Serie su punti}} dal menu.
# La serie viene creata.
# Facoltativamente, modificare le [[#Proprietà|proprietà]] della serie nell'[[property_editor/it|Editor delle proprietà]].


<span id="Point_object_version_0.20_and_below"></span>
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]]}}.
== Oggetto punto versione 0.20 e precedenti ==


Questi sono gli oggetti punto supportati in {{VersionMinus/it|0.20}} e come possono essere creati:
Ogni elemento dell'array è un clone esatto dell'oggetto originale, ma l'intero array è considerato una singola unità in termini di proprietà e aspetto.
* [[Part_Compound/it|Part Composto]]: creare uno o più [[Draft_Point/it|Punti Draft]] o [[Part_Point/it|Punti Part]], selezionarli e richiamarli con il comando [[Part_Compound/it|Part Composto]].
* Blocco di Draft: creare uno o più [[Draft_Point/it|Punti Draft]] o [[Part_Point/it|Punti Part]], selezionarli e invocare il comando [[Draft_Upgrade/it|Draft Promuovi]].
* [[Sketcher_NewSketch/it|Sketch]]: Creare uno [[Sketcher_NewSketch/it|Sketch]] e aggiungere uno o più [[Sketcher_CreatePoint/it|Punti Sketch]] allo sketch.


<span id="Properties"></span>
== Opzioni ==
== Proprietà ==


Vedere anche: [[Property_editor/it|Editor delle proprietà]].
Non ci sono opzioni per questo strumento. O funziona con l'oggetto selezionato o non funziona.


Un oggetto Serie su punti è derivato da un oggetto [[Part_Feature/it|Part Feature]] e ne eredita tutte le proprietà (ad eccezione di alcune proprietà View che non sono ereditate da Serie di Link). Le seguenti proprietà sono aggiuntive se non diversamente specificato:
== Proprietà ==

===Data===

{{TitleProperty|Link}}

Le proprietà in questo gruppo sono disponibili solo per le serie di link. Vedere [[Std_LinkMake/it#Proprietà|Crea link]] per ulteriori informazioni.

* {{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">
* {{PropertyData/it|Base}}: specifica l'oggetto da duplicare.
* {{PropertyData|Base|Link}}: specifica l'oggetto da duplicare nella serie.
* {{PropertyData/it|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|Count|Integer}}: (sola lettura) specifica il numero di elementi nella serie. Questo numero è determinato dal numero di punti nel {{PropertyData|Point Object}}.
* {{PropertyData|Expand Array|Bool}}: specifica se espandere la serie nella [[Tree_view/it|Vista ad albero]] per abilitare la selezione dei suoi singoli elementi. Disponibile solo per le serie di Link.
* {{PropertyData/it|PointList}}: specifica un oggetto composto da oggetti punto che indicano dove verranno visualizzate le copie dell'oggetto {{PropertyData/it|Base}}.
* {{PropertyData|Extra Placement|Placement}}: : specifica un ulteriore [[Placement/it|posizionamento]], traslazione e rotazione, per ogni elemento nella serie.
L'oggetto composto deve avere un attributo {{PropertyData/it|Links}}, {{PropertyData/it|Componets}} o {{PropertyData/it|Geometry}}. Ciascuno degli oggetti all'interno del composto deve essere un [[Draft Point/it|Punto Draft]] con gli attributi {{PropertyData/it|X}}, {{PropertyData/it|Y}} e {{PropertyData/it|Z}}.
* {{PropertyData|Point Object|Link}}: specifica l'oggetto composto i cui punti vengono utilizzati per posizionare gli elementi nella serie. L'oggetto deve avere una proprietà {{PropertyData|Links}}, {{PropertyData|Components}} o {{PropertyData|Geometry}} e contenere almeno un elemento con {{PropertyData|X}}, {{PropertyData|Y }} e le proprietà {{PropertyData|Z}}.
I composti possono essere creati con [[Part MakeCompound/it|Crea composto di Part]] (attributo {{PropertyData/it|Links}} ) o con [[Draft Upgrade/it|Promuovi di Draft]] (attributo {{PropertyData/it|Componets}}).
</div>
</div>


== Script ==
===View===

{{Emphasis|Vedere anche:}} [[Draft API/it|Draft API]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].
{{TitleProperty|Link}}

Le proprietà in questo gruppo, ad eccezione della proprietà ereditata, sono disponibili solo per le serie di link. Vedere [[Std_LinkMake/it#Proprietà|Crea link]] per ulteriori informazioni.

* {{PropertyView|Draw Style|Enumeration}}
* {{PropertyView|Line Width|FloatConstraint}}
* {{PropertyView|Override Material|Bool}}
* {{PropertyView|Point Size|FloatConstraint}}
* {{PropertyView|Selectable|Bool}}: questa è una proprietà ereditata che appare nel gruppo Selezione per altre serie
* {{PropertyView|Shape Material|Material}}

{{TitleProperty|Base}}

Le proprietà in questo gruppo, ad eccezione della proprietà ereditata, sono disponibili solo per le serie di link. Vedere [[Std_LinkMake/it#Proprietà|Crea link]] per ulteriori informazioni.

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

Le proprietà in questo gruppo sono proprietà ereditate. Vedere [[Part_Feature#Properties|Part Feature]] per ulteriori informazioni.

* {{PropertyView|Bounding Box|Bool}}: questa proprietà non è ereditata dalle serie di link.
* {{PropertyView|Modalità di visualizzazione|Enumeration}}: per le serie di link può essere {{value|Link}} o {{value|ChildView}}. Per altre serie può essere: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} o {{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}}

Le proprietà in questo gruppo non vengono ereditate dalle serie di link.

==Scripting==

Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].

Per creare una serie di punti usare il metodo {{incode|make_point_array}} ({{Version/it|0.19}}) del modulo Draft. Questo metodo sostituisce il metodo deprecato {{incode|makePointArray}}.


Lo strumento PointArray può essere utilizzato nelle [[macros/it|macro]] e dalla [[Python/it|console di Python]] tramite la seguente funzione:
{{Code|code=
{{Code|code=
point_array = make_point_array(base_object, point_object, extra=None, use_link=True)
PointArray = makePointArray(base, ptlst)
}}
}}


* Crea un oggetto {{incode|PointArray}} dall'oggetto base {{incode|base}}, posizionando le copie sulla {{incode|ptlst}}.
* {{incode|base_object}} è l'oggetto da disporre in serie. Può anche essere la {{incode|Label}} (string) di un oggetto nel documento corrente.
* {{incode|ptlst}} è un oggetto con gli attributi {{incode|Geometry}}, {{incode|Links}}, o {{incode|Components}} che definisce la posizione delle copie.
* {{incode|point_object}} è l'oggetto che contiene i punti. Può anche essere la {{incode|Label}} (string) di un oggetto nel documento corrente. Dovrebbe avere una proprietà {{incode|Geometry}}, {{incode|Links}} o {{incode|Components}} contenente punti.
* {{incode|extra}} è un {{incode|App.Placement}}, un {{incode|App.Vector}} o un {{incode|App.Rotation}} che sposta ogni elemento.
* Se {{incode|use_link}} è {{incode|True}} gli elementi creati sono [[App_Link/it|App Links]] invece di normali copie.

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



{{Docnav/it
{{Docnav/it
|[[Draft_PathArray/it|Copie su tracciato]]
|[[Draft_PathLinkArray/it|Serie di link su tracciato]]
|[[Draft_PointLinkArray/it|Serie di link su punti]]
|[[Draft_Clone/it|Clona]]
|[[Draft_Module/it|Draft]]
|[[Draft_Workbench/it|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

Serie su punti

Posizione nel menu
Modifiche → 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

Descrizione

Il comando Serie su punti crea una serie (array) regolare da un oggetto base selezionato posizionando copie nei punti da un oggetto punto. Utilizzare invece il comando Serie di link su punti per creare una serie Link più efficiente. Fatta eccezione per il tipo di matrice creata, Serie di link o Serie normale, il comando Serie di link su punti è identico a questo comando.

L'oggetto di base può essere un oggetto 2D creato con Draft o Sketcher, ma anche un oggetto 3D come quelli creati con Part, [ [PartDesign_Workbench/it|PartDesign]] o Arch.

L'oggetto punto può essere qualsiasi oggetto con una forma e vertici (inclusa una Parte contenente uno o più di tali oggetti), così come un mesh e un nuvola di punti. I punti duplicati nell'oggetto punto vengono filtrati. disponibile dalla versione 0.21

In versione 0.20 e precedenti sono supportati solo tre tipi di oggetto punto, vedere Oggetto punto versione 0.20 e precedenti.

Serie su punti

Utilizzo

  1. Selezionare l'oggetto che si desidera allineare.
  2. Aggiungere l'oggetto punto alla selezione.
  3. Esistono diversi modi per invocare il comando:
    • Premere il pulsante Serie su punti.
    • Selezionare l'opzione Modifiche → Strumenti serie→ Serie su punti dal menu.
  4. La serie viene creata.
  5. Facoltativamente, modificare le proprietà della serie nell'Editor delle proprietà.

Oggetto punto versione 0.20 e precedenti

Questi sono gli oggetti punto supportati in versione 0.20 e precedenti e come possono essere creati:

Proprietà

Vedere anche: Editor delle proprietà.

Un oggetto Serie su punti è derivato da un oggetto Part Feature e ne eredita tutte le proprietà (ad eccezione di alcune proprietà View che non sono ereditate da Serie di Link). Le seguenti proprietà sono aggiuntive se non diversamente specificato:

Data

Link

Le proprietà in questo gruppo sono disponibili solo per le serie di link. Vedere Crea link per ulteriori informazioni.

  • 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

  • DatiBase (Link): specifica l'oggetto da duplicare nella serie.
  • DatiCount (Integer): (sola lettura) specifica il numero di elementi nella serie. Questo numero è determinato dal numero di punti nel DatiPoint Object.
  • DatiExpand Array (Bool): specifica se espandere la serie nella Vista ad albero per abilitare la selezione dei suoi singoli elementi. Disponibile solo per le serie di Link.
  • DatiExtra Placement (Placement): : specifica un ulteriore posizionamento, traslazione e rotazione, per ogni elemento nella serie.
  • DatiPoint Object (Link): specifica l'oggetto composto i cui punti vengono utilizzati per posizionare gli elementi nella serie. L'oggetto deve avere una proprietà DatiLinks, DatiComponents o DatiGeometry e contenere almeno un elemento con DatiX, DatiY e le proprietà DatiZ.

View

Link

Le proprietà in questo gruppo, ad eccezione della proprietà ereditata, sono disponibili solo per le serie di link. Vedere Crea link per ulteriori informazioni.

  • VistaDraw Style (Enumeration)
  • VistaLine Width (FloatConstraint)
  • VistaOverride Material (Bool)
  • VistaPoint Size (FloatConstraint)
  • VistaSelectable (Bool): questa è una proprietà ereditata che appare nel gruppo Selezione per altre serie
  • VistaShape Material (Material)

Base

Le proprietà in questo gruppo, ad eccezione della proprietà ereditata, sono disponibili solo per le serie di link. Vedere Crea link per ulteriori informazioni.

  • 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

Le proprietà in questo gruppo sono proprietà ereditate. Vedere Part Feature per ulteriori informazioni.

  • VistaBounding Box (Bool): questa proprietà non è ereditata dalle serie di link.
  • VistaModalità di visualizzazione (Enumeration): per le serie di link può essere Link o ChildView. Per altre serie può essere: Flat Lines, Shaded, Wireframe o Points
  • VistaShow In Tree (Bool)
  • VistaVisibility (Bool)

Draft

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

Object style

Le proprietà in questo gruppo non vengono ereditate dalle serie di link.

Scripting

Vedere anche: Autogenerated API documentation e Script di base per FreeCAD.

Per creare una serie di punti usare il metodo make_point_array (disponibile dalla versione 0.19) del modulo Draft. Questo metodo sostituisce il metodo deprecato makePointArray.

point_array = make_point_array(base_object, point_object, extra=None, use_link=True)
  • base_object è l'oggetto da disporre in serie. Può anche essere la Label (string) di un oggetto nel documento corrente.
  • point_object è l'oggetto che contiene i punti. Può anche essere la Label (string) di un oggetto nel documento corrente. Dovrebbe avere una proprietà Geometry, Links o Components contenente punti.
  • extra è un App.Placement, un App.Vector o un App.Rotation che sposta ogni elemento.
  • Se use_link è True gli elementi creati sono App Links invece di normali copie.

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