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>