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