Massive indent of all codes:
[scilab.git] / scilab / modules / graphics / help / ru_RU / graphics_entities.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  * 
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 xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"  xml:lang="ru" xml:id="graphics_entities">
14         <refnamediv>
15             <refname>Графические объекты</refname>
16             <refpurpose>
17                 описание структур данных графических объектов
18             </refpurpose>
19         </refnamediv>
20         <refsection>
21             <title>Описание</title>
22             <para>
23                 В Scilab'е графическое окно и рисование его содержимого представлены
24                 иерархическими объектами. Верхний уровень иерархии - это
25                 <literal>Figure</literal> ("Окно"). Каждое окно
26                 <literal>Figure</literal> определяет по меньшей мере одного потомка
27                 типа <literal>Axes</literal> ("оси"). Каждый объект осей
28                 <literal>Axes</literal> содержит набор листовых объектов, которые
29                 являются основными графическими объектами такими, как
30                 <literal>Polylines</literal> ("ломанные линии"),
31                 <literal>Rectangles</literal> ("прямоугольники"),
32                 <literal>Arcs</literal> ("дуги"), <literal>Segs</literal> ("сегменты"),...
33                 Он может также содержать составной тип <literal>Compound</literal>,
34                 который является рекурсивным набором объектов. Главный интерес
35                 графического режима заключается в том, чтобы сделать обмен
36                 свойствами проще. Этот графический режим  обеспечивает набор
37                 графических функций высокого уровня (см. <link
38             linkend="set">set</link>, <link linkend="get">get</link>),
39                 используемых для управления свойствами объектов, такими, как данные,
40                 координаты и масштабирование, цвет и вид без необходимости повторять
41                 команды инициализации графики.
42             </para>
43             <para>
44                 Графические объекты связаны с переменными Scilab'а типа
45                 <literal>handle</literal> ("дескриптор"). Дескриптор - это
46                 уникальный идентификатор, который связан с каждым образцом
47                 созданного графического объекта. Используя этот дескриптор, можно
48                 добраться до свойств объекта через функции <function>set</function>
49                 и <function>get</function>. Дескрипторы также используются для
50                 манипулирования графическими объектами, чтобы двигать, копировать
51                 или удалять их.
52             </para>
53             <para/>
54             <variablelist>
55                 <varlistentry>
56                     <term>Figure: </term>
57                     <listitem>
58                         <para>
59                             Объект графического окна <literal>Figure</literal> - это
60                             верхний уровень иерархии графических объектов. Этот
61                             объект определяет параметры собственно графического
62                             окна, а также значения по умолчанию параметров при
63                             создании потомков. Потомки графического окна являются
64                             объектами осей <literal>Axes</literal>.
65                         </para>
66                         <para>
67                             Дескриптор текущего графического окна (графического
68                             окна, используемого для построения графиков) может быть
69                             получен с помощью <code>get("current_figure")</code> и
70                             он может быть установлен с помощью
71                             <code>set("current_figure",h)</code>, где
72                             <literal>h</literal> - это или дескриптор
73                             графического окна, или <literal>figure_id</literal>. В
74                             последнем случае, если графическое окно ещё не
75                             существует, то оно будет создано.
76                         </para>
77                         <para>
78                             См. подробности в <link
79                         linkend="figure_properties">свойствах графического окна</link>.
80                         </para>
81                     </listitem>
82                 </varlistentry>
83                 <varlistentry>
84                     <term>Axes: </term>
85                     <listitem>
86                         <para>
87                             Объект осей The <literal>Axes</literal> - это второй
88                             уровень иерархии графических объектов. Этот объект
89                             определяет параметры для изменения координат и рисования
90                             осей, а также значений по умолчанию параметров для
91                             создания его потомков. См. подробности в <link
92                         linkend="axes_properties">свойствах осей</link>.
93                             Дескриптор текущих осей <literal>Axes</literal> может
94                             быть получен с помощью <code>get("current_axes")</code>.
95                         </para>
96                     </listitem>
97                 </varlistentry>
98                 <varlistentry>
99                     <term>Compound: </term>
100                     <listitem>
101                         <para>
102                             Составной объект <literal>Compound</literal> - это
103                             просто вектор потомков и с единственным свойством
104                             (свойство видимости). Он используется для склеивания
105                             набора объектов вместе.
106                         </para>
107                         <para>
108                             См. функции <link linkend="glue">glue</link>, <link
109                         linkend="unglue">unglue</link> и <link
110                         linkend="Compound_properties">свойства составного
111                                 объекта Compound
112                             </link>
113                             .
114                         </para>
115                     </listitem>
116                 </varlistentry>
117                 <varlistentry>
118                     <term>Axis: </term>
119                     <listitem>
120                         <para>
121                             Объект оси <literal>Axis</literal> - это лист иерархии
122                             графических объектов. Этот объект определяет параметры
123                             для масштабирования и вида осей.
124                         </para>
125                         <para>
126                             См. подробности в <link
127                         linkend="axis_properties">свойствах оси</link>.
128                         </para>
129                     </listitem>
130                 </varlistentry>
131                 <varlistentry>
132                     <term>Polyline: </term>
133                     <listitem>
134                         <para>
135                             Объект ломаной линии <literal>Polyline</literal> - это
136                             лист иерархии графических объектов. Он определяет
137                             двумерные и трёхмерные ломаные линии и свойства
138                             рисования продолжения ломаных линий.
139                         </para>
140                         <para>
141                             См. подробности в <link
142                         linkend="polyline_properties">свойствах ломаных линий</link>.
143                         </para>
144                     </listitem>
145                 </varlistentry>
146                 <varlistentry>
147                     <term>Arc: </term>
148                     <listitem>
149                         <para>
150                             Объект дуги <literal>Arc</literal> - это
151                             лист иерархии графических объектов. Этот объект
152                             определяет параметры эллипсов и части эллипсов.
153                         </para>
154                         <para>
155                             См. подробности в  <link
156                         linkend="arc_properties">свойствах дуги</link>.
157                         </para>
158                     </listitem>
159                 </varlistentry>
160                 <varlistentry>
161                     <term>Rectangle: </term>
162                     <listitem>
163                         <para>
164                             Объект прямоугольника <literal>Rectangle</literal> - это
165                             лист иерархии графических объектов. Этот объект
166                             определяет параметры прямоугольников и залитых
167                             прямоугольников.
168                         </para>
169                         <para>
170                             См. подробности в  <link
171                         linkend="rectangle_properties">свойствах прямоугольника</link>.
172                         </para>
173                     </listitem>
174                 </varlistentry>
175                 <varlistentry>
176                     <term>Surface: </term>
177                     <listitem>
178                         <para>
179                             Объект поверхности <literal>Surface</literal> - это
180                             лист иерархии графических объектов. У него есть подтипы
181                             <literal>Fac3d</literal> или <literal>Plot3d</literal>.
182                             Этот объект определяет параметры для графиков трёхмерной
183                             поверхности.
184                         </para>
185                         <para>
186                             См. подробности в <link
187                         linkend="surface_properties">свойствах поверхности</link>.
188                         </para>
189                     </listitem>
190                 </varlistentry>
191                 <varlistentry>
192                     <term>Fec: </term>
193                     <listitem>
194                         <para>
195                             Объект <literal>Fec</literal> - это
196                             лист иерархии графических объектов. Он представляет
197                             двумерные графики конечных элементов.
198                         </para>
199                         <para>
200                             См. подробности в <link
201                         linkend="fec_properties">свойствах fec</link>.
202                         </para>
203                     </listitem>
204                 </varlistentry>
205                 <varlistentry>
206                     <term>Grayplot: </term>
207                     <listitem>
208                         <para>
209                             Объект палитры серого <literal>Grayplot</literal> - это
210                             лист иерархии графических объектов. Он представляет
211                             двумерные графики поверхности с помощью цветов и
212                             изображений.
213                         </para>
214                         <para>
215                             См. подробности в <link
216                         linkend="grayplot_properties">палитре серого</link>.
217                         </para>
218                     </listitem>
219                 </varlistentry>
220                 <varlistentry>
221                     <term>Matplot: </term>
222                     <listitem>
223                         <para>
224                             Объект <literal>Matplot</literal> - это
225                             лист иерархии графических объектов. Он представляет
226                             двумерные графики с помощью матриц с целочисленными
227                             элементами.
228                         </para>
229                         <para>
230                             См. подробности в <link
231                         linkend="Matplot_properties">свойствах Matplot'а</link>.
232                         </para>
233                     </listitem>
234                 </varlistentry>
235                 <varlistentry>
236                     <term>Segs: </term>
237                     <listitem>
238                         <para>
239                             Объект сегментов <literal>Segs</literal> - это
240                             лист иерархии графических объектов. Этот объект
241                             определяет параметры для набора раскрашенных сегментов
242                             или раскрашенных стрелок.
243                         </para>
244                         <para>
245                             См. подробности в <link
246                         linkend="segs_properties">свойствах сегментов</link>.
247                         </para>
248                     </listitem>
249                 </varlistentry>
250                 <varlistentry>
251                     <term>Champ: </term>
252                     <listitem>
253                         <para>
254                             Объект фона <literal>Champ</literal> - это
255                             лист иерархии графических объектов. Этот объект
256                             определяет параметры двумерного векторного поля.
257                         </para>
258                         <para>
259                             См. подробности в <link
260                         linkend="champ_properties">свойствах фона</link>.
261                         </para>
262                     </listitem>
263                 </varlistentry>
264                 <varlistentry>
265                     <term>Text: </term>
266                     <listitem>
267                         <para>
268                             Объект текста <literal>Text</literal> - это
269                             лист иерархии графических объектов. Этот объект
270                             определяет параметры для рисования строк.
271                         </para>
272                         <para>
273                             См. подробности в <link
274                         linkend="text_properties">свойствах текста</link>.
275                         </para>
276                     </listitem>
277                 </varlistentry>
278                 <varlistentry>
279                     <term>Label: </term>
280                     <listitem>
281                         <para>
282                             Объект подписи <literal>Label</literal> - это
283                             потомок графического объекта осей
284                             <literal>Axes</literal>. Этот объект определяет
285                             параметры подписей к осям x, y и z, а также названия,
286                             нарисованного в графическом окне.
287                         </para>
288                         <para>
289                             См. подробности в <link
290                         linkend="label_properties">свойствах  объекта подписи Label</link>.
291                         </para>
292                     </listitem>
293                 </varlistentry>
294                 <varlistentry>
295                     <term>Legend: </term>
296                     <listitem>
297                         <para>
298                             Объект легенды <literal>Legend</literal> - это
299                             лист иерархии графических объектов. Этот объект
300                             определяет параметры легенды, рисуемой ниже графиков
301                             <literal>plot2dx</literal>. Этот объект требует дальнейшей разработки.
302                         </para>
303                         <para>
304                             См. подробности в <link linkend="legend_properties">свойствах объекта легенды Legend</link>.
305                         </para>
306                     </listitem>
307                 </varlistentry>
308             </variablelist>
309         </refsection>
310         <refsection>
311             <title>Примеры</title>
312             <programlisting role="example"><![CDATA[ 
313 // Проиграйте этот пример строчку за строчкой
314 scf() //создать графическое окно в объектном режиме
315 //получить дескриптор объекта Figure и распечатать его свойства
316 f=get("current_figure") 
317 a=f.children // дескриптор потомка - осей Axes
318 x=(1:10)';  plot2d(x,[x.^2 x.^1.5])
319 e=a.children //Составной объект Compound двух ломаных линий
320 p1=e.children(1) // свойства последней нарисованной ломаной линии
321 p1.foreground=5; // изменение цвета ломаной линии
322 e.children.thickness=5; // изменение толщины двух ломаных линий
323 delete(e.children(2))
324 move(e.children,[0,30]) //перевод ломаной линии
325 a.axes_bounds=[0 0 0.5 0.5]; 
326 subplot(222) //создать новый объект осей Axes
327 plot(1:10);
328 a1=f.children(1); //получить его дескриптор
329 copy(e.children,a1); //скопировать объект ломаной линии первого графика в новый объект осей Axes
330 a1.data_bounds=[1 0;10 100]; //изменить пределы осей Axes
331 set("current_figure",10) //создать новое графическое окно с figure_id=10
332 plot3d() // график посылается в графическое окно 10
333 set("current_figure",f) // создать предыдущее графическое окно текущим
334 plot2d(x,x^3)  // график посылается в первоначальное графическое окно
335  ]]></programlisting>
336         </refsection>
337         <refsection role="see also">
338             <title>Смотрите также</title>
339             <simplelist type="inline">
340                 <member>
341                     <link linkend="set">set</link>
342                 </member>
343                 <member>
344                     <link linkend="get">get</link>
345                 </member>
346                 <member>
347                     <link linkend="move">move</link>
348                 </member>
349                 <member>
350                     <link linkend="draw">draw</link>
351                 </member>
352                 <member>
353                     <link linkend="delete">delete</link>
354                 </member>
355                 <member>
356                     <link linkend="object_editor">редактор объектов</link>
357                 </member>
358                 <member>
359                     <link linkend="plot">plot</link>
360                 </member>
361                 <member>
362                     <link linkend="surf">surf</link>
363                 </member>
364             </simplelist>
365         </refsection>
366     </refentry>