Std Part
Std Part |
Emplacement du menu |
---|
Aucun |
Ateliers |
Tous |
Raccourci par défaut |
Aucun |
Introduit dans la version |
0.17 |
Voir aussi |
Std Groupe, PartDesign Corps |
Description
Std Part (appelé en interne App Part) est un conteneur à usage général qui conserve ensemble un groupe d'objets afin qu'ils puissent être déplacés ensemble en tant qu'unité dans la vue 3D.
L'élément Std Part a été développé pour être le bloc de construction de base pour créer des assemblages mécaniques. En particulier, il est conçu pour organiser les objets qui ont une Part TopoShape, comme Part Primitives, PartDesign Corps, et d'autres Part Features . La pièce standard fournit un objet Origin avec des axes locaux X, Y et Z et des plans standard; cette origine est utilisée comme référence pour positionner et attacher ces autres objets. De plus, les pièces Std peuvent être imbriquées dans d'autres pièces Std pour créer un assemblage complet à partir de sous-assemblages plus petits.
Bien qu'elle soit principalement destinée aux corps solides, la pièce standard peut être utilisée pour gérer tout objet possédant une propriété Positionnement, elle peut donc également contenir Mesh Features, Esquisses et d'autres objets dérivés d'App GeoFeature.
L'outil Std Part n'est pas défini par un établi particulier, mais par le système de base, il se trouve donc dans la barre d'outils de structure qui est disponible dans tous les Ateliers.
Pour regrouper des objets en général, utilisez Std Groupe. Cet objet n'affecte pas les positions des éléments qu'il contient. Il s'agit essentiellement d'un répertoire utilisé pour organiser vue en arborescence.
A gauche: éléments à l'intérieur d'une pièce Std dans l'arborescence. À droite: les objets positionnés dans l'espace, référés à l'origine de la pièce standard
Utilisation
- Appuyez sur le bouton Std Part. Une pièce vide est créée et devient automatiquement actif.
- Pour ajouter des objets à une pièce, sélectionnez-les dans la vue en arborescence, puis faites-les glisser et déposez-les sur la pièce.
- Pour supprimer des objets d'une pièce, faites-les glisser hors de la pièce et sur l'étiquette du document en haut de la vue en arborescence.
Remarques
- Depuis la v0.19, un objet donné ne peut appartenir qu'à une seule pièce.
- Double-cliquez sur la pièce dans la vue en arborescence ou ouvrez le menu contextuel (clic droit) et sélectionnez Toggle active part pour activer ou désactiver la pièce. Si une autre pièce est active, elle sera désactivée. Voir [[status actif]] pour plus d'informations.
Limitations
- À l'heure actuelle, les méthodes Draft accrochage ne fonctionnent pas sur les conteneurs de pièces sélectionnés ni sur les objets à l'intérieur de ceux-ci.
- Une pièce n'a pas de forme topologique donc les opérations 3D comme Part Opérations booléennes ne peuvent pas être utilisées sur une pièce elle-même. Par exemple, vous ne pouvez pas sélectionner deux pièces et effectuer avec elles Part Union ou Part Soustraction.
- Ces opérations booléennes ne fonctionnent que sur les objets contenus tant que ceux-ci sont dérivés de Part Feature et ont une forme topologique.
Propriétés
Une pièce Std Part est appelée en interne App Part (classe App::Part
) et est dérivée d'une App GeoFeature (classe App::GeoFeature
). Elle il partage donc la plupart des propriétés de ce dernier.
En plus des propriétés décrites dans App GeoFeature, la classe App Part possède des propriétés qui l'aident à gérer les informations dans le contexte d'un assemblage, par exemple, DonnéesType, DonnéesId, DonnéesLicense, DonnéesLicenseURL, DonnéesColor et DonnéesGroup.
Ce sont les propriétés disponibles dans l'éditeur de propriétés. Les propriétés masquées peuvent être affichées en utilisant la commande Show all dans le menu contextuel de l'éditeur de propriétés.
Données
Base
- DonnéesType (
String
): une description de cet objet. Par défaut, il s'agit d'une chaîne vide""
. - DonnéesId (
String
): une identification ou un numéro de pièce pour cet objet. Par défaut, il s'agit d'une chaîne vide""
. - DonnéesLicense (
String
): un champ pour spécifier la licence pour cet objet. Par défaut, il s'agit d'une chaîne vide""
. - DonnéesLicenseURL (
String
): un champ pour spécifier l'adresse Web de la licence ou du contrat pour cet objet. Par défaut, il s'agit d'une chaîne vide""
. - DonnéesColor (
Color
): un tuple de quatre valeurs RGBA à virgule flottante(r,g,b,a)
pour définir la couleur de l'objet; par défaut, c'est(1.0, 1.0, 1.0, 1.0)
qui est affiché comme[255,255,255]
sur la base 255, white color. - DonnéesPlacement (
Placement
): la position de l'objet dans la Vue 3D. Le placement est défini par un pointBase
(vecteur) et uneRotation
(axe et angle). Voir Positionnement.- DonnéesAngle: l'angle de rotation autour de DonnéesAxis. Par défaut, il s'agit de
0°
(zéro degré). - DonnéesAxis: le vecteur unitaire qui définit l'axe de rotation pour le placement. Chaque composant est une valeur à virgule flottante entre
0
et1
. Si une valeur est supérieure à1
, le vecteur est normalisé de sorte que l'amplitude du vecteur est1
. Par défaut, il s'agit de l'axe Z positif,(0, 0, 1)
. - DonnéesPosition: un vecteur avec les coordonnées 3D du point de base. Par défaut, c'est l'origine
(0, 0, 0)
.
- DonnéesAngle: l'angle de rotation autour de DonnéesAxis. Par défaut, il s'agit de
- DonnéesLabel (
String
): le nom modifiable par l'utilisateur de cet objet, c'est une chaîne UTF8 arbitraire. - DonnéesGroup (
LinkList
): une liste d'objets référencés. Par défaut, il est vide[]
.
Propriétés cachées de Données
- DonnéesMaterial (
Map
): map with material properties. By default, it is empty{}
. - DonnéesMeta (
Map
): map with additional meta information. By default, it is empty{}
. - DonnéesUid (
UUID
): the universally unique identifier (UUID) (128-bit number) of the object. This is assigned at creation time. - DonnéesLabel2 (
String
): 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""
. - DonnéesExpression Engine (
ExpressionEngine
): a list of expressions. By default, it is empty[]
. - DonnéesVisibility (
Bool
): whether to display the object or not. - DonnéesOrigin (
Link
): the App Origin object that is the positional reference for all elements listed in DonnéesGroup. - Données_ Group Touched (
Bool
): 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.
Base
- VueDisplay Mode (
Enumeration
):Group
. - VueOn Top When Selected (
Enumeration
):Disabled
(default),Enabled
,Object
,Element
. - VueSelection Style (
Enumeration
):Shape
(default),BoundBox
. If the option isShape
, the entire shape (vertices, edges, and faces) will be highlighted in the 3D view; if it isBoundBox
only the bounding box will be highlighted. - VueShow In Tree (
Bool
): if it istrue
, the object appears in the tree view. Otherwise, it is set as invisible. - VueVisibility (
Bool
): if it istrue
, the object appears in the 3D view; otherwise it is invisible. By default this property can be toggled on and off by pressing the Space 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.
Left: three individual contiguous solids, each of them modelled by a PartDesign Body. Right: the individual Bodies put together inside a Std Part to create an assembly.
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.
Detailed explanation
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 Active container 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 Toggle active part.
Notes:
- The active status of Parts was developed in v0.17 in parallel with the active status 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.
Document with two Std Parts, of which the second one is active.
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.
Left: Part Origin in the tree view. Right: representation of the Origin elements in the 3D view.
Note: the Origin is an App Origin object (App::Origin
class), while the axes and planes are objects of type App::Line
and App::Plane
respectively. Each of these elements can be hidden and unhidden individually with the Space bar; this is useful to choose the correct reference when creating other objects.
Note 2: 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 VueVisibility property is set to true
. If the Part is visible, then each object's VueVisibility determines whether the object is shown or not.
The visibility of the Std Part determines whether the objects grouped under it are shown in the 3D view or not. Left: the Part is hidden, so none of the objects will be shown in the 3D view. Right: the Part is visible, so each object controls its own visibility.
Héritage
Un Std Part est formellement une instance de la classe App::Part
dont le parent est la base de App GeoFeature (App::GeoFeature
class).
Diagramme simplifié des relations entre les objets centraux du programme. La classe App::Part
est un groupe simple qui a une position dans l'espace 3D et contrôle le placement des autres objets qu'il contient.
Script
See also: 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:
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::Part", "Part")
bod1 = App.ActiveDocument.addObject("PartDesign::Body", "Body")
bod2 = App.ActiveDocument.addObject("Part::Box", "Box")
obj.addObjects([bod1, bod2])
App.ActiveDocument.recompute()
- 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
- Outils structure : Part, Groupe
- Outils d'aide : Créer un corps, Créer une esquisse, Éditer une esquisse, Plaquer une esquisse sur une face
- Outils de modélisation
- Outils de référence : Créer un point de référence, Créer une ligne de référence, Créer un plan de référence, Créer un système de coordonnées local, Créer une forme liée, Créer une forme liée du sous-objet(s), Créer un clone
- Outils additifs : Protrusion, Révolution, Lissage additif, Balayage additif, Hélice additive, Cube additif, Cylindre additif, Sphère additive, Cône additif, Ellipsoïde additif, Tore additif, Prisme additif, Pyramide tronquée additive
- Outils soustractifs : Cavité, Perçage, Rainure, Lissage soustractif, Balayage soustractif, Hélice soustractive, Cube soustractif, Cylindre soustractif, Sphère soustractive, Cône soustractif, Ellipsoïde soustractif, Tore soustractif, Prisme soustractif, Pyramide tronquée soustractive
- Outils de transformation : Symétrie, Répétition linéaire, Répétition circulaire, Transformation multiple, Mise à l'échelle
- Fonctions d'habillage : Congé, Chanfrein, Dépouille, Évidement
- Opérations Booléenne : Opérations Booléenne
- Démarrer avec FreeCAD
- Installation : Téléchargements, Windows, Linux, Mac, Logiciels supplémentaires, Docker, AppImage, Ubuntu Snap
- Bases : À propos de FreeCAD, Interface, Navigation par la souris, Méthodes de sélection, Objet name, Préférences, Ateliers, Structure du document, Propriétés, Contribuer à FreeCAD, Faire un don
- Aide : Tutoriels, Tutoriels vidéo
- Ateliers : Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test, Web