Part scripting/fr

Introduction
La structure principale de données utilisée dans le module Part est le type de données BRep de OpenCASCADE. Presque tous les contenus et types d'objets du module Part sont disponibles par script en Python. Cela inclut les primitives géométriques, telles que les lignes, les cercles et les arcs, et toute la gamme des TopoShapes, comme les vertex, les arêtes, les fils, les faces, les solides et les composés. Pour chacun de ces objets, plusieurs méthodes de création existent, et pour certains d'entre eux, notamment les TopoShapes, des opérations avancées telles que l'union/différence/intersection booléenne sont également disponibles. Explorez le contenu du module Part, comme décrit dans la page Notions de base sur les scripts FreeCAD, pour en savoir plus.

L'objet le plus simple pouvant être créé est une Part Feature, qui possède une simple propriété et des propriétés de base permettant de définir sa couleur et son apparence.

Un autre objet simple utilisé dans les objets géométriques 2D est un Part Part2DObject qui constitue la base des Sketcher SketchObject et de la plupart des éléments de Draft.

Voir aussi

 * Scripts pour création topologique
 * OpenCASCADE

Script de test
Testez la création de Part Primitives avec un script.

Ce script se trouve dans le répertoire d'installation du programme et peut être examiné pour voir comment les primitives de base sont construites.

Ligne
Pour créer un élément de ligne, passez dans la console Python et entrez :

Passons en revue l'exemple Python ci-dessus étape par étape :

Ceci charge les modules FreeCAD et Part et crée un nouveau document.

La fonction Line décrit en fait un segment de ligne, d'où le point de départ et le point final.

Cette opération ajoute un type d'objet Part au document et attribue la représentation de la forme du segment de ligne à la propriété de l'objet ajouté. Il est important de comprendre ici que nous utilisons une primitive géométrique pour créer une TopoShape à partir de celle-ci (avec la méthode ). Seules les formes peuvent être ajoutées au document. Dans FreeCAD, les primitives géométriques sont utilisées comme "structures de construction" pour les formes.

Met à jour le document. Cela prépare également la représentation visuelle du nouvel objet Part.

Notez qu'une Line Segment (segment de ligne) peut être créée en spécifiant son point de départ et son point final directement dans le constructeur, par ex. Part.LineSegment(point1, point2) ou nous pouvons créer une ligne par défaut et définir ses propriétés après, comme nous l'avons fait ici.

Une ligne peut également être créée en utilisant :

Circle
Un cercle peut être créé de la même manière:

ou en utilisant :

ou créer un cercle défini par son centre, son axe et son rayon en utilisant :

ou créer un cercle défini par trois points en utilisant :

Notez qu'une fois encore, nous avons utilisé le cercle (primitive géométrique) pour construire une forme. Nous pouvons bien sûr toujours accéder à notre géométrie de construction par la suite, en faisant:

Ici on prend la forme de notre objet f, puis nous prenons la liste de ses arêtes. Dans ce cas il y aura une seule arête parce que nous avons fait toute la forme à partir d'un cercle unique, c'est pourquoi nous ne prenons que le premier élément de la liste des arêtes, et puis nous récupérons sa courbe. Chaque arête a une courbe, qui est la géométrie primitive, sur laquelle elle est basée.

Arc
An arc can be created like this:

This draws a half circle. The center is at (0, 0, 0). The radius is 10. P1 is the start point on +X axis. P2 is the middle point on +Y axis and P3 is the end point on -X axis.

We can also create an arc from a circle:

It needs a circle, and a start angle and end angle in radians.