Fix help issues (warnings + wrong format in files)
[scilab.git] / scilab / modules / graphics / help / ja_JP / polygon / xfpolys.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  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
11  *
12  -->
13 <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="xfpolys">
14     <refnamediv>
15         <refname>xfpolys</refname>
16         <refpurpose>一連のポリゴンを塗りつぶす </refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>呼び出し手順</title>
20         <synopsis>xfpolys(xpols,ypols,[fill])</synopsis>
21     </refsynopsisdiv>
22     <refsection>
23         <title>パラメータ</title>
24         <variablelist>
25             <varlistentry>
26                 <term>xpols,ypols</term>
27                 <listitem>
28                     <para>同じ大きさ (p,n) (ポリゴンの点)の行列.</para>
29                 </listitem>
30             </varlistentry>
31             <varlistentry>
32                 <term>fill</term>
33                 <listitem>
34                     <para>大きさ n または大きさ (p,n)のベクトル</para>
35                 </listitem>
36             </varlistentry>
37         </variablelist>
38     </refsection>
39     <refsection>
40         <title>説明</title>
41         <para>
42             <literal>xfpolys</literal>は
43             行列<literal>xpols</literal> および<literal>ypols</literal>
44             で定義された同じ大きさの一連のポリゴンを塗りつぶします.
45             各ポリゴンの座標は<literal>xpols</literal> および <literal>ypols</literal>
46             の列に保存されます.
47         </para>
48         <para>ポリゴンは指定した色で塗られるか(フラット),もしくは,
49             補間色(影付き)で塗られます.
50         </para>
51         <variablelist>
52             <varlistentry>
53                 <term>フラット彩色</term>
54                 <listitem>
55                     <para>
56                         この場合, <literal>fill</literal>は
57                         大きさ<literal>n</literal>のベクトルとなります.
58                         ポリゴン番号 i を塗るパターンは
59                         <literal>fill(i)</literal>で指定されます:
60                     </para>
61                     <itemizedlist>
62                         <listitem>
63                             <para>
64                                 <literal>fill(i)&lt;0</literal>の場合, ポリゴンは
65                                 パターンID <literal>-fill(i)</literal>で塗られます.
66                             </para>
67                         </listitem>
68                         <listitem>
69                             <para>
70                                 <literal>fill(i)=0</literal>の場合, ポリゴンは
71                                 カレントの破線(またはカレントの色)で描画され,
72                                 塗られません.
73                             </para>
74                         </listitem>
75                         <listitem>
76                             <para>
77                                 <literal>fill(i)&gt;0</literal>の場合, 
78                                 ポリゴンはパターンID <literal>fill(i)</literal>で
79                                 塗られます. この後, 等高線がカレントの破線(または色)が描画され,
80                                 および必要に応じて閉じられます.
81                             </para>
82                         </listitem>
83                     </itemizedlist>
84                 </listitem>
85             </varlistentry>
86             <varlistentry>
87                 <term>補間色彩色</term>
88                 <listitem>
89                     <para>
90                         この場合,<literal>fill</literal> は,
91                         <literal>xpols</literal> および <literal>ypols</literal>と
92                         同じ大きさの行列となります.
93                         <literal>p</literal> は 3 または 4とします.
94                     </para>
95                     <para>
96                         <literal>fill(k,i)</literal>はポリゴン<literal>i</literal>の
97                         <literal>k</literal>番目の縁の色を指定します.
98                     </para>
99                 </listitem>
100             </varlistentry>
101         </variablelist>
102     </refsection>
103     <refsection>
104         <title>例</title>
105         <programlisting role="example"><![CDATA[ 
106 a=gca();
107 a.data_bounds=[0,-10;210,40];
108 a.foreground=color('red');
109 x1=[0,10,20,30,20,10,0]';
110 y1=[15,30,30,15,0,0,15]';
111 xpols=[x1 x1 x1 x1];
112 xpols=xpols+[0,60,120,180].*.ones(x1);
113 ypols=[y1 y1 y1 y1];
114 xfpolys(xpols,ypols,[-1,0,1,2])
115  ]]></programlisting>
116         <scilab:image>
117             a=gca();
118             a.data_bounds=[0,-10;210,40];
119             a.foreground=color('red');
120             x1=[0,10,20,30,20,10,0]';
121             y1=[15,30,30,15,0,0,15]';
122             xpols=[x1 x1 x1 x1];
123             xpols=xpols+[0,60,120,180].*.ones(x1);
124             ypols=[y1 y1 y1 y1];
125             xfpolys(xpols,ypols,[-1,0,1,2])
126         </scilab:image>
127         
128         <programlisting role="example"><![CDATA[ 
129 // 補間色
130 clf()
131 f=gcf();
132 a=gca();
133 a.data_bounds=[0,-10;40,30];
134 a.isoview='on';
135 x1=[0,10,20,10]';
136 y1=[10,0,10,20]';
137 c=linspace(2,100,4)';
138 xpols=[x1 x1+20 x1+10 x1+10];
139 ypols=[y1 y1    y1+10 y1-10];
140 cols= [c c($:-1:1) c([3 4 1 2]) c]
141 f.color_map=jetcolormap(max(cols));
142 xfpolys(xpols,ypols,cols)
143  ]]></programlisting>
144         <scilab:image>
145             f=gcf();
146             a=gca();
147             a.data_bounds=[0,-10;40,30];
148             a.isoview='on';
149             x1=[0,10,20,10]';
150             y1=[10,0,10,20]';
151             c=linspace(2,100,4)';
152             xpols=[x1 x1+20 x1+10 x1+10];
153             ypols=[y1 y1    y1+10 y1-10];
154             cols= [c c($:-1:1) c([3 4 1 2]) c]
155             f.color_map=jetcolormap(max(cols));
156             xfpolys(xpols,ypols,cols)
157         </scilab:image>
158         <programlisting role="example"><![CDATA[   
159 // 補間色
160 clf()
161 f=gcf();
162 x11=[0;20;20;0];
163 y11=[10;10;30;30];
164 c11=[10;10;30;30];
165 x12=x11;
166 y12=y11+20;
167 c12=[20;20;1;1];
168 c12=[30;30;10;10];
169 x21=[0;30;30;0]+22;
170 y21=[20;20;30;30];
171 c21=[20;20;30;30];
172 x22=x21;
173 y22=y21+10;
174 c22=[30;30;20;20];
175 x31=[0;40;40;0]+55;
176 y31=[0;0;30;30];
177 c31=[0;0;30;30];
178 x32=x31;
179 y32=y31+30;
180 c32=[30;30;0;0];
181 X=[x11 x12 x21 x22 x31 x32];
182 Y=[y11 y12 y21 y22 y31 y32];
183 C=([c11 c12 c21 c22 c31 c32]+1)*5;
184 a=gca();
185 a.isoview='on';
186 a.data_bounds=[min(X),min(Y);max(X),max(Y)];
187 f=gcf();
188 f.color_map=graycolormap(max(C));
189 xfpolys(X,Y,C)
190  ]]></programlisting>
191         <scilab:image>
192             clf()
193             f=gcf();
194             x11=[0;20;20;0];
195             y11=[10;10;30;30];
196             c11=[10;10;30;30];
197             x12=x11;
198             y12=y11+20;
199             c12=[20;20;1;1];
200             c12=[30;30;10;10];
201             x21=[0;30;30;0]+22;
202             y21=[20;20;30;30];
203             c21=[20;20;30;30];
204             x22=x21;
205             y22=y21+10;
206             c22=[30;30;20;20];
207             x31=[0;40;40;0]+55;
208             y31=[0;0;30;30];
209             c31=[0;0;30;30];
210             x32=x31;
211             y32=y31+30;
212             c32=[30;30;0;0];
213             X=[x11 x12 x21 x22 x31 x32];
214             Y=[y11 y12 y21 y22 y31 y32];
215             C=([c11 c12 c21 c22 c31 c32]+1)*5;
216             a=gca();
217             a.isoview='on';
218             a.data_bounds=[min(X),min(Y);max(X),max(Y)];
219             f=gcf();
220             f.color_map=graycolormap(max(C));
221             xfpolys(X,Y,C)
222         </scilab:image>
223         
224     </refsection>
225     <refsection role="see also">
226         <title>参照</title>
227         <simplelist type="inline">
228             <member>
229                 <link linkend="xfpoly">xfpoly</link>
230             </member>
231             <member>
232                 <link linkend="xpoly">xpoly</link>
233             </member>
234             <member>
235                 <link linkend="xpolys">xpolys</link>
236             </member>
237         </simplelist>
238     </refsection>
239 </refentry>