Fix help issues (warnings + wrong format in files)
[scilab.git] / scilab / modules / graphics / help / ru_RU / graphics_entities.xml
index 32efa16..f651f0e 100644 (file)
@@ -1,5 +1,5 @@
-        <?xml version="1.0" encoding="UTF-8"?>
-    <!--
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA
  * 
  * This source file is licensed as described in the file COPYING, which
  * you should have received as part of this distribution.  The terms
  * are also available at    
- * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
+ * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
  *
  -->
-    <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">
-        <refnamediv>
-            <refname>Графические объекты</refname>
-            <refpurpose>
-                описание структур данных графических объектов
-            </refpurpose>
-        </refnamediv>
-        <refsection>
-            <title>Описание</title>
-            <para>
-                В Scilab'е графическое окно и рисование его содержимого представлены
-                иерархическими объектами. Верхний уровень иерархии - это
-                <literal>Figure</literal> ("Окно"). Каждое окно
-                <literal>Figure</literal> определяет по меньшей мере одного потомка
-                типа <literal>Axes</literal> ("оси"). Каждый объект осей
-                <literal>Axes</literal> содержит набор листовых объектов, которые
-                являются основными графическими объектами такими, как
-                <literal>Polylines</literal> ("ломанные линии"),
-                <literal>Rectangles</literal> ("прямоугольники"),
-                <literal>Arcs</literal> ("дуги"), <literal>Segs</literal> ("сегменты"),...
-                Он может также содержать составной тип <literal>Compound</literal>,
-                который является рекурсивным набором объектов. Главный интерес
-                графического режима заключается в том, чтобы сделать обмен
-                свойствами проще. Этот графический режим  обеспечивает набор
-                графических функций высокого уровня (см. <link
+<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">
+    <refnamediv>
+        <refname>Графические объекты</refname>
+        <refpurpose>
+            описание структур данных графических объектов
+        </refpurpose>
+    </refnamediv>
+    <refsection>
+        <title>Описание</title>
+        <para>
+            В Scilab'е графическое окно и рисование его содержимого представлены
+            иерархическими объектами. Верхний уровень иерархии - это
+            <literal>Figure</literal> ("Окно"). Каждое окно
+            <literal>Figure</literal> определяет по меньшей мере одного потомка
+            типа <literal>Axes</literal> ("оси"). Каждый объект осей
+            <literal>Axes</literal> содержит набор листовых объектов, которые
+            являются основными графическими объектами такими, как
+            <literal>Polylines</literal> ("ломанные линии"),
+            <literal>Rectangles</literal> ("прямоугольники"),
+            <literal>Arcs</literal> ("дуги"), <literal>Segs</literal> ("сегменты"),...
+            Он может также содержать составной тип <literal>Compound</literal>,
+            который является рекурсивным набором объектов. Главный интерес
+            графического режима заключается в том, чтобы сделать обмен
+            свойствами проще. Этот графический режим  обеспечивает набор
+            графических функций высокого уровня (см. <link
             linkend="set">set</link>, <link linkend="get">get</link>),
-                используемых для управления свойствами объектов, такими, как данные,
-                координаты и масштабирование, цвет и вид без необходимости повторять
-                команды инициализации графики.
-            </para>
-            <para>
-                Графические объекты связаны с переменными Scilab'а типа
-                <literal>handle</literal> ("дескриптор"). Дескриптор - это
-                уникальный идентификатор, который связан с каждым образцом
-                созданного графического объекта. Используя этот дескриптор, можно
-                добраться до свойств объекта через функции <function>set</function>
-                и <function>get</function>. Дескрипторы также используются для
-                манипулирования графическими объектами, чтобы двигать, копировать
-                или удалять их.
-            </para>
-            <para/>
-            <variablelist>
-                <varlistentry>
-                    <term>Figure: </term>
-                    <listitem>
-                        <para>
-                            Объект графического окна <literal>Figure</literal> - это
-                            верхний уровень иерархии графических объектов. Этот
-                            объект определяет параметры собственно графического
-                            окна, а также значения по умолчанию параметров при
-                            создании потомков. Потомки графического окна являются
-                            объектами осей <literal>Axes</literal>.
-                        </para>
-                        <para>
-                            Дескриптор текущего графического окна (графического
-                            окна, используемого для построения графиков) может быть
-                            получен с помощью <code>get("current_figure")</code> и
-                            он может быть установлен с помощью
-                            <code>set("current_figure",h)</code>, где
-                            <literal>h</literal> - это или дескриптор
-                            графического окна, или <literal>figure_id</literal>. В
-                            последнем случае, если графическое окно ещё не
-                            существует, то оно будет создано.
-                        </para>
-                        <para>
-                            См. подробности в <link
+            используемых для управления свойствами объектов, такими, как данные,
+            координаты и масштабирование, цвет и вид без необходимости повторять
+            команды инициализации графики.
+        </para>
+        <para>
+            Графические объекты связаны с переменными Scilab'а типа
+            <literal>handle</literal> ("дескриптор"). Дескриптор - это
+            уникальный идентификатор, который связан с каждым образцом
+            созданного графического объекта. Используя этот дескриптор, можно
+            добраться до свойств объекта через функции <function>set</function>
+            и <function>get</function>. Дескрипторы также используются для
+            манипулирования графическими объектами, чтобы двигать, копировать
+            или удалять их.
+        </para>
+        <para/>
+        <variablelist>
+            <varlistentry>
+                <term>Figure: </term>
+                <listitem>
+                    <para>
+                        Объект графического окна <literal>Figure</literal> - это
+                        верхний уровень иерархии графических объектов. Этот
+                        объект определяет параметры собственно графического
+                        окна, а также значения по умолчанию параметров при
+                        создании потомков. Потомки графического окна являются
+                        объектами осей <literal>Axes</literal>.
+                    </para>
+                    <para>
+                        Дескриптор текущего графического окна (графического
+                        окна, используемого для построения графиков) может быть
+                        получен с помощью <code>get("current_figure")</code> и
+                        он может быть установлен с помощью
+                        <code>set("current_figure",h)</code>, где
+                        <literal>h</literal> - это или дескриптор
+                        графического окна, или <literal>figure_id</literal>. В
+                        последнем случае, если графическое окно ещё не
+                        существует, то оно будет создано.
+                    </para>
+                    <para>
+                        См. подробности в <link
                         linkend="figure_properties">свойствах графического окна</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Axes: </term>
-                    <listitem>
-                        <para>
-                            Объект осей The <literal>Axes</literal> - это второй
-                            уровень иерархии графических объектов. Этот объект
-                            определяет параметры для изменения координат и рисования
-                            осей, а также значений по умолчанию параметров для
-                            создания его потомков. См. подробности в <link
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Axes: </term>
+                <listitem>
+                    <para>
+                        Объект осей The <literal>Axes</literal> - это второй
+                        уровень иерархии графических объектов. Этот объект
+                        определяет параметры для изменения координат и рисования
+                        осей, а также значений по умолчанию параметров для
+                        создания его потомков. См. подробности в <link
                         linkend="axes_properties">свойствах осей</link>.
-                            Дескриптор текущих осей <literal>Axes</literal> может
-                            быть получен с помощью <code>get("current_axes")</code>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Compound: </term>
-                    <listitem>
-                        <para>
-                            Составной объект <literal>Compound</literal> - это
-                            просто вектор потомков и с единственным свойством
-                            (свойство видимости). Он используется для склеивания
-                            набора объектов вместе.
-                        </para>
-                        <para>
-                            См. функции <link linkend="glue">glue</link>, <link
+                        Дескриптор текущих осей <literal>Axes</literal> может
+                        быть получен с помощью <code>get("current_axes")</code>.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Compound: </term>
+                <listitem>
+                    <para>
+                        Составной объект <literal>Compound</literal> - это
+                        просто вектор потомков и с единственным свойством
+                        (свойство видимости). Он используется для склеивания
+                        набора объектов вместе.
+                    </para>
+                    <para>
+                        См. функции <link linkend="glue">glue</link>, <link
                         linkend="unglue">unglue</link> и <link
                         linkend="Compound_properties">свойства составного
-                                объекта Compound
-                            </link>
-                            .
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Axis: </term>
-                    <listitem>
-                        <para>
-                            Объект оси <literal>Axis</literal> - это лист иерархии
-                            графических объектов. Этот объект определяет параметры
-                            для масштабирования и вида осей.
-                        </para>
-                        <para>
-                            См. подробности в <link
+                            объекта Compound
+                        </link>
+                        .
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Axis: </term>
+                <listitem>
+                    <para>
+                        Объект оси <literal>Axis</literal> - это лист иерархии
+                        графических объектов. Этот объект определяет параметры
+                        для масштабирования и вида осей.
+                    </para>
+                    <para>
+                        См. подробности в <link
                         linkend="axis_properties">свойствах оси</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Polyline: </term>
-                    <listitem>
-                        <para>
-                            Объект ломаной линии <literal>Polyline</literal> - это
-                            лист иерархии графических объектов. Он определяет
-                            двумерные и трёхмерные ломаные линии и свойства
-                            рисования продолжения ломаных линий.
-                        </para>
-                        <para>
-                            См. подробности в <link
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Polyline: </term>
+                <listitem>
+                    <para>
+                        Объект ломаной линии <literal>Polyline</literal> - это
+                        лист иерархии графических объектов. Он определяет
+                        двумерные и трёхмерные ломаные линии и свойства
+                        рисования продолжения ломаных линий.
+                    </para>
+                    <para>
+                        См. подробности в <link
                         linkend="polyline_properties">свойствах ломаных линий</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Arc: </term>
-                    <listitem>
-                        <para>
-                            Объект дуги <literal>Arc</literal> - это
-                            лист иерархии графических объектов. Этот объект
-                            определяет параметры эллипсов и части эллипсов.
-                        </para>
-                        <para>
-                            См. подробности в  <link
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Arc: </term>
+                <listitem>
+                    <para>
+                        Объект дуги <literal>Arc</literal> - это
+                        лист иерархии графических объектов. Этот объект
+                        определяет параметры эллипсов и части эллипсов.
+                    </para>
+                    <para>
+                        См. подробности в  <link
                         linkend="arc_properties">свойствах дуги</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Rectangle: </term>
-                    <listitem>
-                        <para>
-                            Объект прямоугольника <literal>Rectangle</literal> - это
-                            лист иерархии графических объектов. Этот объект
-                            определяет параметры прямоугольников и залитых
-                            прямоугольников.
-                        </para>
-                        <para>
-                            См. подробности в  <link
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Rectangle: </term>
+                <listitem>
+                    <para>
+                        Объект прямоугольника <literal>Rectangle</literal> - это
+                        лист иерархии графических объектов. Этот объект
+                        определяет параметры прямоугольников и залитых
+                        прямоугольников.
+                    </para>
+                    <para>
+                        См. подробности в  <link
                         linkend="rectangle_properties">свойствах прямоугольника</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Surface: </term>
-                    <listitem>
-                        <para>
-                            Объект поверхности <literal>Surface</literal> - это
-                            лист иерархии графических объектов. У него есть подтипы
-                            <literal>Fac3d</literal> или <literal>Plot3d</literal>.
-                            Этот объект определяет параметры для графиков трёхмерной
-                            поверхности.
-                        </para>
-                        <para>
-                            См. подробности в <link
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Surface: </term>
+                <listitem>
+                    <para>
+                        Объект поверхности <literal>Surface</literal> - это
+                        лист иерархии графических объектов. У него есть подтипы
+                        <literal>Fac3d</literal> или <literal>Plot3d</literal>.
+                        Этот объект определяет параметры для графиков трёхмерной
+                        поверхности.
+                    </para>
+                    <para>
+                        См. подробности в <link
                         linkend="surface_properties">свойствах поверхности</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Fec: </term>
-                    <listitem>
-                        <para>
-                            Объект <literal>Fec</literal> - это
-                            лист иерархии графических объектов. Он представляет
-                            двумерные графики конечных элементов.
-                        </para>
-                        <para>
-                            См. подробности в <link
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Fec: </term>
+                <listitem>
+                    <para>
+                        Объект <literal>Fec</literal> - это
+                        лист иерархии графических объектов. Он представляет
+                        двумерные графики конечных элементов.
+                    </para>
+                    <para>
+                        См. подробности в <link
                         linkend="fec_properties">свойствах fec</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Grayplot: </term>
-                    <listitem>
-                        <para>
-                            Объект палитры серого <literal>Grayplot</literal> - это
-                            лист иерархии графических объектов. Он представляет
-                            двумерные графики поверхности с помощью цветов и
-                            изображений.
-                        </para>
-                        <para>
-                            См. подробности в <link
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Grayplot: </term>
+                <listitem>
+                    <para>
+                        Объект палитры серого <literal>Grayplot</literal> - это
+                        лист иерархии графических объектов. Он представляет
+                        двумерные графики поверхности с помощью цветов и
+                        изображений.
+                    </para>
+                    <para>
+                        См. подробности в <link
                         linkend="grayplot_properties">палитре серого</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Matplot: </term>
-                    <listitem>
-                        <para>
-                            Объект <literal>Matplot</literal> - это
-                            лист иерархии графических объектов. Он представляет
-                            двумерные графики с помощью матриц с целочисленными
-                            элементами.
-                        </para>
-                        <para>
-                            См. подробности в <link
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Matplot: </term>
+                <listitem>
+                    <para>
+                        Объект <literal>Matplot</literal> - это
+                        лист иерархии графических объектов. Он представляет
+                        двумерные графики с помощью матриц с целочисленными
+                        элементами.
+                    </para>
+                    <para>
+                        См. подробности в <link
                         linkend="Matplot_properties">свойствах Matplot'а</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Segs: </term>
-                    <listitem>
-                        <para>
-                            Объект сегментов <literal>Segs</literal> - это
-                            лист иерархии графических объектов. Этот объект
-                            определяет параметры для набора раскрашенных сегментов
-                            или раскрашенных стрелок.
-                        </para>
-                        <para>
-                            См. подробности в <link
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Segs: </term>
+                <listitem>
+                    <para>
+                        Объект сегментов <literal>Segs</literal> - это
+                        лист иерархии графических объектов. Этот объект
+                        определяет параметры для набора раскрашенных сегментов
+                        или раскрашенных стрелок.
+                    </para>
+                    <para>
+                        См. подробности в <link
                         linkend="segs_properties">свойствах сегментов</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Champ: </term>
-                    <listitem>
-                        <para>
-                            Объект фона <literal>Champ</literal> - это
-                            лист иерархии графических объектов. Этот объект
-                            определяет параметры двумерного векторного поля.
-                        </para>
-                        <para>
-                            См. подробности в <link
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Champ: </term>
+                <listitem>
+                    <para>
+                        Объект фона <literal>Champ</literal> - это
+                        лист иерархии графических объектов. Этот объект
+                        определяет параметры двумерного векторного поля.
+                    </para>
+                    <para>
+                        См. подробности в <link
                         linkend="champ_properties">свойствах фона</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Text: </term>
-                    <listitem>
-                        <para>
-                            Объект текста <literal>Text</literal> - это
-                            лист иерархии графических объектов. Этот объект
-                            определяет параметры для рисования строк.
-                        </para>
-                        <para>
-                            См. подробности в <link
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Text: </term>
+                <listitem>
+                    <para>
+                        Объект текста <literal>Text</literal> - это
+                        лист иерархии графических объектов. Этот объект
+                        определяет параметры для рисования строк.
+                    </para>
+                    <para>
+                        См. подробности в <link
                         linkend="text_properties">свойствах текста</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Label: </term>
-                    <listitem>
-                        <para>
-                            Объект подписи <literal>Label</literal> - это
-                            потомок графического объекта осей
-                            <literal>Axes</literal>. Этот объект определяет
-                            параметры подписей к осям x, y и z, а также названия,
-                            нарисованного в графическом окне.
-                        </para>
-                        <para>
-                            См. подробности в <link
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Label: </term>
+                <listitem>
+                    <para>
+                        Объект подписи <literal>Label</literal> - это
+                        потомок графического объекта осей
+                        <literal>Axes</literal>. Этот объект определяет
+                        параметры подписей к осям x, y и z, а также названия,
+                        нарисованного в графическом окне.
+                    </para>
+                    <para>
+                        См. подробности в <link
                         linkend="label_properties">свойствах  объекта подписи Label</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-                <varlistentry>
-                    <term>Legend: </term>
-                    <listitem>
-                        <para>
-                            Объект легенды <literal>Legend</literal> - это
-                            лист иерархии графических объектов. Этот объект
-                            определяет параметры легенды, рисуемой ниже графиков
-                            <literal>plot2dx</literal>. Этот объект требует дальнейшей разработки.
-                        </para>
-                        <para>
-                            См. подробности в <link linkend="legend_properties">свойствах объекта легенды Legend</link>.
-                        </para>
-                    </listitem>
-                </varlistentry>
-            </variablelist>
-        </refsection>
-        <refsection>
-            <title>Примеры</title>
-            <programlisting role="example"><![CDATA[ 
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Legend: </term>
+                <listitem>
+                    <para>
+                        Объект легенды <literal>Legend</literal> - это
+                        лист иерархии графических объектов. Этот объект
+                        определяет параметры легенды, рисуемой ниже графиков
+                        <literal>plot2dx</literal>. Этот объект требует дальнейшей разработки.
+                    </para>
+                    <para>
+                        См. подробности в <link linkend="legend_properties">свойствах объекта легенды Legend</link>.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>Примеры</title>
+        <programlisting role="example"><![CDATA[ 
 // Проиграйте этот пример строчку за строчкой
 scf() //создать графическое окно в объектном режиме
 //получить дескриптор объекта Figure и распечатать его свойства
@@ -333,34 +333,31 @@ plot3d() // график посылается в графическое окно
 set("current_figure",f) // создать предыдущее графическое окно текущим
 plot2d(x,x^3)  // график посылается в первоначальное графическое окно
  ]]></programlisting>
-        </refsection>
-        <refsection role="see also">
-            <title>Смотрите также</title>
-            <simplelist type="inline">
-                <member>
-                    <link linkend="set">set</link>
-                </member>
-                <member>
-                    <link linkend="get">get</link>
-                </member>
-                <member>
-                    <link linkend="move">move</link>
-                </member>
-                <member>
-                    <link linkend="draw">draw</link>
-                </member>
-                <member>
-                    <link linkend="delete">delete</link>
-                </member>
-                <member>
-                    <link linkend="object_editor">редактор объектов</link>
-                </member>
-                <member>
-                    <link linkend="plot">plot</link>
-                </member>
-                <member>
-                    <link linkend="surf">surf</link>
-                </member>
-            </simplelist>
-        </refsection>
-    </refentry>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="set">set</link>
+            </member>
+            <member>
+                <link linkend="get">get</link>
+            </member>
+            <member>
+                <link linkend="move">move</link>
+            </member>
+            <member>
+                <link linkend="delete">delete</link>
+            </member>
+            <member>
+                <link linkend="object_editor">редактор объектов</link>
+            </member>
+            <member>
+                <link linkend="plot">plot</link>
+            </member>
+            <member>
+                <link linkend="surf">surf</link>
+            </member>
+        </simplelist>
+    </refsection>
+</refentry>