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