Part Feature/it

Introduzione


Un oggetto Part Feature, o formalmente un, è un elemento semplice a cui è associato un topologico che può essere visualizzato nella Vista 3D.



Utilizzo
Part Feature è un oggetto interno, quindi non può essere creato dall'interfaccia grafica, ma solo dalla console Python come descritto nel paragrafo Script.

L'oggetto è definito in Part ma può essere usato come classe base per script di oggetti in tutti gli ambienti che producono forme geometriche 2D e 3D. Ad esempio, è la classe genitrice del Corpo PartDesign e di Part Part2DObject, che à specializzata in forme 2D (planari).

Un oggetto ha proprietà semplici come il posizionamento e le proprietà vista per definire l'aspetto dei suoi vertici, bordi e facce. Gli ambienti possono aggiungere altre proprietà a questo elemento di base per produrre un oggetto con un comportamento complesso.

Proprietà
A Part Feature ( class) is derived from the basic App GeoFeature ( class), therefore it shares all the latter's properties.

In addition to the properties described in App GeoFeature, the Part Feature has the property, which stores the Part TopoShape of this object; this is the geometry that is shown in the 3D view.

Other properties that this object has are those related to the appearance of this TopoShape, including, , , , , , , , and also the hidden properties , , , , and.

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

Queste sono le proprietà disponibili nell'editor delle proprietà.

Dati

 * : la posizione dell'oggetto nella Vista 3D. Il posizionamento è definito da un punto (vettore) e una  (asse e angolo). Vedere Posizionamento.
 * : l'angolo di rotazione attorno al.
 * : il vettore unitario che definisce l'asse di rotazione per il posizionamento. Ogni valore è compreso tra 0 e 1. Se un valore è superiore a 1, il vettore viene normalizzato in modo che l'entità del vettore sia 1.
 * : le coordinate 3D del punto base del posizionamento.
 * : la descrizione modificabile dall'utente di questo oggetto.

Hidden properties Data

 * : a list of expressions. By default, it is empty.
 * : a longer, user editable description of this object, it is an arbitrary UTF8 string. By default, it is an empty string.
 * : a class associated with this object.
 * : a Part TopoShape class associated with this object.
 * : whether to display the object or not.

Vista
La maggior parte degli oggetti in FreeCAD ha quello che viene chiamato un "fornitore di viste", che è una classe che definisce l'aspetto visivo dell'oggetto nella vista 3D e nella vista ad albero. Il fornitore di viste predefinito degli oggetti Part Feature definisce le seguenti proprietà. Anche gli oggetti con script derivati da Part Feature hanno accesso a queste proprietà.


 * : accompagna . È un altro modo per specificare la precisione con cui generare la mesh per il rendering sullo schermo o durante l'esportazione. Il valore predefinito è 28,5 gradi o 0,5 radianti. Minore è il valore, più uniforme sarà l'aspetto nella vista 3D e più fine sarà la mesh che verrà esportata.
 * : se è, l'oggetto mostra il parallelepipedo che lo contiene nella vista 3D.
 * : accompagna . È un altro modo per specificare la precisione con cui generare la mesh per il rendering sullo schermo o durante l'esportazione. Il valore predefinito è 28,5 gradi o 0,5 radianti. Minore è il valore, più uniforme sarà l'aspetto nella vista 3D e più fine sarà la mesh che verrà esportata.
 * : Flat lines (visualizzazione normale con facce piene), Ombreggiato (bordi leggeri), Wireframe (solo reticolo e facce vuote), Punti (solo vertici).
 * : Solid, Dashed, Dotted, Dashdot; definisce lo stile dei bordi nella vista 3D.
 * : Two side, One side; l'illuminazione proviene da due lati o un lato nella vista 3D.
 * : una tupla di tre valori per definire il colore dei bordi nella vista 3D.
 * : un flottante che determina la larghezza in pixel dei bordi nella vista 3D.
 * : Disabled, Enabled, Object, Element.
 * : una tupla di tre valori per definire il colore dei vertici nella vista 3D.
 * : un flottante che determina la dimensione in pixel dei vertici nella vista 3D.
 * : se è, l'oggetto può essere selezionato con il puntatore nella vista 3D. Altrimenti, l'oggetto non può essere selezionato fino a quando questa opzione non è impostata su.
 * : Shape, BoundBox.
 * : una tupla di tre valori per definire il colore delle facce nella vista 3D.
 * : se è, l'oggetto appare nella vista ad albero. Altrimenti, è impostato come invisibile.
 * : un valore da 0 a 100 che determina il livello di trasparenza delle facce nella vista 3D. Un valore di 100 indica facce completamente invisibili; le facce che sono invisibili possono comunque essere selezionate se è.
 * : se è, l'oggetto appare nella vista 3D; altrimenti non è visibile. Per impostazione predefinita, questa proprietà può essere attivata e disattivata premendo la barra sulla tastiera.

