* Bug 15359 fixed: twinkle(h) could not blink several objects together
[scilab.git] / scilab / modules / graphics / help / pt_BR / interaction / twinkle.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
5  * Copyright (C) 2012 - 2016 - Scilab Enterprises
6  * Copyright (C) 2015, 2016, 2018 - Samuel GOUGEON
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:ns4="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="twinkle" xml:lang="pt">
20     <refnamediv>
21         <refname>twinkle</refname>
22         <refpurpose>Faz uma entidade gráfica piscar</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>Seqüência de Chamamento</title>
26         <synopsis>
27             twinkle
28             twinkle(n)
29             twinkle(h)
30             twinkle(h,n)
31         </synopsis>
32     </refsynopsisdiv>
33     <refsection role="arguments">
34         <title>Parâmetros</title>
35         <variablelist>
36             <varlistentry>
37                 <term>h</term>
38                 <listitem>
39                     <para>
40                     identificador ou vetor de identificadores de uma ou várias entidades gráficas
41                     para piscar. Por padrão, a entidade gráfica atual apontada por
42                     <literal>gce()</literal> é considerada.
43                     </para>
44                 </listitem>
45             </varlistentry>
46             <varlistentry>
47                 <term>n</term>
48                 <listitem>
49                     <para>número de flashes. Por padrão, n = 5</para>
50                 </listitem>
51             </varlistentry>
52         </variablelist>
53     </refsection>
54     <refsection role="description">
55         <title>Descrição</title>
56         <para>
57             <function>twinkle</function> pisca <varname>n</varname> times objects
58             gráficos cujos identificadores são especificados em <varname>h</varname>.
59             Se alguns dos objetos são inicialmente invisíveis, eles piscam com o
60             outros, tornam-se invisíveis novamente após o relâmpago.
61         </para>
62         <para>
63             If <function>twinkle()</function> is run while no graphical figure exists,
64             it does nothing and returns. If the handle <varname>h</varname> has some invalid
65             components (the entity has been deleted in the meantime),
66             <function>twinkle(h..)</function> yields an error.
67         </para>
68     </refsection>
69     <refsection role="examples">
70         <title>Exemplos</title>
71         <programlisting role="example"><![CDATA[
72 clf
73 plot()
74 twinkle     // twinkles the last group of curves plotted in the plot() example
75 twinkle(3)  // twinkles it only three times
76
77 clf
78 x = linspace(-2*%pi,2*%pi,100)';
79 plot2d(x,[sin(x),cos(x)]);
80 e = gce();
81 p1 = e.children(1);
82 p2 = e.children(2);
83 twinkle(p1)     // fazendo piscar o esboço de cos
84 twinkle(p2,10)  // fazendo piscar o esboço de sin piscar
85 twinkle(gca())  // eixos piscando
86  ]]></programlisting>
87     <para/>
88         <programlisting role="example"><![CDATA[
89 // Blinking a subset of many curves, with some initially invisible ones
90 clf
91 plot()
92 c = gca().children.children(1:10);
93 c(1:5).visible = "off";
94 sleep(5,'s')
95 twinkle(c)
96  ]]></programlisting>
97     </refsection>
98     <refsection role="see also">
99         <title>Ver Também</title>
100         <simplelist type="inline">
101             <member>
102                 <link linkend="graphics_entities">graphics_entities</link>
103             </member>
104         </simplelist>
105     </refsection>
106     <refsection role="history">
107         <title>Histórico</title>
108         <revhistory>
109             <revision>
110                 <revnumber>6.0</revnumber>
111                 <revdescription>
112                     <para>twinkle() and twinkle(n) added.</para>
113                 </revdescription>
114             </revision>
115             <revision>
116                 <revnumber>6.1</revnumber>
117                 <revdescription>
118                     <para>Several independent objects can now be blinked together.</para>
119                 </revdescription>
120             </revision>
121         </revhistory>
122     </refsection>
123 </refentry>