File: object_editor.xml

package info (click to toggle)
scilab 5.2.2-9
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 334,832 kB
  • ctags: 52,586
  • sloc: xml: 526,945; ansic: 223,590; fortran: 163,080; java: 56,934; cpp: 33,840; tcl: 27,936; sh: 20,397; makefile: 9,908; ml: 9,451; perl: 1,323; cs: 614; lisp: 30
file content (400 lines) | stat: -rw-r--r-- 12,575 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA - Fabrice Leray
 * 
 * This file must be used under the terms of the CeCILL.
 * This source file is licensed as described in the file COPYING, which
 * you should have received as part of this distribution.  The terms
 * are also available at    
 * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
 *
 -->
<refentry version="5.0-subset Scilab" xml:id="object_editor" xml:lang="en"
          xmlns="http://docbook.org/ns/docbook"
          xmlns:xlink="http://www.w3.org/1999/xlink"
          xmlns:svg="http://www.w3.org/2000/svg"
          xmlns:ns5="http://www.w3.org/1999/xhtml"
          xmlns:mml="http://www.w3.org/1998/Math/MathML"
          xmlns:db="http://docbook.org/ns/docbook">
  <info>
    <pubdate>$LastChangedDate$</pubdate>
  </info>

  <refnamediv>
    <refname>object_editor</refname>

    <refpurpose>Descrio das capacidades do editor de objetos
    grficos</refpurpose>
  </refnamediv>

  <refnamediv xml:id="graphic">
    <refname>graphic</refname>

    <refpurpose>Descrio das capacidades do editor de objetos
    grficos</refpurpose>
  </refnamediv>

  <refnamediv xml:id="menus">
    <refname>menus</refname>

    <refpurpose>Descrio das capacidades do editor de objetos
    grficos</refpurpose>
  </refnamediv>

  <refsection>
    <title>Descrio</title>

    <para>Os grficos do Scilab permitem que o usurio interaja com os
    grficos antes e depois de t-los desenhado. Cada janela grfica e seus
    contedos so representados por entidades hierrquicas. O topo da
    hierarquia  a figura (entidade Figure). Cada figura define pelo menos uma
    entidade galho do tipo Axes (eixos). Cada entidade Axes contm entidades
    folhas que so objetos grficos bsicos como, Rectangles, Arcs, Segs,...
    (retngulos, arcos, segmentos). Tambm contm o tipo Compound que so
    conjuntos recursivos de entidades.</para>

    <para>O principal interesse do novo modo grfico  tornar mudanas de
    propriedades mais fceis. Este novo modo de grficos fornece um conjunto
    de rotinas grficas de alto-nvel (ver <link linkend="set">set</link>,
    <link linkend="get">get</link>) utilizadas para controlar propriedades dos
    objetos tais como dados, coordenadas e escalas, cores e aparncias sem que
    seja necessrio entrar com os comandos grficos iniciais novamente.</para>

    <para>Entidades grficas so associadas a variveis Scilab do tipo
    <literal>handle</literal>. a qual chamaremos manipulador. Um manipulador 
    um identificador nico que  associado a cada instncia de uma entidade
    grfica criada. Utilizando manipuladores,  possvel alcanar propriedades
    de entidade atravs das rotinas "set" e "get" . Os manipuladores tambm
    so utilizados para manipular objetos grficos, para mov-los, para fazer
    copi-los ou delet-los.</para>

    <para>Para completar e utilizar a capacidade de um manipulador grfico ao
    seu mximo, um editor de objetos grficos tambm foi criado.  um conjunto
    de interfaces Tcl/Tk disponveis para cada tipo de objeto grfico (ver
    <link linkend="graphics_entities">graphics_entities</link> para mais
    detalhes) que pode ser habilitado para cada janela de grficos. Para
    faz-lo funcionar, selecione o menu <literal>Edit</literal> na janela de
    grficos. Sete operaes de edio grfica esto disponveis:</para>

    <para></para>

    <variablelist>
      <varlistentry>
        <term>Select figure as current:</term>

        <listitem>
          <para>permite que uma figura seja a corrente.</para>

          <para></para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Redraw figure:</term>

        <listitem>
          <para> redesenha o contedo da janela de grficos</para>

          <para></para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Erase figure:</term>

        <listitem>
          <para>apaga o contedo da janela de grficos. Sua ao corresponde a
          um comando <literal>clf</literal>.</para>

          <para></para>

          <para></para>

          <para>Os ltimos oito itens so especialmente dedicados ao editor
          grfico:</para>

          <para></para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Copy object:</term>

        <listitem>
          <para>utilizando o mouse, permite que o usurio selecione um objeto
          2d (como uma curva, um retngulo...) e coloque na rea de
          transferncia. Logo, por uma nova chamada a <literal>Paste
          object</literal>, (colar objeto), o objeto  copiado nos eixos
          correntes selecionados.</para>

          <para></para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Paste object:</term>

        <listitem>
          <para>permite que o usurio cole um objeto anterior posto na rea de
          transferncia nos eixos correntes selecionados.</para>

          <para></para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Move object:</term>

        <listitem>
          <para>utilizando o mouse, permite que o usurio mova um objeto 2d
          (como uma curva, um retngulo...) dentro dos eixos correntes
          selecionados.</para>

          <para></para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Delete object:</term>

        <listitem>
          <para>utilizando o mouse, permite que o usurio selecione um objeto
          2d(como uma curva, um retngulo...) dentro dos eixos correntes
          selecionados e delete-o instantaneamente.</para>

          <para></para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Figure Properties:</term>

        <listitem>
          <para>lana a interface Tcl/Tk para o objeto Figure aplicado ao
          manipulador da figura da janela de grficos.</para>

          <para></para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Current Axes Properties:</term>

        <listitem>
          <para>lana a interface Tcl/Tk para o objeto Axes aplicado ao
          manipulador dos eixos correntes da janela de grficos.</para>

          <para></para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Start Entity Picker:</term>

        <listitem>
          <para>inicia um manipulador de eventos na janela de grficos para
          pegar os cliques do mouse sobre objetos grficos e lana a interface
          Tcl/Tk correspondente. O clique com boto esquerdo do mouse permite
          edio de objetos e com boto direito realiza um movimento do objeto
          selecionado. Note que, por ora, este recurso s se aplica a objetos
          2d.</para>

          <para></para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>Stop Entity Picker:</term>

        <listitem>
          <para>para a ao de Entity Picker terminando o manipulador de
          eventos na janela de grficos.</para>

          <para></para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para>Uma vez que a interface grfica  habilitada (utilizando as opes
    <literal>Figure Properties</literal> ou <literal>Current Axes
    Properties</literal>), duas reas principais aparecem:</para>

    <para></para>

    <para></para>

    <variablelist>
      <varlistentry>
        <term>Um tree selector (seletor de rvore):</term>

        <listitem>
          <para>posicionado  direita do editor grfico, um seletor de rvores
          hierrquicas especifica que objeto  correntemente editado . Pode
          ser usado para alternar de um objeto grfico para outro fornecido
          estando eles na mesma janela de grficos.</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para><inlinemediaobject>
        <imageobject>
          <imagedata fileref="../images/tree.gif"></imagedata>
        </imageobject>
      </inlinemediaobject></para>

    <para></para>

    <variablelist>
      <varlistentry>
        <term>Um notebook (caderno):</term>

        <listitem>
          <para>a segunda rea representa um caderno composto de diferentes
          pginas de propriedades (como <literal>Style</literal>,
          <literal>Data</literal>, <literal>Clipping</literal>...) dependendo
          do objeto grfico selecionado. Utilizando-se este editor, pode-se
          editar mais facilmente todo o conjunto de propriedade grficas de
          cada objeto grfico (como atravs dos comandos
          <literal>"set"</literal> e <literal>"get"</literal>). Aqui est um
          exemplo de um caderno para a entidade Axes exibindo as suas
          propriedades:</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para><inlinemediaobject>
        <imageobject>
          <imagedata fileref="../images/notebook.gif"></imagedata>
        </imageobject>
      </inlinemediaobject></para>

    <para></para>

    <para>Furthermore, voc poder colocar legendas/anotaes em sua figura
    utilizando primitivas de amostra fornecidas no menu
    <literal>Insert</literal> na janela grfica. Utilizando o mouse e seguindo
    as instrues na subjanela de mensagem, voc poder acrescentar:</para>

    <para></para>

    <variablelist>
      <varlistentry>
        <term>Line:</term>

        <listitem>
          <para>Desenhe uma linha entre dois cliques do mouse. A linha vive
          nos eixos onde o primeiro ponto foi selecionado.</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para></para>

    <variablelist>
      <varlistentry>
        <term>Polyline:</term>

        <listitem>
          <para>Desenhe uma poligonal clicando no boto esquerdo para definir
          o caminho da linha e clique no boto direito para completar o
          desenho. A poligonal vive nos eixos onde o primeiro ponto foi
          selecionado.</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para></para>

    <variablelist>
      <varlistentry>
        <term>Arrow:</term>

        <listitem>
          <para>Desenhe uma seta entre dois cliques do mouse. A seta vive nos
          eixos onde o primeiro ponto foi selecionado.</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para></para>

    <variablelist>
      <varlistentry>
        <term>Double arrow:</term>

        <listitem>
          <para>Desenhe uma seta dupla entre dois cliques do mouse. A seta
          dupla vive nos eixos onde o primeiro ponto foi selecionado.</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para></para>

    <variablelist>
      <varlistentry>
        <term>Text:</term>

        <listitem>
          <para>Abra uma caixa de dilogo para inserir o texto, ento clique
          na janela da figura para posicion-lo. O texto vive nos eixos onde o
          primeiro ponto foi selecionado.</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para></para>

    <variablelist>
      <varlistentry>
        <term>Rectangle:</term>

        <listitem>
          <para>Desenhe um retngulo: dois cliques com o boto direito definem
          os cantos superior esquerdo e inferior direito do retngulo. O
          retngulo vive nos eixos onde o primeiro ponto foi
          selecionado.</para>
        </listitem>
      </varlistentry>
    </variablelist>

    <para></para>

    <variablelist>
      <varlistentry>
        <term>Circle:</term>

        <listitem>
          <para>Desenhe um crculo: 2dois cliques com o boto direito definem
          os cantos superior esquerdo e inferior direito da caixa em que o
          crculo vive. O retngulo vive nos eixos onde o primeiro ponto foi
          selecionado.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsection>

  <refsection>
    <title>Ver Tambm</title>

    <simplelist type="inline">
      <member><link
      linkend="graphics_entities">graphics_entities</link></member>

      <member><link linkend="set">set</link></member>

      <member><link linkend="get">get</link></member>

      <member><link linkend="clf">clf</link></member>

      <member><link linkend="plot">plot</link></member>
    </simplelist>
  </refsection>

  <refsection>
    <title>Autor</title>

    <para>F.Leray INRIA</para>
  </refsection>
</refentry>