* Bug #14885 fixed - The tag property was not documented in Matplot_properties help... 05/19005/1
Adeline CARNIS [Mon, 5 Dec 2016 10:35:18 +0000 (11:35 +0100)]
  http://bugzilla.scilab.org/14885
  + page improved: http://bugzilla.scilab.org/attachment.cgi?id=4452

Change-Id: I897e84520bd77b4f8b9405f6dfc7c71f08bd972f

scilab/CHANGES.md
scilab/modules/graphics/help/en_US/2d_plot/Matplot_properties.xml
scilab/modules/graphics/help/ja_JP/2d_plot/Matplot_properties.xml
scilab/modules/graphics/help/pt_BR/2d_plot/Matplot_properties.xml [deleted file]
scilab/modules/graphics/help/ru_RU/2d_plot/Matplot_properties.xml [deleted file]

index 440201b..9501a1b 100644 (file)
@@ -212,7 +212,7 @@ Help pages:
 
 * fixed / improved:  `members`, `part`, `ode`, `ode_optional_output`, `ode_roots`, `plot2d`, `roots`,
   `printf`, `sprintf`, `iconvert`, `stdev`, `xlabel`, `and_op`, `or_op`, `permute`, `tree2code`, `%helps`,
-  `scilab|scilex`, `flipdim`
+  `scilab|scilex`, `flipdim`, `Matplot_properties`
 * rewritten: `consolebox`, `double`, `isoview`, `pixel_drawing_mode`, `householder`, `or`, `and`, `format`, `typeof`,
 `brackets`, `setlanguage`, `sleep`, `isinf`, `bitor`, `bitxor`, `bitand`, `macr2tree`, `geomean`, `clf`, `getPreferencesValue`
 * reorganized:
@@ -223,7 +223,7 @@ Help pages:
   - Signal processing: New `Convolution - correlation` subsection. `wfir_gui`, `filt_sinc`, `hilb`, `fft2`, `fftshift`,`ifftshift`, `hilbert`, `cepstrum`, `conv`, `conv2`, `convol2d`, `xcor`, `corr`, `hank`, `mrfit`, `frfir` sorted up in existing subsections.
   - Colormaps and GUI/Menus subsections created
 * translations added:
-  - (fr): `format`, `typeof`, `isoview`, `ndgrid`, `bench_run`, `consolebox`, `harmean`, `sleep`, `strtod`, `permute`
+  - (fr): `format`, `typeof`, `isoview`, `ndgrid`, `bench_run`, `consolebox`, `harmean`, `sleep`, `strtod`, `permute`, `geomean`
   - (ru): homepage
 
 
