13
13
<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" version="5.0-subset Scilab" xml:id="object_editor" xml:lang="en">
15
<refname>object_editor</refname>
16
<refpurpose>Descri��o das capacidades do editor de objetos
20
<refnamediv xml:id="graphic">
21
<refname>graphic</refname>
22
<refpurpose>Descri��o das capacidades do editor de objetos
26
<refnamediv xml:id="menus">
27
<refname>menus</refname>
28
<refpurpose>Descri��o das capacidades do editor de objetos
33
<title>Descri��o</title>
34
<para>Os gr�ficos do Scilab permitem que o usu�rio interaja com os
35
gr�ficos antes e depois de t�-los desenhado. Cada janela gr�fica e seus
36
conte�dos s�o representados por entidades hier�rquicas. O topo da
37
hierarquia � a figura (entidade Figure). Cada figura define pelo menos uma
38
entidade galho do tipo Axes (eixos). Cada entidade Axes cont�m entidades
39
folhas que s�o objetos gr�ficos b�sicos como, Rectangles, Arcs, Segs,...
40
(ret�ngulos, arcos, segmentos). Tamb�m cont�m o tipo Compound que s�o
41
conjuntos recursivos de entidades.
43
<para>O principal interesse do novo modo gr�fico � tornar mudan�as de
44
propriedades mais f�ceis. Este novo modo de gr�ficos fornece um conjunto
45
de rotinas gr�ficas de alto-n�vel (ver <link linkend="set">set</link>,
46
<link linkend="get">get</link>) utilizadas para controlar propriedades dos
47
objetos tais como dados, coordenadas e escalas, cores e apar�ncias sem que
48
seja necess�rio entrar com os comandos gr�ficos iniciais novamente.
50
<para>Entidades gr�ficas s�o associadas a vari�veis Scilab do tipo
51
<literal>handle</literal>. a qual chamaremos manipulador. Um manipulador �
52
um identificador �nico que � associado a cada inst�ncia de uma entidade
53
gr�fica criada. Utilizando manipuladores, � poss�vel alcan�ar propriedades
54
de entidade atrav�s das rotinas "set" e "get" . Os manipuladores tamb�m
55
s�o utilizados para manipular objetos gr�ficos, para mov�-los, para fazer
56
copi�-los ou delet�-los.
58
<para>Para completar e utilizar a capacidade de um manipulador gr�fico ao
59
seu m�ximo, um editor de objetos gr�ficos tamb�m foi criado. � um conjunto
60
de interfaces Tcl/Tk dispon�veis para cada tipo de objeto gr�fico (ver
61
<link linkend="graphics_entities">graphics_entities</link> para mais
62
detalhes) que pode ser habilitado para cada janela de gr�ficos. Para
63
faz�-lo funcionar, selecione o menu <literal>Edit</literal> na janela de
64
gr�ficos. Sete opera��es de edi��o gr�fica est�o dispon�veis:
69
<term>Select figure as current:</term>
71
<para>permite que uma figura seja a corrente.</para>
76
<term>Redraw figure:</term>
78
<para> redesenha o conte�do da janela de gr�ficos</para>
83
<term>Erase figure:</term>
85
<para>apaga o conte�do da janela de gr�ficos. Sua a��o corresponde a
86
um comando <literal>clf</literal>.
90
<para>Os �ltimos oito itens s�o especialmente dedicados ao editor
97
<term>Copy object:</term>
99
<para>utilizando o mouse, permite que o usu�rio selecione um objeto
100
2d (como uma curva, um ret�ngulo...) e coloque na �rea de
101
transfer�ncia. Logo, por uma nova chamada a <literal>Paste
15
<refname>object_editor</refname>
16
<refpurpose>Descri��o das capacidades do editor de objetos
20
<refnamediv xml:id="graphic">
21
<refname>graphic</refname>
22
<refpurpose>Descri��o das capacidades do editor de objetos
26
<refnamediv xml:id="menus">
27
<refname>menus</refname>
28
<refpurpose>Descri��o das capacidades do editor de objetos
33
<title>Descri��o</title>
34
<para>Os gr�ficos do Scilab permitem que o usu�rio interaja com os
35
gr�ficos antes e depois de t�-los desenhado. Cada janela gr�fica e seus
36
conte�dos s�o representados por entidades hier�rquicas. O topo da
37
hierarquia � a figura (entidade Figure). Cada figura define pelo menos uma
38
entidade galho do tipo Axes (eixos). Cada entidade Axes cont�m entidades
39
folhas que s�o objetos gr�ficos b�sicos como, Rectangles, Arcs, Segs,...
40
(ret�ngulos, arcos, segmentos). Tamb�m cont�m o tipo Compound que s�o
41
conjuntos recursivos de entidades.
43
<para>O principal interesse do novo modo gr�fico � tornar mudan�as de
44
propriedades mais f�ceis. Este novo modo de gr�ficos fornece um conjunto
45
de rotinas gr�ficas de alto-n�vel (ver <link linkend="set">set</link>,
46
<link linkend="get">get</link>) utilizadas para controlar propriedades dos
47
objetos tais como dados, coordenadas e escalas, cores e apar�ncias sem que
48
seja necess�rio entrar com os comandos gr�ficos iniciais novamente.
50
<para>Entidades gr�ficas s�o associadas a vari�veis Scilab do tipo
51
<literal>handle</literal>. a qual chamaremos manipulador. Um manipulador �
52
um identificador �nico que � associado a cada inst�ncia de uma entidade
53
gr�fica criada. Utilizando manipuladores, � poss�vel alcan�ar propriedades
54
de entidade atrav�s das rotinas "set" e "get" . Os manipuladores tamb�m
55
s�o utilizados para manipular objetos gr�ficos, para mov�-los, para fazer
56
copi�-los ou delet�-los.
58
<para>Para completar e utilizar a capacidade de um manipulador gr�fico ao
59
seu m�ximo, um editor de objetos gr�ficos tamb�m foi criado. � um conjunto
60
de interfaces Tcl/Tk dispon�veis para cada tipo de objeto gr�fico (ver
61
<link linkend="graphics_entities">graphics_entities</link> para mais
62
detalhes) que pode ser habilitado para cada janela de gr�ficos. Para
63
faz�-lo funcionar, selecione o menu <literal>Edit</literal> na janela de
64
gr�ficos. Sete opera��es de edi��o gr�fica est�o dispon�veis:
69
<term>Select figure as current:</term>
71
<para>permite que uma figura seja a corrente.</para>
76
<term>Redraw figure:</term>
78
<para> redesenha o conte�do da janela de gr�ficos</para>
83
<term>Erase figure:</term>
85
<para>apaga o conte�do da janela de gr�ficos. Sua a��o corresponde a
86
um comando <literal>clf</literal>.
90
<para>Os �ltimos oito itens s�o especialmente dedicados ao editor
97
<term>Copy object:</term>
99
<para>utilizando o mouse, permite que o usu�rio selecione um objeto
100
2d (como uma curva, um ret�ngulo...) e coloque na �rea de
101
transfer�ncia. Logo, por uma nova chamada a <literal>Paste
104
,(colar objeto), o objeto � copiado nos eixos
105
correntes selecionados.
111
<term>Paste object:</term>
113
<para>permite que o usu�rio cole um objeto anterior posto na �rea de
114
transfer�ncia nos eixos correntes selecionados.
120
<term>Move object:</term>
122
<para>utilizando o mouse, permite que o usu�rio mova um objeto 2d
123
(como uma curva, um ret�ngulo...) dentro dos eixos correntes
130
<term>Delete object:</term>
132
<para>utilizando o mouse, permite que o usu�rio selecione um objeto
133
2d(como uma curva, um ret�ngulo...) dentro dos eixos correntes
134
selecionados e delete-o instantaneamente.
140
<term>Figure Properties:</term>
142
<para>lan�a a interface Tcl/Tk para o objeto Figure aplicado ao
143
manipulador da figura da janela de gr�ficos.
149
<term>Current Axes Properties:</term>
151
<para>lan�a a interface Tcl/Tk para o objeto Axes aplicado ao
152
manipulador dos eixos correntes da janela de gr�ficos.
158
<term>Start Entity Picker:</term>
160
<para>inicia um manipulador de eventos na janela de gr�ficos para
161
pegar os cliques do mouse sobre objetos gr�ficos e lan�a a interface
162
Tcl/Tk correspondente. O clique com bot�o esquerdo do mouse permite
163
edi��o de objetos e com bot�o direito realiza um movimento do objeto
164
selecionado. Note que, por ora, este recurso s� se aplica a objetos
171
<term>Stop Entity Picker:</term>
173
<para>para a a��o de Entity Picker terminando o manipulador de
174
eventos na janela de gr�ficos.
180
<para>Uma vez que a interface gr�fica � habilitada (utilizando as op��es
181
<literal>Figure Properties</literal> ou <literal>Current Axes
104
,(colar objeto), o objeto � copiado nos eixos
105
correntes selecionados.
111
<term>Paste object:</term>
113
<para>permite que o usu�rio cole um objeto anterior posto na �rea de
114
transfer�ncia nos eixos correntes selecionados.
120
<term>Move object:</term>
122
<para>utilizando o mouse, permite que o usu�rio mova um objeto 2d
123
(como uma curva, um ret�ngulo...) dentro dos eixos correntes
130
<term>Delete object:</term>
132
<para>utilizando o mouse, permite que o usu�rio selecione um objeto
133
2d(como uma curva, um ret�ngulo...) dentro dos eixos correntes
134
selecionados e delete-o instantaneamente.
140
<term>Figure Properties:</term>
142
<para>lan�a a interface Tcl/Tk para o objeto Figure aplicado ao
143
manipulador da figura da janela de gr�ficos.
149
<term>Current Axes Properties:</term>
151
<para>lan�a a interface Tcl/Tk para o objeto Axes aplicado ao
152
manipulador dos eixos correntes da janela de gr�ficos.
158
<term>Start Entity Picker:</term>
160
<para>inicia um manipulador de eventos na janela de gr�ficos para
161
pegar os cliques do mouse sobre objetos gr�ficos e lan�a a interface
162
Tcl/Tk correspondente. O clique com bot�o esquerdo do mouse permite
163
edi��o de objetos e com bot�o direito realiza um movimento do objeto
164
selecionado. Note que, por ora, este recurso s� se aplica a objetos
171
<term>Stop Entity Picker:</term>
173
<para>para a a��o de Entity Picker terminando o manipulador de
174
eventos na janela de gr�ficos.
180
<para>Uma vez que a interface gr�fica � habilitada (utilizando as op��es
181
<literal>Figure Properties</literal> ou <literal>Current Axes
184
), duas �reas principais aparecem:
190
<term>Um tree selector (seletor de �rvore):</term>
192
<para>posicionado � direita do editor gr�fico, um seletor de �rvores
193
hier�rquicas especifica que objeto � correntemente editado . Pode
194
ser usado para alternar de um objeto gr�fico para outro fornecido
195
estando eles na mesma janela de gr�ficos.
203
<imagedata fileref="../images/tree.gif"/>
210
<term>Um notebook (caderno):</term>
212
<para>a segunda �rea representa um caderno composto de diferentes
213
p�ginas de propriedades (como <literal>Style</literal>,
214
<literal>Data</literal>, <literal>Clipping</literal>...) dependendo
215
do objeto gr�fico selecionado. Utilizando-se este editor, pode-se
216
editar mais facilmente todo o conjunto de propriedade gr�ficas de
217
cada objeto gr�fico (como atrav�s dos comandos
218
<literal>"set"</literal> e <literal>"get"</literal>). Aqui est� um
219
exemplo de um caderno para a entidade Axes exibindo as suas
228
<imagedata fileref="../images/notebook.gif"/>
233
<para>Furthermore, voc� poder� colocar legendas/anota��es em sua figura
234
utilizando primitivas de amostra fornecidas no menu
235
<literal>Insert</literal> na janela gr�fica. Utilizando o mouse e seguindo
236
as instru��es na subjanela de mensagem, voc� poder� acrescentar:
243
<para>Desenhe uma linha entre dois cliques do mouse. A linha vive
244
nos eixos onde o primeiro ponto foi selecionado.
252
<term>Polyline:</term>
254
<para>Desenhe uma poligonal clicando no bot�o esquerdo para definir
255
o caminho da linha e clique no bot�o direito para completar o
256
desenho. A poligonal vive nos eixos onde o primeiro ponto foi
267
<para>Desenhe uma seta entre dois cliques do mouse. A seta vive nos
268
eixos onde o primeiro ponto foi selecionado.
276
<term>Double arrow:</term>
278
<para>Desenhe uma seta dupla entre dois cliques do mouse. A seta
279
dupla vive nos eixos onde o primeiro ponto foi selecionado.
289
<para>Abra uma caixa de di�logo para inserir o texto, ent�o clique
290
na janela da figura para posicion�-lo. O texto vive nos eixos onde o
291
primeiro ponto foi selecionado.
299
<term>Rectangle:</term>
301
<para>Desenhe um ret�ngulo: dois cliques com o bot�o direito definem
302
os cantos superior esquerdo e inferior direito do ret�ngulo. O
303
ret�ngulo vive nos eixos onde o primeiro ponto foi
314
<para>Desenhe um c�rculo: 2dois cliques com o bot�o direito definem
315
os cantos superior esquerdo e inferior direito da caixa em que o
316
c�rculo vive. O ret�ngulo vive nos eixos onde o primeiro ponto foi
323
<refsection role="see also">
324
<title>Ver Tamb�m</title>
325
<simplelist type="inline">
327
<link linkend="graphics_entities">graphics_entities</link>
330
<link linkend="set">set</link>
333
<link linkend="get">get</link>
336
<link linkend="clf">clf</link>
339
<link linkend="plot">plot</link>
184
), duas �reas principais aparecem:
190
<term>Um tree selector (seletor de �rvore):</term>
192
<para>posicionado � direita do editor gr�fico, um seletor de �rvores
193
hier�rquicas especifica que objeto � correntemente editado . Pode
194
ser usado para alternar de um objeto gr�fico para outro fornecido
195
estando eles na mesma janela de gr�ficos.
203
<imagedata fileref="../images/tree.gif"/>
210
<term>Um notebook (caderno):</term>
212
<para>a segunda �rea representa um caderno composto de diferentes
213
p�ginas de propriedades (como <literal>Style</literal>,
214
<literal>Data</literal>, <literal>Clipping</literal>...) dependendo
215
do objeto gr�fico selecionado. Utilizando-se este editor, pode-se
216
editar mais facilmente todo o conjunto de propriedade gr�ficas de
217
cada objeto gr�fico (como atrav�s dos comandos
218
<literal>"set"</literal> e <literal>"get"</literal>). Aqui est� um
219
exemplo de um caderno para a entidade Axes exibindo as suas
228
<imagedata fileref="../images/notebook.gif"/>
233
<para>Furthermore, voc� poder� colocar legendas/anota��es em sua figura
234
utilizando primitivas de amostra fornecidas no menu
235
<literal>Insert</literal> na janela gr�fica. Utilizando o mouse e seguindo
236
as instru��es na subjanela de mensagem, voc� poder� acrescentar:
243
<para>Desenhe uma linha entre dois cliques do mouse. A linha vive
244
nos eixos onde o primeiro ponto foi selecionado.
252
<term>Polyline:</term>
254
<para>Desenhe uma poligonal clicando no bot�o esquerdo para definir
255
o caminho da linha e clique no bot�o direito para completar o
256
desenho. A poligonal vive nos eixos onde o primeiro ponto foi
267
<para>Desenhe uma seta entre dois cliques do mouse. A seta vive nos
268
eixos onde o primeiro ponto foi selecionado.
276
<term>Double arrow:</term>
278
<para>Desenhe uma seta dupla entre dois cliques do mouse. A seta
279
dupla vive nos eixos onde o primeiro ponto foi selecionado.
289
<para>Abra uma caixa de di�logo para inserir o texto, ent�o clique
290
na janela da figura para posicion�-lo. O texto vive nos eixos onde o
291
primeiro ponto foi selecionado.
299
<term>Rectangle:</term>
301
<para>Desenhe um ret�ngulo: dois cliques com o bot�o direito definem
302
os cantos superior esquerdo e inferior direito do ret�ngulo. O
303
ret�ngulo vive nos eixos onde o primeiro ponto foi
314
<para>Desenhe um c�rculo: 2dois cliques com o bot�o direito definem
315
os cantos superior esquerdo e inferior direito da caixa em que o
316
c�rculo vive. O ret�ngulo vive nos eixos onde o primeiro ponto foi
323
<refsection role="see also">
324
<title>Ver Tamb�m</title>
325
<simplelist type="inline">
327
<link linkend="graphics_entities">graphics_entities</link>
330
<link linkend="set">set</link>
333
<link linkend="get">get</link>
336
<link linkend="clf">clf</link>
339
<link linkend="plot">plot</link>