Std Part/fr

Description
Part (Pièce) est un conteneur à usage général qui conserve ensemble un groupe d'objets afin qu'ils puissent être déplacés en tant qu'unité. La Pièce peut contenir la plupart des objets FreeCAD, par exemple des corps de pièces PartDesign, des objets de l'atelier Part, des objets de l'atelier Mesh, etc.

Pièce fournit un système de coordonnées local auquel des esquisses et d'autres objets peuvent être attachés.

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.

Pièce se trouve dans la barre d'outils Structure affichée dans tous les ateliers.

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.



Comment l'utiliser

 * Appuyez sur le bouton dans la barre d'outils. La Pièce devient automatiquement active.
 * Double-cliquez sur la Pièce dans l'arborescence du modèle pour l'activer ou la désactiver.
 * Pour ajouter des objets à une Pièce, faites-les glisser sur la Pièce dans l'arborescence du modèle.
 * Pour supprimer des objets d'une Pièce, faites-les glisser hors de la Pièce et sur le nom du document en haut de l'arborescence du modèle.

Limites

 * Même lorsqu'une Pièce est active, les objets nouvellement créés ne sont pas placés à l'intérieur de la Pièce, mais au bas de l'arbre. Glissez-déposez-les simplement sur la Pièce.
 * Une Pièce n'a pas de forme. Il n'est donc pas possible d'appliquer la plupart des opérations 3D sur une Pièce, telle que les opérations booléennes.
 * À l'heure actuelle, l'accrochage Draft ne fonctionne pas sur un ou des conteneurs Pièces, ni sur des objets contenus dans un conteneur Pièce.
 *  Note du rédacteur : actuellement, le but du statut actif de la Pièce n'est pas clair. 

Propriétés
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 (numéro de Pièce) de l'élément. Ce champ est facultatif.
 * : la licence sous laquelle la Pièce est produite.
 * : l'adresse Web où les termes de la licence peuvent être trouvés.
 * : spécifie l'orientation et la position de la Pièce dans l'espace 3D. Voir Placement.
 * : l'étiquette est le nom donné à l'opération. Ce nom peut être changé à votre convenance.
 * : liste les objets référencés.

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.

Exemples d'utilisation

 * En tant que conteneur d'assemblage qui regroupe des objets à fabriquer séparément puis collés ou vissés, comme une table en bois.
 * Lors de l'importation d'un assemblage STEP dans FreeCAD, l'assemblage principal et ses sous-assemblages sont des conteneurs de pièces.
 * Une pièce composée de plusieurs composants non fusionnés, comme un roulement à billes.

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.

Statut actif
Un document FreeCAD peut contenir plusieurs Pièces. Une seule Pièce peut être active à la fois. Une Pièce active sera affichée dans l'arbre avec une couleur de fond bleu clair.

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 comprend les trois axes standard (X, Y, Z) et trois plans standard (XY, XZ et YZ). Des esquisses peuvent être attachées à ces plans. Tous les éléments à l'intérieur de la Pièce sont référencés à l'origine de la Pièce; ce qui signifie que la Pièce peut être déplacée et tournée en référence au système de coordonnées global sans affecter le placement des éléments à l'intérieur.

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.

Gestion de la visibilité
La visibilité de la Pièce remplace la visibilité de tout objet qu'elle contient. Si la Pièce est masquée, les objets qu'elle contient seront également masqués, même si leur visibilité est définie sur vraie. Plusieurs objets à l'intérieur d'une Pièce peuvent être visibles à la fois.

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.



Héritage
Un Std Part est formellement une instance de la classe dont le parent est la base de App GeoFeature ( class).



Script
FreeCAD Scripting Basics, and scripted objects.

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

La commande suivante ajoute un nouveau groupe au document actif: