Jump to content

Sketcher: Oggetto schizzo

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

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, SketchObject può essere collegato a piani e facce. Inoltre, SketchObject può gestire vincoli geometrici.

Diagramma semplificato delle relazioni tra gli oggetti principali in FreeCAD

Utilizzo

Vedere Sketcher NewSketch.

Proprietà

Vedere Proprietà per tutti i tipi di proprietà che possono avere gli oggetti con script.

La classe Sketcher SketchObject (classe Sketcher::SketchObject) deriva dalla classe Part Part2DObject (classe Part::Part2DObject) e ne eredita tutte le proprietà.

SketchObject di Sketcher ha anche le seguenti proprietà aggiuntive nella Property View. Le proprietà nascoste possono essere visualizzate utilizzando il comando Mostra nascoste nel menu contestuale della Vista proprietà.

Dati

Base

  • Dati (Hidden)Internal Shape (PartShape): TBD.

Internal Geometry

  • DatiMake Internals (Bool): se true i bordi intersecanti vengono divisi (non sembra funzionare).

Sketch

  • Dati (Hidden)Geometry (GeometryList): un elenco delle geometrie delle parti presenti all'interno dello schizzo.
  • DatiConstraints: vincoli con nome, se esistono; altrimenti è un elenco vuoto [].
  • Dati (ReadOnly)External Geometry (LinkSubList): un elenco di geometrie di parti esterne a questo schizzo che vengono utilizzate come riferimento.
  • Dati (Hidden)External Types (IntegerList): tipo di geometria esterna dello schizzo: 0 (proiezione), 1 (intersezione) o 2 (entrambi), disponibile dalla versione 1.1.
  • Dati (Hidden, ReadOnly)Fully Constrained (Bool): se è true lo schizzo è completamente vincolato.
  • Dati (Hidden)Exports (LinkListHidden): geometria di esportazione dello schizzo.
  • Dati (Hidden)External Geo (GeometryList): schizzo della geometria esterna.
  • DatiArc Fit Tolerance (Precision): tolleranza per l'adattamento della proiezione degli archi della geometria esterna.

Vista

Auto Constraints

  • VistaAutoconstraints (Bool): se impostato su true, i vincoli vengono aggiunti automaticamente durante il disegno della geometria.
  • VistaAvoid Redundant (Bool): se impostato su true, i vincoli ridondanti vengono automaticamente evitati.

Grid

  • VistaGrid Auto (Bool): se impostato su true, la griglia viene ridimensionata in base al riquadro di delimitazione della geometria dello schizzo.
  • VistaGrid Size (Length): la dimensione della spaziatura delle linee della griglia locale nella Vista 3D; il valore predefinito è 10 mm.
  • VistaShow Grid (Bool): se impostato su true, nella Vista 3D verrà visualizzata una griglia locale all'oggetto. Questa griglia è indipendente dalla Griglia di Draft.

Layers

  • VistaVisual Layer List (BadType):

Object Style

  • VistaAuto Color (Bool): se true, l'oggetto verrà colorato in base alle preferenze utente, disponibile dalla versione 1.1: le proprietà VistaLine Color, VistaPoint Color e VistaShape Appearance vengono quindi nascoste nella vista proprietà. Impostare su false per specificare i colori in modo esplicito.

Visibility automation

  • VistaEditing Workbench (String): nome dell'ambiente da attivare durante la modifica dello schizzo; il valore predefinito è SketcherWorkbench.
  • VistaForce Ortho (Bool): se è true, la telecamera verrà forzata alla modalità di visualizzazione ortografica quando lo schizzo viene aperto.
  • VistaHide Dependent (Bool): se è true, tutti gli oggetti che dipendono dallo schizzo vengono nascosti quando lo schizzo viene aperto.
  • VistaRestore Camera (Bool): se è true, la posizione della telecamera viene salvata prima di aprire lo schizzo e viene ripristinata dopo averlo chiuso.
  • VistaSection View (Bool): se è true, solo (parti di) oggetti dietro il piano dello schizzo sono visibili mentre lo schizzo viene modificato.
  • VistaShow Links (Bool): se è true, tutti gli oggetti utilizzati nei collegamenti alla geometria esterna vengono mostrati quando si apre lo schizzo.
  • VistaShow Support (Bool): se è true, tutti gli oggetti a cui è allegato questo schizzo vengono mostrati quando lo schizzo viene aperto.
  • Vista (Hidden)Tempo Vis (PythonObject): una classe personalizzata associata a questo oggetto, che gestisce l'occultamento e la visualizzazione di altri oggetti durante l'apertura e la chiusura dello schizzo.

Script

Vedere anche: Nozioni di base sullo scripting di FreeCAD e script di oggetti.

Per informazioni generali sull'aggiunta di oggetti al documento, vedere Part Feature.

Uno 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"

Per la sottoclasse in Python si deve creare l'oggetto Sketcher::SketchObjectPython.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Sketcher::SketchObjectPython", "CustomSketch")
obj.Label = "Custom label"