Draft: Serie su tracciato
Serie su tracciato |
Posizione nel menu |
---|
Modifiche → Strumenti serie → Serie su tracciato |
Ambiente |
Draft, Arch |
Avvio veloce |
Nessuno |
Introdotto nella versione |
0.14 |
Vedere anche |
Serie ortogonale, Serie polare, Serie circolare, Serie di link su tracciato, Serie su punti, Serie di link su punti |
Descrizione
Il comando Serie su tracciato crea una serie (array) regolare da un oggetto selezionato posizionando copie lungo un percorso. Utilizzare invece il comando Serie di link su tracciato per creare una serie di Link più efficiente. Fatta eccezione per il tipo di serie creato, Serie di link o Serie normale, il comando Serie di link su tracciato è identico a questo comando.
Entrambi i comandi possono essere utilizzati su oggetti 2D creati con Draft o Sketcher, ma anche su molti oggetti 3D come quelli creati con gli ambienti Part, PartDesign o Arch.
Serie su tracciato
Utilizzo
- Selezionare l'oggetto che si desidera allineare.
- Aggiungere l'oggetto tracciato alla selezione. È anche possibile selezionare invece dei bordi. I bordi devono appartenere allo stesso oggetto e devono essere collegati.
- Esistono diversi modi per invocare il comando:
- Premere il pulsante Serie su tracciato.
- Selezionare l'opzione Modifiche → Strumenti serie → Serie su tracciato dal menu.
- La serie viene creata.
- Facoltativamente, modificare le proprietà della serie nell'Editor delle proprietà.
Allineamento
L'allineamento degli elementi in una Serie su tracciato dipende dalle proprietà della serie e dall'orientamento dell'oggetto sorgente. La posizione dell'oggetto sorgente viene ignorata: ai fini della serie x
, y
e z
sono impostati su 0
. Se la proprietà DatiAlign della serie è impostata su false
l'orientamento degli elementi della serie è identico a quello dell'oggetto sorgente. Se è impostata su true
, l'asse X del sistema di coordinate locale di ciascun posizionamento dell'elemento è tangente al percorso. Gli assi Y e Z dei sistemi di coordinate locali dipendono dalla proprietà DatiAlign Mode della serie. Altre proprietà della serie coinvolte nell'allineamento includono DatiTangent Vector, DatiForce Vertical e DatiVertical Vector.
3 serie basate sullo stesso percorso non planare. Da sinistra a destra: Align è falso, Align è vero con Align Mode Original e Align è vero con Align Mode Frenet
.
Modalità allineamento
Sono disponibili tre modalità:
Originale
Questa modalità si avvicina di più alla singola DatiAlign Mode disponibile nella versione 0.18. Si basa su un vettore normale fisso. Se il percorso è planare questo vettore è perpendicolare al piano del percorso, altrimenti viene utilizzato un vettore predefinito, l'asse Z positivo. Da questo vettore normale e dal vettore tangente locale (l'asse X locale) viene calcolato un cross product. Questo nuovo vettore viene utilizzato come asse Z locale. L'orientamento dell'asse Y locale è determinato dagli assi X e Z locali.
Frenet
Questa modalità utilizza il vettore normale locale derivato dal percorso in corrispondenza di ciascun posizionamento dell'elemento. Se questo vettore non può essere determinato (ad esempio nel caso di un segmento retto) viene utilizzato un vettore predefinito, sempre l'asse Z positivo. Con questo vettore e il vettore tangente locale si determina il sistema di coordinate locale utilizzando la stessa procedura del paragrafo precedente.
Tangente
Questa modalità è simile a DatiAlign Mode Original
ma include la possibilità di pre-ruotare l'oggetto sorgente specificando un DatiTangent Vector.
Forza Verticale e Vettore Verticale
Queste proprietà sono disponibili solo se DatiAlign Mode è Original
o Tangent
. Se DatiForce Vertical è impostato su true
il sistema di coordinate locale viene calcolato in modo diverso. Il DatiVertical Vector viene utilizzato come vettore normale fisso. Da questo vettore normale e dal vettore tangente locale (l'asse X locale) viene nuovamente calcolato un prodotto incrociato. Ma ora questo vettore è usato come asse Y locale. L'orientamento dell'asse Z locale è determinato dagli assi X e Y locali.
L'utilizzo di queste proprietà può essere richiesto se uno degli spigoli del percorso è (quasi) parallelo alla normale predefinita del percorso.
Proprietà
Vedere anche: Editor delle proprietà.
Un oggetto Serie su tracciato è 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
)
Alignment
- DatiAlign (
Bool
): specifica se gli elementi nella serie sono allineati o meno lungo il percorso. Se èfalse
tutte le altre proprietà in questo gruppo, eccetto DatiExtra Translation, non si applicano e sono nascoste. - DatiAlign Mode (
Enumeration
): specifica la modalità di allineamento, che può essereOriginal
,Frenet
oTangent
. - DatiEnd Offset (
Length
): specifica la lunghezza dalla fine del percorso all'ultima copia. Deve essere inferiore alla lunghezza del percorso meno DatiStart Offset. disponibile dalla versione 0.21 - DatiExtra Translation (
VectorDistance
): specifica uno spostamento aggiuntivo per ogni elemento lungo il percorso. - DatiForce Vertical (
Bool
): specifica se sovrascrivere la direzione normale predefinita con il valore di DatiVertical Vector. Utilizzato solo se DatiAlign Mode èOriginal
oTangent
. - DatiStart Offset (
Length
): specifica la lunghezza dall'inizio del percorso alla prima copia. Deve essere inferiore alla lunghezza del percorso. disponibile dalla versione 0.21 - DatiTangent Vector (
Vector
): specifica il vettore di allineamento. Utilizzato solo se DatiAlign Mode èTangent
. - DatiVertical Vector (
Vector
): specifica l'override per la direzione normale predefinita. Utilizzato solo se DatiVertical Vector ètrue
.
Objects
- DatiBase (
LinkGlobal
): specifica l'oggetto da duplicare nella serie. - DatiCount (
Integer
): specifica il numero di elementi nella serie. - 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. - DatiFuse (
Bool
): specifica se gli elementi sovrapposti nell'array sono fusi o meno. Non utilizzato per le serie di Link. disponibile dalla versione 1.0 - DatiPath Object (
LinkGlobal
): specifica l'oggetto da utilizzare per il percorso. Deve contenereEdges
nella sua Part TopoShape. - DatiPath Subelements (
LinkSubListGlobal
): specifica un elenco di spigoli dell'DatiPath Object. Se forniti solo questi bordi vengono utilizzati per il percorso.
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
): questa è una proprietà ereditata.
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. - VistaDisplay Mode (
Enumeration
): per le serie di link può essereLink
oChildView
. Per altre serie può essere:Flat Lines
,Shaded
,Wireframe
oPoints
- 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.
Script
Vedere anche: Autogenerated API documentation e Script di base per FreeCAD.
Per creare una serie su tracciato utilizzare il metodo make_path_array
(disponibile dalla versione 0.19) del modulo Draft. Questo metodo sostituisce il metodo deprecato makePathArray
.
path_array = make_path_array(base_object, path_object,
count=4, extra=App.Vector(0, 0, 0), subelements=None,
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),
use_link=True)
base_object
è l'oggetto da disporre in serie. Può anche essere laLabel
(string) di un oggetto nel documento corrente.path_object
è l'oggetto percorso. Può anche essere laLabel
(string) di un oggetto nel documento corrente.count
è il numero di elementi nella serie.extra
è un vettore che sposta ogni elemento.subelements
è un elenco di bordi dipath_object
, ad esempio["Edge1", "Edge2"]
. Se forniti solo questi bordi vengono utilizzati per il percorso.- Se
align
èTrue
gli elementi sono allineati lungo il percorso a seconda del valore dialign_mode
, che può essere"Original"
,"Frenet"
o"Tangent"
. tan_vector
è un vettore unitario che definisce la direzione tangente locale degli elementi lungo il percorso. Viene utilizzato quandoalign_mode
è"Tangent"
.- Se
force_vertical
èTrue
vertical_vector
viene utilizzato per la direzione Z locale degli elementi lungo il percorso. Viene utilizzato quandoalign_mode
è"Original"
o"Tangent"
. - Se
use_link
èTrue
gli elementi creati sono App Links invece di normali copie. path_array
viene restituito con l'oggetto serie creato.
Esempio:
import FreeCAD as App
import Draft
doc = App.newDocument()
p1 = App.Vector(500, -1000, 0)
p2 = App.Vector(1500, 1000, 0)
p3 = App.Vector(3000, 500, 0)
p4 = App.Vector(4500, 100, 0)
spline = Draft.make_bspline([p1, p2, p3, p4])
obj = Draft.make_polygon(3, 500)
path_array = Draft.make_path_array(obj, spline, 6)
doc.recompute()
wire = Draft.make_wire([p1, -p2, -p3, -p4])
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)
doc.recompute()
- Drafting: Line, Polyline, Fillet, Arc, Arc by 3 points, Circle, Ellipse, Rectangle, Polygon, B-spline, Cubic Bézier curve, Bézier curve, Point, Facebinder, ShapeString, Hatch
- Annotation: Text, Dimension, Label, Annotation styles, Annotation scale
- Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar array, Circular array, Path array, Path link array, Point array, Point link array, Edit, Subelement highlight, Join, Split, Upgrade, Downgrade, Wire to B-spline, Draft to sketch, Set slope, Flip dimension, Shape 2D view
- Draft Tray: Select plane, Set style, Toggle construction mode, AutoGroup
- Snapping: Snap lock, Snap endpoint, Snap midpoint, Snap center, Snap angle, Snap intersection, Snap perpendicular, Snap extension, Snap parallel, Snap special, Snap near, Snap ortho, Snap grid, Snap working plane, Snap dimensions, Toggle grid
- Miscellaneous: Apply current style, Layer, Manage layers, Add a new named group, Move to group, Select group, Add to construction group, Toggle normal/wireframe display, Create working plane proxy, Heal, Show snap toolbar
- Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
- Context menu:
- Layer container: Merge layer duplicates, Add new layer
- Layer: Activate this layer, Select layer contents
- Text: Open hyperlinks
- Wire: Flatten
- Working plane proxy: Write camera position, Write objects state
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub