* Bug 15359 fixed: twinkle(h) could not blink several objects together
[scilab.git] / scilab / modules / graphics / help / ru_RU / 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:mml="http://www.w3.org/1998/Math/MathML"
18         xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
19         xml:lang="ru" xml:id="twinkle">
20     <refnamediv>
21         <refname>twinkle</refname>
22         <refpurpose>выделяет один или несколько графических объектов путем их мерцания</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>Синтаксис</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>Аргументы</title>
35         <variablelist>
36             <varlistentry>
37                 <term>h</term>
38                 <listitem>
39                     <para>указатель на графический объект. По умолчанию рассматривается текущий
40                        графический объект, управляемый с помощью <literal>gce()</literal>.
41                     </para>
42                 </listitem>
43             </varlistentry>
44             <varlistentry>
45                 <term>n</term>
46                 <listitem>
47                     <para>количество мерцаний. По умолчанию n = 5</para>
48                 </listitem>
49             </varlistentry>
50         </variablelist>
51     </refsection>
52     <refsection role="description">
53         <title>Описание</title>
54         <para>
55             <function>twinkle</function> заставляет графические объекты, управляемые с помощью
56             <varname>h</varname>, мерцать <varname>n</varname> раз. Если некоторые из объектов изначально
57             невидимы, то они мерцают с другими объектами и окончательно остаются невидимыми перед
58             возвратом.
59         </para>
60         <para>
61             Если <function>twinkle()</function> запущена тогда, когда нет ни одного графического окна,
62             то она ничего не делает. Если дескриптор <varname>h</varname> имеет некоторые
63             некорректные компоненты (объекты были в это время удалены), то <function>twinkle(h..)</function>
64             возвращает ошибку.
65         </para>
66     </refsection>
67     <refsection role="examples">
68         <title>Примеры</title>
69         <programlisting role="example"><![CDATA[
70 clf
71 plot()
72 twinkle     // мерцает последняя группа кривых, построенных в примере plot()
73 twinkle(3)  // мерцает только три раза
74
75 x = linspace(-2*%pi,2*%pi,100)';
76 plot2d(x,[sin(x),cos(x)]);
77 e = gce();
78 p1 = e.children(1);
79 p2 = e.children(2);
80 twinkle(p1)     // мерцает график косинуса
81 twinkle(p2,10)  // график синуса мерцает 10 раз
82 twinkle(gca())  // мерцают оси
83  ]]></programlisting>
84     <para/>
85         <programlisting role="example"><![CDATA[
86 // Мерцание подгруппы многих кривых с некоторыми изначально невидимими
87 clf
88 plot()
89 c = gca().children.children(1:10);
90 c(1:5).visible = "off";
91 sleep(5,'s')
92 twinkle(c)
93  ]]></programlisting>
94     </refsection>
95     <refsection role="see also">
96         <title>Смотрите также</title>
97         <simplelist type="inline">
98             <member>
99                 <link linkend="graphics_entities">графические объекты</link>
100             </member>
101         </simplelist>
102     </refsection>
103     <refsection role="history">
104         <title>История</title>
105         <revhistory>
106             <revision>
107                 <revnumber>6.0</revnumber>
108                 <revdescription>
109                     <para>Добавлены twinkle() и twinkle(n).</para>
110                 </revdescription>
111             </revision>
112             <revision>
113                 <revnumber>6.1</revnumber>
114                 <revdescription>
115                     <para>Теперь несколько независимых объектов могут мерцать вместе.</para>
116                 </revdescription>
117             </revision>
118         </revhistory>
119     </refsection>
120 </refentry>