Property editor/it

Descrizione
L'editor delle proprietà appare quando è attiva la scheda 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).





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:

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à relative all'aspetto "visivo" dell'oggetto. Le proprietà  sono legate all'attributo   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à relative ai parametri "fisici" dell'oggetto. Le proprietà  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à sono considerate più "reali", in quanto definiscono veramente la geometria di una forma. Invece le proprietà 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
L'oggetto script più semplice non mostra alcuna proprietà nell'editor delle proprietà, ad eccezione dell'attributo. è una stringa modificabile dall'utente che identifica l'oggetto nella vista ad albero. Invece, l'attributo 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:



La maggior parte degli oggetti geometrici che possono essere creati e visualizzati nella vista 3D sono derivati da una. Vedere Part Feature per le proprietà più basilari di questi oggetti.

Per la geometria 2D, la maggior parte degli oggetti deriva da (essi stessi derivati da ) 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:
 * : 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 è attiva e viene selezionata una proprietà, facendo un secondo clic con il tasto destro sono disponibili altre azioni:
 * : disattiva il comando e nasconde le proprietà aggiuntive di Dati e Vista.
 * : aggiunge una proprietà dinamica all'oggetto; funziona con oggetti definiti in script C++ e Python.
 * : visualizza l'editor delle formule, che consente di utilizzare le espressioni nel valore della proprietà.
 * : se attivo, imposta la proprietà come nascosta, il che significa che verrà visualizzata nell'editor delle proprietà solo se è attivo.
 * : se attivo, imposta la proprietà come output.
 * : se attivo, imposta la proprietà come non ricalcolata quandi il documento viene ricalcolato; è utile quando una proprietà non deve essere influenzata da altri aggiornamenti.
 * : 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 non è più disponibile.  Potrebbe essere ancora possibile modificare la proprietà tramite una finestra di dialogo che aggiorna la proprietà.
 * : 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.
 * : se attivo, viene toccato e pronto per il ricalcolo.
 * : 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.




 * : è 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.
 * : Indica se deve essere visualizzata una casella che mostra l'ingombro complessivo dell'oggetto.
 * : 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.
 * : modalità di visualizzazione dell'intero corpo, (default),, ,.
 * : modalità di visualizzazione della punta del corpo, (default),.
 * :, , , ; definisce lo stile dei bordi nella vista 3D.
 * :, (default).
 * : il colore RGB dei bordi, di default.
 * : lo spessore dei bordi, di default pixels.
 * : il colore RGB dei vertici, di default.
 * : la dimensione dei vertici, di default pixels.
 * : se l'oggetto è selezionabile o meno.
 * : il colore RGB della forma, di default.
 * : se è, l'oggetto appare nella vista ad albero. Altrimenti, è impostato come invisibile.
 * : imposta il grado di trasparenza nella funzione da 0 a 100 (Default, 0).
 * : se l'oggetto è visibile o no nella vista 3D. Commuta con la barra della tastiera.
 * : imposta il grado di trasparenza nella funzione da 0 a 100 (Default, 0).
 * : se l'oggetto è visibile o no nella vista 3D. Commuta con la barra della tastiera.

Dati
In questo caso osserviamo le proprietà dello strumento Rivoluzione di PartDesign.




 * : il nome definito dall'utente assegnato all'oggetto, questo può essere modificato a piacere.


 * : se affinare la fusione fatta con altri oggetti.


 * : il punto nello spazio che specifica dove avviene la rivoluzione. Non può essere modificato direttamente, solo durante la modifica della funzione.


 * : l'asse attorno al quale verrà eseguita la rivoluzione. Non può essere modificato direttamente, solo durante la modifica della funzione.


 * : l'angolo che specifica quanto dell'elemento base viene ruotato. Per impostazione predefinita è, ma può essere qualsiasi sua frazione.


 * : se l'oggetto di base è uno Sketch, quando questa proprietà è, eseguirà la rivoluzione con lo schizzo che funge da piano di simmetria. Questo è evidente se l' è diverso da.
 * : di default è . Indica se eseguire la rivoluzione in una direzione o nell'altra.

Scripting
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à, significa che l'oggetto ha l'attributo.

Questi attributi (proprietà) vengono aggiunti con il metodo dell'oggetto base. È necessario specificare almeno il tipo di proprietà, e il suo nome.

Le proprietà seguono la convenzione o, 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.



In modo simile vengono aggiunte le proprietà, non all'oggetto base, ma al suo. Quindi, ne consegue che proprietà come, , , , , e altri, possono essere esaminati e modificati dalla console Python.

Tutte le proprietà pubbliche dell'oggetto e del relativo provider di visualizzazione sono contenute nell'attributo corrispondente.