Part scripting/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "{{Userdocnavi/fr}}")
No edit summary
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>


{{TOCright}}
== Script==


== Introduction ==
La structure de données principale utilisée dans le module Part est le type de données [https://fr.wikipedia.org/wiki/B-Rep_BREP] de OpenCascade.
Presque tous les contenus et types d'objet du module Part sont disponibles à l'aide de scripts [[Python/fr|Python]]. Cela inclut les primitives géométriques, telles que Line et Circle (ou Arc), et toute la gamme de TopoShapes, telles que les vertex, les arêtes, les fils, les faces, les solides et les composés. Plusieurs méthodes de création existent pour chacun de ces objets. Pour certaines d’entre elles, en particulier TopoShapes, des opérations avancées telles que union booléenne/différence/intersection booléenne sont également disponibles. Explorez le contenu du module Part comme décrit dans la page [[FreeCAD Scripting Basics/fr|Débuter avec les scripts]] pour en savoir plus.


La structure principale des données utilisée dans le module Part est le type de données [https://fr.wikipedia.org/wiki/B-Rep BRep] d'OpenCascade.
=== Exemples ===
Presque tous les contenus et types d'objets du module Part sont disponibles par script [[Python/fr|Python]]. Cela inclut les primitives géométriques, telles que Ligne et Cercle (ou Arc), et toute la gamme de TopoShapes, comme les sommets, 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 certaines d'entre elles, en particulier les TopoShapes, des opérations avancées comme l'union booléenne/différence/intersection sont également disponibles. Pour en savoir plus, explorez le contenu du module Part, comme décrit dans la page [[FreeCAD_Scripting_Basics/fr|Notions de base sur les scripts FreeCAD]].

L'objet le plus simple pouvant être créé est une [[Part Feature/fr|Part Feature]], qui possède une simple propriété {{PropertyData/fr|Placement}} 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 [[Part Part2DObject/fr|Part2DObject]] qui constitue la base des [[Sketcher_SketchObject/fr|Sketcher SketchObject]] ([[Sketcher_Workbench/fr|atelier Sketcher]]) et la plupart des [[Draft Workbench/fr|éléments Draft]].

===Voir aussi===

* [[Topological_data_scripting/fr|Scripts pour création topologique]]
* [[OpenCASCADE/fr|OpenCASCADE]]

==Script de test==

Testez la création de [[Part_Primitives/fr|Part Primitives]] avec un script. {{Version/fr|0.19}}

{{Code|code=
import parttests.part_test_objects as pto
pto.create_test_file("example_file")
}}

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.
{{Code|code=
$INSTALL_DIR/Mod/Part/parttests/part_test_objects.py
}}

==Exemples==


Pour créer un élément ligne, passer à la console Python et taper :
Pour créer un élément ligne, passer à la console Python et taper :

{{Code|code=
{{Code|code=
import Part,PartGui
import Part,PartGui
Line 19: Line 45:
}}
}}


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

{{Code|code=
{{Code|code=
import Part,PartGui
import Part,PartGui
Line 25: Line 52:
}}
}}


charge l'atelier Part (Pièce) et crée un nouveau document
Charge l'atelier Part et crée un nouveau document

{{Code|code=
{{Code|code=
l=Part.LineSegment()
l=Part.LineSegment()
Line 33: Line 61:


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

{{Code|code=
{{Code|code=
doc.addObject("Part::Feature","Line").Shape=l.toShape()
doc.addObject("Part::Feature","Line").Shape=l.toShape()
Line 38: Line 67:


Cette commande ajoute un objet de type Part (Pièce) au document et affecte la représentation de forme du segment de ligne à la propriété 'Shape' ('forme') de l'objet ajouté. Il est important de comprendre ici que nous avons utilisé une primitive géométrique (Part.LineSegment) pour créer un TopoShape à partir de celle-ci (la méthode toShape()). Seules les formes peuvent être ajoutées au document. Dans FreeCAD, les primitives géométriques sont utilisées comme des "structures de base" pour construire les formes.
Cette commande ajoute un objet de type Part (Pièce) au document et affecte la représentation de forme du segment de ligne à la propriété 'Shape' ('forme') de l'objet ajouté. Il est important de comprendre ici que nous avons utilisé une primitive géométrique (Part.LineSegment) pour créer un TopoShape à partir de celle-ci (la méthode toShape()). Seules les formes peuvent être ajoutées au document. Dans FreeCAD, les primitives géométriques sont utilisées comme des "structures de base" pour construire les formes.

{{Code|code=
{{Code|code=
doc.recompute()
doc.recompute()
}}
}}


Mise à jour du document. Cela prépare également la représentation visuelle du nouvel objet Part (pièce).
Met à jour le document. Cela prépare également la représentation visuelle du nouvel objet Part.


Notez qu'un Line Segment peut être créé 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.
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 :

{{Code|code=
import FreeCAD
import Part
DOC = FreeCAD.newDocument()

def mycreateLine(pt1, pt2, objName):
obj = DOC.addObject("Part::Line", objName)
obj.X1 = pt1[0]
obj.Y1 = pt1[1]
obj.Z1 = pt1[2]

obj.X2 = pt2[0]
obj.Y2 = pt2[1]
obj.Z2 = pt2[2]

DOC.recompute()
return obj

line = mycreateLine((0,0,0), (0,10,0), "LineName")
}}


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

{{Code|code=
{{Code|code=
import Part
import Part
Line 55: Line 109:
f.Shape = c.toShape()
f.Shape = c.toShape()
doc.recompute()
doc.recompute()
}}

ou en utilisant :

{{Code|code=
import FreeCAD
import Part
DOC = FreeCAD.newDocument()

def mycreateCircle(rad, objName):
obj = DOC.addObject("Part::Circle", objName)
obj.Radius = rad

DOC.recompute()
return obj

circle = mycreateCircle(5.0, "CircleName")
}}
}}


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:
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:

{{Code|code=
{{Code|code=
s = f.Shape
s = f.Shape
Line 64: Line 136:
}}
}}


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 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.
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.



Rendez-vous sur la page [[Topological data scripting/fr|Les scripts de pièces]] si vous voulez en savoir plus.
Rendez-vous sur la page [[Topological_data_scripting/fr|Scripts pour création topologique]] si vous voulez en savoir plus.


{{Part Tools navi/fr}}


{{Powerdocnavi{{#translation:}}}}
{{Userdocnavi/fr}}
[[Category:Developer Documentation{{#translation:}}]]
[[Category:Python Code{{#translation:}}]]
{{Part Tools navi{{#translation:}}}}
{{clear}}

Revision as of 10:24, 17 October 2020

Introduction

La structure principale des données utilisée dans le module Part est le type de données BRep d'OpenCascade. Presque tous les contenus et types d'objets du module Part sont disponibles par script Python. Cela inclut les primitives géométriques, telles que Ligne et Cercle (ou Arc), et toute la gamme de TopoShapes, comme les sommets, 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 certaines d'entre elles, en particulier les TopoShapes, des opérations avancées comme l'union booléenne/différence/intersection sont également disponibles. Pour en savoir plus, explorez le contenu du module Part, comme décrit dans la page Notions de base sur les scripts FreeCAD.

L'objet le plus simple pouvant être créé est une Part Feature, qui possède une simple propriété DonnéesPlacement 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 Part2DObject qui constitue la base des Sketcher SketchObject (atelier Sketcher) et la plupart des éléments Draft.

Voir aussi

Script de test

Testez la création de Part Primitives avec un script. introduit dans la version 0.19

import parttests.part_test_objects as pto
pto.create_test_file("example_file")

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.

$INSTALL_DIR/Mod/Part/parttests/part_test_objects.py

Exemples

Pour créer un élément ligne, passer à la console Python et taper :

import Part,PartGui 
doc=App.newDocument()  
l=Part.LineSegment()
l.StartPoint=(0.0,0.0,0.0)
l.EndPoint=(1.0,1.0,1.0)
doc.addObject("Part::Feature","Line").Shape=l.toShape() 
doc.recompute()

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

import Part,PartGui
doc=App.newDocument()

Charge l'atelier Part et crée un nouveau document

l=Part.LineSegment()
l.StartPoint=(0.0,0.0,0.0)
l.EndPoint=(1.0,1.0,1.0)

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

doc.addObject("Part::Feature","Line").Shape=l.toShape()

Cette commande ajoute un objet de type Part (Pièce) au document et affecte la représentation de forme du segment de ligne à la propriété 'Shape' ('forme') de l'objet ajouté. Il est important de comprendre ici que nous avons utilisé une primitive géométrique (Part.LineSegment) pour créer un TopoShape à partir de celle-ci (la méthode toShape()). Seules les formes peuvent être ajoutées au document. Dans FreeCAD, les primitives géométriques sont utilisées comme des "structures de base" pour construire les formes.

doc.recompute()

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 :

import FreeCAD
import Part
DOC = FreeCAD.newDocument()

def mycreateLine(pt1, pt2, objName):
    obj = DOC.addObject("Part::Line", objName)
    obj.X1 = pt1[0]
    obj.Y1 = pt1[1]
    obj.Z1 = pt1[2]

    obj.X2 = pt2[0]
    obj.Y2 = pt2[1]
    obj.Z2 = pt2[2]

    DOC.recompute()
    return obj

line = mycreateLine((0,0,0), (0,10,0), "LineName")

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

import Part
doc = App.activeDocument()
c = Part.Circle() 
c.Radius=10.0  
f = doc.addObject("Part::Feature", "Circle")
f.Shape = c.toShape()
doc.recompute()

ou en utilisant :

import FreeCAD
import Part
DOC = FreeCAD.newDocument()

def mycreateCircle(rad, objName):
    obj = DOC.addObject("Part::Circle", objName)
    obj.Radius = rad

    DOC.recompute()
    return obj

circle = mycreateCircle(5.0, "CircleName")

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:

s = f.Shape
e = s.Edges[0]
c = e.Curve

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.

Rendez-vous sur la page Scripts pour création topologique si vous voulez en savoir plus.