Inserted tag <note>. Fixed a typo.
[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</link>.
112                     </para>
113                 </listitem>
114             </varlistentry>
115             <varlistentry>
116                 <term>Axis: </term>
117                 <listitem>
118                     <para>
119                         Объект оси <literal>Axis</literal> - это лист иерархии
120                         графических объектов. Этот объект определяет параметры
121                         для масштабирования и вида осей.
122                     </para>
123                     <para>
124                         См. подробности в <link
125                         linkend="axis_properties">свойствах оси</link>.
126                     </para>
127                 </listitem>
128             </varlistentry>
129             <varlistentry>
130                 <term>Polyline: </term>
131                 <listitem>
132                     <para>
133                         Объект ломаной линии <literal>Polyline</literal> - это
134                         лист иерархии графических объектов. Он определяет
135                         двумерные и трёхмерные ломаные линии и свойства
136                         рисования продолжения ломаных линий.
137                     </para>
138                     <para>
139                         См. подробности в <link
140                         linkend="polyline_properties">свойствах ломаных линий</link>.
141                     </para>
142                 </listitem>
143             </varlistentry>
144             <varlistentry>
145                 <term>Arc: </term>
146                 <listitem>
147                     <para>
148                         Объект дуги <literal>Arc</literal> - это
149                         лист иерархии графических объектов. Этот объект
150                         определяет параметры эллипсов и части эллипсов.
151                     </para>
152                     <para>
153                         См. подробности в  <link
154                         linkend="arc_properties">свойствах дуги</link>.
155                     </para>
156                 </listitem>
157             </varlistentry>
158             <varlistentry>
159                 <term>Rectangle: </term>
160                 <listitem>
161                     <para>
162                         Объект прямоугольника <literal>Rectangle</literal> - это
163                         лист иерархии графических объектов. Этот объект
164                         определяет параметры прямоугольников и залитых
165                         прямоугольников.
166                     </para>
167                     <para>
168                         См. подробности в  <link
169                         linkend="rectangle_properties">свойствах прямоугольника</link>.
170                     </para>
171                 </listitem>
172             </varlistentry>
173             <varlistentry>
174                 <term>Surface: </term>
175                 <listitem>
176                     <para>
177                         Объект поверхности <literal>Surface</literal> - это
178                         лист иерархии графических объектов. У него есть подтипы
179                         <literal>Fac3d</literal> или <literal>Plot3d</literal>.
180                         Этот объект определяет параметры для графиков трёхмерной
181                         поверхности.
182                     </para>
183                     <para>
184                         См. подробности в <link
185                         linkend="surface_properties">свойствах поверхности</link>.
186                     </para>
187                 </listitem>
188             </varlistentry>
189             <varlistentry>
190                 <term>Fec: </term>
191                 <listitem>
192                     <para>
193                         Объект <literal>Fec</literal> - это
194                         лист иерархии графических объектов. Он представляет
195                         двумерные графики конечных элементов.
196                     </para>
197                     <para>
198                         См. подробности в <link
199                         linkend="fec_properties">свойствах fec</link>.
200                     </para>
201                 </listitem>
202             </varlistentry>
203             <varlistentry>
204                 <term>Grayplot: </term>
205                 <listitem>
206                     <para>
207                         Объект палитры серого <literal>Grayplot</literal> - это
208                         лист иерархии графических объектов. Он представляет
209                         двумерные графики поверхности с помощью цветов и
210                         изображений.
211                     </para>
212                     <para>
213                         См. подробности в <link
214                         linkend="grayplot_properties">палитре серого</link>.
215                     </para>
216                 </listitem>
217             </varlistentry>
218             <varlistentry>
219                 <term>Matplot: </term>
220                 <listitem>
221                     <para>
222                         Объект <literal>Matplot</literal> - это
223                         лист иерархии графических объектов. Он представляет
224                         двумерные графики с помощью матриц с целочисленными
225                         элементами.
226                     </para>
227                     <para>
228                         См. подробности в <link
229                         linkend="Matplot_properties">свойствах Matplot'а</link>.
230                     </para>
231                 </listitem>
232             </varlistentry>
233             <varlistentry>
234                 <term>Segs: </term>
235                 <listitem>
236                     <para>
237                         Объект сегментов <literal>Segs</literal> - это
238                         лист иерархии графических объектов. Этот объект
239                         определяет параметры для набора раскрашенных сегментов
240                         или раскрашенных стрелок.
241                     </para>
242                     <para>
243                         См. подробности в <link
244                         linkend="segs_properties">свойствах сегментов</link>.
245                     </para>
246                 </listitem>
247             </varlistentry>
248             <varlistentry>
249                 <term>Champ: </term>
250                 <listitem>
251                     <para>
252                         Объект фона <literal>Champ</literal> - это
253                         лист иерархии графических объектов. Этот объект
254                         определяет параметры двумерного векторного поля.
255                     </para>
256                     <para>
257                         См. подробности в <link
258                         linkend="champ_properties">свойствах фона</link>.
259                     </para>
260                 </listitem>
261             </varlistentry>
262             <varlistentry>
263                 <term>Text: </term>
264                 <listitem>
265                     <para>
266                         Объект текста <literal>Text</literal> - это
267                         лист иерархии графических объектов. Этот объект
268                         определяет параметры для рисования строк.
269                     </para>
270                     <para>
271                         См. подробности в <link
272                         linkend="text_properties">свойствах текста</link>.
273                     </para>
274                 </listitem>
275             </varlistentry>
276             <varlistentry>
277                 <term>Label: </term>
278                 <listitem>
279                     <para>
280                         Объект подписи <literal>Label</literal> - это
281                         потомок графического объекта осей
282                         <literal>Axes</literal>. Этот объект определяет
283                         параметры подписей к осям x, y и z, а также названия,
284                         нарисованного в графическом окне.
285                     </para>
286                     <para>
287                         См. подробности в <link
288                         linkend="label_properties">свойствах  объекта подписи Label</link>.
289                     </para>
290                 </listitem>
291             </varlistentry>
292             <varlistentry>
293                 <term>Legend: </term>
294                 <listitem>
295                     <para>
296                         Объект легенды <literal>Legend</literal> - это
297                         лист иерархии графических объектов. Этот объект
298                         определяет параметры легенды, рисуемой ниже графиков
299                         <literal>plot2dx</literal>. Этот объект требует дальнейшей разработки.
300                     </para>
301                     <para>
302                         См. подробности в <link linkend="legend_properties">свойствах объекта легенды Legend</link>.
303                     </para>
304                 </listitem>
305             </varlistentry>
306         </variablelist>
307     </refsection>
308     <refsection>
309         <title>Примеры</title>
310         <programlisting role="example"><![CDATA[ 
311 // Проиграйте этот пример строчку за строчкой
312 scf() //создать графическое окно в объектном режиме
313 //получить дескриптор объекта Figure и распечатать его свойства
314 f=get("current_figure") 
315 a=f.children // дескриптор потомка - осей Axes
316 x=(1:10)';  plot2d(x,[x.^2 x.^1.5])
317 e=a.children //Составной объект Compound двух ломаных линий
318 p1=e.children(1) // свойства последней нарисованной ломаной линии
319 p1.foreground=5; // изменение цвета ломаной линии
320 e.children.thickness=5; // изменение толщины двух ломаных линий
321 delete(e.children(2))
322 move(e.children,[0,30]) //перевод ломаной линии
323 a.axes_bounds=[0 0 0.5 0.5]; 
324 subplot(222) //создать новый объект осей Axes
325 plot(1:10);
326 a1=f.children(1); //получить его дескриптор
327 copy(e.children,a1); //скопировать объект ломаной линии первого графика в новый объект осей Axes
328 a1.data_bounds=[1 0;10 100]; //изменить пределы осей Axes
329 set("current_figure",10) //создать новое графическое окно с figure_id=10
330 plot3d() // график посылается в графическое окно 10
331 set("current_figure",f) // создать предыдущее графическое окно текущим
332 plot2d(x,x^3)  // график посылается в первоначальное графическое окно
333  ]]></programlisting>
334     </refsection>
335     <refsection role="see also">
336         <title>Смотрите также</title>
337         <simplelist type="inline">
338             <member>
339                 <link linkend="set">set</link>
340             </member>
341             <member>
342                 <link linkend="get">get</link>
343             </member>
344             <member>
345                 <link linkend="move">move</link>
346             </member>
347             <member>
348                 <link linkend="draw">draw</link>
349             </member>
350             <member>
351                 <link linkend="delete">delete</link>
352             </member>
353             <member>
354                 <link linkend="object_editor">редактор объектов</link>
355             </member>
356             <member>
357                 <link linkend="plot">plot</link>
358             </member>
359             <member>
360                 <link linkend="surf">surf</link>
361             </member>
362         </simplelist>
363     </refsection>
364 </refentry>