Introduzione
Un oggetto App GeoFeature, o formalmente un App::GeoFeature, è la classe base della maggior parte degli oggetti che visualizzano elementi geometrici nella vista 3D perché include una proprietà DatiPosizionamento.
Diagramma semplificato delle relazioni tra gli oggetti principali in FreeCAD
Utilizzo
App GeoFeature è un oggetto interno, quindi non può essere creato dall'interfaccia grafica. In genere non è pensato per essere utilizzato direttamente, ma può essere suddiviso in sottoclassi per ottenere un oggetto vuoto che ha solo la proprietà di base DatiPlacement per definire la sua posizione nella vista 3D .
Alcuni degli oggetti derivati più importanti sono i seguenti:
- La classe Part Feature, il genitore della maggior parte degli oggetti con forme topologiche 2D e 3D.
- La classe Mesh Feature, il genitore della maggior parte degli oggetti realizzati da mesh, non solidi.
- La classe Fem FemMeshObject, il genitore delle mesh di elementi finiti create con l'ambiente FEM.
- La classe CAM Feature, il genitore dei percorsi creati con l'ambiente CAM per l'uso nella lavorazione CNC.
- La classe App Part, che definisce Std Parts che può essere utilizzato come contenitore di corpi per eseguire assiemi.
Quando si crea questo oggetto in Python, invece di sottoclassare App::GeoFeature, è necessario sottoclassare App::GeometryPython perché quest'ultimo include di default un provider di visualizzazione e gli attributi Proxy per l'oggetto stesso e il relativo provider di visualizzazione. Vedere Script.
Proprietà App GeoFeature
Vedere Proprietà per tutti i tipi di proprietà che possono avere gli oggetti con script.
L'oggetto App GeoFeature (classe App::GeoFeature) è derivato dall'oggetto base App DocumentObject (classe App::DocumentObject) ed eredita tutte le sue proprietà. Inoltre ha una proprietà DatiPlacement, che controlla la sua posizione nella 3D view.
Proprietà App GeometryPython
Vedere Proprietà per tutti i tipi di proprietà che possono avere gli oggetti con script.
La classe App GeometryPython (App::GeometryPython) è derivata dalla classe di base App GeoFeature (App::GeoFeature) ed eredita tutte le sue proprietà. Ha anche diverse proprietà aggiuntive.
Queste sono le proprietà disponibili nell'editor delle proprietà. Le proprietà nascoste possono essere mostrate usando il comando Mostra nascoste nel menu contestuale dell'editor delle proprietà.
See Part Feature for an explanation of the properties listed below.
Dati
Base
- Dati (Hidden)Proxy (
PythonObject): una classe personalizzata associata a questo oggetto. - DatiPlacement (
Placement): la posizione dell'oggetto nella vista 3D. Il posizionamento è definito da un puntoBase(vettore) e da unaRotazione(asse e angolo). Vedi Posizionamento.- DatiAngle: l'angolo di rotazione attorno a DatiAxis. Per impostazione predefinita, è
0°(zero gradi). - DatiAxis: il vettore unitario che definisce l'asse di rotazione per il posizionamento. Ogni componente è un valore in virgola mobile compreso tra
0e1. Se qualsiasi valore è superiore a1, il vettore viene normalizzato in modo che la grandezza del vettore sia1. Per impostazione predefinita, è l'asse Z positivo,(0, 0, 1). - DatiPosition: un vettore con le coordinate 3D del punto base. Per impostazione predefinita, è l'origine
(0, 0, 0).
- DatiAngle: l'angolo di rotazione attorno a DatiAxis. Per impostazione predefinita, è
- DatiLabel (
String): il nome modificabile dall'utente di questo oggetto, è una stringa UTF8 arbitraria. - Dati (Hidden)Label2 (
String): una descrizione di questo oggetto più lunga e modificabile dall'utente, è una stringa UTF8 arbitraria che può includere ritorni a capo. Per impostazione predefinita, è una stringa vuota"". - Dati (Hidden)Expression Engine (
ExpressionEngine): un elenco di espressioni. Per impostazione predefinita, è vuoto[]. - Dati (Hidden)Visibility (
Bool): se visualizzare o meno l'oggetto.
Vista
Base
Base
- Vista (Hidden)Proxy (
PythonObject): una classe viewprovider personalizzata associata a questo oggetto.
Display Options
Display Options
- VistaBounding Box (
Bool): se ètrue, l'oggetto mostrerà il riquadro di delimitazione nella vista 3D. - Vista (Enumeration)Display Mode (
Enumeration): vedere le informazioni in App FeaturePython. - VistaShow In Tree (
Bool): vedere le informazioni in App FeaturePython. - VistaVisibility (
Bool): vedere le informazioni in App FeaturePython.
Object Style
Object Style
- VistaShape Color (
Color): una tupla di tre valori RGB in virgola mobile(r,g,b)per definire il colore delle facce nella vista 3D; per impostazione predefinita è(0.8, 0.8, 0.8), che viene visualizzato come[204, 204, 204]su base 255, un grigio chiaro . - Vista (Hidden)Shape Material (
Material): un App Material associato a questo oggetto. Per impostazione predefinita è vuoto. - VistaTransparency (
Percent): un numero intero da0a100che determina il livello di trasparenza delle facce nella vista 3D. Un valore di100indica facce completamente invisibili; le facce sono invisibili ma possono comunque essere selezionate purché VistaSelectable siatrue.
Selection
Selection
- VistaOn Top When Selected (
Enumeration): vedere le informazioni in App FeaturePython. - VistaSelectable (
Bool): se ètrue, l'oggetto può essere selezionato con il puntatore nella vista 3D. Altrimenti, l'oggetto non potrà essere selezionato finché questa opzione non sarà impostata sutrue. - VistaSelection Style (
Enumeration): vedere le informazioni in App FeaturePython.
Script
Vedere anche: Script di base per FreeCAD, e script di oggetti.
Vedere Part Feature per le informazioni generali sull'aggiunta di oggetti al documento.
Una GeoFeature viene creata con il metodo addObject() del documento. Se si desidera creare un oggetto con una forma topologica 2D o 3D, potrebbe essere meglio creare una delle sottoclassi specializzate per la gestione delle forme, ad esempio Part Feature o Part Part2DObject.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::GeoFeature", "Name")
obj.Label = "Custom label"
Per la sottoclasse Python si dovrebbe creare l'oggetto App::GeometryPython.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::GeometryPython", "Name")
obj.Label = "Custom label"
Questa pagina è recuperata da https://wiki.freecad.org/App_GeoFeature