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>