The deviation is a value in percentage that is related to the dimensions in millimeters of the bounding box of the object. The deviation in millimeters can be calculated as follows:

where, , are the bounding box dimensions.


 * : (regular visualization),  (no edges),  (no faces),  (only vertices).
 * : (default),, , ; defines the style of the edges in the 3D view.
 * : (default), ; the illumination comes from two sides or one side in the 3D view.
 * : a tuple of three floating point RGB values to define the color of the edges in the 3D view; by default it is, which is displayed as  on base 255, almost black.
 * : a float that determines the width in pixels of the edges in the 3D view. It defaults to.
 * : (default),, ,.
 * : similar to, defines the color of the vertices.
 * : similar to, defines the size of the vertices.
 * : if it is, the object can be picked with the pointer in the 3D view. Otherwise, the object cannot be selected until this option is set to.
 * : (default), . If the option is, the entire shape (vertices, edges, and faces) will be highlighted in the 3D view; if it is  only the bounding box will be highlighted.
 * : similar to, defines the color of the faces. It defaults to , which is displayed as on base 255, a light gray.
 * : if it is, the object appears in the tree view. Otherwise, it is set as invisible.
 * : an integer from to  (a percentage) that determines the level of transparency of the faces in the 3D view. A value of  indicates completely invisible faces; the faces are invisible but they can still be picked as long as  is.
 * : if it is, the object appears in the 3D view; otherwise it is invisible. By default this property can be toggled on and off by pressing the bar in the keyboard.

Hidden properties View

 * : it is a list of RGB tuples defining colors, similar to . It defaults to a list of one.
 * : it is a list of RGB tuples defining colors, similar to . It defaults to a list of one.
 * : an App Material associated with the edges in this object. By default it is empty.
 * : it is a list of RGB tuples defining colors, similar to . It defaults to a list of one.
 * : an App Material associated with the vertices in this object. By default it is empty.
 * : a custom view provider class associated with this object. By default it is empty.
 * : an App Material associated with this object. By default it is empty.

Script
Script di base per FreeCAD, e script di oggetti.

Un oggetto Part Feature viene creato con il metodo del documento.

This basic doesn't have a Proxy object so it can't be fully used for sub-classing.

Therefore, for Python scripting, the recommendation is to create the object.


 * Il primo argomento indica il tipo di oggetto, in questo caso,.
 * Il secondo argomento è una stringa che definisce l'attributo . Se non viene fornito, per impostazione predefinita è.
 * Il viene stabilito al momento della creazione; non può essere modificato in seguito.
 * Il può includere solo caratteri alfanumerici semplici e il trattino basso, . Se vengono forniti altri simboli, questi verranno convertiti in caratteri di sottolineatura; per esempio,  viene convertito in.
 * Il deve essere unico in tutto il documento. Se vengono creati più oggetti con lo stesso nome, viene aggiunto un numero sequenziale per distinguerli, ad esempio,, , etc.
 * Se lo si desidera, l'attributo può essere modificato in un testo più significativo.
 * Di default, è uguale a.
 * A differenza di, può accettare qualsiasi stringa UTF8, inclusi accenti e spazi. Poiché la vista ad albero visualizza , è buona norma cambiare  in una stringa più descrittiva.
 * Di default, deve essere univoco. Questo comportamento può essere modificato nell'editor delle preferenze,.