Draft PointArray/it: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 1: Line 1:
{{Page_in_progress}}
<languages/>
<languages/>

<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
{{Docnav/it
{{Docnav/it
Line 67: Line 69:
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]].
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]].


{{TitleProperty|Objects}}

<div class="mw-translate-fuzzy">
{{TitleProperty|Objects}}
{{TitleProperty|Objects}}
* {{PropertyData|Base|Link}}: l'oggetto da duplicare; deve avere una [[Part_TopoShape/it|Part TopoShape]].
* {{PropertyData|Base|Link}}: l'oggetto da duplicare; deve avere una [[Part_TopoShape/it|Part TopoShape]].
Line 72: Line 77:
* {{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|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 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}}.
* {{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>


==Scripting==

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


Lo strumento PointArray può essere utilizzato nelle [[macros/it|macro]] e dalla [[Python/it|console di Python]] tramite la seguente funzione:
Lo strumento PointArray può essere utilizzato nelle [[macros/it|macro]] e dalla [[Python/it|console di Python]] tramite la seguente funzione:


Older call
Older call:

{{Code|code=
{{Code|code=
point_array = makePointArray(base_object, point_object)
point_array = makePointArray(base_object, point_object)
}}
}}


New call
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):
Line 93: Line 105:
** {{incode|extra}} può essere un {{incode|App.Placement}} completo o solo un {{incode|App.Vector}} o {{incode|App.Rotation}}.
** {{incode|extra}} può essere un {{incode|App.Placement}} completo o solo un {{incode|App.Vector}} o {{incode|App.Rotation}}.


Esempio:
Esempio:

{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App
Line 112: Line 125:
doc.recompute()
doc.recompute()
}}
}}



<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 126: Line 140:
{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 10:31, 20 May 2021

This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.

Serie su punti

Posizione nel menu
Modificche → 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, Clona

Descrizione

Lo strumento 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, che significa forme 2D create con Draft, ma anche solidi 3D creati con altri ambienti, ad esempio Part, PartDesign o Arch.

Per posizionare le copie in una schiera ortogonale usare Serie; per posizionare le copie su un percorso, utilizzare Serie su percorso; per creare copie o cloni e posizionarli manualmente, utilizzare Sposta, Ruota e Clona.

Oggetto duplicato in punti specifici

Utilizzo

  1. Selezionare un oggetto che si desidera distribuire.
  2. Selezionare un composto di punti.
  3. Premere il pulsante Serie su punti.

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

Composto di punti

L'oggetto composto di punti può essere creato in diversi modi.

  • Creare vari punti Draft o punti Part, e poi premere Crea un composto per creare il composto .
  • Creare i punti con il metodo precedente ma invece di creare un composto usare Upgrade per creare un "Blocco".
  • Creare uno Schizzo, e dentro aggiungere vari punti.

In essence, the object to be used as the compound must have one of three properties, DatiComponents, DatiLinks, or DatiGeometry, and inside that compound, there must be at least one point with DatiX, DatiY, and DatiZ properties.

Note: in the case of Draft Point and Part Point the array will try to position the copies using the DatiPlacement of the point. In the case of a Sketcher Point, the position will be taken from its internal X, Y, and Z attributes.

Note 2: for Draft Point its DatiPlacement always follows the values of DatiX, DatiY, DatiZ, so modifying these values is enough to produce the desired displacement. However, for Part Point, the net displacement is given by the sum of DatiPlacement with the vector with components DatiX, DatiY, and DatiZ.

Opzioni

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

Proprietà

A PointArray is derived from a Part Feature (Part::Feature class), therefore it shares all the latter's properties. In addition to the properties described in Part Feature, the PointArray has the following properties in the property editor.

Objects

Objects

  • DatiBase (Link): l'oggetto da duplicare; deve avere una Part TopoShape.
  • DatiCount (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 DatiPoint Object.
  • DatiExtra Placement (Placement): specifica un posizionamento aggiuntivo, traslazione e rotazione, che verrà applicato a ciascuna copia della serie. Ogni copia appare normalmente con la stessa rotazione dell'oggetto DatiBase; con questa proprietà è possibile fornire una rotazione aggiuntiva o contrastare la rotazione originale e apportare piccole modifiche alla posizione delle copie. introduced in version 0.19
  • DatiPoint Object (Link): specifica un oggetto composto di punti che indicano dove verranno visualizzate le copie dell'oggetto DatiBase. L'oggetto composto deve avere una proprietà DatiLinks, DatiComponents, o DatiGeometry, e contenere almeno un elemento con gli attributi DatiX, DatiY, e DatiZ.

Scripting

Lo strumento PointArray può essere utilizzato nelle macro e dalla console di Python tramite la seguente funzione:

Older call:

point_array = makePointArray(base_object, point_object)

New call:

point_array = make_point_array(base_object, point_object, extra=None):
  • Crea un oggetto "PointArray" da un base_object, posizionando le copie nei punti contenuti all'interno di point_object.
    • point_object deve avere uno degli attributi Geometry, Links o Components contenenti punti.
    • Invece di un riferimento a un oggetto, base_object e point_object possono anche essere delle Labels (stringhe) di oggetti esistenti nel documento corrente.
    • extra può essere un App.Placement completo o solo un App.Vector o App.Rotation.

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