Part Module/fr

Introduction
Les capacités de modélisations de solides de FreeCAD sont basées sur le noyau Open Cascade Technology (OCCT), un système de CAO de niveau professionnel qui offre une création et une manipulation avancées de la géométrie 3D. L'atelier Part est une couche située au-dessus des bibliothèques OCCT, qui permet à l'utilisateur d'accéder aux primitives et fonctions géométriques OCCT. Toutes les fonctions de dessin 2D et 3D de chaque atelier ( Draft, Sketcher,  PartDesign, etc.), sont basées sur ces fonctions exposées par l'atelier Part. Par conséquent, L'atelier Part est considéré comme le composant central des capacités de modélisation de FreeCAD.

Les objets créés avec l'atelier Part sont relativement simples. ils sont destinés à être utilisés avec des opérations booléennes (unions et coupes) afin de créer des formes plus complexes. Ce paradigme de modélisation est connu sous le nom de [CSG] constructive solid geometry et constitue la méthodologie traditionnelle utilisée dans les premiers systèmes de CAO. D'autre part, l'atelier PartDesign fournit un flux de travail plus moderne pour la construction de formes: il utilise des croquis définis de manière paramétrique, qui sont extrudés pour former un corps solide de base, qui est ensuite modifié par des transformations paramétriques (édition de fonctions), jusqu'à l'obtention de l'objet final.

Les objets Part sont plus complexes que les objets maillés créés avec les Objets mailles, les objets Part sont plus complexes et permettent donc des opérations plus avancées telles que les opérations booléennes cohérentes, l'historique des modifications et le comportement paramétrique.



Les outils
Les outils de l'atelier Part sont situés dans le menu qui apparaît lorsque l'on charge l'atelier Part.

Primitives
Ce sont des outils pour créer des objets primitifs.


 * [[Image:Part_Box.svg|32px]] Cube: Dessine un cube en spécifiant ses dimensions.
 * [[Image:Part_Cylinder.svg|32px]] Cylindre: Dessine un cylindre en spécifiant ses dimensions.
 * [[Image:Part_Sphere.svg|32px]] Sphère: Dessine une sphère en spécifiant ses dimensions.
 * [[Image:Part_Cone.svg|32px]] Cône: Dessine un cône en spécifiant ses dimensions.
 * [[Image:Part_Torus.svg|32px]] Tore: Dessine un tore en spécifiant ses dimensions.
 * [[Image:Part_Primitives.svg|32px]] Création de Primitives: Un outil pour ajouter l'une des primitives géométriques définies.
 * [[Image:Part_Shapebuilder.svg|32px]] Utilitaire de création de formes: Un outil avancé de création de formes plus complexes à partir de diverses primitives géométriques paramétriques.

