[doc] misc. fix & improvements
[scilab.git] / scilab / modules / graphics / help / pt_BR / object_editor.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) INRIA - Fabrice Leray
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
18           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
19           xmlns:scilab="http://www.scilab.org" xml:id="object_editor" xml:lang="pt">
20     <refnamediv>
21         <refname>object_editor</refname>
22         <refpurpose>Descrição das capacidades do editor de objetos
23             gráficos
24         </refpurpose>
25     </refnamediv>
26     <refnamediv xml:id="graphic">
27         <refname>graphic</refname>
28         <refpurpose>Descrição das capacidades do editor de objetos
29             gráficos
30         </refpurpose>
31     </refnamediv>
32     <refnamediv xml:id="menus">
33         <refname>menus</refname>
34         <refpurpose>Descrição das capacidades do editor de objetos
35             gráficos
36         </refpurpose>
37     </refnamediv>
38     <refsection>
39         <title>Descrição</title>
40         <para>Os gráficos do Scilab permitem que o usuário interaja com os
41             gráficos antes e depois de tê-los desenhado. Cada janela gráfica e seus
42             conteúdos são representados por entidades hierárquicas. O topo da
43             hierarquia é a figura (entidade Figure). Cada figura define pelo menos uma
44             entidade galho do tipo Axes (eixos). Cada entidade Axes contém entidades
45             folhas que são objetos gráficos básicos como, Rectangles, Arcs, Segs,...
46             (retângulos, arcos, segmentos). Também contém o tipo Compound que são
47             conjuntos recursivos de entidades.
48         </para>
49         <para>O principal interesse do novo modo gráfico é tornar mudanças de
50             propriedades mais fáceis. Este novo modo de gráficos fornece um conjunto
51             de rotinas gráficas de alto-nível (ver <link linkend="set">set</link>,
52             <link linkend="get">get</link>) utilizadas para controlar propriedades dos
53             objetos tais como dados, coordenadas e escalas, cores e aparências sem que
54             seja necessário entrar com os comandos gráficos iniciais novamente.
55         </para>
56         <para>Entidades gráficas são associadas a variáveis Scilab do tipo
57             <literal>handle</literal>. a qual chamaremos manipulador. Um manipulador é
58             um identificador único que é associado a cada instância de uma entidade
59             gráfica criada. Utilizando manipuladores, é possível alcançar propriedades
60             de entidade através das rotinas "set" e "get" . Os manipuladores também
61             são utilizados para manipular objetos gráficos, para movê-los, para fazer
62             copiá-los ou deletá-los.
63         </para>
64         <para>Para completar e utilizar a capacidade de um manipulador gráfico ao
65             seu máximo, um editor de objetos gráficos também foi criado. É um conjunto
66             de interfaces Tcl/Tk disponíveis para cada tipo de objeto gráfico (ver
67             <link linkend="graphics_entities">graphics_entities</link> para mais
68             detalhes) que pode ser habilitado para cada janela de gráficos. Para
69             fazê-lo funcionar, selecione o menu <literal>Edit</literal> na janela de
70             gráficos. Sete operações de edição gráfica estão disponíveis:
71         </para>
72         <para/>
73         <variablelist>
74             <varlistentry>
75                 <term>Select figure as current:</term>
76                 <listitem>
77                     <para>permite que uma figura seja a corrente.</para>
78                     <para/>
79                 </listitem>
80             </varlistentry>
81             <varlistentry>
82                 <term>Redraw figure:</term>
83                 <listitem>
84                     <para> redesenha o conteúdo da janela de gráficos</para>
85                     <para/>
86                 </listitem>
87             </varlistentry>
88             <varlistentry>
89                 <term>Erase figure:</term>
90                 <listitem>
91                     <para>apaga o conteúdo da janela de gráficos. Sua ação corresponde a
92                         um comando <literal>clf</literal>.
93                     </para>
94                     <para/>
95                     <para/>
96                     <para>Os últimos oito itens são especialmente dedicados ao editor
97                         gráfico:
98                     </para>
99                     <para/>
100                 </listitem>
101             </varlistentry>
102             <varlistentry>
103                 <term>Copy object:</term>
104                 <listitem>
105                     <para>utilizando o mouse, permite que o usuário selecione um objeto
106                         2d (como uma curva, um retângulo...) e coloque na área de
107                         transferência. Logo, por uma nova chamada a <literal>Paste
108                             object
109                         </literal>
110                         ,(colar objeto), o objeto é copiado nos eixos
111                         correntes selecionados.
112                     </para>
113                     <para/>
114                 </listitem>
115             </varlistentry>
116             <varlistentry>
117                 <term>Paste object:</term>
118                 <listitem>
119                     <para>permite que o usuário cole um objeto anterior posto na àrea de
120                         transferência nos eixos correntes selecionados.
121                     </para>
122                     <para/>
123                 </listitem>
124             </varlistentry>
125             <varlistentry>
126                 <term>Move object:</term>
127                 <listitem>
128                     <para>utilizando o mouse, permite que o usuário mova um objeto 2d
129                         (como uma curva, um retângulo...) dentro dos eixos correntes
130                         selecionados.
131                     </para>
132                     <para/>
133                 </listitem>
134             </varlistentry>
135             <varlistentry>
136                 <term>Delete object:</term>
137                 <listitem>
138                     <para>utilizando o mouse, permite que o usuário selecione um objeto
139                         2d(como uma curva, um retângulo...) dentro dos eixos correntes
140                         selecionados e delete-o instantaneamente.
141                     </para>
142                     <para/>
143                 </listitem>
144             </varlistentry>
145             <varlistentry>
146                 <term>Figure Properties:</term>
147                 <listitem>
148                     <para>lança a interface Tcl/Tk para o objeto Figure aplicado ao
149                         manipulador da figura da janela de gráficos.
150                     </para>
151                     <para/>
152                 </listitem>
153             </varlistentry>
154             <varlistentry>
155                 <term>Current Axes Properties:</term>
156                 <listitem>
157                     <para>lança a interface Tcl/Tk para o objeto Axes aplicado ao
158                         manipulador dos eixos correntes da janela de gráficos.
159                     </para>
160                     <para/>
161                 </listitem>
162             </varlistentry>
163             <varlistentry>
164                 <term>Start Entity Picker:</term>
165                 <listitem>
166                     <para>inicia um manipulador de eventos na janela de gráficos para
167                         pegar os cliques do mouse sobre objetos gráficos e lança a interface
168                         Tcl/Tk correspondente. O clique com botão esquerdo do mouse permite
169                         edição de objetos e com botão direito realiza um movimento do objeto
170                         selecionado. Note que, por ora, este recurso só se aplica a objetos
171                         2d.
172                     </para>
173                     <para/>
174                 </listitem>
175             </varlistentry>
176             <varlistentry>
177                 <term>Stop Entity Picker:</term>
178                 <listitem>
179                     <para>para a ação de Entity Picker terminando o manipulador de
180                         eventos na janela de gráficos.
181                     </para>
182                     <para/>
183                 </listitem>
184             </varlistentry>
185         </variablelist>
186         <para>Uma vez que a interface gráfica é habilitada (utilizando as opções
187             <literal>Figure Properties</literal> ou <literal>Current Axes
188                 Properties
189             </literal>
190             ), duas áreas principais aparecem:
191         </para>
192         <para/>
193         <para/>
194         <variablelist>
195             <varlistentry>
196                 <term>Um tree selector (seletor de árvore):</term>
197                 <listitem>
198                     <para>posicionado à direita do editor gráfico, um seletor de árvores
199                         hierárquicas especifica que objeto é correntemente editado . Pode
200                         ser usado para alternar de um objeto gráfico para outro fornecido
201                         estando eles na mesma janela de gráficos.
202                     </para>
203                 </listitem>
204             </varlistentry>
205         </variablelist>
206         <para>
207             <inlinemediaobject>
208                 <imageobject>
209                     <imagedata fileref="../images/tree.gif"/>
210                 </imageobject>
211             </inlinemediaobject>
212         </para>
213         <para/>
214         <variablelist>
215             <varlistentry>
216                 <term>Um notebook (caderno):</term>
217                 <listitem>
218                     <para>a segunda área representa um caderno composto de diferentes
219                         páginas de propriedades (como <literal>Style</literal>,
220                         <literal>Data</literal>, <literal>Clipping</literal>...) dependendo
221                         do objeto gráfico selecionado. Utilizando-se este editor, pode-se
222                         editar mais facilmente todo o conjunto de propriedade gráficas de
223                         cada objeto gráfico (como através dos comandos
224                         <literal>"set"</literal> e <literal>"get"</literal>). Aqui está um
225                         exemplo de um caderno para a entidade Axes exibindo as suas
226                         propriedades:
227                     </para>
228                 </listitem>
229             </varlistentry>
230         </variablelist>
231         <para>
232             <inlinemediaobject>
233                 <imageobject>
234                     <imagedata fileref="../images/notebook.gif"/>
235                 </imageobject>
236             </inlinemediaobject>
237         </para>
238         <para/>
239         <para>Furthermore, você poderá colocar legendas/anotações em sua figura
240             utilizando primitivas de amostra fornecidas no menu
241             <literal>Insert</literal> na janela gráfica. Utilizando o mouse e seguindo
242             as instruções na subjanela de mensagem, você poderá acrescentar:
243         </para>
244         <para/>
245         <variablelist>
246             <varlistentry>
247                 <term>Line:</term>
248                 <listitem>
249                     <para>Desenhe uma linha entre dois cliques do mouse. A linha vive
250                         nos eixos onde o primeiro ponto foi selecionado.
251                     </para>
252                 </listitem>
253             </varlistentry>
254         </variablelist>
255         <para/>
256         <variablelist>
257             <varlistentry>
258                 <term>Polyline:</term>
259                 <listitem>
260                     <para>Desenhe uma poligonal clicando no botão esquerdo para definir
261                         o caminho da linha e clique no botão direito para completar o
262                         desenho. A poligonal vive nos eixos onde o primeiro ponto foi
263                         selecionado.
264                     </para>
265                 </listitem>
266             </varlistentry>
267         </variablelist>
268         <para/>
269         <variablelist>
270             <varlistentry>
271                 <term>Arrow:</term>
272                 <listitem>
273                     <para>Desenhe uma seta entre dois cliques do mouse. A seta vive nos
274                         eixos onde o primeiro ponto foi selecionado.
275                     </para>
276                 </listitem>
277             </varlistentry>
278         </variablelist>
279         <para/>
280         <variablelist>
281             <varlistentry>
282                 <term>Double arrow:</term>
283                 <listitem>
284                     <para>Desenhe uma seta dupla entre dois cliques do mouse. A seta
285                         dupla vive nos eixos onde o primeiro ponto foi selecionado.
286                     </para>
287                 </listitem>
288             </varlistentry>
289         </variablelist>
290         <para/>
291         <variablelist>
292             <varlistentry>
293                 <term>Text:</term>
294                 <listitem>
295                     <para>Abra uma caixa de diálogo para inserir o texto, então clique
296                         na janela da figura para posicioná-lo. O texto vive nos eixos onde o
297                         primeiro ponto foi selecionado.
298                     </para>
299                 </listitem>
300             </varlistentry>
301         </variablelist>
302         <para/>
303         <variablelist>
304             <varlistentry>
305                 <term>Rectangle:</term>
306                 <listitem>
307                     <para>Desenhe um retângulo: dois cliques com o botão direito definem
308                         os cantos superior esquerdo e inferior direito do retângulo. O
309                         retângulo vive nos eixos onde o primeiro ponto foi
310                         selecionado.
311                     </para>
312                 </listitem>
313             </varlistentry>
314         </variablelist>
315         <para/>
316         <variablelist>
317             <varlistentry>
318                 <term>Circle:</term>
319                 <listitem>
320                     <para>Desenhe um círculo: 2dois cliques com o botão direito definem
321                         os cantos superior esquerdo e inferior direito da caixa em que o
322                         círculo vive. O retângulo vive nos eixos onde o primeiro ponto foi
323                         selecionado.
324                     </para>
325                 </listitem>
326             </varlistentry>
327         </variablelist>
328     </refsection>
329     <refsection role="see also">
330         <title>Ver Também</title>
331         <simplelist type="inline">
332             <member>
333                 <link linkend="ieditor">ieditor</link>
334             </member>
335             <member>
336                 <link linkend="ged">ged</link>
337             </member>
338             <member>
339                 <link linkend="graphics_entities">graphics_entities</link>
340             </member>
341             <member>
342                 <link linkend="set">set</link>
343             </member>
344             <member>
345                 <link linkend="get">get</link>
346             </member>
347             <member>
348                 <link linkend="plot">plot</link>
349             </member>
350         </simplelist>
351     </refsection>
352 </refentry>