Part TopoShape
Introduction
Part TopoShape ou officiellement Part::TopoShape
est une classe qui définit une topological shape (forme topologique) paramétrique dans le logiciel. Les objets dans le document qui montrent quelque chose dans la Vue 3D ont normalement une TopoShape.
Les formes topologiques, ainsi que leurs méthodes, sont définies par le noyau OpenCASCADE (OCCT). FreeCAD utilise ces formes et construit App DocumentObjects autour d'eux.
Un autre type de classe est celui de mesh. Cette classe n'est pas très paramétrique car elle ne peut pas être redéfinie facilement sauf en spécifiant des sommets individuels et des surfaces triangulaires.
A gauche: paramétrique Part TopoShape définie par les propriétés. A droite: un maillage non paramétrique défini par des sommets et des surfaces triangulaires.
Diagramme simplifié des relations entre les objets centraux du programme. La classe Part::TopoShape
est incorporée dans l'objet Part::Feature
et à partir de là, elle est propagée à tous les objets qui en sont dérivés.
Utilisation
Part TopoShape est un objet attribué à certains App DocumentObjects.
En particulier, l'objet de base qui gère ces types d'attributs est la classe Part Feature (Part::Feature
class). Tous les objets dérivés de cette classe auront accès à un Part TopoShape.
Certains des objets les plus importants avec Part TopoShape sont les suivants:
- Tout solide primitif créé avec l'Atelier Part.
- Tout PartDesign Corps et PartDesign Feature créés avec l'Atelier Part.
- Tout objet dérivé de Part Part2DObject, comme la plupart des objets créés avec l'Atelier Draft.
- Toute Esquisse, c'est-à-dire Sketcher SketchObject, créé avec l'Atelier Sketcher.
- Tout objet créé en important un fichier STEP, BREP et des fichiers au format solide similaires.
Script
Voir aussi : Débuter avec les scripts et Objets créés par script.
Tous les objets dérivés de Part::Feature
auront un Part TopoShape qui est normalement accessible à partir de son attribut Shape
.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("Part::Box", "Box")
print(obj.Shape)
Une TopoShape possède de nombreux attributs (variables) et méthodes qui contiennent des informations à son sujet et qui permettent d'effectuer des opérations avec elle. Ces variables et méthodes peuvent être testées dans la Console Python.
print(obj.Shape.Area)
print(obj.Shape.BoundBox)
print(obj.Shape.CenterOfMass)
print(obj.Shape.ShapeType)
obj.Shape.check()
obj.Shape.copy()
obj.Shape.exportStep("my_file.step")
obj.Shape.exportStl("my_file.stl")
Pour une liste complète des attributs et des méthodes, consultez l'outil Documentation du code source et l'outil Std Documentation modules Python.
Vous pouvez obtenir un résumé rapide de toutes les méthodes en utilisant la fonction intégrée help()
en Python.
help(obj.Shape)
- Primitives: Box, Cone, Cylinder, Sphere, Torus, CreatePrimitives, Shapebuilder
- Modifying objects: Opérations booléennes, Union, Intersection, Soustraction, Jointoiement, Connexion, Intégrer, Découpe
- Splitting tools: Fraction boléenne, Séparer un objet, Séparer, XOR, Part Defeaturing
- Compound: Créer un composé, Explose un Composé, Filtre un composé; Extrusion, Congé, Révolution, Section, Sections de coupes, Chanfrein, Miroir, Création de surface, Balayage, Lissage
- Offset tools: 3D Décalage, 2D Décalage, Crée une coque, Projection sur une surface
- Coeur: App DocumentObject
- Base: App FeaturePython, App GeoFeature, Part Feature, Mesh Feature, Fem FemMeshObject
- Formes internes: Part TopoShape, Mesh MeshObject, Fem FemMesh
- Structure: App DocumentObjectGroup (Std Group), App Part (Std Part), App Link
- Derivés: Part Part2DObject, Sketcher SketchObject, PartDesign Body, PartDesign Feature

- Démarrer avec FreeCAD
- Installation: Téléchargements, Windows, Linux, Mac, Logiciels supplémentaires, Docker, AppImage, Ubuntu Snap
- Bases: A 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
- Help: Tutoriels, Tutoriels vidéo
- Ateliers: Std Base, Arch, Draft, FEM, Image, Inspection, Mesh, OpenSCAD, Part, PartDesign, Path, Points, Raytracing, Reverse Engineering, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Ateliers Obsolete: Complete, Drawing, Robot
- Hubs: User hub, Power users hub, Developer hub