[doc] surface_properties page improved 54/20554/5
Samuel GOUGEON [Mon, 15 Oct 2018 22:56:24 +0000 (00:56 +0200)]
  * .color_flag, .color_mode, .visible, .surface_mode, .cdata_mapping,
    .hiddencolor properties overhauled.
  * See also: grayplot_properties and Matplot_properties added

Change-Id: Ic25e832f9bbec0c5a715f70ac046df008b4fb020

scilab/modules/graphics/help/en_US/3d_plot/surface_properties.xml
scilab/modules/graphics/help/ja_JP/3d_plot/surface_properties.xml

index 0217d75..18dbb9d 100644 (file)
@@ -3,8 +3,8 @@
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Djalel Abdemouche
  * Copyright (C) INRIA - Fabrice Leray
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2018 - Samuel GOUGEON
  *
  * 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.
  * 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="surface_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="surface_properties">
     <refnamediv>
         <refname>surface properties</refname>
         <refpurpose>description of the 3D entities
                 <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, surfaces are visibles, the value's property is
-                        <literal>"on"</literal>. If <literal>"off"</literal> the 3D graphics are not
-                        displayed on the screen.
+                        <itemizedlist>
+                            <listitem>
+                                <emphasis role="bold">"on"</emphasis> (default): The surface is
+                                displayed, possibly with its mesh and markers.
+                            </listitem>
+                            <listitem>
+                                <emphasis role="bold">"off"</emphasis> : The surface and its mesh
+                                and markers are hidden.
+                            </listitem>
+                        </itemizedlist>
                     </para>
                 </listitem>
             </varlistentry>
                 <term>surface_mode: </term>
                 <listitem>
                     <para>
-                        This field contains the default <literal>surface_mode</literal> property
-                        value for the surface. Its value should be <literal>"on" </literal>(surface
-                        drawn) or <literal>"off"</literal> (no surface drawn).
+                        <itemizedlist>
+                            <listitem>
+                                <emphasis role="bold">"on"</emphasis> (default): facets (body and
+                                edges) are drawn.
+                            </listitem>
+                            <listitem>
+                                <emphasis role="bold">"off"</emphasis> : facets (body and edges)
+                                are hidden. But markers -- if any -- are still displayed
+                                (provided that <literal>.mark_mode = "on"</literal>).
+                            </listitem>
+                        </itemizedlist>
                     </para>
                 </listitem>
             </varlistentry>
                 <term>color_mode: </term>
                 <listitem>
                     <para>
-                        an integer between <literal>[-size(colormap) ; size(colormap)]</literal>
-                        defining the color of the facet when <literal>color_flag</literal> value is
-                        <literal>0</literal>. As stated before, if<literal> color_mode &gt; 0</literal>,
-                        edges are drawn using <literal>foreground</literal> color. If
-                        <literal>color_mode</literal> is set to <literal>0</literal>, a mesh of the
-                        surface is drawn: front faces have no colors. Finally, when
-                        <literal>color_mode &lt; 0</literal>, front faces are painted with color
-                        <literal>-color_mode</literal> but no edges are displayed.
+                        color index in <literal>[-size(colormap), size(colormap)]</literal>
+                        <para>
+                            If <emphasis role="italic">color_flag == 0</emphasis> :
+                            The uniform color of the whole upward surface is set to the index
+                            <literal>abs(color_mode)</literal>.
+                        </para>
+                        <para>
+                            In addition, whatever is <literal>color_flag</literal>,
+                            <itemizedlist>
+                                <listitem>
+                                    <literal>color_mode = 0</literal> makes facets hollow and displays
+                                    only the surface's mesh.
+                                </listitem>
+                                <listitem>
+                                    <literal>color_mode &lt; 0</literal> displays facets bodies and
+                                    edges.
+                                </listitem>
+                                <listitem>
+                                    <literal>color_mode > 0</literal> hides the mesh and displays
+                                    only facets bodies.
+                                </listitem>
+                            </itemizedlist>
+                        </para>
+                        <para>
+                            When it is displayed, the mesh color is set to <varname>foreground</varname>.
+                        </para>
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>color_flag: </term>
                 <listitem>
-                    <para>This field is used to specify the algorithm used to set facets'
-                        colors.
+                    <para>Chooses the algorithm used to set the color of the body of the upward face
+                        of facets, when it is displayed.
+                    </para>
+                    <para>
+                        In addition,
+                        <itemizedlist>
+                            <listitem>
+                                <varname>color_mode</varname> rules the display of the mesh
+                                (facets edges) and/or body of facets.
+                            </listitem>
+                            <listitem>
+                                <varname>foreground</varname> and <varname>thickness</varname> rules
+                                the line color and thickness of the mesh.
+                            </listitem>
+                            <listitem>
+                                <varname>hiddencolor</varname> rules the color of the backward facets
+                                face.
+                            </listitem>
+                        </itemizedlist>
                     </para>
                     <para>
-                        Note that the rules on <literal>color_mode</literal>,
-                        <literal>foreground</literal> and <literal>hiddencolor</literal> are still applied
-                        to this case.
+                        Here below,
+                        <itemizedlist>
+                            <listitem>
+                                <emphasis role="bold">nf</emphasis> stands for the number of facets
+                                of the surface.
+                            </listitem>
+                            <listitem>
+                                <emphasis role="bold">n</emphasis> stands for the number of
+                                vertices of each facet. All facets have the same number of vertices.
+                            </listitem>
+                        </itemizedlist>
+                        Then we have:
                     </para>
                     <itemizedlist>
                         <listitem>
                             <para>
-                                <literal>color_flag == 0</literal>
+                                <term>color_flag = 0</term> <emphasis role="bold">(uniform color)</emphasis> :
+                            </para>
+                            <para>All facets are painted using the same color index and method
+                                defined by <literal>color_mode</literal> (see above).
                             </para>
-                            <itemizedlist>
-                                <listitem>
-                                    <para>All facets are painted using the color index and method
-                                        defined by <literal>color_mode</literal> (see above).
-                                    </para>
-                                </listitem>
-                            </itemizedlist>
                         </listitem>
                         <listitem>
                             <para>
-                                <literal>color_flag == 1</literal>
+                                <term>color_flag = 1</term>
+                                <emphasis role="bold">(uniform color on each facet, mapping Z)</emphasis> :
                             </para>
-                            <itemizedlist>
-                                <listitem>
-                                    <para>All facets are painted using one color index per facet
-                                        proportional to <literal>z</literal>. The minimum <literal>z</literal>
-                                        value is painted using the index 1 color while the maximum
-                                        <literal>z</literal> value is painted using highest color index. The
-                                        edges of the facets can be additionally drawn depending on the
-                                        value of <literal>color_mode</literal> (see above).
-                                    </para>
-                                </listitem>
-                            </itemizedlist>
-                        </listitem>
-                        <listitem>
                             <para>
-                                The 3 remaining cases (<literal>color_flag</literal><literal>== 2,3 or
-                                    4
-                                </literal>
-                                )are only available only with <literal>Fac3d</literal> entity.
-                                Then, the <literal>data.color</literal> value is used to set colors for
-                                facets (indices in the current colormap) if it exists. If not, the
-                                current <literal>color_mode</literal> is used to paint the facets.
+                                The average Z of each facet is computed according to the Z of
+                                its vertices.
+                                Then the [Zmin, Zmax] range of facets Z is computed.
+                                Each facet gets its uniform color in [1, size(colormap)] according
+                                to its Z position in [Zmin, Zmax].
                             </para>
                         </listitem>
+                    </itemizedlist>
+                    <para>
+                        <emphasis role="bold">color_flag== 2,3 or 4</emphasis> values
+                        are only available with <literal>Fac3d</literal> entities.
+                        These algorithms require the <literal>data.color</literal> input to set
+                        facets colors. If <literal>data.color</literal> is empty, the
+                        <literal>color_flag=1</literal> fallback algorithm is used.
+                    </para>
+                    <itemizedlist>
                         <listitem>
                             <para>
-                                <literal>color_flag == 2 ('flat' shading)</literal>
+                                <term>color_flag = 2</term> <emphasis role="bold">('flat' shading)</emphasis> :
                             </para>
-                            <itemizedlist>
+                            <para>All facets are painted using the color index given in the
+                                <literal>data.color</literal> property (one color per facet is
+                                needed). Two cases are then possible :
+                            </para>
+                            <orderedlist>
                                 <listitem>
-                                    <para>All facets are painted using the color index given in the
-                                        <literal>data.color</literal> property (one color per facet is
-                                        needed). Two cases are then possible :
+                                    <para>
+                                        <literal>data.color</literal> is a vector of as many
+                                        <literal>color</literal> indices as there are facets,
+                                        <literal>color(i)</literal> being the color index for the
+                                        facet <literal>#i</literal> :
+                                        <itemizedlist>
+                                            <listitem>
+                                                <literal>color(i)>0</literal>: the boundary of the facet
+                                                is drawn with current line style and color.
+                                            </listitem>
+                                            <listitem>
+                                                <literal>color(i)&lt;0</literal>: the facet's
+                                                boundary is not drawn, and <literal>-color(i)</literal>
+                                                is used as facet's color.
+                                            </listitem>
+                                        </itemizedlist>
                                     </para>
                                 </listitem>
                                 <listitem>
                                     <para>
-                                        <literal>data.color</literal> contains a <literal>color</literal>
-                                        vector : if <literal>color(i)</literal> is positive it gives the
-                                        color of facet <literal>i</literal> and the boundary of the facet is
-                                        drawn with current line style and color. If
-                                        <literal>color(i)</literal> is negative, color id
-                                        <literal>-color(i)</literal> is used and the boundary of the facet
-                                        is not drawn.
-                                    </para>
-                                    <para>
-                                        <literal>data.color</literal> contains a color matrix of size
-                                        (nf,n) where <literal>n</literal> stands for the number of facets
-                                        and <literal>nf</literal> for the number of points defining the
-                                        polygonal facet. For the <literal>nf</literal> vertices defining
-                                        each facet, the algorithm computes an <literal>average value</literal>
-                                        of the color index (from the matrix color index) : the
-                                        <literal>nf</literal> vertices of the same facet will have the same
-                                        color index value.
+                                        <literal>data.color</literal> is a matrix of color indices,
+                                        of size (n,nf). Then, the actual color index of the facet is
+                                        set to the average color of all its vertices.
                                     </para>
                                 </listitem>
-                            </itemizedlist>
+                            </orderedlist>
                         </listitem>
                         <listitem>
                             <para>
-                                <literal>color_flag == 3 ('interpolated' shading)</literal>
+                                <term>color_flag = 3</term>
+                                <emphasis role="bold">(interpolated shading on each facet)</emphasis> :
                             </para>
-                            <itemizedlist>
+                            <para>
+                                Facets painting is done by interpolating their vertices colors.
+                                The indices of vertices color are given in the
+                                <literal>data.color</literal> property (one color per vertex is
+                                needed). Two cases are possible :
+                            </para>
+                            <orderedlist>
                                 <listitem>
-                                    <para>Facets painting results of interpolation of vertices
-                                        colors. The indices of vertices color are given in the
-                                        <literal>data.color</literal> property (one color per vertex is
-                                        needed). Two cases are possible :
+                                    <para>
+                                        <literal>data.color</literal> is a vector of <literal>nf</literal>
+                                        <literal>color</literal> indices,
+                                        <literal>color(i)</literal> being the index of the flat uniform
+                                        color of the facet <literal>#i</literal>.
                                     </para>
                                 </listitem>
                                 <listitem>
                                     <para>
-                                        <literal>data.color</literal> contains a <literal>colors</literal>
-                                        vector : then, there are too few data to complete the
-                                        interpolated shading mode. Indeed, a color matrix of size
-                                        (nf,n) (where <literal>n</literal> stands for the number of facets
-                                        and <literal>nf</literal> for the number of points defining the
-                                        polygonal facet) is needed to perform this operation. For each
-                                        facet, the algorithm copies the single color index value of
-                                        the facet into the <literal>nf</literal> color indexes vertices
-                                        defining the facet's boundary.
-                                    </para>
-                                    <para>
-                                        <literal>data.color</literal> contains a color matrix of size
-                                        (nf,n) (see upper for <literal>nf</literal> and <literal>n</literal>
-                                        definitions), the interpolated shading mode can be completed
-                                        normally using those color indexes.
+                                        <literal>data.color</literal> is a color matrix of size
+                                        (n,nf): The facet #i is drawn with some graded colors
+                                        interpolated between the <literal>color(:,i)</literal>
+                                        colors of its vertices.
                                     </para>
+                                    <note>
+                                        If the Z coordinate of vertices has been assigned to
+                                        <literal>data.color</literal>, this mode allows to map local Z
+                                        with colors, down to the facet scale. See also the
+                                        <literal>.cdata_mapping</literal> property.
+                                    </note>
                                 </listitem>
-                            </itemizedlist>
+                            </orderedlist>
                         </listitem>
                         <listitem>
                             <para>
-                                <literal>color_flag == 4 (Matlab-like 'flat' shading)</literal>
+                                <term> color_flag = 4</term>
+                                <emphasis role="bold">(Matlab-like 'flat' shading)</emphasis> :
+                            </para>
+                            <para>
+                                Same as <literal>color_flag==2</literal>, except that, when
+                                <literal>data.color</literal> is a color matrix, each facet #i is
+                                painted with the uniform <literal>color(1,i)</literal> of its
+                                first vertex (instead of the average color of all its vertices).
+                                Other vertices colors are ignored.
                             </para>
-                            <itemizedlist>
-                                <listitem>
-                                    <para>
-                                        Same as <literal>color_flag==2</literal> with a slight difference
-                                        when <literal>data.color</literal> is a matrix. All facets are
-                                        painted using the color index given in the
-                                        <literal>data.color</literal> property (one color per facet is
-                                        needed). Two cases are then possible :
-                                    </para>
-                                </listitem>
-                                <listitem>
-                                    <para>
-                                        <literal>data.color</literal> contains a <literal>color</literal>
-                                        vector : if <literal>color(i)</literal> is positive it gives the
-                                        color of facet <literal>i</literal> and the boundary of the facet is
-                                        drawn with current line style and color. If
-                                        <literal>color(i)</literal> is negative, color id
-                                        <literal>-color(i)</literal> is used and the boundary of the facet
-                                        is not drawn.
-                                    </para>
-                                    <para>
-                                        <literal>data.color</literal> contains a color matrix of size
-                                        (nf,n) where <literal>n</literal> stands for the number of facets
-                                        and <literal>nf</literal> for the number of points defining the
-                                        polygonal facet. For the <literal>nf</literal> vertices defining
-                                        each facet, the algorithm takes the<literal> color of the first
-                                            vertex
-                                        </literal>
-                                        defining the patch (facet).
-                                    </para>
-                                </listitem>
-                            </itemizedlist>
                         </listitem>
                     </itemizedlist>
                 </listitem>
                 <term>cdata_mapping: </term>
                 <listitem>
                     <para>
-                        <literal>Specific to Fac3d handles</literal>. A string with value
-                        <literal>'scaled'</literal> or <literal>'direct'</literal>. If a
-                        <literal>data.color</literal> is set, each index color data specifies a
-                        single value for each vertex. <literal>cdata_mapping</literal> determines
-                        whether those indices are scaled to map linearly into the current
-                        colormap (<literal>'scaled'</literal> mode) or point directly into this
-                        colormap (<literal>'direct</literal>' mode). This property is useful when
-                        <literal>color_flag</literal> equals <literal>2</literal>,<literal>3</literal> or
-                        <literal>4</literal>.
+                        <literal>'scaled'</literal> or <literal>'direct'</literal>.
+                        Used only for <literal>color_flag=2|3|4</literal>
+                        (<literal>Fac3d</literal> handles), with some <literal>data.color</literal>
+                        defined. Otherwise ignored.
+                        <itemizedlist>
+                            <listitem>
+                                <para>
+                                    <emphasis>"direct"</emphasis>: <literal>data.color</literal>
+                                    values are directly considered as color indices in the
+                                    current gcf().color_map.
+                                </para>
+                            </listitem>
+                            <listitem>
+                                <para><emphasis>"scaled"</emphasis>: <literal>c=data.color</literal>
+                                    values are linearly mapped on the interval <literal>[1,nC]</literal>,
+                                    with <literal>nC=size(gcf().color_map,1)</literal> is the total
+                                    number of colors in the current colormap. Then,
+                                    <literal>min(c)</literal> represents the color #1, and
+                                    <literal>max(c)</literal> represents the color #nC.
+                                </para>
+                            </listitem>
+                        </itemizedlist>
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>hiddencolor: </term>
                 <listitem>
-                    <para>This field contains the color index used to draw the backward
-                        faces of a surface. Its value should be a positive integer (color
-                        index relative to the current colormap). If it is a negative
-                        integer,the same color than the "visible" face is applied to the rear
-                        face.
+                    <para>
+                        Positive index of the color of the uniform backward faces of all facets.
+                        If a negative or null value is provided, backward faces are painted with
+                        the same respective colors as the upward visible ones.
                     </para>
                 </listitem>
             </varlistentry>
@@ -561,6 +606,12 @@ e.color_flag= 3; // interpolated shading mode (based on blue default color becau
                 <link linkend="surf">surf</link>
             </member>
             <member>
+                <link linkend="grayplot_properties">grayplot_properties</link>
+            </member>
+            <member>
+                <link linkend="Matplot_properties">Matplot_properties</link>
+            </member>
+            <member>
                 <link linkend="graphics_entities">graphics_entities</link>
             </member>
         </simplelist>
index ba1835c..5afa319 100644 (file)
@@ -1,16 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
 <!--
-
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
-
  * Copyright (C) INRIA - Djalel Abdemouche
-
  * 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="surface_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="surface_properties">
     <refnamediv>
-
         <refname>surface_properties</refname>
-
         <refpurpose>3次元エンティティプロパティの説明</refpurpose>
-
     </refnamediv>
-
     <refsection>
-
         <title>説明</title>
-
         <para>Surfaceエンティティはグラフィックエンティティ階層の葉です.
-
             この型のエンティティの元には,
-
             プロットを行う関数またはデータの入力手段により
-
             2つのクラス:<literal>Plot3d</literal> および
-
             <literal>Fac3d</literal> が現れます.
-
             <literal>Fac3d</literal> および <literal>Plo3d</literal> エンティティは
-
             似ていますが,<literal>Fac3d</literal>はより完全で,
-
             <literal>Plot3d</literal>よりも多くのオプションを指定できます.
-
             <literal>Fac3d</literal>エンティティを常に有するようにするには,
-
             <literal>plot3d</literal>を使用する前に
-
             <literal>genfac3d</literal>により行列を事前に構築するか,
-
             <literal>surf</literal>コマンドを使用します.
-
         </para>
-
         <para>以下にsurfaceエンティティに含まれるプロパティを示します:</para>
-
         <variablelist>
-
             <varlistentry>
-
                 <term>parent: </term>
-
                 <listitem>
-
                     <para>このフィールドには親のハンドルが含まれます.
-
                         polylineエンティティの親は<literal>"Axes"</literal> 型または
-
                         <literal>"Compound"</literal>型です.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>children: </term>
-
                 <listitem>
-
                     <para>
-
                         このプロパティにはこのハンドルの<literal>children</literal>
-
                         のベクトルが含まれます.
-
                         しかし,現在,surfaceハンドルには<literal>children</literal>がありません.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>visible: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールドはこのエンティティの<literal>visible</literal>
-
                         プロパティの値を有します.
-
                         値は<literal>"on" </literal> または <literal>"off"</literal>となります.
-
                         デフォルトで polyline は可視であり,プロパティの値は
-
                         <literal>"on" </literal>となります. <literal>"off"</literal> の場合,
-
                         この3次元グラフィックは画面に描画されません.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>surface_mode: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールドは <literal>surface_mode</literal> プロパティのデフォルト値を有します.
-
                         その値は <literal>"on" </literal>(曲面を描画
-
                         ) または <literal>"off"</literal> (曲面を描画しない)とします.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>foreground: </term>
-
                 <listitem>
-
                     <para>
-
                         <literal>color_mode &gt;= 0</literal>の場合,
-
                         このフィールドは縁を描画する際に色インデックスを有します.
-
                         そうでない場合,foregroundは全く使用されません.
-
                         foregounrdの値には(カレントのカラーマップに基づく)整数の色インデックスを指定します.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>thickness: </term>
-
                 <listitem>
-
                     <para>このプロパティは正の実数で,小平面の輪郭の幅をピクセル単位で指定します.
-
                         実際の表示幅は指定した幅を最も近い整数に丸めることにより定義されます.
-
                         唯一の例外はベクトル単位のエキスポートで,全体の
-
                         <literal>thickness</literal>の値が考慮されます.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>mark_mode: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールドはsurfaceの<literal>mark_mode</literal>
-
                         プロパティのデフォルト値を有します.
-
                         この値は<literal>"on"</literal> (マーカを描画
-
                         drawn) または <literal>"off"</literal> (マーカを描画しない)となります.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>mark_style: </term>
-
                 <listitem>
-
                     <para>
-
                         <literal>mark_style</literal>プロパティの値は
-
                         <literal>mark_mode</literal>プロパティが<literal>"on"</literal>の場合に,
-
                         使用するマーカの種類を選択するために使用されます.
-
                         この値は[0 14]の範囲の整数で,それぞれ以下の意味があります :
-
                         ドット,プラス,十字,星,塗りつぶした菱形,
-
                         上向き三角形, 下向き三角形, 菱形プラス,円,アスタリスク,
-
                         正方形,右向き三角形,左向き三角形およびペンタグラム.
-
                         以下の図は,マーカのアスペクトが<literal>mark_style</literal>,
-
                         <literal>mark_foreground</literal> および
-
                         <literal>mark_background</literal>プロパティに依存する
-
                         ことを示します.
-
                     </para>
-
                     <para>
-
                         <inlinemediaobject>
-
                             <imageobject>
-
                                 <imagedata fileref="../../images/marks.svg"/>
-
                             </imageobject>
-
                         </inlinemediaobject>
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>mark_size_unit: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールは<literal>mark_size_unit</literal>プロパティのデフォルト値
-
                         を有します.<literal>mark_size_unit</literal>が<literal>"point"</literal>
-
                         に設定された場合,<literal>mark_size</literal>の値はポイント単位で直接
-
                         指定されます.
-
                         <literal>mark_size_unit</literal> に<literal>"tabulated"</literal>が
-
                         指定された場合,<literal>mark_size</literal>はfont size配列に相対的に
-
                         計算されます: この場合,この値は,
-
                         8pt, 10pt, 12pt, 14pt, 18pt および 24pt を意味する
-
                         [0 5]の範囲の整数とします.
-
                         <link linkend="xrect">xrect</link>および Scilabのネーティブ関数は
-
                         <literal>tabulated</literal>モードをデフォルトとします;
