* Bug 6070 fixed [doc]: Documenting How to make multiscaled plots
[scilab.git] / scilab / modules / graphics / help / ja_JP / axes_operations / newaxes.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) INRIA - Serge Steer
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
18           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
19           xml:lang="ja" xml:id="newaxes">
20     <refnamediv>
21         <refname>newaxes</refname>
22         <refpurpose>新しいAxesエンティティを作成 </refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>呼び出し手順</title>
26         <synopsis>
27             a = newaxes()
28             a = newaxes(h)
29         </synopsis>
30     </refsynopsisdiv>
31     <refsection>
32         <title>引数</title>
33         <variablelist>
34             <varlistentry>
35                 <term>h</term>
36                 <listitem>
37                   <para>
38                     Optional handle of the graphic parent of the new axes,
39                     of type <literal>Figure</literal> or
40                     <literal>Uicontrol</literal> of style <literal>Frame</literal>.
41                     By default, the current figure is used.
42                   </para>
43                 </listitem>
44             </varlistentry>
45             <varlistentry>
46                 <term>a</term>
47                 <listitem>
48                     <para>ハンドル, 新たに作成された Axesエンティティのハンドル</para>
49                 </listitem>
50             </varlistentry>
51         </variablelist>
52     </refsection>
53     <refsection>
54         <title>説明</title>
55         <para>
56             <literal>newaxes()</literal> は,カレントの図に新しい<literal>Axes</literal>
57             エンティティ(
58             <link linkend="graphics_entities">graphics_entities</link>参照)を
59             作成する際に使用されます.
60             このエンティティのプロパティは<literal>default_axes</literal>
61             (<link linkend="gda">gda</link>参照)
62             から継承されます.
63         </para>
64     </refsection>
65     <refsection>
66         <title>例</title>
67         <programlisting role="example"><![CDATA[
68 clf()
69 a1 = newaxes();
70 a1.axes_bounds = [0,0,1.0,0.5];
71 t = 0:0.1:20;
72 plot(t,acosh(t),'r')
73 a2 = newaxes();
74 a2.axes_bounds = [0,0.5,1.0,0.5];
75 x = 0:0.1:4;
76 plot(x,sinh(x))
77 legend('sinh')
78
79 sca(a1); //最初の軸をカレントとする
80 plot(t,asinh(t),'g')
81 legend(['acosh','asinh'])
82  ]]></programlisting>
83         <para>
84             The following example uses <literal>newaxes(h)</literal>
85         </para>
86         <programlisting role="example"><![CDATA[
87 // Create a new figure
88 f = figure("layout", "gridbag", ...
89     "toolbar", "none", ...
90     "menubar", "none", ...
91     "backgroundcolor", [1 1 1]);
92
93 // Create the frames where each graph is put
94 c = createConstraints("gridbag", [1 1 1 1], [1 1], "both");
95 top_left = uicontrol(f, "style", "frame","constraints", c);
96
97 c.grid = [2 1 1 1];
98 top_right = uicontrol(f, "style", "frame", "constraints", c);
99
100 c.grid = [1 2 2 2];
101 bottom = uicontrol(f, "style", "frame", "constraints", c);
102
103 // Create the axes in each frame
104 a_tl = newaxes(top_left);
105 a_tr = newaxes(top_right);
106 a_bt = newaxes(bottom);
107
108 // Plot in the frames
109 X = (1:100) ./ 50;
110 plot(a_tl, X, X, "r");
111 plot(a_tr, X, cos(2 * %pi * 3 * X), "g");
112 plot(a_bt, X, exp(X), "b");
113
114 title(a_tl, "a line");
115 title(a_tr, "a cosine");
116 title(a_bt, "the exponential");
117     ]]></programlisting>
118     </refsection>
119     <refsection role="see also">
120         <title>参照</title>
121         <simplelist type="inline">
122             <member>
123                 <link linkend="plot_multiscaled">Multiscaled plots</link>
124             </member>
125             <member>
126                 <link linkend="subplot">subplot</link>
127             </member>
128             <member>
129                 <link linkend="xsetech">xsetech</link>
130             </member>
131             <member>
132                 <link linkend="gda">gda</link>
133             </member>
134             <member>
135                 <link linkend="sca">sca</link>
136             </member>
137         </simplelist>
138     </refsection>
139     <refsection role="history">
140         <title>履歴</title>
141         <revhistory>
142             <revision>
143                 <revnumber>5.5.0</revnumber>
144                 <revdescription>
145                     newaxes(h) can target a uicontrol frame or a given figure.
146                 </revdescription>
147             </revision>
148         </revhistory>
149     </refsection>
150 </refentry>