Modifier les objets
Voici les outils permettant de modifier les objets existants. Ils vous permettront de choisir quels objets modifier.


 * [[Image:Part_Extrude.svg|32px]] Extrusion: Extrude les faces planes d'un objet
 * [[Image:Part_Revolve.svg|32px]] Révolution: Crée un solide en faisant tourner un autre objet (pas un solide) autour d'un axe
 * [[Image:Part_Mirror.svg|32px]] Miroir: Reflète l'objet sélectionné sur un plan de miroir donné
 * [[Image:Part_Fillet.svg|32px]] Congé: Congé (arrondi) le bords d'un objet
 * [[Image:Part_Chamfer.svg|32px]] Chanfrein: Chanfreine les bords d'un objet
 * [[Image:Part_RuledSurface.svg|32px]] Création de surface: Crée une surface réglée
 * [[Image:Part_Loft.svg|32px]] Lissage: Crée une forme lissée d'un profil à un autre
 * [[Image:Part_Sweep.svg|32px]] Balayage: Crée une forme en balayant un ou plusieurs profils le long d'un chemin


 * [[Image:Part_CompOffsetTools.png|48px]] Outils de décalage:
 * [[Image:Part_Offset.svg|32px]] Décalage 3D: Construit une forme parallèle à une certaine distance de l'original.
 * [[Image:Part_Offset2D.svg|32px]] Décalage 2D: Construit un fil parallèle à une certaine distance de l'original ou agrandit/réduit une face plane.


 * [[Image:Part_Thickness.svg|32px]] Crée un évidement (coque): Creuse un solide sur la (les) face(s) sélectionnée en laissant les autres parois à une épaisseur déterminée.


 * [[Image:Part_ProjectionOnSurface.png|32px]] Projection sur une surface: Projetez un logo, un texte ou une face, un fil de fer, un bord à une surface. Avec Part Projection, il est possible de créer un solide ou un fil.


 * [[Image:Part_Compound.svg|48px]] Outils pour Composés :
 * [[Image:Part_Compound.svg|32px]] Créer un composé : Crée un composé à partir des objets sélectionnés.
 * [[Image: Part_ExplodeCompound.png|32px]] Éclater le composé : Outil pour séparer les composés de formes.
 * [[Image:Part Compound‏‎Filter.svg|32px]] Filtre un composé : Le CompoundFilter peut être utilisé pour extraire les morceaux individuels.


 * [[Image:Part_Booleans.svg|32px]] Opération booléenne : Effectue des opérations booléennes sur des objets
 * [[Image:Part_Fuse.svg|32px]] Union : Union de deux objets
 * [[Image:Part_Common.svg|32px]] Intersection : Extrait la partie commune (intersection) de deux objets
 * [[Image:Part_Cut.svg|32px]] Soustraction : Coupe (soustrait) un objet d'un autre


 * [[Image:Part_CompJoinFeatures.png|48px]] Joindre des objets à parois : fonctions booléennes intelligentes pour les objets à parois (par exemple, les tuyaux)
 * [[Image:Part_JoinConnect.svg|32px]] Connecter : Connecte l'extérieur et l'intérieur d'objets
 * [[Image:Part_JoinEmbed.svg|32px]] Intégrer : Intègre un objet à un autre objet
 * [[Image:Part_JoinCutout.svg|32px]] Découpe : Crée une découpe dans un objet en fonction d'un autre objet


 * [[Image:Part_CompSplittingTools.png|48px]] Outils de division de formes:
 * [[Image:Part_BooleanFragments.svg|32px]] Fragments booléens: Crée toutes les pièces pouvant être obtenues par des opérations booléennes entre objets
 * [[Image:Part SliceApart.png|32px]] Trancher une pièce: outil pour diviser des formes par intersection avec d'autres formes
 * [[Image:Part_Slice.svg|32px]] Scinder: Divise un objet en morceaux par intersection avec un autre objet
 * [[Image:Part_XOR.svg|32px]] XOR: Supprime l'espace partagé (commun) par un nombre pair d'objets (version symétrique de Soustraction booléenne)


 * [[Image:Part Defeaturing.svg|32px]] Défaire une fonctionnalité:
 * [[Image:Part_Section.svg|32px]] Section: Crée une section en croisant un objet avec un plan de coupe
 * [[Image:Part_CrossSections.svg|32px]] Multi Sections ... : Crée une ou plusieurs coupes transversales à travers une forme sélectionnée
 * [[Image:Part Attachment.svg|32px]] Attachment: attachement est un utilitaire pour attacher un objet à un autre.

Mesure
Mesure: Permet des mesures linéaires et angulaires entre les points, les arêtes et les faces.


 * [[Image:Part_Measure_Linear.svg|32px]] Measure Linear vous permet de faire des mesures linéaires.
 * [[Image:Part_Measure_Angular.svg|32px]] Measure Angular vous permet de faire des mesures angulaires.
 * [[Image:Part_Measure_Refresh.svg|32px]] Measure Refresh met à jour les mesures à l'écran.
 * [[Image:Part_Measure_Clear_All.svg|32px]] Clear All Efface toutes les mesures.
 * [[Image:Part_Measure_Toggle_All.svg|32px]] Toggle All affiche ou masque toutes les mesures.
 * [[Image:Part_Measure_Toggle_3d.svg|32px]] Toggle 3D affiche ou masque les mesures 3D.
 * [[Image:Part_Measure_Toggle_Delta.svg|32px]] Toggle Delta affiche ou masque les mesures delta.

