Sketcher SketchObject

From FreeCAD Documentation
Revision as of 20:26, 23 February 2022 by David69 (talk | contribs)
Other languages:

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

  1. Basculez vers l'Atelier Sketcher.
  2. Appuyez sur Sketcher Nouvelle esquisse.
  3. Sélectionnez une Template:MenuCommand/fr: plan XY, plan XZ ou plan YZ. Vous pouvez également choisir d'Template:MenuCommand/fr et donner une valeur de Template:MenuCommand/fr.
  4. Appuyez sur OK.

Bien que SketchObject puisse être utilisé seul pour dessiner sur un plan, il est le plus souvent utilisé conjointement avec l'Atelier PartDesign pour créer des solides extrudés.

  1. Basculer vers l'Atelier PartDesign.
  2. Appuyez sur PartDesign Corps.
  3. Appuyez sur PartDesign Nouvelle esquisse.
  4. Template:MenuCommand/fr: XY_Plane (Plan de base), XZ_Plane (Plan de base) ou YZ_Plane (Plan de base).
  5. Appuyez sur OK.

Propriétés

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

Un Sketcher SketchObject (classe Sketcher::SketchObject) est dérivé de Part Part2DObject (classe Part::Part2DObject) donc partage toutes les propriétés de ce dernier.

Outre les propriétés décrites dans Part Part2DObject, l'objet de base Sketcher SketchObject possède les propriétés suivantes dans l'éditeur de propriétés. Les propriétés masquées peuvent être affichées en utilisant la commande Show all dans le menu contextuel de l'éditeur de propriétés.

Données

Sketch

  • Données (Hidden)Geometry (GeometryList): a list of Part geometries that exist inside the sketch.
  • DonnéesConstraints: named constraints, if they exist; otherwise it is an empty list [].
  • DonnéesExternal Geometry (LinkSubList): a list of Part geometries outside this Sketch that are used for reference.
  • Données (Hidden)Fully Constrained (Bool): (read-only) if true the sketch is fully constrained.

Vue

Auto Constraints

  • VueAutoconstraints (Bool): si true, il essaiera de définir des contraintes lors du tracé de la géométrie.
  • VueAutoconstraints (Bool): if true constraints are automatically added when geometry is drawn.
  • VueAvoid Redundant (Bool): if true redundant auto-constraints are avoided.

Grid

  • Vue (Hidden)Grid Auto Size (Bool): if true the grid is resized based on the boundingbox of the geometry of the sketch.
  • VueGrid Size (Length): the size of the spacing of the local grid lines in the 3D view; it defaults to 10 mm.
  • VueGrid Snap (Bool): if true the grid can be used to snap points.
  • VueGrid Style (Enumeration): the style of the grid lines; Dashed (default) or Light.
  • VueShow Grid (Bool): if true a grid local to the object will be displayed in the 3D view. This grid is independent of the Draft Grid.
  • VueShow Only In Edit Mode (Bool): if true the grid is only displayed while the sketch is being edited.
  • VueTight Grid (Bool): if true the local grid will be localized around the origin of the shape, otherwise it will extend itself more.
  • Vuemax Number Of Lines (Integer): the maximum number of lines in the grid.

Visibility automation

Visibility automation

  • VueEditing Workbench (String): nom du workbench à activer lors de la modification de l'esquisse. Valeur par défaut SketcherWorkbench.
  • VueHide Dependent (Bool): si true, tous les objets qui dépendent de l'esquisse sont masqués lors de l'ouverture de l'esquisse.
  • 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.
  • VueShow Links (Bool): si true, tous les objets utilisés dans les liens vers une géométrie externe sont affichés lors de l'ouverture de l'esquisse.
  • VueShow Support (Bool): si true tous les objets auxquels cette esquisse est attachée sont affichés lors de l'ouverture de l'esquisse.

Création de scripts

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"

Par conséquent, pour la sous-classe 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"