Sketcher SketchObject

From FreeCAD Documentation
Revision as of 13:18, 19 January 2020 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.

Schéma simplifié des relations entre les objets principaux dans FreeCAD. La classe Sketcher::SketchObject est spécialisée pour les formes 2D et comprend en plus une extension pour gérer les contraintes géométriques de ses éléments.

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 Atelier PartDesign pour créer des solides extrudés.

  1. Basculer vers le 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

Attachment

  • DonnéesMap Mode, DonnéesMap Reversed, DonnéesAttachment Offset comme Part Part2DObject. Voir Part Attachement pour plus d'informations sur tous les modes de mappage de pièces jointes.

Sketch

  • DonnéesConstraints: les contraintes nommées, si elles existent sinon c'est une liste vide [].
Propriétés cachées de Données

Voir Part Part2DObject pour le reste des propriétés masquées.

Base

  • DonnéesProxy (PythonObject): classe personnalisée associée à cet objet. Cela n'existe que pour la version Python. Voir Script.

Sketch

  • DonnéesGeometry (GeometryList): liste des géométries de pièce qui existent à l'intérieur de l'esquisse.
  • DonnéesGéométrie externe (LinkSubList): liste des géométries de pièce en dehors de cette esquisse qui sont utilisées comme référence.

Vue

Auto Constraints

  • VueAutoconstraints (Bool): si true, il essaiera de définir des contraintes lors du tracé de la géométrie.

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.

Hidden properties View

Base

  • VueProxy (PythonObject): a custom view provider class associated with this object. This only exists for the Python version. See Scripting.

Visibility automation

  • VueTempo Vis (PythonObject): a custom class associated with this object, that handles hiding and showing other objects when opening and closing the sketch.

All other view properties, including hidden properties, are those of the base Part Feature object.

Création de scripts

Voir aussi: FreeCAD Script de base et objet scripté.

Voir Part Feature pour plus d'informations à l'ajout d'objets.

Un Sketcher 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"

This basic Sketcher::SketchObject doesn't have a Proxy object so it can't be fully used for sub-classing.

Therefore, for Python subclassing, you should create the Sketcher::SketchObjectPython object.

import FreeCAD as App

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