@@ -446,6 +446,7 @@ Bug Fixes
 * [#14824](http://bugzilla.scilab.org/show_bug.cgi?id=14824): Incorrect error message with `mfprintf(fd, "%d", [])`.
 * [#14835](http://bugzilla.scilab.org/show_bug.cgi?id=14835): `AFFICH_m` block was not rendered correctly.
 * [#14839](http://bugzilla.scilab.org/show_bug.cgi?id=14839): `plot2d2` crashed Scilab.
+* [#14885](http://bugzilla.scilab.org/show_bug.cgi?id=14885): The tag property was not documented in Matplot_properties help page.
 * [#14887](http://bugzilla.scilab.org/show_bug.cgi?id=14887): For many graphic handle types, the display of the `.tag` value missed `".."` delimiters
 * [#14909](http://bugzilla.scilab.org/show_bug.cgi?id=14909): getlongpathname and getshortpathname return values with "\" instead of "/"
 * [#14911](http://bugzilla.scilab.org/show_bug.cgi?id=14911): Added the entry "Label => Title" in the graphic context menu in a figure
index 37afb7a..8ad72b2 100644 (file)
@@ -2,6 +2,7 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Fabrice Leray
+ * Copyright (C) 2016 - Samuel GOUGEON
  *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
  *
  * along with this program.
  *
  -->
-<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="en" xml:id="Matplot_properties">
+<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="en" xml:id="Matplot_properties">
     <refnamediv>
         <refname>Matplot properties</refname>
         <refpurpose>
-            description of the Matplot entities properties
+            Description of the Matplot entities properties
         </refpurpose>
     </refnamediv>
     <refsection>
         </para>
         <variablelist>
             <varlistentry>
-                <term>parent: </term>
+                <term>parent</term>
                 <listitem>
                     <para>
-                        this property contains the handle of the parent. The parent of the
-                        <literal>Matplot</literal> entity should be of the type <literal>"Axes"</literal>.
+                        Graphic handle of the Matplot's parent, that should be of the type <literal>"Axes"</literal>.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>children: </term>
+                <term>children</term>
                 <listitem>
                     <para>
-                        this property contains a vector with the <literal>children</literal> of
-                        the handle. However, <literal>Matplot</literal> handles currently do not
-                        have any <literal>children</literal>.
+                        vector of <varname>children</varname> of the Matplot object.
+                        By default, a <literal>Matplot</literal> entity
+                        has no <literal>child</literal>, and <varname>.children</varname>
+                        is <literal>[]</literal>.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>visible: </term>
+                <term>visible</term>
                 <listitem>
                     <para>
-                        this field contains the <literal>visible</literal> property value for
-                        the entity. It should be <literal>"on" </literal> or <literal>"off"</literal> .
-                        By default, the plot is visible, the property's value is
-                        <literal>"on"</literal>. If <literal>"off"</literal> the plot is not drawn on the
-                        screen.
+                        <literal>"on"</literal> (default) or <literal>"off"</literal>.
+                        If <literal>"off"</literal>, the Matplot patch is not displayed.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>data: </term>
+                <term>data</term>
                 <listitem>
                     <para>
-                        this field defines a [<literal>m</literal>x<literal>n</literal>]
-                        <literal>color</literal> data matrix (double, (u)int8, (u)int16, (u)int32) or hypermatrix.
-                        The colors are interpreted according to the image_type property.
-                        The color associated to <literal>color(i,j)</literal> is used do draw a small square
-                        of length 1 with center at location <literal>(x=j,y=(m-i+1))</literal>.
+                        <literal>(m,n)</literal> matrix or <literal>(m,n,nc)</literal> hypermatrix of decimal,
+                        (u)int8, (u)int16, or (u)int32 numbers representing a matrix of (m,n) colors on
+                        <literal>nc = 1|3|4</literal> channels to be plotted.
+                        The color encoding/decoding is set by the <varname>image_type</varname> property.
+                        The color associated to <literal>data(i,j,:)</literal> is used do draw and fill
+                        a small rectangle of fixed sizes touching its neighboors and centered at the
+                        <literal>(i,j)</literal> location.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>rect: </term>
+                <term>rect</term>
                 <listitem>
                     <para>
-                        this field contains a row-vector defined by <literal>[xmin, ymin, xmax, ymax]</literal>.
-                        It specifies a rectangle in the current scale and the matrix is drawn inside this rectangle.
+                        vector <literal>[xmin, ymin, xmax, ymax]</literal> defining a rectangle
+                        in data scales of the parent axes. The full <varname>data</varname> matrix
+                        is scaled accordingly to fill the <varname>rect</varname> shape:
+                        <itemizedlist>
+                            <listitem>
+                                Its <literal>m</literal> rows cover the <literal>[ymin, ymax]</literal> interval.
+                            </listitem>
+                            <listitem>
+                                Its <literal>n</literal> columns cover the <literal>[xmin, xmax]</literal> interval.
+                            </listitem>
+                        </itemizedlist>
+                    </para>
+                    <para>
+                        The <literal>data(i,j)</literal> pixel is drawn in the small rectangle bounded by
+                        <literal>X = xmin + [j-1, j]*(xmax-xmin)/n</literal> and
+                        <literal>Y = ymax - [i-1, i]*(ymax-ymin)/m</literal>
+                    </para>
+                    <para>
+                        If one <varname>rect</varname> bound goes beyond the corresponding
+                        <literal>.parent.data_bounds(i)</literal> axes bound, the overflowing side of the
+                        <varname>data</varname> matrix will be clipped, unless <varname>.clip_state</varname>
+                        is set to <literal>"off"</literal>.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>image_type: </term>
+                <term>image_type</term>
                 <listitem>
                     <para>
-                        this field defines the image type. It could be one of the values: "rgb", "rgba", "gray", "index",
-                        "red", "green", "blue", "rgb332", "rgb444", "rgb555", "rgba5551", "argb".
+                        this field defines the image type. It could be one of the values:
+                        "index", "gray", "rgb", "rgba", "argb", "red", "green", "blue",
+                        "rgb332", "rgb444", "rgb555", "rgb4444", "rgb5551".
                     </para>
                     <para>
-                        Colors are determinated by the data type and by image_type:
+                        Colors are determinated by the data type and by <varname>image_type</varname>:
                     </para>
-                    <itemizedlist>
-                        <listitem>
-                            <para>
-                                When image_type is equal to index, the data are just considered as an index in the colormap.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                When image_type is equal to rgb, hypermat of int8 or uint8 will give the RGB components, hypermat of doubles will give normalized RGB components (values between 0 and 1), matrices of int8 or uint8 where number of rows is a multiple of 3 will give the RGB components, matrices of int32 will give RGB colors, matrices of uint32 will give RGBA colors where the alpha channel will be set to 0xFF.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                When image_type is equal to rgba, hypermat of int8 or uint8 will give the RGBA components, hypermat of doubles will give normalized RGBA components (values between 0 and 1), matrices of int8 or uint8 where number of rows is a multiple of 4 will give the RGB components, matrices of int32 will give RGBA colors, matrices of uint32 will give RGBA colors.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                When image_type is equal to gray, matrices of int8 or uint8 will give Gray level color (R-G-B=GRAY-GRAY-GRAY), for other types, data will be considered as RGB ones and converted into gray colors (0.299*R+0.587*G+0.114*B).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                When image_type is equal to red, matrices of int8 or uint8 will give Red level color (R-G-B=RED-00-00), for other types, data will be considered as RGB ones and converted into red colors (a mask is applied to keep the Red component).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                When image_type is equal to green, matrices of int8 or uint8 will give Green level color (R-G-B=00-GREEN-00), for other types, data will be considered as RGB ones and converted into green colors (a mask is applied to keep the Green component).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                When image_type is equal to blue, matrices of int8 or uint8 will give Blue level color (R-G-B=00-00-BLUE), for other types, data will be considered as RGB ones and converted into blue colors (a mask is applied to keep the Blue component).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                When image_type is equal to rgb332, matrices of int8 or uint8 will give RGB colors where R component is wrote on 3 bits, G component on 3 bits and B component on 2 bits. For other data types, RGB (8-8-8) data are converted into RGB (3-3-2).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                When image_type is equal to rgb444, matrices of int16 or uint16 will give RGB colors where each components is wrote on 4 bits. For other data types, RGB (8-8-8) data are converted into RGB (4-4-4).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                When image_type is equal to rgb555, matrices of int16 or uint16 will give RGB colors where each components is wrote on 5 bits. For other data types, RGB (8-8-8) data are converted into RGB (5-5-5).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                When image_type is equal to rgb4444, matrices of int16 or uint16 will give RGBA colors where each components is wrote on 4 bits. For other data types, RGBA (8-8-8-8) data are converted into RGBA (4-4-4-4).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                When image_type is equal to rgb5551, matrices of int16 or uint16 will give RGBA colors where each non-alpha components is wrote on 5 bits and the alpha component on 1 bit. For other data types, RGBA (8-8-8-8) data are converted into RGBA (5-5-5-1).
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                When image_type is equal to argb, hypermat of int8 or uint8 will give the ARGB components, hypermat of doubles will give normalized ARGB components (values between 0 and 1), matrices of int8 or uint8 where number of rows is a multiple of 4 will give the RGB components, matrices of int32 will give ARGB colors, matrices of uint32 will give ARGB colors.
-                            </para>
-                        </listitem>
-                    </itemizedlist>
+                    <variablelist>
+                        <varlistentry>
+                            <term>"index"</term>
+                            <listitem>
+                                  <varname>data</varname> are colors indices in the colormap.
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>"gray"</term>
+                            <listitem>
+                                <itemizedlist>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int8 or uint8 provides Gray level color (R-G-B=GRAY-GRAY-GRAY).
+                                    </listitem>
+                                    <listitem>
+                                        Otherwise, <varname>data</varname> is considered as RGB levels and converted into gray colors (0.299*R+0.587*G+0.114*B).
+                                    </listitem>
+                                </itemizedlist>
+                                <para></para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>"rgb"</term>
+                            <listitem>
+                                <itemizedlist>
+                                    <listitem>
+                                        <varname>data</varname> as an hypermat of int8 or uint8 provides the RGB components ;
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> as an hypermat of doubles provides normalized RGB components (values between 0 and 1) ;
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int8 or uint8 with a number of rows multiple of 3 provides the RGB components ;
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int32 provides RGB colors ;
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of uint32 provides RGBA colors where the alpha channel will be set to 0xFF.
+                                    </listitem>
+                                </itemizedlist>
+                                <para></para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>"rgba"</term>
+                            <listitem>
+                                <itemizedlist>
+                                    <listitem>
+                                        <varname>data</varname> as an hypermat of int8 or uint8 provides the RGBA components ;
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> as an hypermat of doubles provides normalized RGBA components (values between 0 and 1) ;
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int8 or uint8 with a number of rows multiple of 4 provides the RGBA components ;
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int32 or uint32 provides RGBA colors.
+                                    </listitem>
+                                </itemizedlist>
+                                <para></para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>"argb"</term>
+                            <listitem>
+                                <itemizedlist>
+                                    <listitem>
+                                        <varname>data</varname> as an hypermat of int8 or uint8 provides the ARGB components ;
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> as an hypermat of doubles provides normalized ARGB components (values between 0 and 1) ;
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int8 or uint8 with a number of rows multiple of 4 provides the ARGB components ;
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int32 or uint32 provides ARGB colors.
+                                    </listitem>
+                                </itemizedlist>
+                                <para></para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>"red"</term>
+                            <listitem>
+                                <itemizedlist>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int8 or uint8 provides Red level color (R-G-B=RED-00-00).
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> of another type is considered as RGB intensities. They are then converted into red levels (a mask is applied to keep the Red component).
+                                    </listitem>
+                                </itemizedlist>
+                                <para></para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>"green"</term>
+                            <listitem>
+                                <itemizedlist>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int8 or uint8 provides Green level color (R-G-B=00-GREEN-00).
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> of another type is considered as RGB intensities. They are then converted into green levels (a mask is applied to keep the Green component).
+                                    </listitem>
+                                </itemizedlist>
+                                <para></para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>"blue"</term>
+                            <listitem>
+                                <itemizedlist>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int8 or uint8 provides Blue level color (R-G-B=00-00-BLUE) ;
+                                    </listitem>
+                                    <listitem>
+                                        <varname>data</varname> of another type is considered as RGB intensities. They are then converted into blue levels (a mask is applied to keep the Blue component).
+                                    </listitem>
+                                </itemizedlist>
+                                <para></para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>"rgb332"</term>
+                            <listitem>
+                                <itemizedlist>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int8 or uint8 provides RGB colors where R component is wrote on 3 bits, G component on 3 bits and B component on 2 bits.
+                                    </listitem>
+                                    <listitem>
+                                        For other <varname>data</varname> types, RGB (8-8-8) data are converted into RGB (3-3-2).
+                                    </listitem>
+                                </itemizedlist>
+                                <para></para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>"rgb444"</term>
+                            <listitem>
+                                <itemizedlist>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int16 or uint16 provides RGB colors where each components is wrote on 4 bits.
+                                    </listitem>
+                                    <listitem>
+                                        For other <varname>data</varname> types, RGB (8-8-8) data are converted into RGB (4-4-4).
+                                    </listitem>
+                                </itemizedlist>
+                                <para></para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>"rgb555"</term>
+                            <listitem>
+                                <itemizedlist>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int16 or uint16 provides RGB colors where each components is wrote on 5 bits.
+                                    </listitem>
+                                    <listitem>
+                                        For other <varname>data</varname> types, RGB (8-8-8) data are converted into RGB (5-5-5).
+                                    </listitem>
+                                </itemizedlist>
+                                <para></para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>"rgb4444"</term>
+                            <listitem>
+                                <itemizedlist>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int16 or uint16 provides RGBA colors where each components is wrote on 4 bits.
+                                    </listitem>
+                                    <listitem>
+                                        For other <varname>data</varname> types, RGBA (8-8-8-8) data are converted into RGBA (4-4-4-4).
+                                    </listitem>
+                                </itemizedlist>
+                                <para></para>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>"rgb5551"</term>
+                            <listitem>
+                                <itemizedlist>
+                                    <listitem>
+                                        <varname>data</varname> as a matrix of int16 or uint16 provides RGBA colors where each non-alpha components is wrote on 5 bits and the alpha component on 1 bit.
+                                    </listitem>
+                                    <listitem>
+                                        For other <varname>data</varname> types, RGBA (8-8-8-8) data are converted into RGBA (5-5-5-1).
+                                    </listitem>
+                                </itemizedlist>
+                                <para></para>
+                            </listitem>
+                        </varlistentry>
+                    </variablelist>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>clip_state: </term>
+                <term>clip_state</term>
                 <listitem>
                     <para>
-                        this field contains the <literal>clip_state</literal> property value for
-                        the <literal>Matplot</literal>. It should be :
+                        Its value drives the clipping of the <literal>Matplot</literal> patch outside
+                        its parent <literal>Axes</literal> box. Possible values are:
                     </para>
                     <itemizedlist>
                         <listitem>
-                            <para>
-                                <literal>"off"</literal> this means that the <literal>Matplot</literal> is not
-                                clipped.
-                            </para>
+                                <literal>"off"</literal>: The Matplot patch is not clipped.
+                                Setting <literal>.clip_state = "off"</literal>
+                                automatically resets <literal>.clip_box = []</literal>.
                         </listitem>
                         <listitem>
-                            <para>
-                                <literal>"clipgrf"</literal> this means that the <literal>Matplot</literal> is clipped
-                                outside the <literal>Axes</literal> box.
-                            </para>
+                                <literal>"clipgrf"</literal>: The Matplot patch is clipped outside
+                              its parent axes. Setting <literal>.clip_state = "clipgrf"</literal>
+                              automatically resets <literal>.clip_box = []</literal>.
                         </listitem>
                         <listitem>
-                            <para>
-                                <literal>"on"</literal> this means that the <literal>Matplot</literal> is clipped
-                                outside the rectangle given by property <literal>clip_box</literal>.
-                            </para>
+                                <literal>"on"</literal>: The Matplot patch is clipped outside the
+                                rectangle defined by the <varname>clip_box</varname> property.
                         </listitem>
                     </itemizedlist>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>clip_box: </term>
+                <term>clip_box</term>
                 <listitem>
                     <para>
-                        this field is to determinate the <literal>clip_box</literal> property.
-                        By default its value should be an empty matrix if <literal>clip_state</literal> is
-                        <literal>"off"</literal>. Other cases the vector <literal>[x,y,w,h]</literal>
-                        (upper-left point width height) defines the portions of the <literal>Matplot</literal>
-                        to display, however <literal>clip_state</literal> property value will be changed.
+                      empty matrix <literal>[]</literal> (default) or <literal>[x,y,w,h]</literal>
+                      (upper-left point width height) bounds (in data scales) of the rectangular
+                      area outside which the Matplot patch must be clipped.
+                      Setting <literal>.clip_box = [x y w h]</literal> automatically sets
+                      <literal>.clip_state = "on"</literal>.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>user_data: </term>
+                <term>user_data</term>
                 <listitem>
                     <para>
                         this field can be use to store any scilab variable in the
                     </para>
                 </listitem>
             </varlistentry>
+            <varlistentry>
+                <term>tag</term>
+                <listitem>
+                    <para>
+                      Single text that can be used as identifier/name of the Matplot object.
+                      <literal>findobj("tag", tag_value)</literal> will then return its full graphic handle.
+                    </para>
+                </listitem>
+            </varlistentry>
         </variablelist>
     </refsection>
     <refsection>
         <title>Examples</title>
         <programlisting role="example"><![CDATA[
 Matplot((1:xget("lastpattern")))
-e=gce(); // get current entity
+e = gce(); // get current entity
 
-e.data=e.data($:-1:1) // reverse order
+e.data = e.data($:-1:1) // reverse order
  ]]></programlisting>
         <scilab:image>
             Matplot((1:xget("lastpattern")));
@@ -229,29 +388,23 @@ e.data=e.data($:-1:1) // reverse order
         <title>See also</title>
         <simplelist type="inline">
             <member>
-                <link linkend="set">set</link>
-            </member>
-            <member>
-                <link linkend="get">get</link>
+                <link linkend="Matplot">Matplot</link>
             </member>
             <member>
-                <link linkend="delete">delete</link>
+                <link linkend="Matplot1">Matplot1</link>
             </member>
             <member>
                 <link linkend="grayplot">grayplot</link>
             </member>
             <member>
-                <link linkend="Matplot">Matplot</link>
+                <link linkend="grayplot_properties">grayplot_properties</link>
             </member>
             <member>
-                <link linkend="Matplot1">Matplot1</link>
+                <link linkend="xrects">xrects</link>
             </member>
             <member>
                 <link linkend="graphics_entities">graphics_entities</link>
             </member>
-            <member>
-                <link linkend="grayplot_properties">grayplot_properties</link>
-            </member>
         </simplelist>
     </refsection>
     <refsection>
index e13de88..900172b 100644 (file)
@@ -1,14 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
 <!--
-
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
-
  * Copyright (C) INRIA - Fabrice Leray
-
  *
-
-
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * and continues to be available under such terms.
  * For more information, see the COPYING file which you should have received
  * along with this program.
-
  *
-
  -->
-
-<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="ja" xml:id="Matplot_properties">
-
+<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="ja" xml:id="Matplot_properties">
     <refnamediv>
-
         <refname>Matplot_properties</refname>
-
         <refpurpose>Matplotエンティティプロパティの説明</refpurpose>
-
     </refnamediv>
-
     <refsection>
-
         <title>説明</title>
-
         <para>Matplotエンティティはグラフィックエンティティ階層の葉です.
-
             このエンティティは,曲面および画像の2次元プロットを表します
-
             (<literal>Matplot</literal> および <literal>Matplot1</literal>参照).
-
         </para>
-
         <variablelist>
-
             <varlistentry>
-
-                <term>parent: </term>
-
+                <term>parent</term>
                 <listitem>
-
                     <para>このプロパティは親のハンドルを有します.
-
                         Matplotエンティティの親は <literal>"Axes"</literal>型となります.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
-                <term>children: </term>
-
+                <term>children</term>
                 <listitem>
-
                     <para>
-
                         このプロパティにはハンドルの<literal>children</literal>
-
                         のベクトルが含まれます.
-
                         しかし,現在,<literal>Matplot</literal>には<literal>children</literal>
-
                         がありません.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
-                <term>visible: </term>
-
+                <term>visible</term>
                 <listitem>
-
                     <para>
-
                         このフィールドにはエンティティの<literal>visible</literal>
-
                         プロパティの値が含まれます.
-
                         この値は,<literal>"on" </literal> または <literal>"off"</literal> となります.
-
                         デフォルトでプロットは可視であり,このプロパティの値は
-
                         <literal>"on"</literal>となります. <literal>"off"</literal>の場合,プロットは
-
                         画面に描画されません.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
-                <term>data: </term>
-
+                <term>data</term>
                 <listitem>
-
                     <para>
-
                         このフィールドは[<literal>m</literal>x<literal>n</literal>]のデータ行列
-
                         <literal>color</literal>をカレントのカラーマップに基づき定義します.
-
                         位置<literal>(x=j,y=(m-i+1))</literal>を中心とする長さ1の小さな正方形を
-
                         描画する際には<literal>color(i,j)</literal>が指す色が使用されます.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
-                <term>rect: </term>
-
+                <term>rect</term>
                 <listitem>
-
                     <para>
-
                         このフィールドは<literal>[xmin, ymin, xmax, ymax]</literal>で
-
                         定義される行ベクトルを保持します.
-
                         このフィールドはカレントのスケールで矩形を定義し,
-
                         この矩形内に行列が描画されます.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
-                <term>image_type: </term>
-
+                <term>image_type</term>
                 <listitem>
-
                     <para>
-
                         このフィールドは画像の型を定義します.
-
                         値は以下のどれかを指定します:
-
-                        "rgb", "rgba", "gray", "index",
-
-                        "red", "green", "blue", "rgb332", "rgb444", "rgb555", "rgba5551", "argb".
-
+                        "index", "gray", "rgb", "rgba", "argb", "red", "green", "blue", "rgb332", "rgb444", "rgb555", "rgb4444", "rgb5551".
                     </para>
-
                     <para>
-
                         色はデータ型と image_type により以下のように定義されます:
-
                     </para>
-
                     <itemizedlist>
-
                         <listitem>
-
                             <para>
-
                                 image_type が index の場合,
-
                                 データはカラーマップの添字とみなされます.
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
+                                image_typeがgrayの場合, int8またはuint8の行列は
+                                グレーレベルカラー(R-G-B=GRAY-GRAY-GRAY)となります.
+                                その他の型の場合, data はRGBカラーとみなされ,
+                                グレーカラーに変換されます (0.299*R+0.587*G+0.114*B).
+                            </para>
+                        </listitem>
+                        <listitem>
+                            <para>
                                 image_typeがrgbの場合, int8またはuint8のハイパー行列はRGB要素,
-
                                 doubleのハイパー行列は正規化されたRGB要素(値は0と1の間),
-
                                 int8またはuint8の行列(ただし,行数は3の倍数)はRGB要素,
-
                                 int32の行列はRGBカラー,
-
                                 uint32の行列はRGBAカラー(ただし,アルファチャネルは0xFFに設定)
-
                                 を指定します.
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
                                 image_typeがrgbaの場合, int8またはuint8のハイパー行列はRGBA要素,
-
                                 doubleのハイパー行列は正規化されたRGBA要素(値は0と1の間),
-
                                 int8またはuint8の行列(ただし,行数は4の倍数)はRGBA要素,
-
                                 int32の行列はRGBAカラー,uint32の行列はRGBAカラー
-
                                 を指定します.
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
-                                image_typeがgrayの場合, int8またはuint8の行列は
-
-                                グレーレベルカラー(R-G-B=GRAY-GRAY-GRAY)となります.
-
-                                その他の型の場合, data はRGBカラーとみなされ,
-
-                                グレーカラーに変換されます (0.299*R+0.587*G+0.114*B).
-
+                                image_typeがargbの場合, int8 または uint8 のハイパー行列は
+                                ARGB要素,
+                                doubleのハイパー行列は正規化されたARGB要素(値は0と1の間),
+                                int8またはuint8の行列(ただし行数は4の倍数)はRGB要素,
+                                int32の行列はARGBカラー,uint32の行列はARGBカラーを指定します.
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
                                 image_typeがredの場合, int8またはuint8の行列は
-
                                 レッドレベルカラー(R-G-B=REG-00-00)となります.
-
                                 その他の型の場合, data はRGBカラーとみなされ,
-
                                 レッドカラーに変換されます(赤要素を保持するマスクが適用されます).
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
-                                image_typeがredの場合, int8またはuint8の行列は
-
+                                image_typeがgreenの場合, int8またはuint8の行列は
                                 グリーンレベルカラー(R-G-B=00-GREEN-00)となります.
-
                                 その他の型の場合, data はRGBカラーとみなされ,
-
                                 グリーンカラーに変換されます(緑要素を保持するマスクが適用されます).
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
                                 image_typeがblueの場合, int8またはuint8の行列は
-
                                 ブルーレベルカラー(R-G-B=00-00-BLUE)となります.
-
                                 その他の型の場合, data はRGBカラーとみなされ,
-
                                 ブルーカラーに変換されます(青要素を保持するマスクが適用されます).
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
                                 image_typeがrgb332の場合, int8 または uint8 の行列は
-
                                 RGBカラーを指定します.
-
                                 ただし,R要素を3ビット,G要素を3ビット,B要素を2ビットで指定します.
-
                                 その他のデータ型の場合,
-
                                 RGB (8-8-8) データが RGB (3-3-2)に変換されます.
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
                                 image_typeがrgb444の場合, int8 または uint8 の行列は
-
                                 RGBカラーを指定します.
-
                                 ただし,各要素は4ビットです.
-
                                 その他のデータ型の場合,
-
                                 RGB (8-8-8) データが RGB (4-4-4)に変換されます.
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
                                 image_typeがrgb555の場合, int16 または uint16 の行列は
-
                                 RGBカラーを指定します.
-
                                 ただし,各要素は5ビットです.
-
                                 その他のデータ型の場合,
-
                                 RGB (8-8-8) データが RGB (5-5-5)に変換されます.
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
                                 image_typeがrgb4444の場合, int16 または uint16 の行列は
-
                                 RGBAカラーを指定します.
-
                                 ただし,各要素は4ビットです.
-
                                 その他のデータ型の場合,
-
                                 RGBA (8-8-8-8) データが RGBA (4-4-4-4)に変換されます.
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
                                 image_typeがrgb5551の場合, int16 または uint16 の行列は
-
                                 RGBAカラーを指定します.
-
                                 ただし,アルファチャネル以外の要素は5ビット,
-
                                 アルファチャネルは1ビットです.
-
                                 その他のデータ型の場合,
-
                                 RGBA (8-8-8-8) データが RGBA (5-5-5-1)に変換されます.
-
                             </para>
-
                         </listitem>
-
-                        <listitem>
-
-                            <para>
-
-                                image_typeがargbの場合, int8 または uint8 のハイパー行列は
-
-                                ARGB要素,
-
-                                doubleのハイパー行列は正規化されたARGB要素(値は0と1の間),
-
-                                int8またはuint8の行列(ただし行数は4の倍数)はRGB要素,
-
-                                int32の行列はARGBカラー,uint32の行列はARGBカラーを指定します.
-
-                            </para>
-
-                        </listitem>
-
                     </itemizedlist>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
-                <term>clip_state: </term>
-
+                <term>clip_state</term>
                 <listitem>
-
                     <para>
-
                         このフィールドにはMatplotの<literal>clip_state</literal>
-
                         プロパティの値が含まれます. 値は以下となります :
-
                     </para>
-
                     <itemizedlist>
-
                         <listitem>
-
                             <para>
-
                                 <literal>"off"</literal> Matplot はクリップされません.
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
                                 <literal>"clipgrf"</literal>
-
                                 Matplot は軸ボックスの外側でクリップされます.
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
                                 <literal>"on"</literal>
-
                                 Matplot は<literal>clip_box</literal>
-
                                 で指定された矩形の外側でクリップされます.
-
                             </para>
-
                         </listitem>
-
                     </itemizedlist>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
-                <term>clip_box: </term>
-
+                <term>clip_box</term>
                 <listitem>
-
                     <para>
-
                         このフィールドは<literal>clip_box</literal>プロパティを定義します.
-
                         デフォルトで,この値はclip_stateが"off"の場合に空の行列となります.
-
                         その他の場合,ベクトル<literal>[x,y,w,h]</literal>
-
                         (左上の点,幅,高さ)が<literal>Matplot</literal>
-
                         が表示する範囲を定義しますが,
-
                         <literal>clip_state</literal>プロパティの値は変更されません.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
-                <term>user_data: </term>
-
+                <term>user_data</term>
                 <listitem>
-
                     <para>
-
                         このフィールドは任意のScilab変数を<literal>Matplot</literal>
-
                         データ構造体に保存し,復元する際に使用可能です.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
+            <varlistentry>
+                <term>tag</term>
+                <listitem>
+                    <para>
+                      Single text that can be used as identifier/name of the Matplot object.
+                      <literal>findobj("tag", tag_value)</literal> will then return its full graphic handle.
+                    </para>
+                </listitem>
+            </varlistentry>
         </variablelist>
-
     </refsection>
-
     <refsection>
-
         <title>例</title>
-
         <programlisting role="example"><![CDATA[
-
 Matplot((1:xget("lastpattern")))
-
 e=gce(); // カレントのエンティティを取得
-
-
-
 e.data=e.data($:-1:1) // 逆順
-
  ]]></programlisting>
-
         <scilab:image>
-
             Matplot((1:xget("lastpattern")));
-
             e=gce();
-
             e.data=e.data($:-1:1);
-
         </scilab:image>
-
     </refsection>
-
     <refsection role="see also">
-
         <title>参照</title>
-
         <simplelist type="inline">
-
             <member>
-
-                <link linkend="set">set</link>
-
-            </member>
-
-            <member>
-
-                <link linkend="get">get</link>
-
+                <link linkend="Matplot">Matplot</link>
             </member>
-
             <member>
-
-                <link linkend="delete">delete</link>
-
+                <link linkend="Matplot1">Matplot1</link>
             </member>
-
             <member>
-
                 <link linkend="grayplot">grayplot</link>
-
             </member>
-
             <member>
-
-                <link linkend="Matplot">Matplot</link>
-
+                <link linkend="grayplot_properties">grayplot_properties</link>
             </member>
-
             <member>
-
-                <link linkend="Matplot1">Matplot1</link>
-
+                <link linkend="xrects">xrects</link>
             </member>
-
             <member>
-
                 <link linkend="graphics_entities">graphics_entities</link>
-
-            </member>
-
-            <member>
-
-                <link linkend="grayplot_properties">grayplot_properties</link>
-
             </member>
-
         </simplelist>
-
     </refsection>
-
     <refsection>
-
         <title>履歴</title>
-
         <revhistory>
-
             <revision>
-
                 <revnumber>5.5.0</revnumber>
-
                 <revremark>
-
                     <itemizedlist>
-
                         <listitem>
-
                             プロパティ <literal>image_type</literal>が導入されました.
-
                         </listitem>
-
                         <listitem>
-
                             プロパティ <literal>rect</literal>が導入されました.
-
                         </listitem>
-
                     </itemizedlist>
-
                 </revremark>
-
             </revision>
-
         </revhistory>
-
     </refsection>
-
-</refentry>
-
-
-
+</refentry>
\ No newline at end of file
diff --git a/scilab/modules/graphics/help/pt_BR/2d_plot/Matplot_properties.xml b/scilab/modules/graphics/help/pt_BR/2d_plot/Matplot_properties.xml
deleted file mode 100644 (file)
index cfae487..0000000
+++ /dev/null
@@ -1,160 +0,0 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA - Fabrice Leray
- *
- * Copyright (C) 2012 - 2016 - Scilab Enterprises
- *
- * This file is hereby licensed under the terms of the GNU GPL v2.0,
- * pursuant to article 5.3.4 of the CeCILL v.2.1.
- * This file was originally licensed under the terms of the CeCILL v2.1,
- * and continues to be available under such terms.
- * For more information, see the COPYING file which you should have received
- * along with this program.
- *
- -->
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="Matplot_properties" xml:lang="pt">
-    <refnamediv>
-        <refname>Matplot_properties</refname>
-        <refpurpose>Descrição das propriedades da entidade Matplot</refpurpose>
-    </refnamediv>
-    <refsection>
-        <title>Descrição</title>
-        <para>A entidade Matplot é uma folha na hierarquia de entidades gráficas.
-            Representa esboços 2d de superfícies utilizando cores e imagens (ver
-            <literal>Matplot</literal> e <literal>Matplot1</literal>).
-        </para>
-        <variablelist>
-            <varlistentry>
-                <term>parent:</term>
-                <listitem>
-                    <para>esta propriedade contém o manipulador da raiz. A raiz de uma
-                        entidade Matplot deve ser do tipo <literal>"Axes"</literal>.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>children:</term>
-                <listitem>
-                    <para>esta propriedade contém um vetor com os galhos do manipulador.
-                        Contudo, manipuladores <literal>Matplot</literal> handles
-                        correntemente não possuem galhos.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>visible:</term>
-                <listitem>
-                    <para>este campo contém o valor da propriedade
-                        <literal>visible</literal> para a entidade . Pode ser <literal>"on"
-                        </literal>
-                        ou <literal>"off"</literal> . Por padrão, o esboço é
-                        visível, o valor da propriedade é <literal>"on"</literal>. Se
-                        <literal>"off"</literal> o esboço não é desenhado na tela.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>data:</term>
-                <listitem>
-                    <para>este campo define uma matriz de cores
-                        [<literal>m</literal>x<literal>n</literal>] <literal>color</literal>
-                        utilizando o mapa de cores corrente. A cor associada a
-                        <literal>color(i,j)</literal> é utilizanda para se esboçar um
-                        pequeno quadrado de lado 1 com centro localizado em
-                        <literal>(x=j,y=(m-i+1))</literal>.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>clip_state:</term>
-                <listitem>
-                    <para>este campo contém o valor da propriedade
-                        <literal>clip_state</literal> para o Matplot. o valor de clip_state
-                        pode ser :
-                    </para>
-                    <itemizedlist>
-                        <listitem>
-                            <para>
-                                <literal>"off"</literal> significa que o Matplot não é
-                                recortado.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"clipgrf"</literal> significa que o Matplot é
-                                recortado fora da caixa dos eixos.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"on"</literal> significa que o Matplot é
-                                recortado fora do retângulo dado pela propriedade
-                                clip_box.
-                            </para>
-                        </listitem>
-                    </itemizedlist>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>clip_box:</term>
-                <listitem>
-                    <para>este campo determina a propriedade
-                        <literal>clip_box</literal>. Por padrão seu valor é uma matriz vazia
-                        se a propriedade clip_state é "off". Em outros casos, o vetor
-                        <literal>[x,y,w,h]</literal> (ponto superior esquerdo, largura,
-                        altura) define as porções do retângulo a ser exibido, contudo o
-                        valor da propriedade <literal>clip_state</literal> será
-                        alterado.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>user_data:</term>
-                <listitem>
-                    <para>este campo pode armazenar qualquer variável Scilab na
-                        estrutura de dados do Matplot e recuperá-la.
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
-        <title>Exemplos</title>
-        <programlisting role="example"><![CDATA[
-Matplot((1:xget("lastpattern")))
-e=gce(); // obtendo a entidade corrente
-
-e.data=e.data($:-1:1) // ordem inversa
- ]]></programlisting>
-    </refsection>
-    <refsection role="see also">
-        <title>Ver Também</title>
-        <simplelist type="inline">
-            <member>
-                <link linkend="set">set</link>
-            </member>
-            <member>
-                <link linkend="get">get</link>
-            </member>
-            <member>
-                <link linkend="delete">delete</link>
-            </member>
-            <member>
-                <link linkend="grayplot">grayplot</link>
-            </member>
-            <member>
-                <link linkend="Matplot">Matplot</link>
-            </member>
-            <member>
-                <link linkend="Matplot1">Matplot1</link>
-            </member>
-            <member>
-                <link linkend="graphics_entities">graphics_entities</link>
-            </member>
-            <member>
-                <link linkend="grayplot_properties">grayplot_properties</link>
-            </member>
-        </simplelist>
-    </refsection>
-</refentry>
diff --git a/scilab/modules/graphics/help/ru_RU/2d_plot/Matplot_properties.xml b/scilab/modules/graphics/help/ru_RU/2d_plot/Matplot_properties.xml
deleted file mode 100644 (file)
index 72cc0bd..0000000
+++ /dev/null
@@ -1,162 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
- * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
- * Copyright (C) INRIA - Fabrice Leray
- *
- * Copyright (C) 2012 - 2016 - Scilab Enterprises
- *
- * This file is hereby licensed under the terms of the GNU GPL v2.0,
- * pursuant to article 5.3.4 of the CeCILL v.2.1.
- * This file was originally licensed under the terms of the CeCILL v2.1,
- * and continues to be available under such terms.
- * For more information, see the COPYING file which you should have received
- * along with this program.
- *
- -->
-<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="Matplot_properties">
-    <refnamediv>
-        <refname>свойства Matplot</refname>
-        <refpurpose>
-            описание свойств объектов Matplot
-        </refpurpose>
-    </refnamediv>
-    <refsection>
-        <title>Описание</title>
-        <para>
-            Объект <literal>Matplot</literal> - это лист иерархии графических объектов.
-            Он представляет двумерные графики поверхности, используя цвета и изображения
-            (см. <function>Matplot</function> и <function>Matplot1</function>).
-        </para>
-        <variablelist>
-            <varlistentry>
-                <term>parent: </term>
-                <listitem>
-                    <para>
-                        это свойство содержит указатель предка. Предок объекта
-                        <literal>Matplot</literal> должен быть типа <literal>"Axes"</literal> ("Оси").
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>children: </term>
-                <listitem>
-                    <para>
-                        это свойство содержит вектор с потомками <literal>children</literal>
-                        указателя. Однако, указатели <literal>Matplot</literal> в настоящее
-                        время не имеют потомков <literal>children</literal>.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>visible: </term>
-                <listitem>
-                    <para>
-                        это поле содержит значение свойства видимости <literal>visible</literal>
-                        для объекта. Оно должно быть <literal>"on"</literal> ("вкл.") или
-                        <literal>"off"</literal> ("откл."). По умолчанию, график видим, значение
-                        свойства <literal>"on"</literal>. Если же <literal>"off"</literal>, то
-                        график на экране не рисуется.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>data: </term>
-                <listitem>
-                    <para>
-                        это поле определяет матрицу данных о цвете <literal>color</literal>
-                        размером [<literal>m</literal> на <literal>n</literal>] с помощью
-                        текущей цветовой карты. Цвет, связанный с <literal>color(i,j)</literal>
-                        используется для рисования маленького квадрата длиной 1 с центром в
-                        <literal>(x=j,y=(m-i+1))</literal>.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>clip_state: </term>
-                <listitem>
-                    <para>
-                        это поле содержит значение свойства <literal>clip_state</literal>
-                        ("обрезка") для <literal>Matplot</literal>. Оно должно быть:
-                    </para>
-                    <itemizedlist>
-                        <listitem>
-                            <para>
-                                <literal>"off"</literal> - это значит, что <literal>Matplot</literal> не обрезан.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"clipgrf"</literal> - это значит, что <literal>Matplot</literal>
-                                обрезан с внешней стороы рамки осей <literal>Axes</literal>.
-                            </para>
-                        </listitem>
-                        <listitem>
-                            <para>
-                                <literal>"on"</literal> - это значит, что <literal>Matplot</literal> обрезан по внешеней
-                                стороне прямоугольника, заданного свойством <literal>clip_box</literal>.
-                            </para>
-                        </listitem>
-                    </itemizedlist>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>clip_box: </term>
-                <listitem>
-                    <para>
-                        это поле предназначено для определения свойства <literal>clip_box</literal> ("рамка обрезки").
-                        По умолчанию его значение должно быть пустой матрицей, если <literal>clip_state</literal>
-                        равно <literal>"off"</literal>. В других случаях вектор <literal>[x,y,w,h]</literal>
-                        (верхняя левая точка, ширина, высота) определяет часть <literal>Matplot</literal>,
-                        которую нужно отобразить, однако значение свойства <literal>clip_state</literal> будет меняться.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>user_data: </term>
-                <listitem>
-                    <para>
-                        это поле может быть использовано для хранения и возврата любой переменной Scilab в
-                        структуре данных <literal>Matplot</literal>.
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
-        <title>Примеры</title>
-        <programlisting role="example"><![CDATA[
-Matplot((1:xget("lastpattern")))
-e=gce(); // получить текущий объект
-e.data=e.data($:-1:1) // обратить порядок
- ]]></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="delete">delete</link>
-            </member>
-            <member>
-                <link linkend="grayplot">grayplot</link>
-            </member>
-            <member>
-                <link linkend="Matplot">Matplot</link>
-            </member>
-            <member>
-                <link linkend="Matplot1">Matplot1</link>
-            </member>
-            <member>
-                <link linkend="graphics_entities">graphics_entities</link>
-            </member>
-            <member>
-                <link linkend="grayplot_properties">grayplot_properties</link>
-            </member>
-        </simplelist>
-    </refsection>
-</refentry>