1 <?xml version="1.0" encoding="UTF-8"?>
3 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4 * Copyright (C) INRIA - Fabrice Leray
6 * Copyright (C) 2012 - 2016 - Scilab Enterprises
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.
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">
21 <refname>object_editor</refname>
22 <refpurpose>Descrição das capacidades do editor de objetos
26 <refnamediv xml:id="graphic">
27 <refname>graphic</refname>
28 <refpurpose>Descrição das capacidades do editor de objetos
32 <refnamediv xml:id="menus">
33 <refname>menus</refname>
34 <refpurpose>Descrição das capacidades do editor de objetos
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.
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.
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.
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:
75 <term>Select figure as current:</term>
77 <para>permite que uma figura seja a corrente.</para>
82 <term>Redraw figure:</term>
84 <para> redesenha o conteúdo da janela de gráficos</para>
89 <term>Erase figure:</term>
91 <para>apaga o conteúdo da janela de gráficos. Sua ação corresponde a
92 um comando <literal>clf</literal>.
96 <para>Os últimos oito itens são especialmente dedicados ao editor
103 <term>Copy object:</term>
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
110 ,(colar objeto), o objeto é copiado nos eixos
111 correntes selecionados.
117 <term>Paste object:</term>
119 <para>permite que o usuário cole um objeto anterior posto na àrea de
120 transferência nos eixos correntes selecionados.
126 <term>Move object:</term>
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
136 <term>Delete object:</term>
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.
146 <term>Figure Properties:</term>
148 <para>lança a interface Tcl/Tk para o objeto Figure aplicado ao
149 manipulador da figura da janela de gráficos.
155 <term>Current Axes Properties:</term>
157 <para>lança a interface Tcl/Tk para o objeto Axes aplicado ao
158 manipulador dos eixos correntes da janela de gráficos.
164 <term>Start Entity Picker:</term>
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
177 <term>Stop Entity Picker:</term>
179 <para>para a ação de Entity Picker terminando o manipulador de
180 eventos na janela de gráficos.
186 <para>Uma vez que a interface gráfica é habilitada (utilizando as opções
187 <literal>Figure Properties</literal> ou <literal>Current Axes
190 ), duas áreas principais aparecem:
196 <term>Um tree selector (seletor de árvore):</term>
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.
209 <imagedata fileref="../images/tree.gif"/>
216 <term>Um notebook (caderno):</term>
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
234 <imagedata fileref="../images/notebook.gif"/>
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:
249 <para>Desenhe uma linha entre dois cliques do mouse. A linha vive
250 nos eixos onde o primeiro ponto foi selecionado.
258 <term>Polyline:</term>
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
273 <para>Desenhe uma seta entre dois cliques do mouse. A seta vive nos
274 eixos onde o primeiro ponto foi selecionado.
282 <term>Double arrow:</term>
284 <para>Desenhe uma seta dupla entre dois cliques do mouse. A seta
285 dupla vive nos eixos onde o primeiro ponto foi selecionado.
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.
305 <term>Rectangle:</term>
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
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
329 <refsection role="see also">
330 <title>Ver Também</title>
331 <simplelist type="inline">
333 <link linkend="ieditor">ieditor</link>
336 <link linkend="ged">ged</link>
339 <link linkend="graphics_entities">graphics_entities</link>
342 <link linkend="set">set</link>
345 <link linkend="get">get</link>
348 <link linkend="plot">plot</link>