Autres outils

 * [[Image:Part_Import.svg|32px]] Import : Cet outil vous permet d'ajouter un fichier *.IGES, *.STEP, *.BREP au document actuel.
 * [[Image:Part_Export.svg|32px]] Export : Cet outil vous permet d’exporter un objet pièce dans un fichier *.IGES, *.STEP, *.BREP.
 * Part_BoxSelection.svg BoxSelection : Ajoute à la sélection les faces des formes touchées par la sélection rectangulaire.
 * [[Image:Part_ShapeFromMesh.svg|32px]] Forme avec un Mesh : Crée un objet de forme à partir d'un objet de maillage.
 * Part_PointsFromMesh.svg Points du maillage : crée un objet de forme constitué de points du maillage.
 * Conversion en solide : Convertit un objet solide forme en mesh objet.
 * Inverse L'objet : Inverse les normales de toutes les faces de l'objet sélectionné.


 * Créer une copie :
 * [[Image:Part_SimpleCopy‎.svg|32px]] Créer une copie simple : crée une copie simple de l'objet sélectionné.
 * Part_TransformedCopy.svg Créer une copie transformée : crée une copie transformée de l'objet sélectionné.
 * Part_ElementCopy.svg Créer une copie d'élément de la forme : crée une copie d'un élément (sommet, arête, face) de l'objet sélectionné.
 * [[Image:Part_RefineShape.svg|32px]] Affiner la forme : nettoie les faces en supprimant les lignes inutiles.


 * [[Image:Part_CheckGeometry.svg|32px]] Check geometry: Vérifie la géométrie des objets sélectionnés pour en détecter les erreurs.

Préférences

 * [[Image:Preferences-import-export.svg|32px]] Preference ... Import Export

OCCT concepts géométriques
Dans la terminologie OpenCascade, nous faisons la distinction entre les primitives géométriques et les formes (topologiques). Une primitive géométrique peut être un point, une ligne, un cercle, un plan, etc. ou même certains types plus complexes, comme une courbe B-Spline ou une surface. Une forme (shape en anglais) peut être un sommet, une arête, un fil, une face, un solide ou un composé d'autres formes. Les primitives géométriques ne sont pas faites pour être affichées directement sur la scène 3D, mais plutôt pour être utilisées comme géométrie de construction des formes. Par exemple, une arête peut être construite à partir d'une ligne ou d'une partie de cercle.

Pour résumer, les primitives géométriques sont des blocs de construction "informes", tandis que les entités géométriques spatialessont les véritables formes construites sur ces blocs.

Pour obtenir une liste complète de tous ces éléments, se référer à la documentation OCC et rechercher Geom_Geometry et TopoDS_Shape. Là, vous pourrez également en savoir plus sur les différences entre les objets géométriques et les formes. À notre grand regret, la documentation OCC n'est malheureusement pas disponible en ligne (vous devez télécharger une archive) et est principalement destiné aux programmeurs et non aux utilisateurs finaux. Mais espérons que vous trouverez suffisamment d'informations pour commencer ici.

''At a very high level, topology tells what pieces an object is made of, and the logical relationships between them. A shape is made of a certain set of faces. A face is bounded by a certain set of edges. Two faces are adjacent if they share a common edge.''

''Topology alone does not tell you the size, curvature, or 3D locations of any of those pieces. However, each piece of topology does knows about it's underlying geometry. A face knows what surface it lies on. An edge knows what curve it lies on. The geometry knows about curvature and location in space.'' - Source

Thus, Topology defines the relationship between simple geometric entities, which can be linked together to represent complex shapes. - Modeling Data User's Guide



Les types géométriques peuvent en fait être divisés en deux groupes principaux: les courbes et les surfaces. Sur les courbes (ligne, cercle, ...) vous pouvez directement créer une arête, sur les surfaces (plan, cylindre, ...) une face peut être construite. Par exemple, la ligne primitive géométrique est illimitée, c'est à dire qu'elle est définie par un vecteur de base et un vecteur directeur tandis que la forme associée (et représentée) doit être quelque chose de limité par un début et de fin. Et un cube - un solide - peut être créée par six plans limités.