-
                         <link linkend="plot">plot</link>関数を使用する場合,
-
                         <literal>point</literal> モードが自動的に有効となります.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>mark_size: </term>
-
                 <listitem>
-
                     <para>
-
                         <literal>mark_size</literal>プロパティは,
-
                         <literal>mark_mode</literal>プロパティが<literal>"on"</literal>の時,
-
                         マーカの大きさを選択するために使用されます.
-
                         この値は, 8pt, 10pt, 12pt, 14pt, 18pt および 24pt を意味する
-
                         [0 5]の範囲の整数です.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>mark_foreground: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールドは,マーカの縁の色である<literal>mark_foreground</literal>
-
                         プロパティの値を有します.この値は(カレントのcolor_mapに関連する)色インデックス
-
                         または透過エッジを意味する 0 とします.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>mark_background: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールドは,マーカの縁の色である<literal>mark_foreground</literal>
-
                         プロパティの値を有します.この値は(カレントのcolor_mapに関連する)色インデックス
-
                         または透過エッジを意味する 0 とします.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>data: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールドは,"3次元"型の<literal>tlist</literal>データ構造体
-
                         を定義します.
-
                         この構造体は,
-
                         x, yおよびz座標をそれぞれ
-
                         <literal>data.x</literal>,<literal>data.y</literal> および <literal>data.z</literal>
-
                         に含む各要素の行および列インデックスから構成されます.
-
                         実際のcolorベクトルまたは行列が指定された場合,
-
                         <literal>data.color</literal>という名前の相補フィールドが利用可能です.
-
                         指定されない場合,<literal>data.color</literal>は利用できません.
-
                         曲面は<literal>color_mode </literal>および<literal>color_flag</literal>
-
                         プロパティに基づき塗りつぶされます.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>color_mode: </term>
-
                 <listitem>
-
                     <para>
-
                         <literal>[-size(colormap) ; size(colormap)]</literal>の範囲の整数で,
-
                         <literal>color_flag</literal>の値が<literal>0</literal>の時,
-
                         小平面の色を定義します.
-
                         前記のように, <literal> color_mode &gt; 0</literal> の時,
-
                         <literal>foreground</literal>色により,縁が描画されます.
-
                         <literal>color_mode</literal> が <literal>0</literal>に設定された場合,
-
                         曲面のメッシュが描画されます: 表面には色がありません.
-
                         最後に,<literal>color_mode &lt; 0</literal>の時,
-
                         表面は色<literal>-color_mode</literal>で塗られますが,
-
                         縁は表示されません.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>color_flag: </term>
-
                 <listitem>
-
                     <para>このフィールドは小平面の色を設定するために使用される
-
                         アルゴリズムを指定する際に使用されます.
-
                     </para>
-
                     <para>
-
                         <literal>color_mode</literal>,
-
                         <literal>foreground</literal> および <literal>hiddencolor</literal>に
-
                         関する規則はこの場合にも適用されます.
-
                     </para>
-
                     <itemizedlist>
-
                         <listitem>
-
                             <para>
-
-                                <literal>color_flag == 0</literal>
-
+                                <literal>color_flag = 0</literal>
+                            </para>
+                            <para>全ての小平面はcolorインデックスおよび
+                                <literal>color_mode</literal>で定義された手法により
+                                塗りつぶされます(上記参照).
                             </para>
-
-                            <itemizedlist>
-
-                                <listitem>
-
-                                    <para>全ての小平面はcolorインデックスおよび
-
-                                        <literal>color_mode</literal>で定義された手法により
-
-                                        塗りつぶされます(上記参照).
-
-                                    </para>
-
-                                </listitem>
-
-                            </itemizedlist>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
-                                <literal>color_flag == 1</literal>
-
+                                <literal>color_flag = 1</literal>
+                            </para>
+                            <para>全ての小平面は
+                                <literal>z</literal>に比例する小平面毎に1つのインデックスを
+                                用いて塗りつぶされます.
+                                <literal>z</literal>の最小値はインデックス1の色で塗られ,
+                                <literal>z</literal>の最大値は最も大きなインデックスの色で塗られます.
+                                加えて,小平面の縁も<literal>color_mode</literal>の値に基づき
+                                塗られます(上記参照).
                             </para>
-
-                            <itemizedlist>
-
-                                <listitem>
-
-                                    <para>全ての小平面は
-
-                                        <literal>z</literal>に比例する小平面毎に1つのインデックスを
-
-                                        用いて塗りつぶされます.
-
-                                        <literal>z</literal>の最小値はインデックス1の色で塗られ,
-
-                                        <literal>z</literal>の最大値は最も大きなインデックスの色で塗られます.
-
-                                        加えて,小平面の縁も<literal>color_mode</literal>の値に基づき
-
-                                        塗られます(上記参照).
-
-                                    </para>
-
-                                </listitem>
-
-                            </itemizedlist>
-
                         </listitem>
-
+                    </itemizedlist>
+                    <para>
+                        残る3つのケース(<literal>color_flag</literal><literal>= 2,3 または
+                            4
+                        </literal>
+                        )は,<literal>Fac3d</literal>エンティティを指定した場合のみ
+                        利用可能です.
+                        次に,<literal>data.color</literal>の値は(存在する場合,)小平面の色を
+                        (カレントのカラーマップのインデックスで)
+                        設定するために使用されます
+                        そうでない場合, 小平面を塗りつぶす際に
+                        カレントの<literal>color_mode</literal>が使用されます.
+                    </para>
+                    <itemizedlist>
                         <listitem>
-
                             <para>
