ged and object editor unavailabilities on MacOS is now documented.
[scilab.git] / scilab / modules / graphics / help / fr_FR / object_editor.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="object_editor">
3     <refnamediv>
4         <refname>object_editor </refname>
5         <refpurpose>description des capacités de
6             l'éditeur graphique
7         </refpurpose>
8     </refnamediv>
9     <refsection>
10         <title>Description</title>
11         <para>La module graphique de Scilab permet de nombreuses intéractions
12             entre l'utilisateur et le graphique aussi bien avant
13             qu'après sa création. Chaque fenêtre
14             graphique et les dessins qu'elle contient sont représentés sous forme
15             d'entités hiérarchiques. Le plus haut niveau de la hiérarchie est
16             toujours l'entité Figure. Chaque Figure définit au moins un enfant de type
17             Axes. Chaque entité Axes contient un ensemble d'entités feuilles (entités
18             terminales de la hiérarchie - elles n'ont pas de fils) qui sont les objets
19             de type Polylines, Rectangles, Arcs, Segs,... L'entités Axes peut
20             également contenir une entité intermédiaire nommé Compound qui regroupe un
21             ensemble d'entités filles.
22         </para>
23         <para>Le principal intérêt du mode graphique réside dans sa capacité
24             à   changer à   volonté les propriétés des objets graphiques a
25             priori et surtout a posteriori. Ce mode graphique est fourni avec
26             une suite de commandes graphiques de haut niveau (voir <link linkend="set">set</link>,
27             <link linkend="get">get</link>) utliisées pour positionner les proriéts des objets
28             telles que les données, les coordonnées, échelles, couleur etc... sans
29             avoir à   rejouer les commandes initiales (comportement de l'ancien
30             mode graphique).
31         </para>
32         <para>
33             Les entités graphiques ont un type <literal>handle</literal> dans Scilab.Un
34             handle est un identificateur unique qui est associé chaque instance d'un
35             objet graphique créé. En utilisant ce handle, il sera possible d'atteindre
36             les propriétés de l'entité considérée à   travers l'utilisation des
37             commandes "set" et "get". Les handles sont aussi utiles pour manipuler des
38             objets graphiques, les bouger, les copier ou encore les supprimer.
39         </para>
40         <para>Pour compléter ce mode, un éditeur graphique a été développé
41             pour ces objets. Il s'agit d'un ensemble d'interfaces en Tcl/Tk
42             disponibles pour chaque objet graphique (voir
43             <link linkend="graphics_entities">graphics_entities</link> pour plus de détail). Pour lancer
44             l'interface, il faut sélectionner le menu <literal>Edit</literal> dans la
45             fenêtre graphique. On a alors sept opérations d'édition disponibles:
46         </para>
47         <para/>
48         <variablelist>
49             <varlistentry>
50                 <term>Select figure as current: </term>
51                 <listitem>
52                     <para>Positionne la figure comme étant la nouvelle figure courante.</para>
53                     <para/>
54                 </listitem>
55             </varlistentry>
56             <varlistentry>
57                 <term>Redraw figure: </term>
58                 <listitem>
59                     <para>Redessinne le contenu de la figure.</para>
60                     <para/>
61                 </listitem>
62             </varlistentry>
63             <varlistentry>
64                 <term>Erase figure: </term>
65                 <listitem>
66                     <para>Efface le contenu de la figure. Son action correspond à   un
67                         appel à <literal>clf</literal>.
68                     </para>
69                     <para/>
70                 </listitem>
71             </varlistentry>
72             <varlistentry>
73                 <term>Copy object/Copier: </term>
74                 <listitem>
75                     <para>En utilisant la souris, cela permet de sélectionner un objet
76                         graphique 2D (comme une courbe, un rectangle...) et de le glisser dans
77                         le presse-papier. Ainsi, par un prochain appel à   <literal>Paste
78                             object
79                         </literal>
80                         ,l'objet est recopié dans les axe courant.
81                     </para>
82                     <para/>
83                 </listitem>
84             </varlistentry>
85             <varlistentry>
86                 <term>Paste object/Coller: </term>
87                 <listitem>
88                     <para>Permet à   l'utilisateur de coller un objet précédemment placé
89                         dans le presse-papier sur l'axe courant.
90                     </para>
91                     <para/>
92                 </listitem>
93             </varlistentry>
94             <varlistentry>
95                 <term>Move object/Déplacer: </term>
96                 <listitem>
97                     <para>En utilisant la souris, cette fonction permet de bouger un objet
98                         2D (comme une courbe, un rectangle...) à   l'intérieur d'un axe
99                         courant.
100                     </para>
101                     <para/>
102                 </listitem>
103             </varlistentry>
104             <varlistentry>
105                 <term>Delete object/Détruire: </term>
106                 <listitem>
107                     <para>En utilisant la souris, cette fonction permet de détruire un objet
108                         2D (like a curve, a rectangle...) que l'on sélectionne a
109                         posteriori.
110                     </para>
111                     <para/>
112                 </listitem>
113             </varlistentry>
114             <varlistentry>
115                 <term>Figure Properties: </term>
116                 <listitem>
117                     <para>Lance l'interface Tcl/Tk pour l'objet Figure, handle de la figure
118                         de la fenêtre courante.
119                     </para>
120                     <para/>
121                 </listitem>
122             </varlistentry>
123             <varlistentry>
124                 <term>Current Axes Properties: </term>
125                 <listitem>
126                     <para>Lance l'interface Tcl/Tk pour l'objet Axes courant, handle de
127                         l'axe courant de la fenêtre courante.
128                     </para>
129                     <para/>
130                 </listitem>
131             </varlistentry>
132             <varlistentry>
133                 <term>Start Entity Picker/Démarrer le sélecteur d'entités: </term>
134                 <listitem>
135                     <para>Démarre un sélecteur d'entité pour pointer des objets 2D à  
136                         la souris et ainsi ouvrir leur interface Tcl/Tk pour pouvoir modifier
137                         leurs propriétés. Le clic souris gauche permet d'éditer l'objet
138                         cliqué; le clic droit réalise un déplacement de l'objet sélectionné.
139                         Remarque: pour l'instant, cette option fonctionne uniquement avec des
140                         objets 2D.
141                     </para>
142                     <para/>
143                 </listitem>
144             </varlistentry>
145             <varlistentry>
146                 <term>Stop Entity Picker/Arrêter le sélecteur d'entités: </term>
147                 <listitem>
148                     <para>Arrête l'action du sélecteur d'entité.</para>
149                     <para/>
150                 </listitem>
151             </varlistentry>
152         </variablelist>
153         <para>Une fois l'interface graphique (fenêtre Tcl/Tk) activée en utilisant
154             les commandes <literal>Figure Properties</literal> ou <literal>Current Axes
155                 Properties
156             </literal>
157             ,on distingue 2 zones pricnipales sur ces interfaces
158             :
159         </para>
160         <para/>
161         <para/>
162         <variablelist>
163             <varlistentry>
164                 <term>Un arbre sélecteur: </term>
165                 <listitem>
166                     <para>placé sur la gauche de la fenêtre de l'éditeur graphique, l'arbre
167                         sélecteur permet de parcourir la hiérarchie des objets présents au
168                         sein de la figure. On peut passer d'un objet à   l'autre en
169                         déroulant la hiérarchie.
170                     </para>
171                 </listitem>
172             </varlistentry>
173         </variablelist>
174         <para>
175             <inlinemediaobject>
176                 <imageobject>
177                     <imagedata fileref="../images/tree.gif"/>
178                 </imageobject>
179             </inlinemediaobject>
180         </para>
181         <para/>
182         <variablelist>
183             <varlistentry>
184                 <term>Des onglets: </term>
185                 <listitem>
186                     <para>La seconde zone d'intérêt est à   droite: les propriétés de
187                         l'objet sélectionné dans l'arbre sont disposées dans une structure
188                         multi-onglets. On y trouve différents types de propriétés telles le
189                         <literal>Style</literal>, <literal>Data</literal>, <literal>Clipping</literal>... Elles
190                         dépendent du type d'objet considéré. A travers cet éditeur, on peut
191                         voir et changer les propriétés de ces objets de façon graphique comme
192                         on le ferait à   travers l'emploi des fonctions <literal>"set"</literal>
193                         et <literal>"get"</literal> dans la console. Voici un exemple d'onglets
194                         affichant les propriétés d'un objet de type Axes:
195                     </para>
196                 </listitem>
197             </varlistentry>
198         </variablelist>
199         <para>
200             <inlinemediaobject>
201                 <imageobject>
202                     <imagedata fileref="../images/notebook.gif"/>
203                 </imageobject>
204             </inlinemediaobject>
205         </para>
206         <para/>
207         <para>De plus, on peut légender/annoter la figure en utilisant des primitives
208             simples données dans le menu <literal>Insert</literal> de la fenêtre graphique.
209             En utilisant la souris et en suivant les instructions dans la sous-fenêtre
210             de message, on peut ajouter un(e):
211         </para>
212         <para/>
213         <variablelist>
214             <varlistentry>
215                 <term>Line/Ligne: </term>
216                 <listitem>
217                     <para>Dessine une ligne définie entre 2 clics souris gauche. La ligne
218                         est définie dans le repère des axes du premier point sélectionné.
219                     </para>
220                 </listitem>
221             </varlistentry>
222         </variablelist>
223         <para/>
224         <variablelist>
225             <varlistentry>
226                 <term>Polyline/Ligne brisée: </term>
227                 <listitem>
228                     <para>Dessine une ligne brisée en sélectionnant un chemin (clic gauche)
229                         et une fin (clic droit). La ligne brisée est définie dans le repère
230                         des axes du premier point sélectionné.
231                     </para>
232                 </listitem>
233             </varlistentry>
234         </variablelist>
235         <para/>
236         <variablelist>
237             <varlistentry>
238                 <term>Arrow/Flèche: </term>
239                 <listitem>
240                     <para>Dessine une flèche définie entre 2 clics souris gauche. La flèche
241                         est définie dans le repère des axes du premier point sélectionné.
242                     </para>
243                 </listitem>
244             </varlistentry>
245         </variablelist>
246         <para/>
247         <variablelist>
248             <varlistentry>
249                 <term>Double arrow/Double flèche: </term>
250                 <listitem>
251                     <para>Dessine une double-flèche définie entre 2 clics souris gauche. La
252                         flèche est définie dans le repère des axes du premier point
253                         sélectionné.
254                     </para>
255                 </listitem>
256             </varlistentry>
257         </variablelist>
258         <para/>
259         <variablelist>
260             <varlistentry>
261                 <term>Text/Texte: </term>
262                 <listitem>
263                     <para>Ouvre une boîte de dialogue pour entrer un texte, puis, en
264                         cliquant qur une zone de la figure, insert le texte à   l'endroit
265                         cliquer. Le texte est définie dans le repère des axes du point
266                         sélectionné.
267                     </para>
268                 </listitem>
269             </varlistentry>
270         </variablelist>
271         <para/>
272         <variablelist>
273             <varlistentry>
274                 <term>Rectangle: </term>
275                 <listitem>
276                     <para>Dessine un rectangle : 2 clics souris gauches définissent
277                         respectivement le coin supérieur gauche et inférieur droit du
278                         rectangle. Le rectangle est défini dans le repère des axes du premier
279                         point sélectionné.
280                     </para>
281                 </listitem>
282             </varlistentry>
283         </variablelist>
284         <para/>
285         <variablelist>
286             <varlistentry>
287                 <term>Circle/Cercle: </term>
288                 <listitem>
289                     <para>Dessine un cercle : 2 clics souris gauches définissent
290                         respectivement le coin supérieur gauche et inférieur droit de la boîte
291                         englobante du cercle. Le cercle est défini dans le repère des axes du
292                         premier point sélectionné.
293                     </para>
294                 </listitem>
295             </varlistentry>
296         </variablelist>
297     </refsection>
298     <refsection role="see also">
299         <title>Voir aussi</title>
300         <simplelist type="inline">
301             <member>
302                 <link linkend="graphics_entities">graphics_entities</link>
303             </member>
304             <member>
305                 <link linkend="set">set</link>
306             </member>
307             <member>
308                 <link linkend="get">get</link>
309             </member>
310             <member>
311                 <link linkend="clf">clf</link>
312             </member>
313             <member>
314                 <link linkend="plot">plot</link>
315             </member>
316             <member>
317                 <link linkend="ged">ged</link>
318             </member>
319         </simplelist>
320     </refsection>
321 </refentry>