Sketcher Scripts
Créer un SketchObject en utilisant Python
Nous créons un SketchObject comme ceci :
import FreeCAD as App
import Part
import Sketcher
doc = App.newDocument()
sketch = doc.addObject("Sketcher::SketchObject", "Sketch")
sketch.addGeometry(Part.LineSegment(App.Vector(1.2, 1.8, 0),
App.Vector(5.2, 5.3, 0)), False)
sketch.addGeometry(Part.LineSegment(App.Vector(6.5, 1.5, 0),
App.Vector(10.2, 5.0, 0)), False)
sketch.addGeometry(Part.LineSegment(App.Vector(12.2, 1.0, 0),
App.Vector(15.4, 5.0, 0)), False)
doc.recompute()
Cela ajoute également trois lignes dans l'esquisse juste créée.
Créer une contrainte en Python
Une contrainte géométrique, et peuvent être créées à partir de macros et de la console Python en utilisant la commande suivante :
sketch.addConstraint(Sketcher.Constraint(ConstraintType, EdgeOrPartOfEdge…))
Une contrainte dimensionnelle, , et la contrainte spéciale Loi de Snell peuvent être créés à partir de macros et de la console Python en utilisant la commande suivante :
sketch.addConstraint(Sketcher.Constraint(DimensionalConstraintType, EdgeOrPartOfEdge…, App.Units.Quantity("float_value unit")))
par exemple
sketch.addConstraint(Sketcher.Constraint(DimensionalConstraintType, EdgeOrPartOfEdge…, App.Units.Quantity("123.0 mm")))
Le premier argument ConstraintType
est décrit ci-dessous dans les Types de contraintes.
Une contrainte peut prendre jusqu'à six arguments qui sont des arêtes ou indiquent quelle sous-partie d'une arête est utilisée par la contrainte. Consultez la documentation des contraintes individuelles pour plus de détails sur les combinaisons d'arêtes et de sous-parties d'arêtes pouvant être passées en arguments. Le principal problème avec cette fonction est d'identifier correctement le numéro de ligne et le numéro de sommet des lignes que vous souhaitez traiter. Les sections ci-dessous décrivent comment identifier le numéro d'une ligne et comment Identifier le numéro des sous-parties d'une ligne.
Types de contraintes
Pour les contraintes géométriques, le premier argument est l'un des suivants. Voir la page de fonctionnalités correspondante pour les combinaisons d'arguments possibles autorisées pour chaque contrainte.
Code | Icône | Fonction |
---|---|---|
"Coincident" |
Contrainte de coïncidence | |
"PointOnObject" |
Contrainte point sur objet | |
"Vertical" |
Contrainte verticale | |
"Horizontal" |
Contrainte horizontale | |
"Parallel" |
Contrainte parallèle | |
"Perpendicular" |
Contrainte perpendiculaire | |
"Tangent" |
Contrainte tangente | |
"Equal" |
Contrainte d'égalité | |
"Symmetric" |
Contrainte symétrique | |
"Block" |
Contrainte de blocage |
Pour les contraintes dimensionnelles, le premier argument est l'un des suivants. Voir la page de fonctionnalités correspondante pour les combinaisons d'arguments possibles autorisées pour chaque contrainte.
Code | Icône | Fonction |
---|---|---|
"DistanceX" |
Contrainte distance en X | |
"DistanceY" |
Contrainte distance en Y | |
"Distance" |
Contrainte dimensionnelle | |
"Radius" |
Contrainte rayon | |
"Diameter" |
Contrainte diamètre | |
"Angle" |
Contrainte angulaire | |
"AngleViaPoint" |
Contrainte angulaire |
Les contraintes de la Loi de Snell se comportent comme des contraintes dimensionnelles pour les besoins du script. Encore une fois, consultez la page de fonctionnalités correspondante pour les combinaisons d'arguments possibles autorisées pour chaque contrainte.
Code | Icône | Fonction |
---|---|---|
"SnellsLaw" |
Contrainte de réfraction |
La contrainte fixe est une commande de l'interface graphique qui crée une contrainte distance horizontale et une distance verticale, ce n'est pas une contrainte en soi.
Identifier le numéro d'une ligne
J'ai dessiné trois lignes comme indiqué dans la figure suivante.
En déplaçant le curseur de la souris au-dessus de la ligne, vous pouvez voir le numéro de la ligne en bas à gauche des fenêtres FreeCAD, voir la figure suivante.
Malheureusement la numérotation affichée sur les fenêtres de FreeCAD commence à partir de 1 alors que la numérotation de la ligne utilisée pour le script commence à partir de 0 : cela signifie que vous devez soustraire un à chaque fois que vous voulez faire référence à une ligne.
Les nombres positifs indiquent les arêtes d'esquisse (lignes droites, cercles, coniques, B-splines, etc.). Les valeurs suivantes peuvent être utilisées pour désigner des éléments qui ne sont pas des arêtes d'esquisse :
-1
désigne l'axe horizontal des x-2
désigne l'axe vertical y-n
désigne le numéro de l'élément de géométrie externen-3
(par exemple, l'élément de géométrie externe avec l'indice 0 dans la liste aplatiesketch.ExternalGeometry
serait désigné par -3, l'élément suivant dans la liste aplatie serait -4 et ainsi de suite).
Identifier le numéro des sous-parties d'une ligne
Pour déterminer quelle partie d'une ligne est affectée par une contrainte, les valeurs suivantes peuvent être utilisées :
0
pour indiquer que la contrainte affecte tout le bord.1
pour indiquer que la contrainte affecte le point de départ du bord (un cercle entier n'a pas de point de départ).2
pour indiquer que la contrainte affecte le point final du bord.3
pour indiquer que la contrainte affecte le point central de l'arête. Pour des cercles et des coniques (ellipses), c'est le centre du cercle ou le centre (intersection des grands et petits axes) de l'ellipse. Pour des lignes droites,3
ne peut pas être utilisé pour indiquer le point central.n
pour indiquer que la contrainte affecte le n-ième pôle d'une B-spline.
Les sommets indiqués par 1 et 2 sont numérotés selon leur ordre de création. Pour connaître l'ordre de leur création (si vous avez beaucoup de lignes, vous ne vous souvenez plus quel sommet vous avez créé en premier), il vous suffit de déplacer le curseur de votre souris au-dessus des deux sommets d'une ligne, voir figure suivante.
Si vous lisez par exemple 4 et 5, cela signifie que le sommet avec le numéro le plus bas (4 dans cet exemple) sera référencé en utilisant le numéro 1 (en premier dans la commande de script et le sommet avec le numéro le plus élevé (5 dans cet exemple) sera référencé par en utilisant le numéro 2 dans la commande de script.
Exemple
Prenons l'exemple précédent des trois lignes. La figure suivante indique la numérotation de chaque ligne et de leurs sommets selon la convention de script.
Text en bleu : numérotation des lignes, text en noir : numérotation des sommets
La commande sketch.addConstraint(Sketcher.Constraint("Coincident", 1, 2, 2, 1))
donne le résultat suivant :
Le code complet pour dessiner les trois lignes et ajouter une contrainte de coïncidence sur deux points de deux lignes est le suivant :
import FreeCAD as App
import Part
import Sketcher
doc = App.newDocument()
sketch = doc.addObject("Sketcher::SketchObject", "Sketch")
sketch.addGeometry(Part.LineSegment(App.Vector(1.2, 1.8, 0),
App.Vector(5.2, 5.3, 0)), False)
sketch.addGeometry(Part.LineSegment(App.Vector(6.5, 1.5, 0),
App.Vector(10.2, 5.0, 0)), False)
sketch.addGeometry(Part.LineSegment(App.Vector(12.2, 1.0, 0),
App.Vector(15.4, 5.0, 0)), False)
sketch.addConstraint(Sketcher.Constraint("Coincident", 1, 2, 2, 1))
doc.recompute()
- Général : Créer une esquisse, Modifier l'esquisse, Esquisse sur une face, Réorienter l'esquisse, Valider l'esquisse, Fusionner les esquisses, Esquisse miroir, Quitter l'esquisse, Vue de l'esquisse, Vue de section, Grille, Aimantation, Ordre de rendu, Arrêt de l'opération
- Géométries : Point, Ligne, Arc, Arc par 3 points, Cercle, Cercle par 3 points, Ellipse par son centre, Ellipse par 3 points, Arc d'ellipse, Arc d'hyperbole, Arc de parabole, B-spline simple, B-spline périodique, B-spline par des nœuds, B-spline périodique par des nœuds, Polyligne, Rectangle, Rectangle centré, Rectangle arrondi, Triangle, Carré, Pentagone, Hexagone, Heptagone, Octogone, Polygone régulier, Contour oblong, Congé, Congé avec contrainte, Ajuster, Prolonger, Diviser, Géométrie externe, Copie carbone, Géométrie de construction
- Contraintes :
- Contraintes geometriques : Coïncidence, Point sur objet, Vertical, Horizontal, Parallèle, Perpendiculaire, Tangente, Égalité, Symétrie, Blocage
- Contraintes de dimension : Fixe, Distance horizontale, Distance verticale, Dimensionnelle, Rayon ou poids, Diamètre, Rayon automatique, Angle, Contrainte de réfraction
- Outils de contraintes : Contraintes pilotantes, Activation des contraintes
- Outils : Degrés de liberté non contraints, Contraintes associées, Éléments associés aux contraintes, Contraintes redondantes, Contraintes conflictuelles, Géométrie interne, Origine, Axe horizontal, Axe vertical, Symétrie, Clone, Copie, Déplacer, Réseau rectangulaire, Supprimer l'alignement des axes, Supprimer tous les éléments de géométrie, Supprimer toutes les contraintes
- Outils B-spline : Degré de la B-spline, Polygone de contrôle de la B-spline, Peigne de courbure, Multiplicité des nœuds, Poids des points de contrôle, Convertir une géométrie en B-spline, Augmenter le degré, Diminuer le degré, Augmenter la multiplicité des nœuds, Diminuer la multiplicité des nœuds, Insérer un nœud, Joindre des courbes
- Espace virtuel : Espace virtuel
- 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