-
-                                残る3つのケース(<literal>color_flag</literal><literal>== 2,3 または
-
-                                    4
-
-                                </literal>
-
-                                )は,<literal>Fac3d</literal>エンティティを指定した場合のみ
-
-                                利用可能です.
-
-                                次に,<literal>data.color</literal>の値は(存在する場合,)小平面の色を
-
-                                (カレントのカラーマップのインデックスで)
-
-                                設定するために使用されます
-
-                                そうでない場合, 小平面を塗りつぶす際に
-
-                                カレントの<literal>color_mode</literal>が使用されます.
-
+                                <literal>color_flag = 2 ('フラット' シェーディング)</literal>
                             </para>
-
-                        </listitem>
-
-                        <listitem>
-
                             <para>
-
-                                <literal>color_flag == 2 ('フラット' シェーディング)</literal>
-
+                                全ての小平面は<literal>data.color</literal>プロパティで
+                                指定した色インデックスにより塗りつぶされます
+                                (小平面毎に1つの色が必要):
+                                <itemizedlist>
+                                    <listitem>
+                                        <para>
+                                            <literal>data.color</literal> は <literal>color</literal>ベクトルを
+                                            有します: <literal>color(i)</literal> が正の場合,
+                                            小平面<literal>i</literal>の色を指定します.
+                                            小平面の境界はカレントの線種と色で描画されます.
+                                            <literal>color(i)</literal> が負の場合,色id
+                                            <literal>-color(i)</literal> が使用され,小平面の境界は描画されません.
+                                        </para>
+                                    </listitem>
+                                    <listitem>
+                                        <para>
+                                            <literal>data.color</literal> は大きさ(n,nf)のcolor行列を
+                                            有します.ただし,<literal>nf</literal> は小平面の数,
+                                            <literal>n</literal>はポリゴン小平面を定義する点の数を意味します.
+                                            <literal>n</literal>個の頂点が各小平面を定義する場合,
+                                            アルゴリズムは(colorインデックス行列の)各色インデックスの
+                                            <literal>平均値</literal>を計算します:
+                                            同じ小平面の<literal>n</literal>個の頂点は同じ色インデックスの値を有します.
+                                        </para>
+                                    </listitem>
+                                </itemizedlist>
                             </para>
-
-                            <itemizedlist>
-
-                                <listitem>
-
-                                    <para>
-
-                                        全ての小平面は<literal>data.color</literal>プロパティで
-
-                                        指定した色インデックスにより塗りつぶされます
-
-                                        (小平面毎に1つの色が必要):
-
-                                    </para>
-
-                                </listitem>
-
-                                <listitem>
-
-                                    <para>
-
-                                        <literal>data.color</literal> は <literal>color</literal>ベクトルを
-
-                                        有します: <literal>color(i)</literal> が正の場合,
-
-                                        小平面<literal>i</literal>の色を指定します.
-
-                                        小平面の境界はカレントの線種と色で描画されます.
-
-                                        <literal>color(i)</literal> が負の場合,色id
-
-                                        <literal>-color(i)</literal> が使用され,小平面の境界は描画されません.
-
-                                    </para>
-
-                                    <para>
-
-                                        <literal>data.color</literal> は大きさ(nf,n)のcolor行列を
-
-                                        有します.ただし,<literal>n</literal> は小平面の数,
-
-                                        <literal>nf</literal>はポリゴン小平面を定義する点の数を意味します.
-
-                                        <literal>nf</literal>個の頂点が各小平面を定義する場合,
-
-                                        アルゴリズムは(colorインデックス行列の)各色インデックスの
-
-                                        <literal>平均値</literal>を計算します:
-
-                                        同じ小平面の<literal>nf</literal>個の頂点は同じ色インデックスの値を有します.
-
-                                    </para>
-
-                                </listitem>
-
-                            </itemizedlist>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
-                                <literal>color_flag == 3 ('補間' シェーディング)</literal>
-
+                                <literal>color_flag = 3 ('補間' シェーディング)</literal>
+                            </para>
+                            <para>小平面は頂点の色を補間した結果に基づき塗りつぶされます.
+                                頂点の色のインデックスは<literal>data.color</literal>プロパティで
+                                指定されます (各頂点毎に1つの色が必要).
+                                以下の2種類のケースがありえます:
+                                <itemizedlist>
+                                    <listitem>
+                                        <para>
+                                            <literal>data.color</literal> が <literal>colors</literal>
+                                            ベクトルを有する場合 :
+                                            <itemizedlist>
+                                                <listitem>
+                                                    この場合,
+                                                    補間シェーディングモードを完成するにはデータが少なすぎます.
+                                                    この処理を行うには,大きさ (n,nf) のcolor行列が必要です
+                                                    (ただし, <literal>nf</literal> は小平面の数,
+                                                    <literal>n</literal>はポリゴン小平面を定義する点の数を意味します).
+                                                </listitem>
+                                                <listitem>
+                                                    各小平面について,このアルゴリズムは,
+                                                    単一の小平面のcolorインデックスの値を,小平面の境界を定義する
+                                                    <literal>n</literal>個の頂点の色インデックスにコピーします.
+                                                </listitem>
+                                            </itemizedlist>
+                                        </para>
+                                    </listitem>
+                                    <listitem>
+                                        <para>
+                                            <literal>data.color</literal> が大きさ(n,nf)の色行列を有する場合
+                                            (前記の <literal>n</literal> および <literal>nf</literal>の定義参照),
+                                            補間シェーディングモードはこれらの色インデックスにより完了することが
+                                            できます.
+                                        </para>
+                                    </listitem>
+                                </itemizedlist>
                             </para>
