Draft PointArray/it: Difference between revisions

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


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


<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
|MenuLocation=Modificche → Strumenti serie → Serie su punti
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]
|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]], [[Draft_Clone/it|Clona]]
|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]]
}}
}}
</div>


<span id="Description"></span>
<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.
<div class="mw-translate-fuzzy">
Lo strumento [[Image:Draft_PointArray.svg|16px]] Serie su punti posiziona le copie di una forma selezionata lungo vari punti selezionati.
</div>


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


The point object can be any object with a shape and vertices (including a [[Std_Part|Std Part]] containing one or more of such objects), as well as a [[Mesh_Workbench|mesh]] and a [[Points_Workbench|point cloud]]. Duplicate points in the point object are filtered out. {{Version|0.21}}
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|0.20}} only three point object types are supported see [[#Point_object_version_0.20_and_below|Point object version 0.20 and below]].
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}}
<div class="mw-translate-fuzzy">
{{Caption|Oggetto duplicato in punti specifici}}
</div>


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


# Selezionare l'oggetto che si desidera allineare.
<div class="mw-translate-fuzzy">
# Selezionare un oggetto che si desidera distribuire.
# Aggiungere l'oggetto punto alla selezione.
# Esistono diversi modi per invocare il comando:
# Selezionare un composto di punti.
# 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.
</div>
# 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>
== Point object version 0.20 and below ==
== Oggetto punto versione 0.20 e precedenti ==


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


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


Vedere anche: [[Property_editor/it|Editor delle proprietà]].
See also: [[property_editor|Property editor]].


A Draft PointArray object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties (with the exception of some View properties that are not inherited by Link arrays). The following properties are additional unless otherwise stated:
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:


===Data===
===Data===
Line 73: Line 63:
{{TitleProperty|Link}}
{{TitleProperty|Link}}


The properties in this group are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.
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|Float}}
Line 88: Line 78:
{{TitleProperty|Objects}}
{{TitleProperty|Objects}}


* {{PropertyData|Base|Link}}: specifica l'oggetto da duplicare nella serie.
<div class="mw-translate-fuzzy">
* {{PropertyData|Count|Integer}}: (sola lettura) specifica il numero di elementi nella serie. Questo numero è determinato dal numero di punti nel {{PropertyData|Point Object}}.
{{TitleProperty|Objects}}
* {{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|Base|Link}}: l'oggetto da duplicare; deve avere una [[Part_TopoShape/it|Part TopoShape]].
* {{PropertyData|Extra Placement|Placement}}: specifica un ulteriore [[Placement/it|posizionamento]], traslazione e rotazione, per ogni elemento nella serie.
* {{PropertyData|Count|Integer}}: (sola lettura) specifica il numero di copie nella serie. Questa proprietà è di sola lettura perché il numero di copie è determinato dal numero di punti all'interno di {{PropertyData|Point Object}}.
* {{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|Extra Placement|Placement}}: specifica un [[Placement/it|posizionamento]] aggiuntivo, traslazione e rotazione, che verrà applicato a ciascuna copia della serie. Ogni copia appare normalmente con la stessa rotazione dell'oggetto {{PropertyData|Base}}; con questa proprietà è possibile fornire una rotazione aggiuntiva o contrastare la rotazione originale e apportare piccole modifiche alla posizione delle copie. {{Version|0.19}}
* {{PropertyData|Point Object|Link}}: specifica l'oggetto i cui punti vengono utilizzati per posizionare gli elementi nella serie.
* {{PropertyData|Point Object|Link}}: specifica un oggetto composto di punti che indicano dove verranno visualizzate le copie dell'oggetto {{PropertyData|Base}}. L'oggetto composto deve avere una proprietà {{PropertyData|Links}}, {{PropertyData|Components}}, o {{PropertyData|Geometry}}, e contenere almeno un elemento con gli attributi {{PropertyData|X}}, {{PropertyData|Y}}, e {{PropertyData|Z}}.
</div>


===View===
===View===
Line 100: Line 89:
{{TitleProperty|Link}}
{{TitleProperty|Link}}


The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.
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|Draw Style|Enumeration}}
Line 106: Line 95:
* {{PropertyView|Override Material|Bool}}
* {{PropertyView|Override Material|Bool}}
* {{PropertyView|Point Size|FloatConstraint}}
* {{PropertyView|Point Size|FloatConstraint}}
* {{PropertyView|Selectable|Bool}}: this is an inherited property that appears in the Selection group for other arrays
* {{PropertyView|Selectable|Bool}}: questa è una proprietà ereditata che appare nel gruppo Selezione per altre serie
* {{PropertyView|Shape Material|Material}}
* {{PropertyView|Shape Material|Material}}


{{TitleProperty|Base}}
{{TitleProperty|Base}}


The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.
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|Child View Provider|PersistentObject|Hidden}}
Line 121: Line 110:
{{TitleProperty|Display Options}}
{{TitleProperty|Display Options}}


The properties in this group are inherited properties. See [[Part_Feature#Properties|Part Feature]] for more information.
Le proprietà in questo gruppo sono proprietà ereditate. Vedere [[Part_Feature#Properties|Part Feature]] per ulteriori informazioni.


* {{PropertyView|Bounding Box|Bool}}: this property is not inherited by Link arrays.
* {{PropertyView|Bounding Box|Bool}}: questa proprietà non è ereditata dalle serie di link.
* {{PropertyView|Display Mode|Enumeration}}: for Link arrays it can be {{value|Link}} or {{value|ChildView}}. For other arrays it can be: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} or {{value|Points}}
* {{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|Show In Tree|Bool}}
* {{PropertyView|Visibility|Bool}}
* {{PropertyView|Visibility|Bool}}
Line 135: Line 124:
{{TitleProperty|Object style}}
{{TitleProperty|Object style}}


Le proprietà in questo gruppo non vengono ereditate dalle serie di link.
The properties in this group are not inherited by Link arrays.


==Scripting==
==Scripting==


Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].
<div class="mw-translate-fuzzy">
== Script ==
{{Emphasis|Vedere anche:}} [[Draft API/it|Draft API]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].
</div>


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}}.
<div class="mw-translate-fuzzy">
Lo strumento PointArray può essere utilizzato nelle [[macros/it|macro]] e dalla [[Python/it|console di Python]] tramite la seguente funzione:
</div>


{{Code|code=
{{Code|code=
Line 152: Line 136:
}}
}}


* {{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">
* {{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.
* Crea un oggetto {{incode|"PointArray"}} da un {{incode|base_object}}, posizionando le copie nei punti contenuti all'interno di {{incode|point_object}}.
** {{incode|point_object}} deve avere uno degli attributi {{incode|Geometry}}, {{incode|Links}} o {{incode|Components}} contenenti 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.
** Invece di un riferimento a un oggetto, {{incode|base_object}} e {{incode|point_object}} possono anche essere delle {{incode|Labels}} (stringhe) di oggetti esistenti nel documento corrente.
** {{incode|extra}} può essere un {{incode|App.Placement}} completo o solo un {{incode|App.Vector}} o {{incode|App.Rotation}}.
</div>


Esempio:
Esempio:
Line 181: Line 163:




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


{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}

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