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 : Box, Cylindre, Sphère, Cône, Tore, Tube, Primitives, Générateur de formes
- Création et modification des objets : Extrusion, Révolution, Miroir, Congé, Chanfrein, Créer une face, Surface réglée, Lissage, Balayage, Section, Coupes, Décalage 3D, Décalage 2D, Évidement, Projection sur surface, Ancrage
---
- Booléen : Créé un composé, Éclater le composé, Filtre composé, Opération booléenne, Soustraction, Union, Intersection, Connecter, Intégrer, Découper, Fragments booléens, Séparer/exploser, Scinder, OU exclusif
- Mesure : Mesure linéaire, Mesure Angulaire, Rafraîchir les mesures, Effacer toute mesure, Tout basculer, Mesures dans la 3D, Mesures selon le repère global
- Autre outils : Importation, Exportation, Sélection par zone, 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, Vérifier la géométrie, Supprimer la fonctionnalité, Apparence, Définir les couleurs
- Coeur : App DocumentObject
- Base : App FeaturePython, App GeoFeature, Part Fonction, Mesh Feature, Fem FemMeshObject
- Formes internes : Part TopoShape, Mesh MeshObject, Fem FemMesh
- Structure : App DocumentObjectGroup (Std Groupe), App Part (Std Part), App Link
- Derivés : Part Part2DObject, Sketcher SketchObject, PartDesign Corps, PartDesign Fonction
- 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