-
-                            <itemizedlist>
-
-                                <listitem>
-
-                                    <para>小平面は頂点の色を補間した結果に基づき塗りつぶされます.
-
-                                        頂点の色のインデックスは<literal>data.color</literal>プロパティで
-
-                                        指定されます (各頂点毎に1つの色が必要).
-
-                                        以下の2種類のケースがありえます:
-
-                                    </para>
-
-                                </listitem>
-
-                                <listitem>
-
-                                    <para>
-
-                                        <literal>data.color</literal> が <literal>colors</literal>
-
-                                        ベクトルを有する場合 : この場合,
-
-                                        補間シェーディングモードを完成するにはデータが少なすぎます.
-
-                                        この処理を行うには,大きさ (nf,n) のcolor行列が必要です
-
-                                        (ただし, <literal>n</literal> は小平面の数,
-
-                                        <literal>nf</literal>はポリゴン小平面を定義する点の数を意味します).
-
-                                        各小平面について,このアルゴリズムは,
-
-                                        単一の小平面のcolorインデックスの値を,小平面の境界を定義する
-
-                                        <literal>nf</literal>個の頂点の色インデックスにコピーします.
-
-                                    </para>
-
-                                    <para>
-
-                                        <literal>data.color</literal> が大きさ(nf,n)の色行列を有する場合
-
-                                        (前記の <literal>nf</literal> および <literal>n</literal>の定義参照),
-
-                                        補間シェーディングモードはこれらの色インデックスにより完了することが
-
-                                        できます.
-
-                                    </para>
-
-                                </listitem>
-
-                            </itemizedlist>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
-                                <literal>color_flag == 4 (Matlabライクな 'フラット' シェーディング)</literal>
-
+                                <literal>color_flag = 4 (Matlabライクな 'フラット' シェーディング)</literal>
+                            </para>
+                            <para>
+                                <literal>color_flag==2</literal>と同じですが,
+                                <literal>data.color</literal>が行列の場合,わずかな違いがあります.
+                                全ての小平面は<literal>data.color</literal>プロパティで
+                                指定された色インデックスにより塗りつぶされます
+                                (各小平面について1つの色が必要).
+                                以下の2つのケースがありえます:
+                                <itemizedlist>
+                                    <listitem>
+                                        <para>
+                                            <literal>data.color</literal> が <literal>colors</literal>
+                                            ベクトルを有する場合 :
+                                            <itemizedlist>
+                                                <listitem>
+                                                    <literal>color(i)</literal>が正の場合,
+                                                    この値は小平面<literal>i</literal>の色を指定し,
+                                                    小平面の境界はカレントの線種と色で描画されます.
+                                                </listitem>
+                                                <listitem>
+                                                    <literal>color(i)</literal>が負の場合,
+                                                    色ID <literal>-color(i)</literal> が使用され,小平面の境界は
+                                                    描画されません.
+                                                </listitem>
+                                            </itemizedlist>
+                                        </para>
+                                    </listitem>
+                                    <listitem>
+                                        <para>
+                                            <literal>data.color</literal> は大きさ(n,nf)の色行列を有します.
+                                            ただし, <literal>nf</literal> は小平面の数,
+                                            <literal>n</literal>はポリゴン小平面を定義する点の数を意味します.
+                                            <literal>n</literal> 個の頂点が各小平面を定義する場合,
+                                            アルゴリズムはパッチ(小平面)を定義する最初の頂点の色を使用します.
+                                        </para>
+                                    </listitem>
+                                </itemizedlist>
                             </para>
-
-                            <itemizedlist>
-
-                                <listitem>
-
-                                    <para>
-
-                                        <literal>color_flag==2</literal>と同じですが,
-
-                                        <literal>data.color</literal>が行列の場合,わずかな違いがあります.
-
-                                        全ての小平面は<literal>data.color</literal>プロパティで
-
-                                        指定された色インデックスにより塗りつぶされます
-
-                                        (各小平面について1つの色が必要).
-
-                                        以下の2つのケースがありえます:
-
-                                    </para>
-
-                                </listitem>
-
-                                <listitem>
-
-                                    <para>
-
-                                        <literal>data.color</literal> が <literal>colors</literal>
-
-                                        ベクトルを有する場合 :
-
-                                        <literal>color(i)</literal>が正の場合,
-
-                                        この値は小平面<literal>i</literal>の色を指定し,
-
-                                        小平面の境界はカレントの線種と色で描画されます.
-
-                                        <literal>color(i)</literal>が負の場合,
-
-                                        色ID <literal>-color(i)</literal> が使用され,小平面の境界は
-
-                                        描画されません.
-
-                                    </para>
-
-                                    <para>
-
-                                        <literal>data.color</literal> は大きさ(nf,n)の色行列を有します.
-
-                                        ただし, <literal>n</literal> は小平面の数,
-
-                                        <literal>nf</literal>はポリゴン小平面を定義する点の数を意味します.
-
-                                        <literal>nf</literal> 個の頂点が各小平面を定義する場合,
-
-                                        アルゴリズムはパッチ(小平面)を定義する最初の頂点の色を使用します.
-
-                                    </para>
-
-                                </listitem>
-
-                            </itemizedlist>
-
                         </listitem>
-
                     </itemizedlist>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>cdata_mapping: </term>
-
                 <listitem>
-
                     <para>
-
                         <literal>Fac3dハンドルの仕様</literal>.
-
                         <literal>'scaled'</literal> または <literal>'direct'</literal>を値とする文字列.
-
                         <literal>data.color</literal> が設定されている場合,
-
                         各インデックス色データは各頂点に単一の値を指定します.
-
                         <literal>cdata_mapping</literal> は,
-
                         これらのインデックスをカレントのカラーマップに線形にマップするようにスケーリングするか
-
                         (<literal>'scaled'</literal> モード),
-
                         このカラーマップを直接参照するか(<literal>'direct</literal>' モード)のどちらかを
-
                         選択します.
-
                         このプロパティは<literal>color_flag</literal>が <literal>2</literal>,<literal>3</literal>
-
                         または
-
                         <literal>4</literal>に等しい時に有用です.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>hiddencolor: </term>
-
                 <listitem>
-
                     <para>このフィールドは曲面の小平面の背景を描画する際に使用される
-
                         色インデックスを有します.
-
                         この値は正の整数(カレントのカラーマップの色インデックス)とします.
