Draft PointArray/it: Difference between revisions

From FreeCAD Documentation
(Created page with "* L'array inizia con copie della forma che non sono allineate al percorso, né traslate in una nuova posizione di default. È quindi possibile modificare l'allineamento o il v...")
No edit summary
Tag: Manual revert
 
(107 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/it
|[[Draft_PathLinkArray/it|Serie di link su tracciato]]
|[[Draft_PointLinkArray/it|Serie di link su punti]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_PathLinkArray.svg
|IconR=Draft_PointLinkArray.svg
|IconC=Workbench_Draft.svg
}}

{{GuiCommand/it
{{GuiCommand/it
|Name=Draft PointArray
|Name=Draft_PointArray
|Name/it=Draft PointArray
|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 → PointArray
|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|Array]], [[Draft PathArray/it|PathArray]]
}}
}}


<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 PointArray posiziona le copie di una forma selezionata lungo vari punti selezionati.

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

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|Serie su punti}}


<span id="Usage"></span>
== Utilizzo ==
==Utilizzo==


# Selezionare l'oggetto che si desidera allineare.
# Creare l'oggetto shape che si desidera distribuire. I migliori risultati si ottengono quando l'oggetto è '''centrato sull'origine''', cioè, se la sua {{PropertyData|posizione}} è [0,0,0].
# Aggiungere l'oggetto punto alla selezione.
# Posizionare punti usando [[Draft Point/it|Punto]] di Draft.
# Esistono diversi modi per invocare il comando:
# Selezionare i punti e creare un composto usando [[Draft Upgrade/it|Upgrade]].
# Prima selezionare la forma, poi il nuovo composto di punti, quindi premi il pulsante {{KEY|[[Image:Draft_PointArray.svg|16px]] [[Draft PointArray/it|PointArray]]}}.
#* 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>
== Opzioni ==
== Oggetto punto versione 0.20 e precedenti ==


Questi sono gli oggetti punto supportati in {{VersionMinus/it|0.20}} e come possono essere creati:
* L'array inizia con copie della forma che non sono allineate al percorso, né traslate in una nuova posizione di default. È quindi possibile modificare l'allineamento o il vettore di traslazione nelle proprietà.
* [[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.


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


Vedere anche: [[Property_editor/it|Editor delle proprietà]].
* {{PropertyData|Base}}: The shape object

* {{PropertyData|Count}}: The number of times to copy the shape (read only)
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:
* {{PropertyData|PointList}}: a compound of points

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

* {{PropertyData|Base|Link}}: specifica l'oggetto da duplicare nella serie.
* {{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|Extra Placement|Placement}}: specifica un ulteriore [[Placement/it|posizionamento]], traslazione e rotazione, per ogni elemento nella serie.
* {{PropertyData|Fuse|Bool}}: specifica se gli elementi sovrapposti nell'array sono fusi o meno. Non utilizzato per per le serie di Link. {{Version/it|0.22}}
* {{PropertyData|Point Object|Link}}: specifica l'oggetto i cui punti vengono utilizzati per posizionare gli elementi nella serie.

===View===

{{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==
==Scripting==


Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].
The PointArray tool can be used in [[macros]] and from the [[Python]] console by using the following function:

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


{{Code|code=
{{Code|code=
point_array = make_point_array(base_object, point_object, extra=None, use_link=True)
makePointArray(base, ptlst)
}}
}}
* {{incode|base}} is the shape to copy, and {{incode|ptlst}} is an object with Geometry, Links, or Components that define the position of the copies.


* {{incode|base_object}} è l'oggetto da disporre in serie. Può anche essere la {{incode|Label}} (string) di un oggetto nel documento corrente.
Example:
* {{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:

{{Code|code=
{{Code|code=
import FreeCAD, Draft
import FreeCAD as App
import Draft


doc = App.newDocument()
poly = Draft.makePolygon(3, radius=500.0)

p1 = Draft.makePoint(FreeCAD.Vector(1500, 0, 0))
p2 = Draft.makePoint(FreeCAD.Vector(2500, 0, 0))
polygon = Draft.make_polygon(3, radius=500.0)

p3 = Draft.makePoint(FreeCAD.Vector(2000, 1000, 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()
}}


upg = Draft.upgrade([p1, p2, p3], delete=True)
compound = upg[0][0] # Extract the compound from the list


{{Docnav/it
array = Draft.makePointArray(poly, compound)
|[[Draft_PathLinkArray/it|Serie di link su tracciato]]
|[[Draft_PointLinkArray/it|Serie di link su punti]]
|[[Draft_Workbench/it|Draft]]
|IconL=Draft_PathLinkArray.svg
|IconR=Draft_PointLinkArray.svg
|IconC=Workbench_Draft.svg
}}
}}


{{Draft Tools navi{{#translation:}}}}
==Usage Notes==
{{Userdocnavi{{#translation:}}}}
* {{emphasis|in progress}}

Latest revision as of 20:24, 23 April 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.
  • DatiFuse (Bool): specifica se gli elementi sovrapposti nell'array sono fusi o meno. Non utilizzato per per le serie di Link. disponibile dalla versione 0.22
  • DatiPoint Object (Link): specifica l'oggetto i cui punti vengono utilizzati per posizionare gli elementi nella serie.

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