Sketcher SketchObject/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "Bien que SketchObject puisse être utilisé seul pour dessiner sur un plan, il est le plus souvent utilisé conjointement avec Atelier PartDesign p...")
No edit summary
 
(65 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}


== Introduction ==
== Introduction ==
Line 7: Line 8:
Un [[Sketcher_SketchObject/fr|Sketcher SketchObject]], ou formellement un {{incode|Sketcher::SketchObject}}, est l'élément de base pour créer des objets 2D avec l'[[Sketcher_Workbench/fr|Atelier Sketcher]].
Un [[Sketcher_SketchObject/fr|Sketcher SketchObject]], ou formellement un {{incode|Sketcher::SketchObject}}, est l'élément de base pour créer des objets 2D avec l'[[Sketcher_Workbench/fr|Atelier Sketcher]].


{{incode|Sketcher::SketchObject}} est dérivé de [[Part_Part2DObject/fr|Part Part2DObject]]. Cela signifie qu'il s'agit d'un objet [[Part Feature/fr|Part Feature]] spécialisé dans la géométrie 2D. Comme Part2DObject, l'objet SketchObject peut être attaché à des plans et à des faces. De plus, SketchObject peut gérer les contraintes géométriques des lignes et des courbes qui y sont dessinées.
{{incode|Sketcher::SketchObject}} est dérivé de [[Part_Part2DObject/fr|Part Part2DObject]]. Cela signifie qu'il s'agit d'un objet [[Part Feature/fr|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.


[[File:FreeCAD_core_objects.svg|800px]]
[[File:FreeCAD_core_objects.svg|800px]]


{{Caption|Schéma simplifié des relations entre les objets principaux dans FreeCAD. La classe {{incode|Sketcher::SketchObject}} est spécialisée pour les formes 2D et peut en outre gérer des contraintes.}}
{{Caption|Diagramme simplifié des relations entre les objets centraux dans Freecad}}


<span id="Usage"></span>
== Utilisation ==
== Utilisation ==


# Basculez vers l'[[Sketcher Workbench/fr|Atelier Sketcher]].
# Basculez vers l'[[Sketcher Workbench/fr|Atelier Sketcher]].
# Appuyez sur {{Button|[[File:Sketcher_NewSketch.svg|16px]] [[Sketcher_NewSketch|Créer une nouvelle esquisse]]}}.
# Appuyez sur {{Button|[[File:Sketcher_NewSketch.svg|16px]] [[Sketcher_NewSketch/fr|Sketcher Nouvelle esquisse]]}}.
# Sélectionnez une {{MenuCommand/fr|Orientation de l'esquisse}}: plan XY, plan XZ ou plan YZ. Vous pouvez également choisir d'{{MenuCommand/fr|Inverser la direction}} et donner une valeur de {{MenuCommand/fr|Décalage}}.
# Sélectionnez une {{MenuCommand|Orientation de l'esquisse}}: plan XY, plan XZ ou plan YZ. Vous pouvez également choisir d'{{MenuCommand|Inverser la direction}} et donner une valeur de {{MenuCommand|Décalage}}.
# Appuyez sur {{Button|OK}}.
# Appuyez sur {{Button|OK}}.


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


# Switch to the [[PartDesign Workbench|PartDesign Workbench]].
# Basculer vers l'[[PartDesign_Workbench/fr|Atelier PartDesign]].
# Press {{Button|[[File:PartDesign_Body.svg|16px]] [[PartDesign_Body|PartDesign Body]]}}.
# Appuyez sur {{Button|[[File:PartDesign_Body.svg|16px]] [[PartDesign_Body/fr|PartDesign Corps]]}}.
# Press {{Button|[[File:PartDesign_NewSketch.svg|16px]] [[PartDesign_NewSketch|PartDesign NewSketch]]}}.
# Appuyez sur {{Button|[[File:PartDesign_NewSketch.svg|16px]] [[PartDesign_NewSketch/fr|PartDesign Nouvelle esquisse]]}}.
# {{MenuCommand|Select feature}}: XY_Plane (Base plane), XZ_Plane (Base plane), or YZ_Plane (Base plane).
# {{MenuCommand|Fonction sélectionnée}}: XY_Plane (Plan de base), XZ_Plane (Plan de base) ou YZ_Plane (Plan de base).
# Press {{Button|OK}}.
# Appuyez sur {{Button|OK}}.


<span id="Properties"></span>
== Propriétés ==
== Propriétés ==


See [[Property|Property]] for all property types that scripted objects can have.
Voir [[Property/fr|Propriétés]] pour tous les types de propriétés que les objets scriptés peuvent avoir.


