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 PartDesign.
- 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 : Cube, Cylindre, Sphère, Cône, Tore, Tube, Primitives, Générateur de formes
- Création et modification des objets : Créer une esquisse, Extrusion, Révolution, Objet en miroir, Échelle, Congé, Chanfrein, Créer une face, Surface réglée, Lissage, Balayage, Section, Coupes, Décaler en 3D, Décaler en 2D, Évider, Projeter sur une surface, Apparence par face
- Booléen : Composé, Éclater le composé, Filtre de composé, Opérations booléennes, Soustraction, Union, Intersection, Connecter, Intégrer, Découper, Fragments booléens, Séparer/exploser, Séparer en composés, OU exclusif, Vérifier la géométrie, Supprimer la fonction
- Autre outils : Sélection de faces par boîte, Forme à partir d'un maillage, Points à partir d'un maillage, Convertir en solide, Inverser les formes, Copie simple, Copie transformée, Copie d'un élément, Affiner la forme, Définir une tolérance, Créer une coupe persistante, Ancrer
- Préférences : Préférences, Réglage fin
- 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 Groupe), App Part (Std Part), App Link (Std LinkMake)
- Derivés : Part Part2DObject, Sketcher SketchObject, PartDesign Corps, PartDesign Feature
- 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, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test