Part TopoShape

This page is a translated version of the page Part TopoShape and the translation is 100% complete.

Other languages:

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")