Sketcher SketchObject/fr: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Created page with "Un Sketcher SketchObject est créé avec la méthode {{incode|addObject()}} du document.")
(18 intermediate revisions by the same user not shown)
Line 5: Line 5:
[[File:Sketcher_Sketch.svg|32px]]
[[File:Sketcher_Sketch.svg|32px]]


A [[Sketcher_SketchObject|Sketcher SketchObject]], or formally a {{incode|Sketcher::SketchObject}}, is the base element to create 2D objects with the [[Sketcher_Workbench|Sketcher Workbench]].
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]].


The {{incode|Sketcher::SketchObject}} is derived from [[Part_Part2DObject|Part Part2DObject]], which means it is a [[Part Feature|Part Feature]] object specialized for 2D geometry. Like Part2DObject, the SketchObject can be attached to planes and faces. In addition to this, the SketchObject can handle geometrical constraints of the lines and curves that are drawn within it.
{{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.


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


{{Caption|Simplified diagram of the relationships between the core objects in FreeCAD. The {{incode|Sketcher::SketchObject}} class is specialized for 2D shapes, and in addition it can handle constraints.}}
{{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.}}


== Utilisation ==
== Utilisation ==


# Switch to the [[Sketcher Workbench|Sketcher Workbench]].
# Basculez vers l'[[Sketcher Workbench/fr|Atelier Sketcher]].
# Press {{Button|[[File:Sketcher_NewSketch.svg|16px]] [[Sketcher_NewSketch|Sketcher NewSketch]]}}.
# Appuyez sur {{Button|[[File:Sketcher_NewSketch.svg|16px]] [[Sketcher_NewSketch/fr|Sketcher Nouvelle esquisse]]}}.
# Select a {{MenuCommand|Sketch orientation}}: XY-plane, XZ-plane, or YZ-plane. Optionally also choose {{MenuCommand|Reverse direction}}, and give an {{MenuCommand|Offset}} value.
# 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}}.
# Press {{Button|OK}}.
# Appuyez sur {{Button|OK}}.


Although the SketchObject can be used by itself to draw on a plane, it is most commonly used in conjunction with the [[PartDesign Workbench|PartDesign Workbench]] to create extruded solids.
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.


# Switch to the [[PartDesign Workbench|PartDesign Workbench]].
# Basculer vers le [[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/fr|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}}.


== 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.
Un [[Sketcher_SketchObject/fr|Sketcher SketchObject]] (classe {{incode|Sketcher::SketchObject}}) est dérivé de [[Part_Part2DObject/fr|Part Part2DObject]] (classe {{incode|Part::Part2DObject}}) donc partage toutes les propriétés de ce dernier.


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]].
Outre les propriétés décrites dans [[Part_Part2DObject/fr|Part Part2DObject]], l'objet de base Sketcher SketchObject possède les propriétés suivantes dans l'[[property editor/fr|éditeur de propriétés]].


=== Données ===
=== Données ===


{{TitleProperty|Attachment}}
{{TitleProperty|Attachment}}
* {{PropertyData|Map Mode}}: See [[Part Attachment|Part Attachment]] for more information on all attachment mapping modes.
* {{PropertyData|Map Mode}}: voir [[Part Attachment/fr|Part Attachement]] pour plus d'informations sur tous les modes de mappage de pièces jointes.


{{TitleProperty|Sketch}}
{{TitleProperty|Sketch}}
* {{PropertyData|Constraints}}: named constraints, if they exist; otherwise it is an empty list {{incode|[]}}.
* {{PropertyData|Constraints}}: les contraintes nommées, si elles existent sinon c'est une liste vide {{incode|[]}}.


=== Vue ===
=== Vue ===


{{TitleProperty|Auto Constraints}}
{{TitleProperty|Auto Constraints}}
* {{PropertyView|Autoconstraints}}: if {{TRUE}} it will try setting constraints when the geometry is drawn.
* {{PropertyView|Autoconstraints}}: si {{TRUE}}, il essaiera de définir des contraintes lors du tracé de la géométrie.


{{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|Editing Workbench}}: normalement {{incode|SketcherWorkbench}}, il s'agit du nom du workbench à activer lors de la modification de l'esquisse.
* {{PropertyView|Hide Dependent}}: if {{TRUE}} all objects that depend on the sketch are hidden when opening the sketch.
* {{PropertyView|Hide Dependent}}: si {{TRUE}}, tous les objets qui dépendent de l'esquisse sont masqués lors de l'ouverture de l'esquisse.
* {{PropertyView|Restore Camera}}: if {{TRUE}} the camera position is saved before opening the sketch, and is restored after closing it.
* {{PropertyView|Restore Camera}}: 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|Show Links}}: if {{TRUE}} all objects used in links to external geometry are shown when opening the sketch.
* {{PropertyView|Show Links}}: 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.
* {{PropertyView|Show Support}}: if {{TRUE}} all objects this sketch is attached to are shown when opening the sketch.
* {{PropertyView|Show Support}}: 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 ==
== 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|FreeCAD Script de base]] et [[scripted objects/fr|objet scripté]].


See [[Part_Feature|Part Feature]] for the general information.
Voir [[Part_Feature/fr|Part Feature]] pour plus d'informations.


A Sketcher SketchObject is created with the {{incode|addObject()}} method of the document.
Un Sketcher SketchObject est créé avec la méthode {{incode|addObject()}} du document.
{{Code|code=
{{Code|code=
import FreeCAD as App
import FreeCAD as App

Revision as of 14:17, 1 December 2019

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. De plus, 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 peut en outre gérer des contraintes.

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.

Données

Attachment

  • DonnéesMap Mode: 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 [].

Vue

Auto Constraints

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

Visibility automation

  • VueEditing Workbench: normalement SketcherWorkbench, il s'agit du nom du workbench à activer lors de la modification de l'esquisse.
  • VueHide Dependent: si true, tous les objets qui dépendent de l'esquisse sont masqués lors de l'ouverture de l'esquisse.
  • VueRestore Camera: 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: 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: 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 aussi: FreeCAD Script de base et objet scripté.

Voir Part Feature pour plus d'informations.

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", "Name")
obj.Label = "Custom label"