* Bug 10723 fixed [doc]: subplot() page improved
[scilab.git] / scilab / modules / graphics / help / ja_JP / axes_operations / subplot.xml
index f247b63..e06e24a 100644 (file)
@@ -1,15 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
 <!--
-
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
-
  * Copyright (C) INRIA
-
- *
-
-
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2019 - 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.
  * 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="subplot">
-
+<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="subplot">
     <refnamediv>
-
         <refname>subplot</refname>
-
         <refpurpose>グラフィックウインドウをサブウインドウの行列に分割する</refpurpose>
-
     </refnamediv>
-
     <refsynopsisdiv>
-
         <title>呼び出し手順</title>
-
-        <synopsis>subplot(m,n,p)
-
+        <synopsis>
+            subplot(m,n,p)
             subplot(mnp)
-
         </synopsis>
-
     </refsynopsisdiv>
-
     <refsection>
-
         <title>引数</title>
-
         <variablelist>
-
             <varlistentry>
-
-                <term>m,n,p</term>
-
+                <term>m, n, p</term>
                 <listitem>
-
                     <para>正の整数</para>
-
                 </listitem>
-
             </varlistentry>
-
             <varlistentry>
-
                 <term>mnp</term>
-
                 <listitem>
-
                     <para>
-
                         10進表記の整数 <literal>mnp</literal>
-
                     </para>
-
                 </listitem>
-
             </varlistentry>
-
         </variablelist>
-
     </refsection>
-
     <refsection>
-
         <title>説明</title>
-
         <para>
-
             subplot(m,n,p) または subplot(mnp) はグラフィックウインドウを
-
             m行n列のサブウインドウの行列に分割し,
-
             p番目のサブウインドウを描画先として選択します.
-
             サブウインドウの番号は,行優先でカウント,つまり,
-
             行列の要素(i,j)に対応するサブウインドウは(i-1)*n + j番となります.
-
         </para>
-
+        <para>
+            When the selected area matches exactly an existing axes, <literal>subplot(…)</literal>
+            just sets it as the current axes, and returns.
+        </para>
+        <para>
+            Otherwise, <literal>subplot(…)</literal> creates an empty axes covering the selected area,
+            ready to receive forthcoming plotting contents.
+        </para>
     </refsection>
-
     <refsection>
-
         <title>例</title>
-
         <programlisting role="example"><![CDATA[
+            clf
+            subplot(221)
+            plot2d()
 
-subplot(221)
-
-plot2d()
-
-subplot(222)
-
-plot3d()
-
-subplot(2,2,3)
-
-param3d()
-
-subplot(2,2,4)
+            subplot(222)
+            plot3d()
 
-hist3d()
+            subplot(2,2,3)
+            param3d()
 
+            subplot(2,2,4)
+            hist3d()
  ]]></programlisting>
-
         <scilab:image>
-
             subplot(221)
-
             plot2d()
-
             subplot(222)
-
             plot3d()
+            subplot(2,2,3)
+            param3d()
+            subplot(2,2,4)
+            hist3d()
+        </scilab:image>
+        <para/>
+        <para>
+            <emphasis role="bold">A more complex layout</emphasis>, but still gridable:
+        </para>
+        <programlisting role="example"><![CDATA[
+            clf
+            subplot(1,2,2)
+            Matplot1()
+            xtitle("Matplot1() example","","")
+
+            subplot(2,2,1)
+            histplot
+            delete(findobj("type","Legend"))
 
             subplot(2,2,3)
+            title("Smaller plots:", "fontsize",3)
 
+            subplot(2,4,5)
+            polarplot()
+
+            subplot(2,4,6)
             param3d()
+            xtitle("","","","")
+ ]]></programlisting>
+        <scilab:image>
+            clf
+            subplot(1,2,2)
+            Matplot1()
+            xtitle("Matplot1() example","","")
 
-            subplot(2,2,4)
+            subplot(2,2,1)
+            histplot
+            delete(findobj("type","Legend"))
 
-            hist3d()
+            subplot(2,2,3)
+            title("Smaller plots:", "fontsize",3)
 
-        </scilab:image>
+            subplot(2,4,5)
+            polarplot()
 
+            subplot(2,4,6)
+            param3d()
+            xtitle("","","","")
+            gcf().axes_size = [670 400];
+        </scilab:image>
     </refsection>
-
     <refsection role="see also">
-
         <title>参照</title>
-
         <simplelist type="inline">
-
             <member>
-
-                <link linkend="plot2d">plot2d</link>
-
+                <link linkend="xsetech">xsetech</link>
             </member>
-
             <member>
-
-                <link linkend="plot3d">plot3d</link>
-
+                <link linkend="newaxes">newaxes</link>
             </member>
-
             <member>
-
-                <link linkend="xstring">xstring</link>
-
+                <link linkend="axes_properties">axes_properties</link>
             </member>
-
             <member>
-
-                <link linkend="xtitle">xtitle</link>
-
+                <link linkend="plotframe">plotframe</link>
             </member>
-
         </simplelist>
-
     </refsection>
-
-</refentry>
-
+</refentry>
\ No newline at end of file