Jump to content

Sketcher SketchObject

From FreeCAD Documentation
This page is a translated version of the page Sketcher SketchObject and the translation is 100% complete.

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 ancré à des plans et à des faces. En outre, le SketchObject peut gérer des contraintes géométriques.

Diagramme simplifié des relations entre les objets clés 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

Base

  • Données (Hidden)Internal Shape (PartShape) : à définir.

Internal Geometry

  • DonnéesMake Internals (Bool) : si true, les arêtes qui se croisent sont scindées (ne semble pas fonctionner).

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ées (ReadOnly)External Geometry (LinkSubList) : liste des Part géométries extérieures à l'esquisse utilisées à titre de référence.
  • Données (Hidden)External Types (IntegerList) : type de géométrie externe de l'esquisse : 0 (projection), 1 (intersection) ou 2 (les deux). introduit dans la version 1.1
  • Données (Hidden, ReadOnly)Fully Constrained (Bool) : si true, l'esquisse est entièrement contrainte.
  • Données (Hidden)Exports (LinkListHidden) : géométrie d'exportation de l'esquisse.
  • Données (Hidden)External Geo (GeometryList) : géométrie externe de l'esquisse.
  • DonnéesArc Fit Tolerance (Precision) : tolérance d'ajustement des arcs de la géométrie externe projetée.

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. Par défaut 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.

Layers

  • VueVisual Layer List (BadType) :

Object style

  • VueAuto Color (Bool) : si true, l'objet sera coloré en fonction des préférences de l'utilisateur, introduit dans la version 1.1 : les propriétés VueLine Color, VuePoint Color et VueShape Appearance sont alors masquées dans l'éditeur de propriétés. Mettez à false pour spécifier explicitement les couleurs.

Visibility automation

  • VueEditing Workbench (String) : nom de l'atelier à activer lors de l'édition de l'esquisse. Par défaut 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 en 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"