Sketcher SketchObject/it: Difference between revisions
No edit summary |
(Updating to match new version of source page) |
||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{TOCright}} |
|||
== Introduzione == |
== Introduzione == |
||
Line 7: | Line 8: | ||
Un [[Sketcher_SketchObject/it|Sketcher SketchObject]], o formalmente un {{incode|Sketcher::SketchObject}}, è l'elemento base per creare oggetti 2D con l'ambiente [[Sketcher_Workbench/it|Sketcher]]. |
Un [[Sketcher_SketchObject/it|Sketcher SketchObject]], o formalmente un {{incode|Sketcher::SketchObject}}, è l'elemento base per creare oggetti 2D con l'ambiente [[Sketcher_Workbench/it|Sketcher]]. |
||
⚫ | |||
{{Incode|Sketcher::SketchObject}} deriva da [[Part_Part2DObject/it|Part Part2DObject]], il che significa che è un oggetto [[Part Feature/it|Part Feature]] specializzato per la geometria 2D. Come Part2DObject, anche SketchObject può essere collegato a piani e facce. Inoltre, SketchObject è in grado di gestire i vincoli geometrici delle linee e delle curve disegnate al suo interno. |
{{Incode|Sketcher::SketchObject}} deriva da [[Part_Part2DObject/it|Part Part2DObject]], il che significa che è un oggetto [[Part Feature/it|Part Feature]] specializzato per la geometria 2D. Come Part2DObject, anche SketchObject può essere collegato a piani e facce. Inoltre, SketchObject è in grado di gestire i vincoli geometrici delle linee e delle curve disegnate al suo interno. |
||
⚫ | |||
[[File:FreeCAD_core_objects.svg|800px]] |
[[File:FreeCAD_core_objects.svg|800px]] |
||
Line 22: | Line 25: | ||
# Premere {{Button|OK}}. |
# Premere {{Button|OK}}. |
||
⚫ | |||
Sebbene SketchObject possa essere utilizzato da solo per disegnare su un piano, viene comunemente utilizzato insieme a [[PartDesign Workbench/it|PartDesign]] per creare solidi estrusi. |
Sebbene SketchObject possa essere utilizzato da solo per disegnare su un piano, viene comunemente utilizzato insieme a [[PartDesign Workbench/it|PartDesign]] per creare solidi estrusi. |
||
⚫ | |||
<div class="mw-translate-fuzzy"> |
|||
# Passare in [[PartDesign Workbench/it|PartDesign]]. |
# Passare in [[PartDesign Workbench/it|PartDesign]]. |
||
# Premere {{Button|[[File:PartDesign_Body.svg|16px]] [[PartDesign_Body/it|Crea un corpo]]}}. |
# Premere {{Button|[[File:PartDesign_Body.svg|16px]] [[PartDesign_Body/it|Crea un corpo]]}}. |
||
Line 29: | Line 35: | ||
# {{MenuCommand|Selezione della funzione}}: piano XY (piano base), piano XZ (piano base) o piano YZ (piano base). |
# {{MenuCommand|Selezione della funzione}}: piano XY (piano base), piano XZ (piano base) o piano YZ (piano base). |
||
# Premere {{Button|OK}}. |
# Premere {{Button|OK}}. |
||
</div> |
|||
== Proprietà == |
== Proprietà == |
||
Line 34: | Line 41: | ||
Vedere [[Property/it|Proprietà]] per tutti i tipi di proprietà che possono avere gli oggetti con script. |
Vedere [[Property/it|Proprietà]] per tutti i tipi di proprietà che possono avere gli oggetti con script. |
||
<div class="mw-translate-fuzzy"> |
|||
Un [[Sketcher_SketchObject|Sketcher SketchObject]] (classe {{incode|Sketcher::SketchObject}}) deriva da un [[Part_Part2DObject|Part Part2DObject]] ({{incode|Part::Part2DObject}}), quindi condivide tutte le proprietà di quest'ultimo. |
Un [[Sketcher_SketchObject|Sketcher SketchObject]] (classe {{incode|Sketcher::SketchObject}}) deriva da un [[Part_Part2DObject|Part Part2DObject]] ({{incode|Part::Part2DObject}}), quindi condivide tutte le proprietà di quest'ultimo. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
<div class="mw-translate-fuzzy"> |
||
Line 42: | Line 51: | ||
=== Dati === |
=== Dati === |
||
⚫ | |||
⚫ | |||
* {{PropertyData|Map Mode}}: vedere [[Part EditAttachment/it|Part EditAttachment]] per ulteriori informazioni su tutte le modalità di associazione. |
|||
⚫ | |||
⚫ | |||
{{TitleProperty|Sketch}} |
{{TitleProperty|Sketch}} |
||
⚫ | |||
⚫ | |||
⚫ | |||
==== Hidden properties Data ==== |
|||
⚫ | |||
See [[Part_Part2DObject|Part Part2DObject]] for the rest of the hidden properties. |
|||
⚫ | |||
* {{PropertyData|Proxy|PythonObject}}: a custom class associated with this object. This only exists for the [[Python|Python]] version. See [[Sketcher_SketchObject#Scripting|Scripting]]. |
|||
{{TitleProperty|Sketch}} |
|||
⚫ | |||
* {{PropertyData|External Geometry|LinkSubList}}: a list of Part geometries outside this Sketch that are used for reference. |
* {{PropertyData|External Geometry|LinkSubList}}: a list of Part geometries outside this Sketch that are used for reference. |
||
* {{PropertyData|Fully Constrained|Bool|Hidden}}: (read-only) if {{TRUE}} the sketch is fully constrained. |
|||
===Vista=== |
===Vista=== |
||
Line 71: | Line 64: | ||
* {{PropertyView|Autoconstraints}}: se è {{TRUE}} prova ad impostare i vincoli quando viene disegnata la geometria. |
* {{PropertyView|Autoconstraints}}: se è {{TRUE}} prova ad impostare i vincoli quando viene disegnata la geometria. |
||
</div> |
</div> |
||
* {{PropertyView|Autoconstraints|Bool}}: if {{TRUE}} constraints are automatically added when geometry is drawn. |
|||
* {{PropertyView|Avoid Redundant|Bool}}: if {{TRUE}} redundant auto-constraints are avoided. |
|||
⚫ | |||
* {{PropertyView|Grid Auto Size|Bool|Hidden}}: if {{TRUE}} the grid is resized based on the boundingbox of the geometry of the sketch. |
|||
* {{PropertyView|Grid Size|Length}}: the size of the spacing of the local grid lines in the [[3D_view|3D view]]; it defaults to {{value|10 mm}}. |
|||
* {{PropertyView|Grid Snap|Bool}}: if {{TRUE}} the grid can be used to snap points. |
|||
* {{PropertyView|Grid Style|Enumeration}}: the style of the grid lines; {{value|Dashed}} (default) or {{value|Light}}. |
|||
* {{PropertyView|Show Grid|Bool}}: if {{TRUE}} a grid local to the object will be displayed in the [[3D_view|3D view]]. This grid is independent of the [[Draft_ToggleGrid|Draft Grid]]. |
|||
* {{PropertyView|Show Only In Edit Mode|Bool}}: if {{TRUE}} the grid is only displayed while the sketch is being edited. |
|||
* {{PropertyView|Tight Grid|Bool}}: if {{TRUE}} the local grid will be localized around the origin of the shape, otherwise it will extend itself more. |
|||
* {{PropertyView|max Number Of Lines|Integer}}: the maximum number of lines in the grid. |
|||
⚫ | |||
<div class="mw-translate-fuzzy"> |
<div class="mw-translate-fuzzy"> |
||
Line 80: | Line 89: | ||
* {{PropertyView|Show Support}}: se è {{TRUE}} tutti gli oggetti a cui è associato questo schizzo vengono mostrati quando si apre lo schizzo. |
* {{PropertyView|Show Support}}: se è {{TRUE}} tutti gli oggetti a cui è associato questo schizzo vengono mostrati quando si apre lo schizzo. |
||
</div> |
</div> |
||
==== Hidden properties View ==== |
|||
{{TitleProperty|Base}} |
|||
* {{PropertyView|Proxy|PythonObject}}: a custom view provider class associated with this object. This only exists for the [[Python|Python]] version. See [[Sketcher_SketchObject#Scripting|Scripting]]. |
|||
{{TitleProperty|Visibility automation}} |
|||
* {{PropertyView|Tempo Vis|PythonObject}}: a custom class associated with this object, that handles hiding and showing other objects when opening and closing the sketch. |
|||
All other view properties, including hidden properties, are those of the base [[Part_Feature|Part Feature]] object. |
|||
== Script == |
== Script == |
||
<div class="mw-translate-fuzzy"> |
|||
{{Emphasis|Vedere anche:}} [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]], e [[scripted objects/it|script di oggetti]]. |
{{Emphasis|Vedere anche:}} [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]], e [[scripted objects/it|script di oggetti]]. |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
<div class="mw-translate-fuzzy"> |
||
Line 104: | Line 103: | ||
Un oggetto Sketcher SketchObject viene creato con il metodo {{incode|addObject()}} del documento. |
Un oggetto Sketcher SketchObject viene creato con il metodo {{incode|addObject()}} del documento. |
||
</div> |
</div> |
||
{{Code|code= |
{{Code|code= |
||
import FreeCAD as App |
import FreeCAD as App |
||
Line 112: | Line 112: | ||
}} |
}} |
||
⚫ | |||
This basic {{incode|Sketcher::SketchObject}} doesn't have a Proxy object so it can't be fully used for sub-classing. |
|||
⚫ | |||
{{Code|code= |
{{Code|code= |
||
Line 125: | Line 123: | ||
{{ |
{{Sketcher_Tools_navi{{#translation:}}}} |
||
⚫ | |||
{{Userdocnavi{{#translation:}}}} |
{{Userdocnavi{{#translation:}}}} |
||
⚫ | |||
{{clear}} |
Revision as of 07:40, 22 February 2022
Introduzione
Un Sketcher SketchObject, o formalmente un Sketcher::SketchObject
, è l'elemento base per creare oggetti 2D con l'ambiente Sketcher.
Sketcher::SketchObject
deriva da Part Part2DObject, il che significa che è un oggetto Part Feature specializzato per la geometria 2D. Come Part2DObject, anche SketchObject può essere collegato a piani e facce. Inoltre, SketchObject è in grado di gestire i vincoli geometrici delle linee e delle curve disegnate al suo interno.
Diagramma semplificato delle relazioni tra gli oggetti principali in FreeCAD. La classe Sketcher::SketchObject
è specializzata per le forme 2D e inoltre può gestire i vincoli.
Utilizzo
- Passare all'ambiente Sketcher.
- Premere Nuovo schizzo.
- Selezionare un orientamento: piano XY, piano XZ o piano YZ. Opzionalmente scegliere anche Direzione inversa, e assegnare un valore di Offset.
- Premere OK.
Sebbene SketchObject possa essere utilizzato da solo per disegnare su un piano, viene comunemente utilizzato insieme a PartDesign per creare solidi estrusi.
- Passare in PartDesign.
- Premere Crea un corpo.
- Premere Crea uno schizzo.
- Selezione della funzione: piano XY (piano base), piano XZ (piano base) o piano YZ (piano base).
- Premere OK.
Proprietà
Vedere Proprietà per tutti i tipi di proprietà che possono avere gli oggetti con script.
Un Sketcher SketchObject (classe Sketcher::SketchObject
) deriva da un Part Part2DObject (Part::Part2DObject
), quindi condivide tutte le proprietà di quest'ultimo.
Oltre alle proprietà descritte in Part Part2DObject, il corpo di PartDesign ha le seguenti proprietà nell'editor delle proprietà.
Dati
Sketch
- Dati (Hidden)Geometry (
GeometryList
): a list of Part geometries that exist inside the sketch. - DatiConstraints: named constraints, if they exist; otherwise it is an empty list
[]
. - DatiExternal Geometry (
LinkSubList
): a list of Part geometries outside this Sketch that are used for reference. - Dati (Hidden)Fully Constrained (
Bool
): (read-only) iftrue
the sketch is fully constrained.
Vista
Auto Constraints
- VistaAutoconstraints: se è
true
prova ad impostare i vincoli quando viene disegnata la geometria.
- VistaAutoconstraints (
Bool
): iftrue
constraints are automatically added when geometry is drawn. - VistaAvoid Redundant (
Bool
): iftrue
redundant auto-constraints are avoided.
Grid
- Vista (Hidden)Grid Auto Size (
Bool
): iftrue
the grid is resized based on the boundingbox of the geometry of the sketch. - VistaGrid Size (
Length
): the size of the spacing of the local grid lines in the 3D view; it defaults to10 mm
. - VistaGrid Snap (
Bool
): iftrue
the grid can be used to snap points. - VistaGrid Style (
Enumeration
): the style of the grid lines;Dashed
(default) orLight
. - VistaShow Grid (
Bool
): iftrue
a grid local to the object will be displayed in the 3D view. This grid is independent of the Draft Grid. - VistaShow Only In Edit Mode (
Bool
): iftrue
the grid is only displayed while the sketch is being edited. - VistaTight Grid (
Bool
): iftrue
the local grid will be localized around the origin of the shape, otherwise it will extend itself more. - Vistamax Number Of Lines (
Integer
): the maximum number of lines in the grid.
Visibility automation
Visibility automation
- VistaEditing Workbench: normalmente
SketcherWorkbench
, è il nome dell'ambiente da attivare durante la modifica dello schizzo. - VistaHide Dependent: se è
true
tutti gli oggetti che dipendono dallo schizzo vengono nascosti quando si apre lo schizzo. - VistaRestore Camera: se è
true
la posizione della telecamera viene salvata prima di aprire lo schizzo e viene ripristinata quando lo si chiude. - VistaShow Links: se è
true
tutti gli oggetti utilizzati nei collegamenti alla geometria esterna vengono visualizzati quando si apre lo schizzo. - VistaShow Support: se è
true
tutti gli oggetti a cui è associato questo schizzo vengono mostrati quando si apre lo schizzo.
Script
Vedere anche: Script di base per FreeCAD, e script di oggetti.
Vedere Part Feature per le informazioni generali.
Un oggetto Sketcher SketchObject viene creato con il metodo addObject()
del documento.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("Sketcher::SketchObject", "Sketch")
obj.Label = "Custom label"
For Python subclassing you should create the Sketcher::SketchObjectPython
object.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("Sketcher::SketchObjectPython", "CustomSketch")
obj.Label = "Custom label"
- General: Create sketch, Edit sketch, Map sketch to face, Reorient sketch, Validate sketch, Merge sketches, Mirror sketch, Leave sketch, View sketch, View section, Toggle grid, Toggle snap, Configure rendering order, Stop operation
- Sketcher geometries: Point, Line, Arc, Arc by 3 points, Circle, Circle by 3 points, Ellipse, Ellipse by 3 points, Arc of ellipse, Arc of hyperbola, Arc of parabola, B-spline by control points, Periodic B-spline by control points, B-spline by knots, Periodic B-spline by knots, Polyline, Rectangle, Centered rectangle, Rounded rectangle, Triangle, Square, Pentagon, Hexagon, Heptagon, Octagon, Regular polygon, Slot, Fillet, Corner-preserving fillet, Trim, Extend, Split, External geometry, Carbon copy, Toggle construction geometry
- Sketcher constraints:
- Geometric constraints: Coincident, Point on object, Vertical, Horizontal, Parallel, Perpendicular, Tangent, Equal, Symmetric, Block
- Dimensional constraints: Lock, Horizontal distance, Vertical distance, Distance, Radius or weight, Diameter, Auto radius/diameter, Angle, Refraction (Snell's law)
- Constraint tools: Toggle driving/reference constraint, Activate/deactivate constraint
- Sketcher tools: Select unconstrained DoF, Select associated constraints, Select associated geometry, Select redundant constraints, Select conflicting constraints, Show/hide internal geometry, Select origin, Select horizontal axis, Select vertical axis, Symmetry, Clone, Copy, Move, Rectangular array, Remove axes alignment, Delete all geometry, Delete all constraints
- Sketcher B-spline tools: Show/hide B-spline degree, Show/hide B-spline control polygon, Show/hide B-spline curvature comb, Show/hide B-spline knot multiplicity, Show/hide B-spline control point weight, Convert geometry to B-spline, Increase B-spline degree, Decrease B-spline degree, Increase knot multiplicity, Decrease knot multiplicity, Insert knot, Join curves
- Sketcher virtual space: Switch virtual space
- Additional: Sketcher Dialog, Preferences, Sketcher scripting
- Cuore: App DocumentObject
- Base: App FeaturePython, App GeoFeature, Part Feature, Mesh Feature, Fem FemMeshObject
- Forme interne: Part TopoShape, Mesh MeshObject, Fem FemMesh
- Struttura: App DocumentObjectGroup (Std Group), App Part (Std Part), App Link
- Derivate: Part Part2DObject, Sketcher SketchObject, PartDesign Body, PartDesign Feature
- 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, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub