Donate

Introduction

Un Sketcher SketchObject, ou formellement un Sketcher::SketchObject, est l'élément de base pour créer des objets 2D avec l'atelier Sketcher.

Sketcher::SketchObject est dérivé de Part Part2DObject. Cela signifie qu'il s'agit d'un objet Part Feature spécialisé dans la géométrie 2D. Comme Part2DObject, l'objet SketchObject peut être attaché à des plans et à des faces. En plus de cela, SketchObject peut gérer les contraintes géométriques des lignes et des courbes qui y sont dessinées.

Diagramme simplifié des relations entre les objets centraux dans Freecad

Utilisation

Voir Sketcher Créer une esquisse.

Propriétés

Voir Propriétés pour tous les types de propriétés que les objets scriptés peuvent avoir.

Sketcher SketchObject (classe Sketcher::SketchObject) est dérivé de Part Part2DObject (classe Part::Part2DObject) et hérite de toutes ses propriétés.

Sketcher SketchObject possède également les propriétés supplémentaires suivantes dans l'éditeur de propriétés. Les propriétés cachées peuvent être affichées à l'aide de la commande Afficher les propriétés cachées du menu contextuel de l'éditeur de propriétés.

Données

Sketch

• Données (Hidden)Geometry (GeometryList) : une liste des géométries de Part qui existent dans l'esquisse.
• DonnéesConstraints : contraintes nommées, si elles existent ; sinon, il s'agit d'une liste vide [].
• DonnéesExternal Geometry (LinkSubList) : une liste de géométries de pièces extérieures à cette esquisse qui sont utilisées comme référence.
• Données (Hidden)Fully Constrained (Bool) : (en lecture seule) si true l'esquisse est entièrement contrainte.

Vue

Auto Constraints

• VueAutoconstraints (Bool) : si true les contraintes sont automatiquement ajoutées lorsque la géométrie est dessinée.
• VueAvoid Redundant (Bool) : si true les contraintes automatiques redondantes sont évitées.

Grid

• VueGrid Auto (Bool) : si true, la grille est redimensionnée en fonction de la boîte de délimitation de la géométrie de l'esquisse.
• VueGrid Size (Length) : la taille de l'espacement des lignes de la grille locale dans la vue 3D ; la valeur par défaut est 10 mm.
• VueShow Grid (Bool) : si true, une grille locale à l'objet sera affichée dans la vue 3D. Cette grille est indépendante de la Draft Grille.

Visibility automation

• VueEditing Workbench (String) : nom de l'atelier à activer lors de l'édition de l'esquisse ; la valeur par défaut est SketcherWorkbench.
• VueForce Ortho (Bool) : si true, la caméra sera forcée à mode de vue orthographique lorsque l'esquisse est ouverte.
• VueHide Dependent (Bool) : si true, tous les objets qui dépendent de l'esquisse sont masqués lorsque l'esquisse est ouverte.
• VueRestore Camera (Bool) : si true, la position de la caméra est enregistrée avant l'ouverture de l'esquisse et est restaurée après sa fermeture.
• VueSection View (Bool) : si true, seuls les (parties des) objets situés derrière le plan de l'esquisse sont visibles pendant l'édition de l'esquisse.
• VueShow Links (Bool) : si true, tous les objets utilisés dans les liens vers la géométrie externe sont affichés à l'ouverture de l'esquisse.
• VueShow Support (Bool) : si true, tous les objets auxquels cette esquisse est attachée sont affichés lorsque l'esquisse est ouverte.
• Vue (Hidden)Tempo Vis (PythonObject) : une classe personnalisée associée à cet objet, qui gère le masquage et l'affichage d'autres objets lors de l'ouverture et de la fermeture de l'esquisse.

Création de scripts

Voir aussi : Débuter avec les scripts et Objets créés par script.

Voir Part Feature pour les informations générales sur l'ajout d'objets au document.

Un SketchObject est créé avec la méthode addObject() du document.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Sketcher::SketchObject", "Sketch")
obj.Label = "Custom label"

Pour la sous-classification de Python, vous devez créer l'objet Sketcher::SketchObjectPython.

import FreeCAD as App

doc = App.newDocument()
obj = App.ActiveDocument.addObject("Sketcher::SketchObjectPython", "CustomSketch")
obj.Label = "Custom label"