En contrepartie, il est également possible, depuis une arête ou une face, de revenir à sa primitive géométrique.

Ainsi, en se basant sur les formes, vous pouvez construire des pièces très complexes ou, dans l'autre sens, extraire tous les sous-formes dont est faite une forme plus complexe.

Thus, out of shapes you can build very complex parts or, the other way round, extract all sub-shapes a more complex shape is made of.



Les scripts
Part scripts

La structure principale de données utilisée dans l'atelier Pièce est le type de données BRep d'OpenCascade. Presque tous les contenus et les types d'objets de l'atelier Pièce sont maintenant disponibles pour les scripts Python. Cela inclut les primitives géométriques, telles que les lignes (Line) et les cercles (Circle ou Arc), et l'ensemble des TopoShapes, tels que les vertex, arêtes, fils, faces, solides et composés. Pour chacun de ces objets, plusieurs méthodes de création existent, et pour certains d'entre eux, en particulier les TopoShapes, des opérations avancées telles que les opérations booléennes union / soustraction / intersection sont également disponibles. Explorez le contenu de l'atelier Pièce, tel que décrit dans la page Les bases du langage de script de FreeCAD, pour en savoir plus.

L'objet le plus simple pouvant être créé est une Part Feature, qui possède une simple propriété et des propriétés de base permettant de définir sa couleur et son apparence.

Un autre objet simple utilisé dans les objets géométriques 2D est Part2DObject, qui constitue la base des objets esquisses (esquisses) et la plupart des éléments Draft.

Script test
Testez la création de primitives de pièce avec un script.

Ce script se trouve dans le répertoire d'installation du programme et peut être examiné pour voir comment les primitives de base sont construites.

Exemples
Pour créer un élément ligne, passer à la console Python et taper :

Passons en revue l'exemple Python ci-dessus étape par étape :

charge l'atelier Pièce et crée un nouveau document

La fonction Line décrit en fait un segment de ligne, d'où le point de départ et le point final.

Cette commande ajoute un objet de type pièce au document et affecte la représentation de forme du segment de ligne à la propriété 'forme' ('Shape') de l'objet ajouté. Il est important de comprendre ici que nous avons utilisé une primitive géométrique (le Part.LineSegment) pour créer un TopoShape à partir de celle-ci (la méthode toShape). Seules les formes peuvent être ajoutées au document. Dans FreeCAD, les primitives géométriques sont utilisées comme des "structures de base" pour construire les formes.

Mise à jour du document. Cela prépare également la représentation visuelle du nouvel objet pièce.

Notez qu'une Line Segment peut être créée en spécifiant son point de départ et son point final directement dans le constructeur, par ex. Part.LineSegment (point1, point2) ou nous pouvons créer une ligne par défaut et définir ses propriétés après, comme nous l'avons fait ici.

Une ligne peut également être créée en utilisant :

Un cercle peut être créé de la même manière :

ou en utilisant :

Notez qu'une fois encore, nous avons utilisé le cercle (primitive géométrique) pour construire une forme. Nous pouvons bien sûr toujours accéder à notre géométrie de construction par la suite, en faisant:

Ici on prend la forme de notre objet f, puis nous prenons la liste de ses arêtes. Dans ce cas il y aura une seule arête parce que nous avons fait toute la forme à partir d'un cercle unique, c'est pourquoi nous ne prenons que le premier élément de la liste des arêtes, et puis nous récupérons sa courbe. Chaque arête a une courbe, qui est la géométrie primitive, sur laquelle elle est basée.

Rendez-vous sur la page Les scripts de pièces si vous voulez en savoir plus.

Tutoriels

 * Import from STL or OBJ : Comment importer les fichiers STL/OBJ dans FreeCAD
 * Export to STL or OBJ : Comment exporter les fichiers STL/OBJ avec FreeCAD
 * Tutoriel balle Whiffle : Comment utiliser l'atelier Part