help: fix minor typos and warnings on Scilab code colorization
[scilab.git] / scilab / modules / graphics / help / ru_RU / axes_operations / isoview.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 - Serge Steer
5  * Copyright (C) 2016, 2018 - Samuel GOUGEON
6  *
7  * Copyright (C) 2012 - 2016 - Scilab Enterprises
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
18           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
19           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
20           xml:lang="ru" xml:id="isoview">
21     <refnamediv>
22         <refname>isoview</refname>
23         <refpurpose>
24           настраивает изометрическое представление графических осей
25         </refpurpose>
26     </refnamediv>
27     <refsynopsisdiv>
28         <title>Синтаксис</title>
29         <synopsis>isoview
30             isoview on
31             isoview off
32             isoview(idGraphics [,"on"|"off"])
33             isoview(xmin, xmax, ymin, ymax)    // НЕ РЕКОМЕНДУЕТСЯ, используйте replot()
34         </synopsis>
35     </refsynopsisdiv>
36     <refsection role="arguments">
37         <title>Аргументы</title>
38         <variablelist>
39             <varlistentry>
40                 <term>"on" | "off" | &lt;none&gt;</term>
41                 <listitem>
42                     Включает или отключает или переключает изометрическое представление для всех
43                     рассматриваемых осей.
44                     <para/>
45                 </listitem>
46             </varlistentry>
47             <varlistentry>
48                 <term>idGraphics</term>
49                 <listitem>
50                     Вектор графических указателей. Обрабатываются все связанные оси.
51                     По умолчанию обрабатываются текущие оси.
52                     <para/>
53                 </listitem>
54             </varlistentry>
55             <varlistentry>
56                 <term>xmin, xmax, ymin, ymax</term>
57                 <listitem>
58                     Четыре десятичных числа: новые пределы осей.
59                     <warning>
60                         Эти параметры будут удалены из Scilab 6.1.
61                         Пожалуйста, вместо этого используйте <link linkend="replot">replot</link>
62                         после <function>isoview</function>.
63                     </warning>
64                     <para/>
65                 </listitem>
66             </varlistentry>
67         </variablelist>
68     </refsection>
69     <refsection role="description">
70         <title>Описание</title>
71         <para>
72             Функция <function>isoview</function> используется для установки или
73             вернуть в исходное состояние масштабы изометрического представления
74             осей x, y (и z), без изменения размера графического окна.
75         </para>
76         <para>
77             <literal>isoview()</literal> или просто <literal>isoview</literal>
78             переключает статус изометрического представления текущих осей, и 
79             сохраняет их текущие пределы: изометрические масштабы устанавливаются
80             всегда, когда они свободны, или масштабы возвращаются в исходное
81             состояние всегда, когда они являются изометрическими.
82         </para>
83         <para>
84             <literal>isoview("on")</literal> или <literal>isoview on</literal>
85             устанавливаются изометрические масштабы для текущих осей.
86         </para>
87         <para>
88             <literal>isoview("off")</literal> или <literal>isoview off</literal>
89             возвращает в исходное состояние масштабы x, y (и z) для текущих осей.
90         </para>
91         <para>
92             <literal>isoview(idGraphics,..)</literal> запускается на осях, связанных
93             с каждым графическим объектом, содержащимся в векторе <varname>idGraphics</varname>:
94             <itemizedlist>
95                 <listitem>
96                     Если <varname>idGraphics(i)</varname> - это указатель на графическое окно,
97                     то рассматриваются все её оси (Axes).
98                 </listitem>
99                 <listitem>
100                     Если <varname>idGraphics(i)</varname> - это оси Axes, то
101                     он рассматривается как есть.
102                 </listitem>
103                 <listitem>
104                     Если <varname>idGraphics(i)</varname> - это указатель на подосевой
105                     компонент (такой как polyline, compound, и т.д.), то рассматриваются
106                     оси, на которых он размещается.
107                 </listitem>
108             </itemizedlist>
109         </para>
110         <para>
111             <literal>isoview(xmin, xmax, ymin, ymax)</literal> устанавливает текущие 
112             оси в изометрический режим,  а затем устанавливает их пределы на указанные значения.
113             <warning>
114                 Это использование не рекомендуется и будет удалено из Scilab 6.1.
115                 Пожалуйста, используйте вместо этого <link linkend="replot">replot</link> 
116                 после <function>isoview</function>.
117             </warning>
118         </para>
119         <note>
120             Графический элемент текущих осей остаётся таким же после вызова <literal>isoview(..)</literal>.
121         </note>
122         <note>
123             Чтобы построить график каких-либо кривых напрямую в изометрическом режиме
124             без вызова <function>isoview</function> после того, как опция <literal>plot2d(...,frameflag=4)</literal>
125             может быть использована в момент вызова.
126         </note>
127         <refsect3>
128             <title>Построение в соответствии с установками .isoview и .cube_scaling</title>
129             <para>
130             <table align="middle">
131                 <tr>
132                     <th>isoview(..)</th><th>gca().isoview</th>
133                                        <th>gca().cube_scaling</th>
134                                        <td><emphasis role="bold">Построение</emphasis></td>
135                 </tr>
136                 <tr>
137                     <th>on</th><td align="center">on</td>
138                                <td align="center">off</td>
139                                <td>X, Y и Z изометрические</td>
140                 </tr>
141                 <tr>
142                     <th>off</th><td align="center">off</td>
143                                 <td align="center">on</td>
144                                 <td>Независимые масштабы по X, Y и Z. В трёхмерном представлении, улучшенные
145                                   отношения высоты и ширины объекта, когда диапазоны X/Y/Z очень разные.</td>
146                 </tr>
147                 <tr>
148                     <th></th><td align="center">off</td>
149                             <td align="center">off</td>
150                             <td>Независимые масштабы по X, Y и Z. В трёхмерном представлении, улучшенные
151                                   отношения высоты и ширины объекта, когда диапазоны X/Y/Z близки к диапазонам данных</td>
152                 </tr>
153                 <tr>
154                     <th></th><td align="center">on</td>
155                              <td align="center">on</td>
156                              <td>Масштабы таковы, что оси выглядят квадратными или кубическими</td>
157                 </tr>
158             </table>
159             </para>
160         </refsect3>
161     </refsection>
162     <refsection role="examples">
163         <title>Примеры</title>
164         <programlisting role="example"><![CDATA[
165 t = [0:0.1:2*%pi]';
166 clf
167 nc = 3;
168 subplot(2,nc,1)
169 plot2d(cos(t),sin(t))
170 xtitle("Истинная окружность")
171 a1 = gca();
172 subplot(2,nc,nc+1)
173 plot2d(cos(t),sin(t))
174 isoview
175 subplot(2,nc,2)
176 plot2d(7*cos(t),2*sin(t))
177 xtitle("Истинный эллипс")
178 a2 = gca();
179 subplot(2,nc,nc+2)
180 plot2d(7*cos(t),2*sin(t))
181 isoview
182 // построение сферы, используя фасеты, вычисленные с помощью eval3dp
183 deff("[x,y,z] = sph(alp,tet)",[
184     "x = r*cos(alp).*cos(tet)+orig(1)*ones(tet)"; ..
185     "y = r*cos(alp).*sin(tet)+orig(2)*ones(tet)"; ..
186     "z = r*sin(alp)+orig(3)*ones(tet)"]);
187 r = 3; orig = [0 0 0];
188 [xx,yy,zz] = eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,40));
189 subplot(2,nc,3)
190 plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
191 zlabel("isoview off", "rotation", -90, "fontsize",4)
192 xtitle("Истинная сфера")
193 a3 = gca();
194 subplot(2,nc,nc+3)
195 plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
196 zlabel("isoview on", "rotation", -90, "fontsize",4)
197 isoview
198 // Переключение статуса isoview для всех осей
199 isoview(gcf())
200 // Установка isoview для всех осей текущего графического окна
201 isoview(gcf(), "on")
202 // Восстановление исходных значений isoview для текущих осей
203 isoview off
204 // Установка isoview для верхних осей
205 isoview(gcf(),"off")
206 isoview([a1 a2 a3], "on")
207              ]]></programlisting>
208         <scilab:image>
209             t = [0:0.1:2*%pi]';
210             clf
211             f = gcf();
212             f.axes_size = [850 400];
213             nc = 3;
214             subplot(2,nc,1)
215             plot2d(cos(t),sin(t))
216             xtitle("True circle")
217             a1 = gca();
218             subplot(2,nc,nc+1)
219             plot2d(cos(t),sin(t))
220             isoview
221             subplot(2,nc,2)
222             plot2d(7*cos(t),2*sin(t))
223             xtitle("True ellipse")
224             a2 = gca();
225             subplot(2,nc,nc+2)
226             plot2d(7*cos(t),2*sin(t))
227             isoview
228             // plot of a sphere using facets computed by eval3dp
229             deff("[x,y,z] = sph(alp,tet)",["x = r*cos(alp).*cos(tet)+orig(1)*ones(tet)"; ..
230             "y = r*cos(alp).*sin(tet)+orig(2)*ones(tet)"; ..
231             "z = r*sin(alp)+orig(3)*ones(tet)"]);
232             r = 3; orig = [0 0 0];
233             [xx,yy,zz] = eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,40));
234             subplot(2,nc,3)
235             plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
236             zlabel("isoview off", "rotation", -90, "fontsize",4)
237             xtitle("True sphere")
238             a3 = gca();
239             subplot(2,nc,nc+3)
240             plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
241             zlabel("isoview on", "rotation", -90, "fontsize",4)
242             isoview
243         </scilab:image>
244         <programlisting role="example"><![CDATA[
245 // Использование plot2d(..., frameflag=4) :
246 r = linspace(1,10,200);
247 t = r*3;
248 scf();
249 subplot(1,2,1)
250 plot2d(r.*sin(t),r.*cos(t))
251 xtitle("plot2d(..)")
252 subplot(1,2,2)
253 plot2d(r.*sin(t),r.*cos(t),frameflag=4)
254 xtitle("при frameflag=4")
255              ]]></programlisting>
256         <scilab:image localized="true">
257             r = linspace(1,10,200);
258             t = r*3;
259             scf();
260             subplot(1,2,1)
261             plot2d(r.*sin(t),r.*cos(t))
262             xtitle("plot2d(..)")
263             subplot(1,2,2)
264             plot2d(r.*sin(t),r.*cos(t),frameflag=4)
265             xtitle("при frameflag=4")
266         </scilab:image>
267     </refsection>
268     <refsection role="see also">
269         <title>Смотрите также</title>
270         <simplelist type="inline">
271             <member>
272                 <link linkend="replot">replot</link>
273             </member>
274             <member>
275                 <link linkend="axes_properties">свойства осей</link>
276             </member>
277         </simplelist>
278     </refsection>
279     <refsection role="history">
280         <title>История</title>
281         <revhistory>
282             <revision>
283                 <revnumber>6.0.0</revnumber>
284                 <revdescription>
285                     <itemizedlist>
286                         <listitem>добавлены входные флаги "on"|"off".</listitem>
287                         <listitem>добавлены входные параметры &lt;none&gt; или idGraphics.</listitem>
288                         <listitem>
289                             <literal>isoview(xmin, xmax, ymin, ymax)</literal> отмечена как нерекомендуемая.
290                         </listitem>
291                     </itemizedlist>
292                 </revdescription>
293             </revision>
294             <revision>
295                 <revnumber>6.0.2</revnumber>
296                 <revdescription>
297                     "isoview on" теперь устанавливает .cube_scaling="off", а
298                     "isoview off" устанавливает .cube_scaling="on".
299                 </revdescription>
300             </revision>
301         </revhistory>
302     </refsection>
303 </refentry>