Sketcher SketchObject

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

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

Basculez vers l'Atelier Sketcher.
Appuyez sur Sketcher Nouvelle esquisse.
Sélectionnez une Orientation de l'esquisse: plan XY, plan XZ ou plan YZ. Vous pouvez également choisir d'Inverser la direction et donner une valeur de Décalage.
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.

Basculer vers l'Atelier PartDesign.
Appuyez sur PartDesign Corps.
Appuyez sur PartDesign Nouvelle esquisse.
Fonction sélectionnée: XY_Plane (Plan de base), XZ_Plane (Plan de base) ou YZ_Plane (Plan de base).
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.

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

Le 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 Show all 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

Vue (Hidden)Grid Auto Size (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.
VueGrid Snap (Bool) : si true, la grille peut être utilisée pour fixer des points.
VueGrid Style (Enumeration) : le style des lignes de la grille ; Dashed (par défaut) ou Light.
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.
VueShow Only In Edit Mode (Bool) : si true, la grille n'est affichée que lorsque l'esquisse est en cours d'édition.
VueTight Grid (Bool) : si true la grille locale sera localisée autour de l'origine de la forme, sinon elle s'étendra davantage.
Vuemax Number Of Lines (Integer) : le nombre maximum de lignes dans la 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 prise de vue 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 prise de vue 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"