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