A [[Sketcher_SketchObject|Sketcher SketchObject]] ({{incode|Sketcher::SketchObject}} class) is derived from a [[Part_Part2DObject|Part Part2DObject]] ({{incode|Part::Part2DObject}} class), therefore it shares all the latter's properties.
[[Sketcher_SketchObject/fr|Sketcher SketchObject]] (classe {{incode|Sketcher::SketchObject}}) est dérivé de [[Part_Part2DObject/fr|Part Part2DObject]] (classe {{incode|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'[[Property_editor/fr|éditeur de propriétés]]. Les propriétés cachées peuvent être affichées à l'aide de la commande {{MenuCommand|Show all}} du menu contextuel de l'[[Property_editor/fr|éditeur de propriétés]].
In addition to the properties described in [[Part_Part2DObject|Part Part2DObject]], the basic Sketcher SketchObject has the following properties in the [[property editor|property editor]].


<span id="Data"></span>
=== Données ===
=== Données ===

{{TitleProperty|Attachment}}
* {{PropertyData|Map Mode}}: See [[Part Attachment|Part Attachment]] for more information on all attachment mapping modes.


{{TitleProperty|Sketch}}
{{TitleProperty|Sketch}}
* {{PropertyData|Constraints}}: named constraints, if they exist; otherwise it is an empty list {{incode|[]}}.


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

<span id="View"></span>
=== Vue ===
=== Vue ===


{{TitleProperty|Auto Constraints}}
{{TitleProperty|Auto Constraints}}

* {{PropertyView|Autoconstraints}}: if {{TRUE}} it will try setting constraints when the geometry is drawn.
* {{PropertyView|Autoconstraints|Bool}} : si {{TRUE}} les contraintes sont automatiquement ajoutées lorsque la géométrie est dessinée.
* {{PropertyView|Avoid Redundant|Bool}} : si {{TRUE}} les contraintes automatiques redondantes sont évitées.

{{TitleProperty|Grid}}

* {{PropertyView|Grid Auto Size|Bool|Hidden}} : si {{TRUE}}, la grille est redimensionnée en fonction de la boîte de délimitation de la géométrie de l'esquisse.
* {{PropertyView|Grid Size|Length}} : la taille de l'espacement des lignes de la grille locale dans la [[3D_view/fr|Vue 3D]] ; la valeur par défaut est {{value|10 mm}}.
* {{PropertyView|Grid Snap|Bool}} : si {{TRUE}}, la grille peut être utilisée pour fixer des points.
* {{PropertyView|Grid Style|Enumeration}} : le style des lignes de la grille ; {{value|Dashed}} (par défaut) ou {{value|Light}}.
* {{PropertyView|Show Grid|Bool}} : si {{TRUE}}, une grille locale à l'objet sera affichée dans la [[3D_view/fr|Vue 3D]]. Cette grille est indépendante de la [[Draft_ToggleGrid/fr|Draft Grille]].
* {{PropertyView|Show Only In Edit Mode|Bool}} : si {{TRUE}}, la grille n'est affichée que lorsque l'esquisse est en cours d'édition.
* {{PropertyView|Tight Grid|Bool}} : si {{TRUE}} la grille locale sera localisée autour de l'origine de la forme, sinon elle s'étendra davantage.
* {{PropertyView|max Number Of Lines|Integer}} : le nombre maximum de lignes dans la grille.


{{TitleProperty|Visibility automation}}
{{TitleProperty|Visibility automation}}
* {{PropertyView|Editing Workbench}}: normally {{incode|SketcherWorkbench}}, it is the name of the workbench to activate when editing the sketch.
* {{PropertyView|Hide Dependent}}: if {{TRUE}} all objects that depend on the sketch are hidden when opening the sketch.
* {{PropertyView|Restore Camera}}: if {{TRUE}} the camera position is saved before opening the sketch, and is restored after closing it.
* {{PropertyView|Show Links}}: if {{TRUE}} all objects used in links to external geometry are shown when opening the sketch.
* {{PropertyView|Show Support}}: if {{TRUE}} all objects this sketch is attached to are shown when opening the sketch.


* {{PropertyView|Editing Workbench|String}} : nom de l'atelier à activer lors de l'édition de l'esquisse ; la valeur par défaut est {{value|SketcherWorkbench}}.
* {{PropertyView|Force Ortho|Bool}} : si {{TRUE}}, la caméra sera forcée à [[Std_OrthographicCamera/fr|mode de vue orthographique]] lorsque l'esquisse est ouverte.
* {{PropertyView|Hide Dependent|Bool}} : si {{TRUE}}, tous les objets qui dépendent de l'esquisse sont masqués lorsque l'esquisse est ouverte.
* {{PropertyView|Restore 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.
* {{PropertyView|Section 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.
* {{PropertyView|Show 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.
* {{PropertyView|Show Support|Bool}} : si {{TRUE}}, tous les objets auxquels cette esquisse est attachée sont affichés lorsque l'esquisse est ouverte.
* {{PropertyView|Tempo Vis|PythonObject|Hidden}} : 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.

<span id="Scripting"></span>
== Création de scripts ==
== Création de scripts ==


{{Emphasis|See also:}} [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]], and [[scripted objects|scripted objects]].
{{Emphasis|Voir aussi :}} [[FreeCAD_Scripting_Basics/fr|Débuter avec les scripts]] et [[Scripted_objects/fr|Objets créés par script]].


See [[Part_Feature|Part Feature]] for the general information.
Voir [[Part_Feature/fr|Part Feature]] pour les informations générales sur l'ajout d'objets au document.

Un SketchObject est créé avec la méthode {{incode|addObject()}} du document.


A Sketcher SketchObject is created with the {{incode|addObject()}} method of the document.
{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App


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


Pour la sous-classification de [[Python/fr|Python]], vous devez créer l'objet {{incode|Sketcher::SketchObjectPython}}.
{{Sketcher Tools navi/fr}}

{{Userdocnavi/fr}}
{{Code|code=
import FreeCAD as App

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


{{Sketcher_Tools_navi{{#translation:}}}}
{{Document_objects_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 14:45, 3 February 2023

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 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.
  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. Fonction sélectionnée: 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.

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