scilab/modules/graphics/help/pt_BR/set_posfig_dim.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!--
   3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
   4  * Copyright (C) INRIA - Serge Steer
   5  *
   6  * This file must be used under the terms of the CeCILL.
   7  * This source file is licensed as described in the file COPYING, which
   8  * you should have received as part of this distribution.  The terms
   9  * are also available at
  10  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
  11  *
  12  -->
  13 <refentry version="5.0-subset Scilab" xml:id="set_posfig_dim" xml:lang="en"
  14           xmlns="http://docbook.org/ns/docbook"
  15           xmlns:xlink="http://www.w3.org/1999/xlink"
  16           xmlns:svg="http://www.w3.org/2000/svg"
  17           xmlns:ns3="http://www.w3.org/1999/xhtml"
  18           xmlns:mml="http://www.w3.org/1998/Math/MathML"
  19           xmlns:db="http://docbook.org/ns/docbook">
  20   <info>
  21     <pubdate>$LastChangedDate$</pubdate>
  22   </info>
  23
  24   <refnamediv>
  25     <refname>set_posfig_dim</refname>
  26
  27     <refpurpose>Muda a transformação padrão para exportação em
  28     postcript</refpurpose>
  29   </refnamediv>
  30
  31   <refsynopsisdiv>
  32     <title>Seqüência de Chamamento</title>
  33
  34     <synopsis>set_posfig_dim(w,h)
  35 set_posfig_dim(0,0)</synopsis>
  36   </refsynopsisdiv>
  37
  38   <refsection>
  39     <title>Parâmetros</title>
  40
  41     <variablelist>
  42       <varlistentry>
  43         <term>w</term>
  44
  45         <listitem>
  46           <para>largura da figura gráfica, número de pixeis </para>
  47         </listitem>
  48       </varlistentry>
  49
  50       <varlistentry>
  51         <term>h</term>
  52
  53         <listitem>
  54           <para>altura da figura gráfica, número de pixeis</para>
  55         </listitem>
  56       </varlistentry>
  57     </variablelist>
  58   </refsection>
  59
  60   <refsection>
  61     <title>Descrição</title>
  62
  63     <para><literal>set_posfig_dim(w,h)</literal> ajusta a transformação de
  64     coordenadas a ser utlizada ao se exportar uma janela de gráficos em
  65     postscript. A figura gráfica é ampliada ou diminuida nas razões
  66     <literal>w/&lt;largura da figura gráfica&gt;</literal> horizontalmente e
  67     <literal>h/&lt;altura da figura gráfica&gt;</literal>
  68     verticalmente.</para>
  69
  70     <para>Esta função é particularmente útil quando se quer exportar uma
  71     figura gráfica exatamente como ela é exibida na tela. Para isto
  72     <literal>w</literal> e <literal>h</literal> devem ser respectivamente
  73     ajustados para <literal>&lt;largura da figura gráfica&gt;</literal> e
  74     <literal>&lt;altura da figura gráfica&gt;</literal></para>
  75
  76     <para><literal>set_posfig_dim(0,0)</literal> reajusta os valores padrões:
  77     <literal>w=600</literal>, <literal>h=424</literal>.</para>
  78
  79     <para>A função <literal>set_posfig_dim</literal> está obsoleta e será
  80     permanentemente removida no Scilab 5.2. Na versão corrente, set_posfig_dim
  81     não tem influência sobre arquivos exportados. Suas larguras e alturas
  82     devem, ao invés, corresponderem à propriedade <literal>axes_size</literal>
  83     da figura exportada.</para>
  84   </refsection>
  85
  86   <refsection>
  87     <title>Exemplos</title>
  88
  89     <programlisting role="example"><![CDATA[
  90 // criando uma figura com um formato específico
  91 f=scf(0);f.figure_size=[800,300];
  92 plot2d();
  93 set_posfig_dim(f.figure_size(1),f.figure_size(2));
  94 filename='foo.ps';
  95 xs2ps(0,filename);
  96  ]]></programlisting>
  97   </refsection>
  98
  99   <refsection>
 100     <title>Ver Também</title>
 101
 102     <simplelist type="inline">
 103       <member><link linkend="xs2ps">xs2ps</link></member>
 104     </simplelist>
 105   </refsection>
 106
 107   <refsection>
 108     <title>Autor</title>
 109
 110     <para>Serge Steer INRIA</para>
 111   </refsection>
 112 </refentry>