Draft: Serie su punti

From FreeCAD Documentation
This page is a translated version of the page Draft PointArray and the translation is 100% complete.

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