-
                         この値が負の場合,"visible"平面以外に同じ色が背面側に適用されます.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>clip_state: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールドはsurfaceの<literal>clip_state</literal>プロパティの
-
                         値を有します. 値は以下となります:
-
                     </para>
-
                     <itemizedlist>
-
                         <listitem>
-
                             <para>
-
                                 <literal>"off"</literal> surfaceはクリップされません.
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
                                 <literal>"clipgrf"</literal> surfaceはAxesボックスの外側でクリップ
-
                                 されます.
-
                             </para>
-
                         </listitem>
-
                         <listitem>
-
                             <para>
-
                                 <literal>"on"</literal>surfaceはclip_boxプロパティで
-
                                 指定された矩形の外側でクリップされます.
-
                             </para>
-
                         </listitem>
-
                     </itemizedlist>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>clip_box: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールドは<literal>clip_box</literal>プロパティを定義します.
-
                         clip_state が "off" の場合, デフォルトで,この値は空の行列です.
-
                         その他の場合, ベクトル <literal>[x,y,w,h]</literal> (左上の点 幅 高さ)
-
                         は表示する曲面の部分を定義しますが,
-
                         <literal>clip_state</literal>プロパティの値が変更されます.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>use_color_material: </term>
-
                 <listitem>
-
                     <para>このフィールドは拡散色を面の色に使用できるように
-
                         する際に使用されます.デフォルト値は,<literal>"on"</literal>です.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>material_shininess: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールドは, 面の輝度レベルを定義します. このパラメータは,
-
                         面に拡散する輝度色を制御します.
-
                         任意の正の値を使用可能です.
-
                         [0 10]の範囲にある値を使用すると良く,
-
                         小さい値は強いハイライトを生成し, 大きい値は単に検知できるレベルの
-
                         ハイライトを生成します.
-
                         デフォルト値は <literal>"2"</literal>です.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>ambient_color: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールドは面の環境色を定義します.
-
                         この色は,各要素が[0, 1]の範囲である
-
                         3要素ベクトル<literal>"[red, green, blue]"</literal>
-
                         により定義されます.
-
                         デフォルト値は <literal>"[1 1 1]"</literal>です.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>diffuse_color: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールドは面の拡散色を定義します.
-
                         この色は,各要素が[0, 1]の範囲である
-
                         3要素ベクトル<literal>"[red, green, blue]"</literal>
-
                         により定義されます.
-
                         このフィールドは use_color_material が無効の場合のみ使用されます.
-
                         デフォルト値は <literal>"[1 1 1]"</literal>です.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>specular_color: </term>
-
                 <listitem>
-
                     <para>
-
                         このフィールドは面の反射色を定義します.
-
                         この色は,各要素が[0, 1]の範囲である
-
                         3要素ベクトル<literal>"[red, green, blue]"</literal>
-
                         により定義されます.
-
                         デフォルト値は <literal>"[1 1 1]"</literal>です.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>user_data: </term>
-
                 <listitem>
-
                     <para>このフィールドはsurfaceデータ構造体に任意のScilab変数を
-
                         保存し,再度取得する際に使用できます.
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
         </variablelist>
-
     </refsection>
-
     <refsection>
-
         <title>例</title>
-
         <programlisting role="example"><![CDATA[
-
 //図を作成
-
 t=[0:0.3:2*%pi]'; z=sin(t)*cos(t');
-
 [xx,yy,zz]=genfac3d(t,t,z);
-
 plot3d([xx xx],[yy yy],list([zz zz+4],[4*ones(1,400) 5*ones(1,400)]))
-
 h=get("hdl") //カレントのエンティティ(ここではsurface)のハンドルを取得
-
 a=gca(); //get current axes
-
 a.rotation_angles=[40,70];
-
 a.grid=[1 1 1];
-
 //グリッドを作成
-
 a.data_bounds=[-6,0,-1;6,6,5];
-
 a.axes_visible="off";
-
 //軸は隠されている a.axes_bounds=[.2 0 1 1];
-
 f=get("current_figure");
-
 //親の図のハンドルを取得
-
 f.color_map=hotcolormap(64);
-
 //図のカラーマップを変更
-
 h.color_flag=1;
-
 //z に基づく色
-
 h.color_mode=-2;
-
 //小平面境界を削除
-
 h.color_flag=2;
-
 //指定色に基づく色
-
 h.data.color=[1+modulo(1:400,64),1+modulo(1:400,64)];
-
 //影付き
-
 h.color_flag=3;
 
-
-
 scf(2); // 2番目のウインドウを作成し,surfコマンドを使用
-
 subplot(211)
-
 surf(z,'cdata_mapping','direct','facecol','interp')
 
-
-
 subplot(212)
-
 surf(t,t,z,'edgeco','b','marker','d','markersiz',9,'markeredg','red','markerfac','k')
-
 e=gce();
-
 e.color_flag=1 // 高度 (z座標)に比例する色インデックス
-
 e.color_flag=2; // デフォルトモードに戻す
-
 e.color_flag= 3; // 補間影モード (data.colorフィールドが指定されていないため,デフォルトの青色に基づく)
-
  ]]></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="plot3d">plot3d</link>
-
             </member>
-
             <member>
-
                 <link linkend="plot3d1">plot3d1</link>
-
             </member>
-
             <member>
-
                 <link linkend="plot3d2">plot3d2</link>
-
             </member>
-
             <member>
-
                 <link linkend="surf">surf</link>
-
             </member>
-
             <member>
-
+                <link linkend="grayplot_properties">grayplot_properties</link>
+            </member>
+            <member>
+                <link linkend="Matplot_properties">Matplot_properties</link>
+            </member>
+            <member>
                 <link linkend="graphics_entities">graphics_entities</link>
-
             </member>
-
         </simplelist>
-
     </refsection>
-
-</refentry>
-
+</refentry>
\ No newline at end of file