* Bug 6070 fixed [doc]: Documenting How to make multiscaled plots
[scilab.git] / scilab / modules / graphics / help / ja_JP / axis / drawaxis.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) ENPC - Jean-Philippe Chancelier
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" 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="drawaxis">
17     <refnamediv>
18         <refname>drawaxis</refname>
19         <refpurpose>軸を描画</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>呼び出し手順</title>
23         <synopsis>drawaxis([options])
24             // options: x,y,dir,sub_int,fontsize,format_n,seg,textcolor,ticscolor,tics
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>引数</title>
29         <variablelist>
30             <varlistentry>
31                 <term>dir=文字列</term>
32                 <listitem>
33                     <para>メモリの方向を指定するために使用されます.
34                         <literal>string</literal> には'u','r','d','l'のどれかを指定し,
35                         'l'がデフォルト値です.
36                         値  'u','r','d','l' はそれぞれ up, right, down, leftを意味します.
37                     </para>
38                 </listitem>
39             </varlistentry>
40             <varlistentry>
41                 <term>tics=文字列</term>
42                 <listitem>
43                     <para>
44                         目盛の指定方法を記述するフラグ.
45                         <literal>string</literal> には'v','r', および 'i'のどれかを指定し,
46                         'v'がデフォルト値です
47                     </para>
48                 </listitem>
49             </varlistentry>
50             <varlistentry>
51                 <term>x,y</term>
52                 <listitem>
53                     <para>目盛の位置を指定するベクトル.</para>
54                 </listitem>
55             </varlistentry>
56             <varlistentry>
57                 <term>val= 文字列行列</term>
58                 <listitem>
59                     <para>文字列行列で, 指定された場合,
60                         目盛の位置で軸に沿って描画される文字列を指定します.
61                     </para>
62                 </listitem>
63             </varlistentry>
64             <varlistentry>
65                 <term>fontsize=整数</term>
66                 <listitem>
67                     <para>
68                         軸に沿って表示される数値で使用されるフォントの大きさを指定します.
69                         デフォルト値はカレントのフォントサイズを意味する <literal>-1</literal> です
70                     </para>
71                 </listitem>
72             </varlistentry>
73             <varlistentry>
74                 <term>format_n=文字列</term>
75                 <listitem>
76                     <para>
77                         軸に沿って表示される数値のフォーマットで,<literal>string</literal>には
78                         C言語のprintf関数の構文形式に基づくフォーマット(例えば<literal>string="%.3f"</literal>)を指定します.
79                     </para>
80                 </listitem>
81             </varlistentry>
82             <varlistentry>
83                 <term>seg= 1 または 0</term>
84                 <listitem>
85                     <para>
86                         軸のベースセグメントの表示を制御するフラグ (デフォルト値は 1です).
87                     </para>
88                 </listitem>
89             </varlistentry>
90             <varlistentry>
91                 <term>sub_int=整数</term>
92                 <listitem>
93                     <para>
94                         大きな目盛の間に描画されるサブ間隔(目盛)の数を指定する整数.
95                     </para>
96                 </listitem>
97             </varlistentry>
98             <varlistentry>
99                 <term>textcolor=整数</term>
100                 <listitem>
101                     <para>
102                         軸に沿って表示される値で使用される色を指定します.
103                         デフォルト値はカレントの色を意味する <literal>-1</literal> です.
104                     </para>
105                 </listitem>
106             </varlistentry>
107             <varlistentry>
108                 <term>ticscolor=整数</term>
109                 <listitem>
110                     <para>目盛の描画で使用される色を指定します. デフォルト値はカレントの色を意味する
111                         <literal>-1</literal> です.
112                     </para>
113                 </listitem>
114             </varlistentry>
115         </variablelist>
116     </refsection>
117     <refsection>
118         <title>説明</title>
119         <para>
120             <literal>drawaxis</literal> は垂直または水平方向の
121             軸を描画する際に使用されます.
122             軸の方向は dir で指定され,
123             <literal>dir = 'u'</literal> または <literal>'d'</literal>は
124             目盛が増加 (<literal>'u'</literal>)または減少(<literal>'d'</literal>)
125             する水平軸を指定します.
126             <literal>dir = 'r'</literal> または <literal>'l'</literal>は
127             右方向(<literal>'r'</literal>) または左方向 (<literal>'l'</literal>)の
128             目盛を有する垂直軸を指定します.
129         </para>
130         <para>
131             <literal>x</literal> および <literal>y</literal> は軸の目盛の位置を指定します.
132             軸が水平軸の場合,<literal>y</literal> はスカラーまたは省略する必要があり,
133             <literal>x</literal> はScilabベクトルとします.
134             <literal>x</literal>の意味は<literal>tics</literal>で制御されます.
135         </para>
136         <para>
137             <literal>tics='v'</literal>の場合, <literal>x</literal> は x軸方向の目盛の
138             位置を指定します.
139         </para>
140         <para>
141             <literal>tics='r'</literal>の場合, <literal>x</literal> の大きさは3である必要があります.
142             <literal>x=[xmin,xmax,n]</literal>で,
143             <literal>n</literal> は間隔の数を指定します.
144         </para>
145         <para>
146             <literal>tics='i'</literal>の場合, <literal>x</literal> は大きさ4の
147             <literal>x=[k1,k2,a,n]</literal>とします.
148             <literal>xmin=k1*10^a</literal>, <literal>xmax=k2*10^a</literal>で,
149             <literal>n</literal> は間隔の数を指定します.
150         </para>
151         <para>
152             <literal>y</literal> が省略された場合,軸は,<literal>dir='u'</literal>の場合に
153             フレームの上部,<literal>dir='d'</literal>の場合にフレームの下部
154             に配置されます.
155         </para>
156         <para>
157             デフォルトで,軸に沿って数値が描画されます.
158             これらの数値はデフォルトのフォーマットで描画されますが,
159             このフォーマットは<literal>format_n</literal>で変更可能です.
160             数値ではなく文字列を表示することも可能で,
161             <literal>val</literal>を指定した場合に文字列が表示されます.
162             <literal>val</literal> の大きさは目盛の数に一致する必要があります.
163         </para>
164     </refsection>
165     <refsection>
166         <title>例</title>
167         <programlisting role="example"><![CDATA[
168 plot2d(1:10,1:10,1,"020")
169 // 水平軸
170 drawaxis(x=2:7,y=4,dir='u',tics='v')
171 // フレームの上部に水平軸
172 drawaxis(x=2:7,dir='u',tics='v')
173 // フレームの下部に水平軸
174 drawaxis(x=2:7,dir='d',tics='v')
175
176 // 範囲で指定した水平軸
177 drawaxis(x=[2,7,3],y=4,dir='d',tics='r')
178
179 // 垂直軸
180 drawaxis(x=4,y=2:7,dir='r',tics='v')
181 drawaxis(x=2,y=[2,7,3],dir='l',tics='r')
182 drawaxis(y=2:7,dir='r',tics='v')
183 drawaxis(y=2:7,dir='l',tics='v')
184
185 // 目盛位置に表示する文字列を指定した水平軸
186 drawaxis(x=2:7,y=8,dir='u',tics='v',val='A'+string(1:6));
187 // vertical axis with strings displayed at tics positions
188 drawaxis(x=8,y=2:7,dir='r',tics='v',val='B'+string(1:6));
189
190 // 'i' 範囲で指定した水平軸.
191 drawaxis(x=[2,5,0,3],y=9,dir='u',tics='i');
192 drawaxis(x=9,y=[2,5,0,3],dir='r',tics='i',sub_int=5);
193
194 // 再び水平軸
195 drawaxis(x=2:7,y=4,dir='u',tics='v',fontsize=10,textcolor=9,ticscolor=7,seg=0,sub_int=20)
196  ]]></programlisting>
197         <scilab:image>
198             plot2d(1:10,1:10,1,"020")
199             drawaxis(x=2:7,y=4,dir='u',tics='v')
200             drawaxis(x=2:7,dir='u',tics='v')
201             drawaxis(x=2:7,dir='d',tics='v')
202             drawaxis(x=[2,7,3],y=4,dir='d',tics='r')
203             drawaxis(x=4,y=2:7,dir='r',tics='v')
204             drawaxis(x=2,y=[2,7,3],dir='l',tics='r')
205             drawaxis(y=2:7,dir='r',tics='v')
206             drawaxis(y=2:7,dir='l',tics='v')
207             drawaxis(x=2:7,y=8,dir='u',tics='v',val='A'+string(1:6));
208             drawaxis(x=8,y=2:7,dir='r',tics='v',val='B'+string(1:6));
209             drawaxis(x=[2,5,0,3],y=9,dir='u',tics='i');
210             drawaxis(x=9,y=[2,5,0,3],dir='r',tics='i',sub_int=5);
211             drawaxis(x=2:7,y=4,dir='u',tics='v',fontsize=10,textcolor=9,ticscolor=7,seg=0,sub_int=20)
212         </scilab:image>
213     </refsection>
214     <refsection role="see also">
215         <title>参照</title>
216         <simplelist type="inline">
217             <member>
218                 <link linkend="plot_multiscaled">Multiscaled plots</link>
219             </member>
220             <member>
221                 <link linkend="axis_properties">axis_properties</link>
222             </member>
223         </simplelist>
224     </refsection>
225 </refentry>