Part TopoShape/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "{{Caption|Diagramme simplifié des relations entre les objets centraux du programme. La classe {{incode|Part::TopoShape}} est incorporée dans l'objet {{incode|Part::Feature}}...")
(Remplacement de Part par PartDesign comme dans la version anglaise)
 
(32 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}


== Introduction ==
== Introduction ==
Line 5: Line 6:
[[Part_TopoShape/fr|Part TopoShape]] ou officiellement {{incode|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 [[3D view/fr|Vue 3D]] ont normalement une TopoShape.
[[Part_TopoShape/fr|Part TopoShape]] ou officiellement {{incode|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 [[3D view/fr|Vue 3D]] ont normalement une TopoShape.


Les formes topologiques, ainsi que leurs méthodes, sont définies par le noyau de technologie OpenCASCADE (OCCT). FreeCAD utilise ces formes et construit [[App_DocumentObject/fr|App DocumentObjects]] autour d'eux.
Les formes topologiques, ainsi que leurs méthodes, sont définies par le noyau [[OpenCASCADE/fr|OpenCASCADE]] (OCCT). FreeCAD utilise ces formes et construit [[App_DocumentObject/fr|App DocumentObjects]] autour d'eux.

Un autre type de classe est celui de [[Mesh/fr|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.

[[File:Shape_and_mesh.svg]]

{{Caption|A gauche: paramétrique [[Part_TopoShape/fr|Part TopoShape]] définie par les propriétés. A droite: un [[Mesh/fr|maillage]] non paramétrique défini par des sommets et des surfaces triangulaires.}}


[[File:FreeCAD_core_objects.svg|800px]]
[[File:FreeCAD_core_objects.svg|800px]]
Line 11: Line 18:
{{Caption|Diagramme simplifié des relations entre les objets centraux du programme. La classe {{incode|Part::TopoShape}} est incorporée dans l'objet {{incode|Part::Feature}} et à partir de là, elle est propagée à tous les objets qui en sont dérivés.}}
{{Caption|Diagramme simplifié des relations entre les objets centraux du programme. La classe {{incode|Part::TopoShape}} est incorporée dans l'objet {{incode|Part::Feature}} et à partir de là, elle est propagée à tous les objets qui en sont dérivés.}}


<span id="Usage"></span>
== How to use ==
== Utilisation ==

Part TopoShape est un objet attribué à certains [[App_DocumentObject/fr|App DocumentObjects]].

En particulier, l'objet de base qui gère ces types d'attributs est la classe [[Part_Feature/fr|Part Feature]] ({{incode|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'[[Part_Workbench/fr|Atelier Part]].
* Tout [[PartDesign_Body/fr|PartDesign Corps]] et [[PartDesign_Feature/fr|PartDesign Feature]] créés avec l'[[PartDesign_Workbench/fr|Atelier PartDesign]].
* Tout objet dérivé de [[Part_Part2DObject/fr|Part Part2DObject]], comme la plupart des objets créés avec l'[[Draft_Workbench/fr|Atelier Draft]].
* Toute [[Sketch/fr|Esquisse]], c'est-à-dire [[Sketcher_SketchObject/fr|Sketcher SketchObject]], créé avec l'[[Sketcher_Workbench/fr|Atelier Sketcher]].
* Tout objet créé en important un fichier STEP, BREP et des fichiers au format solide similaires.

<span id="Scripting"></span>
== Script ==

{{Emphasis|Voir aussi :}} [[FreeCAD_Scripting_Basics/fr|Débuter avec les scripts]] et [[Scripted_objects/fr|Objets créés par script]].

Tous les objets dérivés de {{incode|Part::Feature}} auront un [[Part TopoShape/fr|Part TopoShape]] qui est normalement accessible à partir de son attribut {{incode|Shape}}.
{{Code|code=
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 [[Python_console/fr|Console Python]].
{{Code|code=
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 [[Source_documentation/fr|Documentation du code source]] et l'outil{{Button|[[File:Std PythonHelp.svg|16px]] [[Std_PythonHelp/fr|Std Documentation modules Python]]}}.
The Part TopoShape is an object that is assigned to some [[App_DocumentObject|App DocumentObjects]].


Vous pouvez obtenir un résumé rapide de toutes les méthodes en utilisant la fonction intégrée {{incode|help()}} en Python.
In particular, the basic object that handles these types of attributes is the [[Part_Feature|Part Feature]] ({{incode|Part::Feature}} class). All objects derived from this class will have access to a Part TopoShape.
{{Code|code=
help(obj.Shape)
}}


Some of the most important objects with Part TopoShape are the following:
* Any primitive solid created with the [[Part_Workbench|Part Workbench]].
* Any [[PartDesign_Body|PartDesign Body]] and [[PartDesign_Feature|PartDesign Feature]] created with the [[PartDesign_Workbench|PartDesign Workbench]].
* Any object derived from [[Part_Part2DObject|Part Part2DObject]], like most objects created with the [[Draft_Workbench|Draft Workbench]].
* Any [[Sketch|sketch]], that is, [[Sketcher_SketchObject|Sketcher SketchObject]], created with the [[Sketcher_Workbench|Sketcher Workbench]].


{{Part Tools navi}}
{{Part Tools navi{{#translation:}}}}
{{Document objects navi{{#translation:}}}}
{{Userdocnavi}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 00:56, 9 January 2024

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:

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)