Draft PointArray/it: Difference between revisions

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

{{Docnav/it
{{Docnav/it
|[[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]]
|[[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
}}
}}


<div class="mw-translate-fuzzy">
{{GuiCommand/it
{{GuiCommand/it
|Name=Draft PointArray
|Name=Draft_PointArray
|Name/it=Serie 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 → Serie 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|Serie]], [[Draft PathArray/it|Serie su tracciato]]
}}
}}
</div>


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

Per posizionare le copie in una schiera ortogonale usare [[Draft Array/it|Serie]]; per posizionare le copie su un percorso, utilizzare [[Draft PathArray/it|Serie 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]].
</div>


[[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>
==Utilizzo==
==Utilizzo==


# 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|Serie 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>
Ogni elemento della serie è un clone esatto dell'oggetto originale, ma l'intera serie è considerata una singola unità in termini di proprietà e aspetto.
== Oggetto punto versione 0.20 e precedenti ==


Questi sono gli oggetti punto supportati in {{VersionMinus/it|0.20}} e come possono essere creati:
=== Composto di punti ===
* [[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>
L'oggetto composto di punti può essere creato in diversi modi.
== Proprietà ==
* 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]]}}, epoi premere {{Button|[[File:Part_Compound.svg|16px]] [[Part_Compound/it|Crea un composto]]}} per creare il composto .
* Creare i punti il metodo precedente ma invece di creare un composto usare {{Button|[[Image:Draft_Upgrade.svg|16px]] [[Draft_Upgrade/it|Upgrade]]}} per creare un "Blocco".
* Crea uno {{Button|[[File:Sketcher_NewSketch.svg|16px]] [[Sketch/it|Schizzo]]}}, e dentro aggiungere vari punti.


Vedere anche: [[Property_editor/it|Editor delle proprietà]].
In essence, the object to be used as the compound must have one of three properties, {{PropertyData|Components}}, {{PropertyData|Links}}, or {{PropertyData|Geometry}}, and inside that compound, there must be at least one point with {{PropertyData|X}}, {{PropertyData|Y}}, and {{PropertyData|Z}} properties.


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:
{{Emphasis|Note:}} in the case of {{Button|[[File:Draft_Point.svg|16px]] [[Draft_Point|Draft Point]]}} and {{Button|[[File:Part_Point.svg|16px]] [[Part_Point|Part Point]]}} the array will try to position the copies using the {{PropertyData|Placement}} of the point. In the case of a {{Button|[[File:Sketcher_CreatePoint.svg|16px]] [[Sketcher_CreatePoint|Sketcher Point]]}}, the position will be taken from its internal {{incode|X}}, {{incode|Y}}, and {{incode|Z}} attributes.


===Data===
{{Emphasis|Note 2:}} for {{Button|[[File:Draft_Point.svg|16px]] [[Draft_Point|Draft Point]]}} its {{PropertyData|Placement}} always follows the values of {{PropertyData|X}}, {{PropertyData|Y}}, {{PropertyData|Z}}, so modifying these values is enough to produce the desired displacement. However, for {{Button|[[File:Part_Point.svg|16px]] [[Part_Point|Part Point]]}}, the net displacement is given by the sum of {{PropertyData|Placement}} with the vector with components {{PropertyData|X}}, {{PropertyData|Y}}, and {{PropertyData|Z}}.


{{TitleProperty|Link}}
== Opzioni ==


Le proprietà in questo gruppo sono disponibili solo per le serie di link. Vedere [[Std_LinkMake/it#Proprietà|Crea link]] per ulteriori informazioni.
Non ci sono opzioni per questo strumento. O funziona con l'oggetto selezionato o non funziona.


* {{PropertyData|Scale|Float}}
== Proprietà ==
* {{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}}
A [[Draft_PointArray|PointArray]] is derived from a [[Part_Feature|Part Feature]] ({{incode|Part::Feature}} class), therefore it shares all the latter's properties. In addition to the properties described in [[Part_Feature|Part Feature]], the PointArray has the following properties in the [[property editor|property editor]].


<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 Compound/it|Crea composto di Part]] (attributo {{PropertyData|Links}} ) o con [[Draft Upgrade/it|Promuovi di Draft]] (attributo {{PropertyData|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}}
Lo strumento PointArray può essere utilizzato nelle [[macros/it|macro]] e dalla [[Python/it|console di Python]] tramite la seguente funzione:


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.
Older call

{{Code|code=
* {{PropertyView|Draw Style|Enumeration}}
point_array = makePointArray(base_object, point_object)
* {{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}}.


New call
{{Code|code=
{{Code|code=
point_array = make_point_array(base_object, point_object, extra=None):
point_array = make_point_array(base_object, point_object, extra=None, use_link=True)
}}
}}


* {{incode|base_object}} è l'oggetto da disporre in serie. Può anche essere la {{incode|Label}} (string) di un oggetto nel documento corrente.
<div class="mw-translate-fuzzy">
* Crea un oggetto {{incode|PointArray}} dall'oggetto base {{incode|base}}, posizionando le copie sulla {{incode|ptlst}}.
* {{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|ptlst}} è un oggetto con gli attributi {{incode|Geometry}}, {{incode|Links}}, o {{incode|Components}} che definisce la posizione delle copie.
* {{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.
</div>

Esempio:


Esempio:
{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App
Line 110: Line 162:
doc.recompute()
doc.recompute()
}}
}}



{{Docnav/it
{{Docnav/it
|[[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]]
|[[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()