Property editor/it: Difference between revisions
Renatorivo (talk | contribs) No edit summary |
No edit summary |
||
(93 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{Docnav/it|[[Interface Customization/it|Personalizzare l'interfaccia]]|[[Workbenches/it|Ambienti di lavoro]]}} |
|||
{{Docnav/it |
|||
|[[Document_structure/it|Struttura del documento]] |
|||
|[[Workbenches/it|Ambienti di lavoro]]}} |
|||
{{TOCright}} |
|||
<span id="Introduction"></span> |
|||
== Descrizione == |
== Descrizione == |
||
L'[[property editor/it| |
L'[[property editor/it|editor delle proprietà]] appare quando è attiva la scheda {{MenuCommand|Modello}} della [[combo_view/it|vista combinata]] nell'[[interface/it|interfaciia]]; consente di gestire le proprietà degli oggetti nel documento. |
||
Generalmente, l' |
Generalmente, l'editor delle proprietà è destinato a gestire solo un oggetto alla volta. I valori mostrati nell'editor appartengono all'oggetto selezionato nel documento attivo. Nonostante questo, alcune proprietà come i colori, possono essere impostate per più oggetti selezionati. Se non ci sono elementi selezionati, l'editor delle proprietà è vuoto. |
||
Non tutte le proprietà possono sempre essere modificate; a seconda dello stato specifico della proprietà, alcune di esse possono essere invisibili (non elencate) o di sola lettura (non modificabili). |
Non tutte le proprietà possono sempre essere modificate; a seconda dello stato specifico della proprietà, alcune di esse possono essere invisibili (non elencate) o di sola lettura (non modificabili). |
||
{{TOCright}} |
|||
[[File:FreeCAD_Properties_empty.png]] |
|||
[[File:FreeCAD_Property_editor_empty.png]] |
|||
{{Caption|Editore delle proprietà vuoto, quando nessun oggetto è selezionato.}} |
{{Caption|Editore delle proprietà vuoto, quando nessun oggetto è selezionato.}} |
||
<span id="Property_types"></span> |
|||
==Tipi di proprietà== |
==Tipi di proprietà== |
||
Una proprietà è un'informazione come un numero o una stringa di testo allegata a un documento FreeCAD o ad un oggetto del documento. |
Una proprietà è un'informazione come un numero o una stringa di testo allegata a un documento di FreeCAD o ad un oggetto del documento. |
||
Gli oggetti creati con [[scripted objects/it|script personalizzati]] possono utilizzare qualsiasi tipo di proprietà definita nel sistema di base. Vedere l'elenco completo in [[Property/it|Proprietà]]. |
Gli oggetti creati con [[scripted objects/it|script personalizzati]] possono utilizzare qualsiasi tipo di proprietà definita nel sistema di base. Vedere l'elenco completo in [[Property/it|Proprietà degli oggetti]]. |
||
Alcuni dei tipi di proprietà più comunemente usati sono: |
Alcuni dei tipi di proprietà più comunemente usati sono: |
||
{{Code|code= |
{{Code|code= |
||
App::PropertyBool |
App::PropertyBool |
||
Line 33: | Line 43: | ||
}} |
}} |
||
Oggetti diversi possono avere |
Oggetti diversi possono avere tipi di proprietà diverse. Tuttavia, molti oggetti hanno gli stessi tipi perché sono derivati dalla stessa classe interna. Ad esempio, la maggior parte degli oggetti che descrivono le forme geometriche (linee, cerchi, rettangoli, corpi solidi, parti importate, ecc.) hanno la proprietà "Posizionamento" che definisce la loro posizione nella [[3D view/it|Vista 3D]]. |
||
<span id="View_and_Data_properties"></span> |
|||
== Proprietà Vista e Dati == |
== Proprietà Vista e Dati == |
||
Line 41: | Line 52: | ||
* Proprietà {{MenuCommand|Dati}} relative ai parametri "fisici" dell'oggetto. Le proprietà {{MenuCommand|Dati}} definiscono le caratteristiche essenziali dell'oggetto; esistono sempre, anche quando FreeCAD viene utilizzato in modalità console o come libreria. Ciò significa che se si carica un documento in modalità console, è possibile modificare il raggio di un cerchio o la lunghezza di una linea, anche se non è possibile visualizzare il risultato sullo schermo. |
* Proprietà {{MenuCommand|Dati}} relative ai parametri "fisici" dell'oggetto. Le proprietà {{MenuCommand|Dati}} definiscono le caratteristiche essenziali dell'oggetto; esistono sempre, anche quando FreeCAD viene utilizzato in modalità console o come libreria. Ciò significa che se si carica un documento in modalità console, è possibile modificare il raggio di un cerchio o la lunghezza di una linea, anche se non è possibile visualizzare il risultato sullo schermo. |
||
Per questo motivo, le proprietà {{MenuCommand|Dati}} sono considerate più "reali", in quanto definiscono veramente la geometria di una forma. Invece le proprietà {{MenuCommand|Vista}} sono meno importanti perché influenzano solo l'aspetto della geometria. Ad esempio, un cerchio di raggio di 10 mm è diverso da un cerchio di raggio di 5 mm; il colore del cerchio (proprietà vista) non influisce sulla sua forma, ma il raggio (proprietà dati) sì. In molti casi in questa documentazione, si intende che la parola "proprietà" si riferisce a una "proprietà dati". |
Per questo motivo, le proprietà {{MenuCommand|Dati}} sono considerate più "reali", in quanto definiscono veramente la geometria di una forma. Invece le proprietà {{MenuCommand|Vista}} sono meno importanti perché influenzano solo l'aspetto supericiale della geometria. Ad esempio, un cerchio di raggio di 10 mm è diverso da un cerchio di raggio di 5 mm; il colore del cerchio (proprietà vista) non influisce sulla sua forma, ma il raggio (proprietà dati) sì. In molti casi in questa documentazione, si intende che la parola "proprietà" si riferisce a una "proprietà dati" e non ad una "proprietà vista". |
||
<span id="Basic_properties"></span> |
|||
=== Proprietà di base === |
=== Proprietà di base === |
||
{{Emphasis|Vedere anche: [[Object_name/it|Nome dell'oggetto]]}} |
|||
L'oggetto [[scripted objects/it|script]] più semplice non mostra alcuna proprietà {{MenuCommand|Dati}} nell'editore delle proprietà, ad eccezione dell'attributo {{incode|Label}}. {{Incode|Label}} è una stringa modificabile dall'utente che identifica l'oggetto nella [[tree view/it|vista ad albero]]. Invece, l'attributo {{incode|Name}} di un oggetto viene assegnato al momento della sua creazione e non può essere modificato; questo attributo è di sola lettura e non viene nemmeno visualizzato nell'editor delle proprietà. |
|||
L'oggetto [[scripted objects/it|script]] più semplice non mostra alcuna proprietà {{MenuCommand|Dati}} nell'editor delle proprietà, ad eccezione dell'attributo {{incode|Label}}. {{Incode|Label}} è una stringa modificabile dall'utente che identifica l'oggetto nella [[tree view/it|vista ad albero]]. Invece, l'attributo {{incode|Name}} di un oggetto viene assegnato al momento della sua creazione e non può essere modificato; questo attributo è di sola lettura e non viene nemmeno visualizzato nell'editor delle proprietà. |
|||
Un oggetto parametrico di base viene creato nel modo seguente: |
Un oggetto parametrico di base viene creato nel modo seguente: |
||
{{Code|code= |
{{Code|code= |
||
obj = App.ActiveDocument.addObject("App::FeaturePython") |
obj = App.ActiveDocument.addObject("App::FeaturePython", "App__FeaturePython") |
||
obj.Label = "Plain_object" |
obj.Label = "Plain_object" |
||
print(obj.Name) |
print(obj.Name) |
||
print(obj.Label) |
|||
}} |
}} |
||
[[File: |
[[File:FreeCAD_Property_editor_View_basic.png|x264px]] [[File:FreeCAD_Property_editor_Data_basic.png|x264px]] |
||
{{Caption|Schede Vista e Dati dell'editor delle proprietà, per un oggetto script di base "App::FeaturePython".}} |
{{Caption|Schede Vista e Dati dell'editor delle proprietà, per un oggetto script di base "App::FeaturePython".}} |
||
La maggior parte degli oggetti geometrici che possono essere creati e visualizzati nella [[3D view/it|vista 3D]] sono derivati da una {{incode|Part::Feature}}. Vedere [[Part Feature/it|Part Feature]] per le proprietà più basilari di questi oggetti. |
|||
Per la geometria 2D, la maggior parte degli oggetti deriva da {{incode|Part::Part2DObject}} (essi stessi derivati da {{incode|Part::Feature}}) che sono la base di [[Sketch/it|Schizzi]], e di molti elementi di [[Draft Workbench/it|Draft]]. Vedere [[Part Part2DObject/it|Part Part2DObject]] per le proprietà più basilari di questi oggetti. |
|||
= |
<span id="Actions"></span> |
||
==Azioni == |
|||
Facendo clic con il tasto destro in uno spazio vuoto della vista o con una proprietà selezionata, viene visualizzato solo un comando: |
|||
Actions in the property view were implemented in 0.19. |
|||
* {{MenuCommand|Mostra tutto}}: se attivo, oltre alle proprietà standard che appaiono già, mostra tutti i dati nascosti e visualizza le proprietà nelle rispettive schede. |
|||
** Dati: "Proxy", "Label2", "Expression Engine", and "Visibility". |
|||
** Vista: "Proxy". |
|||
Quando l'opzione {{MenuCommand|Mostra tutto}} è attiva e viene selezionata una proprietà, facendo un secondo clic con il tasto destro sono disponibili altre azioni: |
|||
Right clicking in an empty space of the view, or with a property selected, shows only one command: |
|||
* {{MenuCommand|Mostra tutto}}: disattiva il comando {{MenuCommand|Mostra tutto}} e nasconde le proprietà aggiuntive di Dati e Vista. |
|||
* {{MenuCommand|Show all}}: if active, in addition to the standard properties that appear already, it shows all the hidden Data and View properties in their respective tabs. |
|||
* {{MenuCommand|Aggiungi proprietà}}: aggiunge una proprietà dinamica all'oggetto; funziona con oggetti definiti in [[scripted objects/it|script]] C++ e Python. |
|||
** Data: "Proxy", "Label2", "Expression Engine", and "Visibility". |
|||
* {{MenuCommand|Espressione}}: visualizza l'editor delle formule, che consente di utilizzare le [[Expressions/it|espressioni]] nel valore della proprietà. |
|||
** View: "Proxy". |
|||
* {{MenuCommand|Hidden}}: se attivo, imposta la proprietà come nascosta, il che significa che verrà visualizzata nell'editor delle proprietà solo se {{MenuCommand|Mostra tutto}} è attivo. |
|||
* {{MenuCommand|Output}}: se attivo, imposta la proprietà come output. |
|||
When the {{MenuCommand|Show all}} option is active, and one property is selected, more actions are available with a second right click: |
|||
* {{MenuCommand|NoRecompute}}: se attivo, imposta la proprietà come non ricalcolata quandi il documento viene ricalcolato; è utile quando una proprietà non deve essere influenzata da altri aggiornamenti. |
|||
* {{MenuCommand|Show all}}: deactivates the {{MenuCommand|Show all}} command, hiding the additional Data and View properties. |
|||
* {{MenuCommand|ReadOnly}}: se attivo, imposta la proprietà in sola lettura; non sarà più modificabile nell'editor delle proprietà fino a quando questo interruttore non viene disattivato.La voce di menu {{MenuCommand|Expression...}} non è più disponibile. {{Emphasis|Nota:}} Potrebbe essere ancora possibile modificare la proprietà tramite una finestra di dialogo che aggiorna la proprietà. |
|||
* {{MenuCommand|Add Property}}: adds a dynamic property to the object; this works with both C++ and Python [[scripted objects|scripted objects]]. |
|||
* {{MenuCommand|Transient}}: se attivo, imposta la proprietà come transitoria. Il valore di una proprietà transitoria non viene salvato su file. Quando si apre un file, viene istanziata con il suo valore predefinito. |
|||
* {{MenuCommand|Expression}}: brings up the formula editor, which allows using [[Expressions|expressions]] in the property value. |
|||
* {{MenuCommand|Touched}}: se attivo, viene toccato e pronto per il ricalcolo. |
|||
* {{MenuCommand|Hidden}}: if active, sets the property as hidden, meaning that it will only be displayed if {{MenuCommand|Show all}} is active. |
|||
* {{MenuCommand| |
* {{MenuCommand|EvalOnRestore}}: se attivo, viene valutato al ripristino del documento. |
||
* {{MenuCommand|NoRecompute}}: if active, sets the property as not recomputed when the document is recomputed; this is useful when a property should be kept unaffected by other updates. |
|||
* {{MenuCommand|ReadOnly}}: if active, sets the property to be read-only; it won't be editable any more until this switch is turned off. |
|||
* {{MenuCommand|Transient}}: if active, sets the property as transient. |
|||
* {{MenuCommand|Touched}}: if active, it becomes touched, and ready for recompute. |
|||
* {{MenuCommand|EvalOnRestore}}: if active, it is evaluated when the document is restored. |
|||
<span id="Example_of_the_properties_of_a_PartDesign_object"></span> |
|||
==Esempio di proprietà di un oggetto PartDesign== |
==Esempio di proprietà di un oggetto PartDesign== |
||
In questa sezione mostriamo alcune proprietà comuni che sono visibili per un [[Corpo PartDesign|Corpo PartDesign]] e una [[Funzione PartDesign|Funzione PartDesign]]. Le proprietà specifiche di un oggetto possono essere trovate nella pagina della documentazione specifica di quell'oggetto. |
|||
<span id="View"></span> |
|||
===Vista=== |
===Vista=== |
||
La maggior parte di queste proprietà viene ereditata dall'oggetto di base [[Part_Feature/it|Funzione Part]]. |
|||
[[File:FreeCAD_Properties_View.png|490px|left]] |
|||
[[File:FreeCAD_Property_editor_View.png|490px|frame|left]] |
|||
{{TitleProperty|Base}} |
{{TitleProperty|Base}} |
||
* {{PropertyView|Angular Deflection}}: è un altro modo per specificare quanto finemente generare la mesh per il rendering sullo schermo o durante l'esportazione. Il valore predefinito è 28,5 gradi o 0,5 radianti. Più piccolo è il valore, più uniforme sarà l'aspetto in [[3D_view/it|Vista 3D]] e più fine sarà la mesh che verrà esportata. |
|||
* {{PropertyView|Bounding Box}} : Indica se deve essere visualizzata una casella (riquadro di delimitazione) che mostra l'ingombro complessivo dell'oggetto. Valore Falso o Vero (predefinito, Falso). |
|||
* {{PropertyView| |
* {{PropertyView|Bounding Box}}: Indica se deve essere visualizzata una casella che mostra l'ingombro complessivo dell'oggetto. |
||
* {{PropertyView|Deviation}} |
* {{PropertyView|Deviation}}: imposta la precisione della rappresentazione poligonale del modello nella vista 3D (tassellatura). Valori più bassi indicano una migliore qualità. Il valore è in percentuale della dimensione dell'oggetto. |
||
* {{PropertyView|Display Mode}} |
* {{PropertyView|Display Mode}}: modalità di visualizzazione dell'intero corpo,{{Value|Flat lines}} (default), {{Value|Shaded}}, {{Value|Wireframe}}, {{Value|Points}}. |
||
* {{PropertyView|Display Mode Body}}: modalità di visualizzazione della punta del corpo, {{Value|Through}} (default), {{Value|Tip}}. |
|||
* {{PropertyView|Lighting}} : Illuminazione '''One side, Two side''' [[IMAGE:Vue_Lighting_fr_00.png|96px]]. (Default, '''Two side'''). |
|||
* {{PropertyView|Draw Style}}: {{Value|Solid}}, {{Value|Dashed}}, {{Value|Dotted}}, {{Value|Dashdot}}; definisce lo stile dei bordi nella [[3D_view/it|vista 3D]]. |
|||
* {{PropertyView|Line Color}} : Dà il colore della linea (bordi) (Default, '''25, 25, 25'''). |
|||
* {{PropertyView| |
* {{PropertyView|Lighting}}: {{Value|One side}}, {{Value|Two side}} (default). |
||
* {{PropertyView| |
* {{PropertyView|Line Color}}: il colore RGB dei bordi, di default {{value|(25, 25, 25)}}. |
||
* {{PropertyView| |
* {{PropertyView|Line Width}}: lo spessore dei bordi, di default {{value|2}} pixels. |
||
* {{PropertyView|On Top When Selected}}: {{value|Disabled}}, {{value|Enabled}}, {{value|Object}}, {{value|Element}}. |
|||
* {{PropertyView|Selectable}} : Consente la selezione della funzione. Valore Falso o Vero (predefinito, Vero). |
|||
* {{PropertyView| |
* {{PropertyView|Point Color}}: il colore RGB dei vertici, di default {{value|(25, 25, 25)}}. |
||
* {{PropertyView| |
* {{PropertyView|Point Size}}: la dimensione dei vertici, di default {{value|2}} pixels. |
||
* {{PropertyView|Selectable}}: se l'oggetto è selezionabile o meno. |
|||
* {{PropertyView|Visibility}} : Determina la visibilità della funzione (come la barra {{KEY|SPACE}}). Valore Falso o Vero (predefinito, Vero). |
|||
* {{PropertyView|Selection Style}}: {{value|Shape}}, {{value|BoundBox}}. |
|||
* {{PropertyView|Shape Color}}: il colore RGB della forma, di default {{value|(204, 204, 204)}}. |
|||
* {{PropertyView|Show In Tree}}: se è {{TRUE}}, l'oggetto appare nella vista ad albero. Altrimenti, è impostato come invisibile. |
|||
* {{PropertyView|Transparency}}: imposta il grado di trasparenza nella funzione da '''0''' a '''100''' (Default, '''0'''). |
|||
* {{PropertyView|Visibility}}: se l'oggetto è visibile o no nella [[3D_view/it|vista 3D]]. Commuta con la barra {{KEY|Space}} della tastiera. |
|||
{{clear}} |
|||
{{clear}} |
{{clear}} |
||
<span id="Data"></span> |
|||
=== Dati === |
=== Dati === |
||
In questo caso osserviamo le proprietà dello strumento [[PartDesign_Revolution/it|Rivoluzione di PartDesign]]. |
|||
[[File:FreeCAD_Properties_Data.png|490px|left]] |
|||
[[File:FreeCAD_Property_editor_Data.png|490px|frame|left]] |
|||
{{TitleProperty|Base}} |
{{TitleProperty|Base}} |
||
* {{ProprietaDati|Label}}: il nome definito dall'utente assegnato all'oggetto, questo può essere modificato a piacere. |
|||
* {{PropertyData|Placement}} : |
|||
Ogni funzione ha un posizionamento che può essere controllato tramite la tabella delle proprietà dei dati. Placement controlla il posizionamento della parte rispetto al sistema di coordinate. NOTA: le proprietà di posizionamento non influenzano le dimensioni fisiche della funzione, ma semplicemente la sua posizione nello spazio!<br>Se si seleziona il titolo '''Placement''' [[Image:Tache_Placement_01_fr_00.png|256px|Options Placement]], alla sua destra appare un pulsante con {{KEY|tre puntini}}. Cliccando su questi {{KEY| '''...'''}}, si apre la finestra delle opzioni per il '''[[Tasks_Placement/it|Posizionamento]]'''. |
|||
{{TitleProperty|Part Design}} |
|||
* {{ProprietaDati|Angle}}: |
|||
* {{PropertyData|Refine}}: se affinare la fusione fatta con altri oggetti. |
|||
L'argomento Angolo specifica l'angolo da utilizzare con l'opzione Axis. In questa opzione si stabilisce un angolo, poi sotto, con l'opzione Axis, si imposta l'asse sul quale si vuole utilizzare questo angolo. |
|||
L'operazione viene ruotata dell'angolo specificato, attorno all'asse specificato. Un esempio di utilizzo potrebbe essere quando si crea una operazione rivoluzione, ma poi serve ruotare l'intera operazione di un certo valore, per allinearla con una diversa operazione preesistente. |
|||
{{TitleProperty|Rivoluzione}} |
|||
* {{ProprietaDati|Axis}}: |
|||
* {{PropertyData|Base}}: il punto nello spazio che specifica dove avviene la rivoluzione. Non può essere modificato direttamente, solo durante la modifica della funzione. |
|||
Questa opzione specifica l'asse o gli assi su cui l'operazione creata deve essere ruotata. Il valore di rotazione esatto viene dalla opzione angolo (sopra). |
|||
Questa opzione ha tre argomenti, che vengono passati come numeri alle rispettive caselle di testo X, Y, Z dello strumento. Inserendo un valore in più di uno degli assi si causa la rotazione della parte del corrispondente angolo per ogni asse. Per esempio, con un angolo impostato pari a 15°, specificando un valore di 1,0 per X, e di 2,0 per Y causa una rotazione finale del pezzo di 15° sull'asse X e di 30° sull'asse Y. |
|||
* {{PropertyData|Asse}}: l'asse attorno al quale verrà eseguita la rivoluzione. Non può essere modificato direttamente, solo durante la modifica della funzione. |
|||
* {{ProprietaDati|Position}}: |
|||
Questa opzione specifica il punto base, ovvero, il punto a cui tutte le dimensioni si riferiscono. Questa opzione ha tre argomenti, che vengono passati come numeri alle rispettive caselle di testo X, Y, Z dello strumento. Inserendo un valore in una o più caselle si produce una traslazione della parte sull'asse corrispondente, pari al numero di unità indicate. |
|||
* {{PropertyData|Angolo}}: l'angolo che specifica quanto dell'elemento base viene ruotato. Per impostazione predefinita è {{value|360 gradi}}, ma può essere qualsiasi sua frazione. |
|||
* {{ProprietaDati|Label}}: |
|||
Label è il nome attribuito all'operazione, questo nome può essere modificato a discrezione. |
|||
{{TitleProperty|Sketch Based}} |
|||
{{docnav/it|[[Interface Customization/it|Personalizzare l'interfaccia]]|[[Workbenches/it|Ambienti di lavoro]]}} |
|||
* {{PropertyData|Midplane}}: se l'oggetto di base è uno [[Sketch|Sketch]], quando questa proprietà è {{TRUE}}, eseguirà la rivoluzione con lo schizzo che funge da piano di simmetria. Questo è evidente se l' {{PropertyData|Angolo}} è diverso da {{value|360 gradi}}. |
|||
* {{PropertyData|Reversed}}: di default è {{TRUE}}. Indica se eseguire la rivoluzione in una direzione o nell'altra. |
|||
{{clear}} |
|||
== Scripting == |
|||
{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics/it|Script di base per FreeCAD]]. |
|||
Vedere [[scripted_objects/it|script di oggetti]] per le informazioni complete sull'aggiunta di proprietà agli oggetti definiti tramite [[Python/it|Python]]. |
|||
È possibile accedere alla maggior parte delle proprietà visibili nell'editor delle proprietà dalla [[Python_console/it|console Python]]. Queste proprietà sono solo attributi della classe che definisce l'oggetto selezionato. Ad esempio, se l'editor delle proprietà mostra la proprietà {{PropertyData|Group}}, significa che l'oggetto ha l'attributo {{incode|Group}}. |
|||
{{Code|code= |
|||
print(obj.Group) |
|||
}} |
|||
Questi attributi (proprietà) vengono aggiunti con il metodo {{incode|addProperty}} dell'oggetto base. È necessario specificare almeno il tipo di [[proprietà|proprietà]], e il suo nome. |
|||
{{Code|code= |
|||
obj.addProperty("App::PropertyFloat", "Custom") |
|||
print(obj.Custom) |
|||
}} |
|||
Le proprietà seguono la convenzione {{incode|CapitalCamelCase}} o {{incode|PascalCase}}, il che significa che ogni parola inizia con una lettera maiuscola e non ci sono trattini bassi. Quando l'editor di proprietà visualizza tali nomi, lascia uno spazio tra ogni lettera maiuscola, facilitandone la lettura. |
|||
{{Code|code= |
|||
obj.addProperty("App::PropertyDistance", "CustomCamelProperty") |
|||
obj.CustomCamelProperty = 1000 |
|||
print(obj.CustomCamelProperty) |
|||
}} |
|||
[[File:FreeCAD_Property_editor_Custom.png]] |
|||
{{Caption|Editor di proprietà che mostra le proprietà dei dati di un [[PartDesign Body/it|Corpo PartDesign]], con due proprietà aggiuntive, "Personalizzato" e "Proprietà Camel personalizzata".}} |
|||
In modo simile vengono aggiunte le proprietà {{MenuCommand|View}}, non all'oggetto base, ma al suo {{incode|ViewObject}}. Quindi, ne consegue che proprietà come {{PropertyView|Angular Deflection}}, {{PropertyView|Bounding Box}}, {{PropertyView|Display Mode}}, {{PropertyView|Display Mode Body}}, {{PropertyView|Line Color}}, e altri, possono essere esaminati e modificati dalla [[Python_console/it|console Python]]. |
|||
{{Code|code= |
|||
print(obj.ViewObject.AngularDeflection) |
|||
print(obj.ViewObject.BoundingBox) |
|||
print(obj.ViewObject.DisplayMode) |
|||
print(obj.ViewObject.DisplayModeBody) |
|||
print(obj.ViewObject.LineColor) |
|||
}} |
|||
Tutte le proprietà pubbliche dell'oggetto e del relativo provider di visualizzazione sono contenute nell'attributo {{incode|PropertiesList}} corrispondente. |
|||
{{Code|code= |
|||
print(obj.PropertiesList) |
|||
print(obj.ViewObject.PropertiesList) |
|||
}} |
|||
{{docnav/it |
|||
|[[Document_structure/it|Struttura del documento]] |
|||
|[[Workbenches/it|Ambienti di lavoro]] |
|||
}} |
|||
{{Interface |
{{Interface navi{{#translation:}}}} |
||
{{Std Base navi{{#translation:}}}} |
|||
{{Userdocnavi/it}} |
|||
{{Userdocnavi{{#translation:}}}} |
Latest revision as of 20:39, 31 March 2024
Descrizione
L'editor delle proprietà appare quando è attiva la scheda Modello della vista combinata nell'interfaciia; consente di gestire le proprietà degli oggetti nel documento.
Generalmente, l'editor delle proprietà è destinato a gestire solo un oggetto alla volta. I valori mostrati nell'editor appartengono all'oggetto selezionato nel documento attivo. Nonostante questo, alcune proprietà come i colori, possono essere impostate per più oggetti selezionati. Se non ci sono elementi selezionati, l'editor delle proprietà è vuoto.
Non tutte le proprietà possono sempre essere modificate; a seconda dello stato specifico della proprietà, alcune di esse possono essere invisibili (non elencate) o di sola lettura (non modificabili).
Editore delle proprietà vuoto, quando nessun oggetto è selezionato.
Tipi di proprietà
Una proprietà è un'informazione come un numero o una stringa di testo allegata a un documento di FreeCAD o ad un oggetto del documento.
Gli oggetti creati con script personalizzati possono utilizzare qualsiasi tipo di proprietà definita nel sistema di base. Vedere l'elenco completo in Proprietà degli oggetti.
Alcuni dei tipi di proprietà più comunemente usati sono:
App::PropertyBool
App::PropertyFloat
App::PropertyAngle
App::PropertyDistance
App::PropertyInteger
App::PropertyString
App::PropertyMatrix
App::PropertyVector
App::PropertyPlacement
Oggetti diversi possono avere tipi di proprietà diverse. Tuttavia, molti oggetti hanno gli stessi tipi perché sono derivati dalla stessa classe interna. Ad esempio, la maggior parte degli oggetti che descrivono le forme geometriche (linee, cerchi, rettangoli, corpi solidi, parti importate, ecc.) hanno la proprietà "Posizionamento" che definisce la loro posizione nella Vista 3D.
Proprietà Vista e Dati
Ci sono due classi di proprietà delle funzioni accessibili tramite le schede nell'editore delle proprietà:
- Proprietà Vista relative all'aspetto "visivo" dell'oggetto. Le proprietà Vista sono legate all'attributo ViewProvider (
ViewObject
) dell'oggetto e sono accessibili solo quando viene caricata l'interfaccia utente grafica (GUI). Non sono accessibili quando si utilizza FreeCAD in modalità console o come libreria senza testa. - Proprietà Dati relative ai parametri "fisici" dell'oggetto. Le proprietà Dati definiscono le caratteristiche essenziali dell'oggetto; esistono sempre, anche quando FreeCAD viene utilizzato in modalità console o come libreria. Ciò significa che se si carica un documento in modalità console, è possibile modificare il raggio di un cerchio o la lunghezza di una linea, anche se non è possibile visualizzare il risultato sullo schermo.
Per questo motivo, le proprietà Dati sono considerate più "reali", in quanto definiscono veramente la geometria di una forma. Invece le proprietà Vista sono meno importanti perché influenzano solo l'aspetto supericiale della geometria. Ad esempio, un cerchio di raggio di 10 mm è diverso da un cerchio di raggio di 5 mm; il colore del cerchio (proprietà vista) non influisce sulla sua forma, ma il raggio (proprietà dati) sì. In molti casi in questa documentazione, si intende che la parola "proprietà" si riferisce a una "proprietà dati" e non ad una "proprietà vista".
Proprietà di base
Vedere anche: Nome dell'oggetto
L'oggetto script più semplice non mostra alcuna proprietà Dati nell'editor delle proprietà, ad eccezione dell'attributo Label
. Label
è una stringa modificabile dall'utente che identifica l'oggetto nella vista ad albero. Invece, l'attributo Name
di un oggetto viene assegnato al momento della sua creazione e non può essere modificato; questo attributo è di sola lettura e non viene nemmeno visualizzato nell'editor delle proprietà.
Un oggetto parametrico di base viene creato nel modo seguente:
obj = App.ActiveDocument.addObject("App::FeaturePython", "App__FeaturePython")
obj.Label = "Plain_object"
print(obj.Name)
print(obj.Label)
Schede Vista e Dati dell'editor delle proprietà, per un oggetto script di base "App::FeaturePython".
La maggior parte degli oggetti geometrici che possono essere creati e visualizzati nella vista 3D sono derivati da una Part::Feature
. Vedere Part Feature per le proprietà più basilari di questi oggetti.
Per la geometria 2D, la maggior parte degli oggetti deriva da Part::Part2DObject
(essi stessi derivati da Part::Feature
) che sono la base di Schizzi, e di molti elementi di Draft. Vedere Part Part2DObject per le proprietà più basilari di questi oggetti.
Azioni
Facendo clic con il tasto destro in uno spazio vuoto della vista o con una proprietà selezionata, viene visualizzato solo un comando:
- Mostra tutto: se attivo, oltre alle proprietà standard che appaiono già, mostra tutti i dati nascosti e visualizza le proprietà nelle rispettive schede.
- Dati: "Proxy", "Label2", "Expression Engine", and "Visibility".
- Vista: "Proxy".
Quando l'opzione Mostra tutto è attiva e viene selezionata una proprietà, facendo un secondo clic con il tasto destro sono disponibili altre azioni:
- Mostra tutto: disattiva il comando Mostra tutto e nasconde le proprietà aggiuntive di Dati e Vista.
- Aggiungi proprietà: aggiunge una proprietà dinamica all'oggetto; funziona con oggetti definiti in script C++ e Python.
- Espressione: visualizza l'editor delle formule, che consente di utilizzare le espressioni nel valore della proprietà.
- Hidden: se attivo, imposta la proprietà come nascosta, il che significa che verrà visualizzata nell'editor delle proprietà solo se Mostra tutto è attivo.
- Output: se attivo, imposta la proprietà come output.
- NoRecompute: se attivo, imposta la proprietà come non ricalcolata quandi il documento viene ricalcolato; è utile quando una proprietà non deve essere influenzata da altri aggiornamenti.
- ReadOnly: se attivo, imposta la proprietà in sola lettura; non sarà più modificabile nell'editor delle proprietà fino a quando questo interruttore non viene disattivato.La voce di menu Expression... non è più disponibile. Nota: Potrebbe essere ancora possibile modificare la proprietà tramite una finestra di dialogo che aggiorna la proprietà.
- Transient: se attivo, imposta la proprietà come transitoria. Il valore di una proprietà transitoria non viene salvato su file. Quando si apre un file, viene istanziata con il suo valore predefinito.
- Touched: se attivo, viene toccato e pronto per il ricalcolo.
- EvalOnRestore: se attivo, viene valutato al ripristino del documento.
Esempio di proprietà di un oggetto PartDesign
In questa sezione mostriamo alcune proprietà comuni che sono visibili per un Corpo PartDesign e una Funzione PartDesign. Le proprietà specifiche di un oggetto possono essere trovate nella pagina della documentazione specifica di quell'oggetto.
Vista
La maggior parte di queste proprietà viene ereditata dall'oggetto di base Funzione Part.
Base
- VistaAngular Deflection: è un altro modo per specificare quanto finemente generare la mesh per il rendering sullo schermo o durante l'esportazione. Il valore predefinito è 28,5 gradi o 0,5 radianti. Più piccolo è il valore, più uniforme sarà l'aspetto in Vista 3D e più fine sarà la mesh che verrà esportata.
- VistaBounding Box: Indica se deve essere visualizzata una casella che mostra l'ingombro complessivo dell'oggetto.
- VistaDeviation: imposta la precisione della rappresentazione poligonale del modello nella vista 3D (tassellatura). Valori più bassi indicano una migliore qualità. Il valore è in percentuale della dimensione dell'oggetto.
- VistaDisplay Mode: modalità di visualizzazione dell'intero corpo,
Flat lines
(default),Shaded
,Wireframe
,Points
. - VistaDisplay Mode Body: modalità di visualizzazione della punta del corpo,
Through
(default),Tip
. - VistaDraw Style:
Solid
,Dashed
,Dotted
,Dashdot
; definisce lo stile dei bordi nella vista 3D. - VistaLighting:
One side
,Two side
(default). - VistaLine Color: il colore RGB dei bordi, di default
(25, 25, 25)
. - VistaLine Width: lo spessore dei bordi, di default
2
pixels. - VistaOn Top When Selected:
Disabled
,Enabled
,Object
,Element
. - VistaPoint Color: il colore RGB dei vertici, di default
(25, 25, 25)
. - VistaPoint Size: la dimensione dei vertici, di default
2
pixels. - VistaSelectable: se l'oggetto è selezionabile o meno.
- VistaSelection Style:
Shape
,BoundBox
. - VistaShape Color: il colore RGB della forma, di default
(204, 204, 204)
. - VistaShow In Tree: se è
true
, l'oggetto appare nella vista ad albero. Altrimenti, è impostato come invisibile. - VistaTransparency: imposta il grado di trasparenza nella funzione da 0 a 100 (Default, 0).
- VistaVisibility: se l'oggetto è visibile o no nella vista 3D. Commuta con la barra Space della tastiera.
Dati
In questo caso osserviamo le proprietà dello strumento Rivoluzione di PartDesign.
Base
- DatiLabel: il nome definito dall'utente assegnato all'oggetto, questo può essere modificato a piacere.
Part Design
- DatiRefine: se affinare la fusione fatta con altri oggetti.
Rivoluzione
- DatiBase: il punto nello spazio che specifica dove avviene la rivoluzione. Non può essere modificato direttamente, solo durante la modifica della funzione.
- DatiAsse: l'asse attorno al quale verrà eseguita la rivoluzione. Non può essere modificato direttamente, solo durante la modifica della funzione.
- DatiAngolo: l'angolo che specifica quanto dell'elemento base viene ruotato. Per impostazione predefinita è
360 gradi
, ma può essere qualsiasi sua frazione.
Sketch Based
- DatiMidplane: se l'oggetto di base è uno Sketch, quando questa proprietà è
true
, eseguirà la rivoluzione con lo schizzo che funge da piano di simmetria. Questo è evidente se l' DatiAngolo è diverso da360 gradi
. - DatiReversed: di default è
true
. Indica se eseguire la rivoluzione in una direzione o nell'altra.
Scripting
See also: Script di base per FreeCAD.
Vedere script di oggetti per le informazioni complete sull'aggiunta di proprietà agli oggetti definiti tramite Python.
È possibile accedere alla maggior parte delle proprietà visibili nell'editor delle proprietà dalla console Python. Queste proprietà sono solo attributi della classe che definisce l'oggetto selezionato. Ad esempio, se l'editor delle proprietà mostra la proprietà DatiGroup, significa che l'oggetto ha l'attributo Group
.
print(obj.Group)
Questi attributi (proprietà) vengono aggiunti con il metodo addProperty
dell'oggetto base. È necessario specificare almeno il tipo di proprietà, e il suo nome.
obj.addProperty("App::PropertyFloat", "Custom")
print(obj.Custom)
Le proprietà seguono la convenzione CapitalCamelCase
o PascalCase
, il che significa che ogni parola inizia con una lettera maiuscola e non ci sono trattini bassi. Quando l'editor di proprietà visualizza tali nomi, lascia uno spazio tra ogni lettera maiuscola, facilitandone la lettura.
obj.addProperty("App::PropertyDistance", "CustomCamelProperty")
obj.CustomCamelProperty = 1000
print(obj.CustomCamelProperty)
Editor di proprietà che mostra le proprietà dei dati di un Corpo PartDesign, con due proprietà aggiuntive, "Personalizzato" e "Proprietà Camel personalizzata".
In modo simile vengono aggiunte le proprietà View, non all'oggetto base, ma al suo ViewObject
. Quindi, ne consegue che proprietà come VistaAngular Deflection, VistaBounding Box, VistaDisplay Mode, VistaDisplay Mode Body, VistaLine Color, e altri, possono essere esaminati e modificati dalla console Python.
print(obj.ViewObject.AngularDeflection)
print(obj.ViewObject.BoundingBox)
print(obj.ViewObject.DisplayMode)
print(obj.ViewObject.DisplayModeBody)
print(obj.ViewObject.LineColor)
Tutte le proprietà pubbliche dell'oggetto e del relativo provider di visualizzazione sono contenute nell'attributo PropertiesList
corrispondente.
print(obj.PropertiesList)
print(obj.ViewObject.PropertiesList)
- Preferences Editor, Interface Customization
- Main window: Standard menu, Main view area, 3D view, Combo view (Tree view, Task panel, Property editor), Selection view, Report view, Python console, Status bar, DAG view, Workbench Selector
- Auxiliary windows: Scene inspector, Dependency graph
- File: New, Open, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Project information, Print, Print preview, Export PDF, Recent files, Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Box selection, Box element selection, Select All, Delete, Send to Python Console, Placement, Transform, Alignment, Toggle Edit mode, Edit mode, Preferences
- View:
- Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Texture mapping, Toggle navigation/Edit mode, Appearance, Random color, Workbench, Status bar
- Standard views: Fit all, Fit selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right
- Freeze display: Save views, Load views, Freeze view, Clear views
- Draw style: As is, Points, Wireframe, Hidden line, No shading, Shaded, Flat lines
- Stereo: Stereo red/cyan, Stereo quad buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue camera position
- Zoom: Zoom In, Zoom Out, Box zoom
- Document window: Docked, Undocked, Fullscreen
- Visibility: Toggle visibility, Show selection, Hide selection, Select visible objects, Toggle all objects, Show all objects, Hide all objects, Toggle selectability, Toggle measurement, Clear measurement
- Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Structure, Help
- Panels: Tree view, Property view, Selection view, Tasks, Python console, DAG view, Model, Report view
- Link navigation: Go to linked object, Go to the deepest linked object, Select all links
- Tree view actions: Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection, Selection Back, Selection Forward
- Tools: Edit parameters, Save image, Load image, Scene inspector, Dependency graph, Project utility, Measure distance, Add text document, View turntable, Units calculator, Customize, Addon manager
- Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint
- Help: Help, FreeCAD Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, FreeCAD Forum, FreeCAD FAQ, Report a bug, About FreeCAD, What's This
- 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