Part scripting/fr: Difference between revisions
(Created page with "== Script==") |
(Created page with "{{Userdocnavi/fr}}") |
||
(15 intermediate revisions by the same user not shown) | |||
Line 3: | Line 3: | ||
== Script== |
== Script== |
||
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. |
|||
=== |
=== Exemples === |
||
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 19: | ||
}} |
}} |
||
Passons en revue l'exemple Python ci-dessus étape par étape: |
|||
Let's go through the above python example step by step: |
|||
{{Code|code= |
{{Code|code= |
||
import Part,PartGui |
import Part,PartGui |
||
Line 25: | Line 25: | ||
}} |
}} |
||
charge l'atelier Part (Pièce) et crée un nouveau document |
|||
{{Code|code= |
{{Code|code= |
||
l=Part.LineSegment() |
l=Part.LineSegment() |
||
Line 32: | Line 32: | ||
}} |
}} |
||
Line |
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() |
||
}} |
}} |
||
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). |
|||
Updates the document. This also prepares the visual representation of the new part object. |
|||
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. |
|||
Un cercle peut être créé de la même manière: |
|||
A circle can be created in a similar way: |
|||
{{Code|code= |
{{Code|code= |
||
import Part |
import Part |
||
Line 57: | Line 57: | ||
}} |
}} |
||
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 64: | ||
}} |
}} |
||
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. |
|||
Here we take the shape of our object f, then we take its list of edges. In this case there will be only one because we made the whole shape out of a single circle, so we take only the first item of the Edges list, and we takes its curve. Every Edge has a Curve, which is the geometry primitive it is based on. |
|||
Rendez-vous sur la page [[Topological data scripting/fr|Les scripts de pièces]] si vous voulez en savoir plus. |
|||
{{Part Tools navi}} |
{{Part Tools navi/fr}} |
||
{{Userdocnavi}} |
{{Userdocnavi/fr}} |
Revision as of 12:05, 10 August 2019
Script
La structure de données principale utilisée dans le module Part est le type de données [1] de OpenCascade. Presque tous les contenus et types d'objet du module Part sont disponibles à l'aide de scripts 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 Débuter avec les scripts pour en savoir plus.
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 (Pièce) 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()
Mise à jour du document. Cela prépare également la représentation visuelle du nouvel objet Part (pièce).
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.
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()
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 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 Les scripts de pièces si vous voulez en savoir plus.
- 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
- 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