update CHANGES and homepage before the release
[scilab.git] / scilab / modules / graphics / help / ja_JP / color_management / colorbar.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <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="colorbar">
4
5     <refnamediv>
6
7         <refname>colorbar</refname>
8
9         <refpurpose>カラーバーを描画</refpurpose>
10
11     </refnamediv>
12
13     <refsynopsisdiv>
14
15         <title>呼び出し手順</title>
16
17         <synopsis>colorbar(umin, umax [, colminmax, fmt])</synopsis>
18
19     </refsynopsisdiv>
20
21     <refsection>
22
23         <title>引数</title>
24
25         <variablelist>
26
27             <varlistentry>
28
29                 <term>umin</term>
30
31                 <listitem>
32
33                     <para>実数スカラー, プロットの最小値</para>
34
35                 </listitem>
36
37             </varlistentry>
38
39             <varlistentry>
40
41                 <term>umax</term>
42
43                 <listitem>
44
45                     <para>実数スカラー, プロットの最大値</para>
46
47                 </listitem>
48
49             </varlistentry>
50
51             <varlistentry>
52
53                 <term>colminmax</term>
54
55                 <listitem>
56
57                     <para>(オプション) 2整数の要素を有するベクトル</para>
58
59                 </listitem>
60
61             </varlistentry>
62
63             <varlistentry>
64
65                 <term>fmt</term>
66
67                 <listitem>
68
69                     <para>(オプション) カラーバーのグラデーションの表示形式を設定する
70
71                         ための文字列
72
73                     </para>
74
75                 </listitem>
76
77             </varlistentry>
78
79         </variablelist>
80
81     </refsection>
82
83     <refsection>
84
85         <title>説明</title>
86
87         <para>
88
89             plot3d, fec, Sgrayplot, etc...用にカラーバーを描画します.
90
91             この関数は, plot3d, fec, Sgrayplot,... の
92
93             <emphasis role="bold">前に</emphasis>コールする必要があります.
94
95             これは,この関数がプロットのフレームの設定を変更するためです.
96
97             この方法では,カラーバーは関連するプロットの一部ではなく,このため,
98
99             ズームや回転による修正はできません.
100
101         </para>
102
103         <para>
104
105             オプションの引数 <literal>colminmax</literal> は,
106
107             カレントのカラーマップの
108
109             (uminに関連する)最初の色と(umaxに関連する)最後の色を正確に
110
111             指定するために使用できます.
112
113             デフォルトでは <literal>colminmax=[1 nb_colors]</literal> です.ただし,
114
115             nb_colors はカレントのカラーマップの色数です.
116
117         </para>
118
119         <para>
120
121             オプションの引数<literal>fmt</literal> は,
122
123             <literal>"%.2f"</literal>, <literal>"%e"</literal>, etc...のような
124
125             C言語形式を含む文字列です.
126
127         </para>
128
129         <para>
130
131             この2つのオプションのパラメータについて,
132
133             構文 <literal>keyword=value</literal> を使用することができます
134
135             (最後の例を参照ください).
136
137         </para>
138
139     </refsection>
140
141     <refsection>
142
143         <title>例</title>
144
145         <programlisting role="example"><![CDATA[
146
147 // 例 1
148
149 x = linspace(0,1,81);
150
151 z = cos(2*%pi*x)'*sin(2*%pi*x);
152
153 zm = min(z); zM = max(z);
154
155 clf()
156
157 gcf().color_map = jetcolormap(64);
158
159 colorbar(zm,zM)
160
161 Sgrayplot(x,x,z)
162
163 xtitle("The function cos(2 pi x)sin(2 pi y)")
164
165  ]]></programlisting>
166
167         <scilab:image localized="true">
168
169             // example 1
170
171             x = linspace(0,1,81);
172
173             z = cos(2*%pi*x)'*sin(2*%pi*x);
174
175             zm = min(z); zM = max(z);
176
177             clf()
178             
179             gcf().color_map = jetcolormap(64);
180             
181             colorbar(zm,zM)
182
183             Sgrayplot(x,x,z)
184
185             xtitle("The function cos(2 pi x)sin(2 pi y)")
186
187         </scilab:image>
188
189         <programlisting role="example"><![CDATA[
190
191 // 例 2
192
193 x = linspace(0,1,81);
194
195 z = cos(2*%pi*x)'*sin(2*%pi*x);
196
197 zm = min(z); zM = max(z);
198
199 zz = abs(0.5*cos(2*%pi*x)'*cos(2*%pi*x));
200
201 zzm = min(zz); zzM = max(zz);
202
203 clf();
204
205 gcf().color_map = jetcolormap(64);
206
207
208
209 drawlater() ;
210
211 subplot(2,2,1)
212
213    colorbar(zm,zM)
214
215    Sgrayplot(x,x,z, strf="031", rect=[0 0 1 1])
216
217    xtitle("a Sgrayplot with a colorbar")
218
219 subplot(2,2,2)
220
221    colorbar(zm,zM)
222
223    plot3d1(x,x,z)
224
225    xtitle("a plot3d1 with a colorbar")
226
227 subplot(2,2,3)
228
229    colorbar(zzm,zzM)
230
231    plot3d1(x,x,zz)
232
233    xtitle("a plot3d1 with a colorbar")
234
235 subplot(2,2,4)
236
237    colorbar(zzm,zzM)
238
239    Sgrayplot(x,x,zz, strf="031", rect=[0 0 1 1])
240
241    xtitle("a Sgrayplot with a colorbar")
242
243 drawnow() ;
244
245  ]]></programlisting>
246
247         <scilab:image localized="true">
248
249             x = linspace(0,1,81);
250
251             z = cos(2*%pi*x)'*sin(2*%pi*x);
252
253             zm = min(z); zM = max(z);
254
255             zz = abs(0.5*cos(2*%pi*x)'*cos(2*%pi*x));
256
257             zzm = min(zz); zzM = max(zz);
258
259             clf();
260             
261             gcf().color_map = jetcolormap(64);
262             
263             drawlater();
264
265             subplot(2,2,1)
266
267             colorbar(zm,zM)
268
269             Sgrayplot(x,x,z, strf="031", rect=[0 0 1 1])
270
271             xtitle("a Sgrayplot with a colorbar")
272
273             subplot(2,2,2)
274
275             colorbar(zm,zM)
276
277             plot3d1(x,x,z)
278
279             xtitle("a plot3d1 with a colorbar")
280
281             subplot(2,2,3)
282
283             colorbar(zzm,zzM)
284
285             plot3d1(x,x,zz)
286
287             xtitle("a plot3d1 with a colorbar")
288
289             subplot(2,2,4)
290
291             colorbar(zzm,zzM)
292
293             Sgrayplot(x,x,zz, strf="031", rect=[0 0 1 1])
294
295             xtitle("a Sgrayplot with a colorbar")
296
297             drawnow() ;
298
299
300
301         </scilab:image>
302
303
304
305         <programlisting role="example"><![CDATA[
306
307 // 例 3
308
309 x = linspace(0,1,81);
310
311 zz = abs(0.5*cos(2*%pi*x)'*cos(2*%pi*x));
312
313 zzm = min(zz); zzM = max(zz);
314
315 [xf,yf,zf]=genfac3d(x,x,zz);
316
317 nb_col = 64;
318
319 clf()
320
321 gcf().color_map = hotcolormap(nb_col);
322
323 drawlater() ;
324
325 colorbar(zzm,zzM,[1, nb_col],fmt="%.1f")
326
327 zcol = dsearch(zf, linspace(zzm, zzM, nb_col+1));
328
329 plot3d(xf, yf, list(zf, zcol), flag = [-2 6 4])
330
331 xtitle("a plot3d with shaded interpolated colors")
332
333 drawnow() ;
334
335 show_window()
336
337  ]]></programlisting>
338
339         <scilab:image localized="true">
340
341             x = linspace(0,1,81);
342
343             zz = abs(0.5*cos(2*%pi*x)'*cos(2*%pi*x));
344
345             zzm = min(zz); zzM = max(zz);
346
347             [xf,yf,zf]=genfac3d(x,x,zz);
348
349             nb_col = 64;
350
351             gcf().color_map = hotcolormap(nb_col);
352
353             colorbar(zzm,zzM,[1, nb_col],fmt="%.1f")
354
355             zcol = dsearch(zf, linspace(zzm, zzM, nb_col+1));
356
357             plot3d(xf, yf, list(zf, zcol), flag = [-2 6 4])
358
359             xtitle("a plot3d with shaded interpolated colors")
360
361         </scilab:image>
362
363     </refsection>
364
365     <refsection role="see also">
366
367         <title>参照</title>
368
369         <simplelist type="inline">
370
371             <member>
372
373                 <link linkend="colormap">colormap</link>
374
375             </member>
376
377         </simplelist>
378
379     </refsection>
380
381 </refentry>
382