Std Part/it

Descrizione
Parte è un contenitore per scopi generali che contiene un gruppo di oggetti in modo che essi possano essere spostati come una singola unità. Parte può contenere la maggior parte, se non qualsiasi oggetto di FreeCAD, come i corpi di PartDesign, gli oggetti dell'ambiente Parte, gli oggetti mesh, ecc.

Parte fornisce un sistema di coordinate locali a cui è possibile associare schizzi e altri oggetti.

Although it is primarily intended for solid bodies, the Std Part can be used to manage any object that has a Placement property, so it can also contain Mesh Features, sketches, and other objects derived from App GeoFeature.

Parte si trova nella barra degli strumenti Struttura che viene visualizzata in tutti gli ambienti.

To group objects in general use Std Group. This object does not affect the positions of the elements that it contains; it is essentially just a folder that is used to keep the tree view organized.



Utilizzo

 * Premere il pulsante nella barra degli strumenti. La parte diventa automaticamente attiva.
 * Fare doppio clic sulla parte nell'albero del modello per attivarla o disattivarla.
 * Per aggiungere oggetti a una parte, trascinali e rilasciali sulla parte nell'albero del modello.
 * Per rimuovere oggetti da una parte, trascinali e rilasciali fuori dalla parte e sull'etichetta del documento nella parte superiore dell'albero del modello.

Limitazioni

 * Anche quando una parte è attiva, gli oggetti appena creati non sono collocati all'interno della parte, ma al fondo dell'albero. Basta trascinarli sulla parte.
 * Una parte non ha forma. Pertanto, non è possibile applicare la maggior parte delle operazioni 3D su una parte, ad esempio lo operazioni booleane di Part.
 * Nota del redattore: al momento non è chiaro se lo stato attivo della Parte abbia uno scopo.

Proprietà
A Std Part is internally called App Part ( class), and is derived from an App GeoFeature ( class), therefore it shares most of the latter's properties.

In addition to the properties described in App GeoFeature, the App Part class has some properties that help it manage information in the context of an assembly, for example,, , , , , and.

These are the properties available in the property editor. Hidden properties can be shown by using the command in the context menu of the property editor.

Data

 * : ID (Numero di parte) dell'elemento. Questo campo è facoltativo.
 * : la licenza con cui viene rilasciata la parte.
 * : l'indirizzo Web in cui è possibile trovare i termini della licenza.
 * : specifica l'orientamento e la posizione della parte nello spazio 3D. Vedere Posizionamento.
 * : l'etichetta è il nome dato all'operazione. Questo nome può essere cambiato a piacimento.
 * : elenca gli oggetti riferiti.

Hidden properties Data

 * : map with material properties. By default, it is empty.
 * : map with additional meta information. By default, it is empty.
 * : the universally unique identifier (UUID) (128-bit number) of the object. This is assigned at creation time.
 * : a longer, user editable description of this object, it is an arbitrary UTF8 string that may include newlines. By default, it is an empty string.
 * : a list of expressions. By default, it is empty.
 * : whether to display the object or not.
 * : the App Origin object that is the positional reference for all elements listed in.
 * : whether the group is touched or not.

View
The App Part only has the five properties of the basic App FeaturePython, and it does not have hidden properties.


 * : (default),, ,.
 * : (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.
 * : if it is, the object appears in the tree view. Otherwise, it is set as invisible.
 * : 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.
 * : 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.

Esempi di utilizzo

 * Come un contenitore di assemblaggio che raggruppa oggetti da produrre separatamente, e che poi vengono incollati o avvitati insieme, come nel caso di un tavolo di legno.
 * Quando si importa un assieme STEP in FreeCAD, l'assieme principale e i suoi sottoinsiemi sono dei contenitori di Parti.
 * Una parte composta da più componenti non fusi insieme, come un cuscinetto a sfere.

The Std Part is intended to be the basic building block to create assemblies. Unlike a PartDesign Body, an assembly is meant to be a collection of separate, distinguishable elements which are connected in some way in the physical world, for example, through pressure, screws, or glue.

Examples that could be Parts:
 * A wooden table that consists of individual wooden pieces (legs, top), which are put together by glue or metal screws.
 * A ball bearing that is composed of multiple steel balls, an inner ring, a retainer, a seal, and an outer ring.
 * An assembly of a screw with a washer, and a matching nut.



In general terms, when importing a STEP file into the program, the main assembly and its sub-assemblies will be imported as Part containers, each of them containing a simple Part Feature.

Stato attivo
Un documento di FreeCAD può contenere più Parti. Può essere attiva solo una parte per volta. La parte attiva viene visualizzata nell'albero con un colore di sfondo blu chiaro.

An open document can contain multiple Parts. An active Part will be displayed in the tree view with the background color specified by the value in the preferences editor (by default, light blue). An active part will also be shown in bold text.

To activate or de-activate a Part:
 * Double click on it on the tree view, or
 * Open the context menu (right click) and select.


 * The of Parts was developed in v0.17 in parallel with the  of PartDesign Bodies; however, as of v0.19 this status does not serve a real purpose for Parts.
 * Even when a Part is active, newly created objects are not placed inside of it automatically. In this case, simply drag these new objects, and drop them onto the desired Part.
 * Only a single Part can be active at a time.



Origine
L'origine comprende i tre assi standard (X, Y, Z) e tre piani standard (XY, XZ e YZ). Gli schizzi possono essere collegati a questi piani. Tutti gli elementi all'interno della parte sono riferiti all'origine della parte; il che significa che la parte può essere spostata e ruotata in riferimento al sistema di coordinate globale senza influire sul posizionamento di elementi che sono al suo interno.

The Origin consists of the three standard axes (X, Y, Z) and three standard planes (XY, XZ and YZ). Sketches and other objects can be attached to these elements when creating them.



the Origin is an App Origin object ( class), while the axes and planes are objects of type and  respectively. Each of these elements can be hidden and unhidden individually with the bar; this is useful to choose the correct reference when creating other objects.

all elements inside the Part are referenced to the Part's Origin which means that the Part can be moved and rotated in reference to the global coordinate system without affecting the placement of the elements inside.

Gestione della visibilità
La visibilità della Parte prevale sulla visibilità di qualsiasi oggetto che essa contiene. Se la parte è nascosta, sono nascosti anche gli oggetti che contiene, anche se la loro visibilità è impostata su true. Gli oggetti multipli all'interno di una parte possono essere visibili uno per volta.

The Part's visibility supersedes the visibility of any object it contains. If the Part is hidden, the objects it contains will be hidden as well, even if their individual property is set to. If the Part is visible, then each object's determines whether the object is shown or not.



Inheritance
A Std Part is formally an instance of the class, whose parent is the basic App GeoFeature ( class), and is augmented with an Origin extension.



Scripting
FreeCAD Scripting Basics, and scripted objects.

See Part Feature for the general information on adding objects to the document.

A Std Part (App Part) is created with the method of the document. Once a Part exists, other objects can be added to it with the or  methods of this Part.

A Part is a container for other objects, so it doesn't have its own Shape (Part TopoShape). However, in expressions or in the Spreadsheet Workbench, it is useful to get the compound shape of all objects contained inside the Part. This can be accomplished by using the pseudo-property, which can then be used to extract other attributes.