Mesh Scripting/fr

Introduction

Pour accéder au module Mesh, vous devez d'abord l'importer :

import Mesh

Création

Pour créer un objet maillage vide il suffit d'utiliser la commande standard :

mesh = Mesh.Mesh()

Vous pouvez aussi créer un objet à partir d'un fichier :

mesh = Mesh.Mesh("D:/temp/Something.stl")

ou créer un ensemble de triangles en les décrivant par leurs sommets (Vertex) :

triangles = [
# triangle 1
[-0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000], [-0.5000, 0.5000, 0.0000],
#triangle 2
[-0.5000, -0.5000, 0.0000], [0.5000, -0.5000, 0.0000], [0.5000, 0.5000, 0.0000],
]
meshObject = Mesh.Mesh(triangles)
Mesh.show(meshObject)

Le Mesh-Kernel prend soin de créer une structure de données topologiquement correcte en triant les points et les bords coïncidents.

En haut

Modélisation

Pour créer des formes géométriques, vous pouvez utiliser l'une des méthodes create*(). Un tore, par exemple, peut être créé comme suit :

m = Mesh.createTorus(8.0, 2.0, 50)
Mesh.show(m)

Les deux premiers paramètres définissent les rayons du tore et le troisième paramètre est un facteur de sous-échantillonnage pour le nombre de triangles qui seront créés. Plus cette valeur est élevée plus la figure sera lisse.

Le module Mesh propose également trois méthodes booléennes : union(), intersection() et difference() :

m1, m2              # are the input mesh objects
m3 = Mesh.Mesh(m1)  # create a copy of m1
m3.unite(m2)        # union of m1 and m2, the result is stored in m3
m4 = Mesh.Mesh(m1)
m4.intersect(m2)    # intersection of m1 and m2
m5 = Mesh.Mesh(m1)
m5.difference(m2)   # the difference of m1 and m2
m6 = Mesh.Mesh(m2)
m6.difference(m1)   # the difference of m2 and m1, usually the result is different to m5

Voici un exemple qui crée un tube en utilisant la méthode difference() :

import FreeCAD, Mesh
cylA = Mesh.createCylinder(2.0, 10.0, True, 1.0, 36)
cylB = Mesh.createCylinder(1.0, 12.0, True, 1.0, 36)
cylB.Placement.Base = (FreeCAD.Vector(-1, 0, 0)) # move cylB to avoid co-planar faces
pipe = cylA
pipe = pipe.difference(cylB)
pipe.flipNormals() # somehow required
doc = FreeCAD.ActiveDocument
obj = d.addObject("Mesh::Feature", "Pipe")
obj.Mesh = pipe
doc.recompute()

En haut

Remarques

Les scripts, bien que difficiles à utiliser, de test unitaire du module Mesh constituent une source étendue de scripts liés au maillage.
Dans ces tests unitaires, toutes les méthodes sont appelées et toutes les propriétés/attributs sont modifiés. Donc, si vous êtes assez audacieux, jetez un œil au module de test unitaire.

Voir aussi : Mesh API.

En haut

Hub utilisateurs expérimentés

• Scripts FreeCAD : Python, Introduction à Python, Tutoriel sur les scripts Python, Débuter avec les scripts

---

• Modules : Modules intégrés, Unités, Quantity
• Ateliers : Création d'atelier, Commands Gui, Les commandes, Installer des ateliers supplémentaires
• Maillages et objets Parts : Scripts Mesh, Script de données topologiques, Conversion objet Mesh en Part, PythonOCC

---

• Objets paramétriques : Objets créés par script, Viewproviders (Icône personnalisée dans l'arborescence)
• Scénographie : Graphe de scène Coin (Inventor), Pivy
• Interface graphique : Création d'interface, Création d'une boite de dialogue (1, 2, 3, 4, 5), PySide, Exemples PySide débutant, intermédiaire, expérimenté
• Macros : Macros, Comment installer des macros
• Intégration : Intégrer FreeCAD, Intégration de FreeCADGui

---

• Autre : Expressions, Extraits de codes, Fonction - tracer une ligne, Bibliothèque mathématique vectorielle de FreeCAD (déprécié)

---

• Hubs : Hub utilisateurs, Hub utilisateurs expérimentés, Hub développeurs

Mesh

• Divers : Importer un maillage, Exporter un maillage, Créer un maillage, Solide régulier, Développer un maillage, Développer une face
• Modifier : Harmoniser les normales, Inverser les normales, Remplir les trous, Boucher un trou, Ajouter un triangle, Supprimer des composants, Suppression manuelle de composants, Lissage, Affinage, Décimation, Échelle

---

• Opérations booléennes : Union, Intersection, Différence
• Couper : Couper le maillage, Découper, Ajuster par plan, Créer une section à partir d'un maillage et d'un plan, Coupes
• Composants et segments : Fusionner, Éclater par composants, Diviser le maillage, Créer des segments de maillage de surfaces ajustées

---

• Analyser : Évaluer et réparer un maillage, Infos sur la face, Tracé de courbure, Infos de courbure, Vérifier la solidité du maillage, Boîte englobante
• Additionnel : Préférences d'Import Export, Atelier OpenSCAD, Scripts Mesh