53dbe91eb5f5eaa0de56abd80cfb28d2a07103bd
[scilab.git] / scilab / modules / graphics / help / ja_JP / axes_operations / zoom_rect.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  * Copyright (C) INRIA - 2008 - Jean-Baptiste Silvy
6  * 
7  * This file must be used under the terms of the CeCILL.
8  * This source file is licensed as described in the file COPYING, which
9  * you should have received as part of this distribution.  The terms
10  * are also available at    
11  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
12  *
13  -->
14 <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="zoom_rect">
15     <refnamediv>
16         <refname>zoom_rect</refname>
17         <refpurpose>カレントのグラフィック図の選択した部分をズーム</refpurpose>
18     </refnamediv>
19     <refsynopsisdiv>
20         <title>呼び出し手順</title>
21         <synopsis>zoom_rect()
22             zoom_rect(rect)
23             zoom_rect(h)
24             zoom_rect(h,rect)
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection>
28         <title>パラメータ</title>
29         <variablelist>
30             <varlistentry>
31                 <term>rect</term>
32                 <listitem>
33                     <para>
34                         大きさ 4のベクトル <literal>[xmin,ymin,xmax,ymax]</literal> で,
35                         ズームする矩形を指定します.
36                     </para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>h</term>
41                 <listitem>
42                     <para>Figure または Axes型のグラフィックハンドル. ズームを適用するAxesを指定します.</para>
43                 </listitem>
44             </varlistentry>
45         </variablelist>
46     </refsection>
47     <refsection>
48         <title>説明</title>
49         <para>
50             <literal>zoom_rect</literal> 関数はAxesオブジェクトの中をズームする際に使用されます.
51         </para>
52         <para>
53             入力引数<literal>h</literal>はズームを適用するAxesを指定します.
54             <literal>h</literal>が Figureハンドルの場合, ズームはその子のAxesに適用されます.
55             <literal>h</literal> がAxesハンドルの場合,このハンドルのみにズームが適用されます.
56             <literal>h</literal> が指定されない場合,カレントのFigureにズームが適用されます.
57         </para>
58         <para>
59             入力引数<literal>rect</literal> が指定された場合,ズームされるAxesの
60             プロパティ<literal>zoom_box</literal>はこの引数により修正されます
61             (<link linkend="axes_properties">axes_properties</link>参照).
62             XおよびY軸の境界は<literal>rect</literal>で置換されます.
63             <literal>rect</literal>が指定されない場合,zoom_rectは対話的なズームとなります.
64             ユーザはマウスで矩形を選択する必要があります.
65             ズームされた軸の新しい<literal>zoom_box</literal> プロパティは
66             矩形の交点を見つけることにより計算されます.
67         </para>
68     </refsection>
69     <refsection>
70         <title>例</title>
71         <programlisting role="example"><![CDATA[ 
72 clf()
73 x=0:0.01:6*%pi;
74 plot2d(x,sin(x^2))
75 zoom_rect([16,-1,18,1])
76 //もっとズーム
77 zoom_rect([16,0,16.2,1])
78 //元に戻す
79 unzoom()
80 // axes_propertiesによりズーム
81 a=gca();
82 a.zoom_box=[16,0,16.2,1];
83 a.zoom_box=[];
84
85 //サブプロットを適当にズーム
86 clf()
87 x=0:0.01:6*%pi;
88 subplot(211)
89 plot2d(x,cos(x))
90 subplot(212)
91 plot2d(x,cos(2*x))
92 rect=[3 -2 7 10]; //カレントの軸(直近の軸)で指定された矩形座標
93 zoom_rect(rect) 
94 unzoom()
95 //グローバルな軸をカレントの軸に設定
96 f=gcf();set('current_axes',f.children($)) 
97 rect=[0.4 0 0.6 1] //ウインドウの大きさの比で指定した矩形
98 zoom_rect(rect) 
99 rect=[0.4 0.2 0.6 0.8]; //ウインドウの大きさの比で指定した矩形
100 zoom_rect(rect)
101
102 // カレントの図を対話的にズーム
103 zoom_rect();
104 // or
105 zoom_rect(gcf());
106  ]]></programlisting>
107     </refsection>
108     <refsection role="see also">
109         <title>参照</title>
110         <simplelist type="inline">
111             <member>
112                 <link linkend="unzoom">unzoom</link>
113             </member>
114             <member>
115                 <link linkend="axes_properties">axes_properties</link>
116             </member>
117         </simplelist>
118     </refsection>
119 </refentry>