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.1-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>