<?xml version="1.0" encoding="Shift_JIS" ?>
<doc>
<title>前景を表示しよう</title>

<para>
<ptitle>前景とは</ptitle>
　前景とは・・・要するに、人物の立ちポーズなど、背景とメッセージの間に表示されるものです。KAG では標準で 3 つまで重ね合わせて表示できます ( カスタマイズすればもっと重ね合わせて表示できます )。<r/>
<r/>
　前景は、人物などの形に画像を切り取って表示するために、マスクあるいはカラーキーという手法を使います。KAG では、マスクを使って前景を表示する方法と、カラーキーを使って画像を表示する方法の両方、PNG や ERI や TLG5/TLG6 画像のように画像そのものにアルファチャネルや透過情報を含むことができる場合はその画像固有の方法を用いて透過させることができます。<r/>
</para>

<para>
<ptitle>カラーキーを使った前景</ptitle>
　カラーキーとは、透明になるべき部分を特定の一色で塗りつぶし、その色の部分が透明になる、というものです。<r/>
　これは画像が フルカラーの場合と 256 色や 16 色の場合で少々扱いが違います。<r/>
<r/>
　フルカラーの場合は、つまり「つかわなさそー」な色を「<kw>抜き色</kw>」( カラーキー ) として、透明にしたい部分をそれで塗るわけです。使われなさそうな色としては、真マゼンダ (r,g,b)=(255,0,255) や、真緑 (r,g,b)=(0,255,0) がよく使われるようです。<r/>
　でもそうするとマゼンダや緑を表現したい場合はどうするの？ということになりますが、(r,g,b)=(254,0,255) や (r,g,b)=(0,254,0) という色を使えば KAG では別の色として処理されるので OK です。<r/>
<r/>
　256 色の画像や 16 色の画像では、ある一つの<kw>パレットインデックス</kw>を「透明色」として使います。このパレットインデックスで塗りつぶされた部分が透明になるのです。<r/>
<r/>
<note>
　PNG などの画像形式の場合は保存時に<kw>透明色</kw>(カラーキー)を指定できるようなソフトがありますが、そのようなソフトで出力された PNG 画像も扱うことができます。
</note>
<r/>
<descimg>
<dititle>抜き色の例</dititle>
<img src="ButtonGlyphImageList.png"/>
</descimg>
</para>

<para>
<ptitle>マスクを使った前景</ptitle>
　KAG では、普通の前景画像とは別に、マスク画像と呼ばれるものを用意して、そのマスク画像に従って前景画像を切り抜くようにして表示することができます。<r/>
<r/>
　<kw>マスク画像</kw>は、前景画像と同じサイズの 256 階調グレースケールの画像で、輝度がそのまま「不透明度」を示します。つまり、輝度 0 の部分は「全く透明」で輝度 255 の部分は「全く不透明」です。128 ぐらいのところは「半分程度の透明」ということとなります。表示されるべき部分が白くて、透明な部分は黒いという画像になります。<r/>
　マスク画像は必ず 256 階調のグレースケール ( 256 色画像 ) で保存してください。フルカラーや16色で保存すると正常に表示されません。<r/>
　マスク画像は不透明度を保持する画像ですが、これに対して前景画像は色の情報を保持する画像となります。この場合の前景画像をとくに<kw>メイン画像</kw>と呼んでいます。<r/>
<note>
　PNGやERI、TLG5/TLG6 形式の画像の場合は、一つの PNG/ERI/TLG5 ファイル内に<kw>アルファチャネル</kw> ( つまるところのマスク画像 ) を含めることができます。<r/>
　そういう画像を出力できるソフト ( PNG では GIMP 等 ) をお持ちの方は、それを使えばマスクファイルを別に用意する必要はありません。また、吉里吉里 SDK 付属の画像フォーマットコンバータを用いればこれらの画像形式の変換を簡単に行うことができます。</note>
<r/>
　マスク画像は、メイン画像のファイル名に _m をつけた名前で保存します。たとえばメイン画像が hogehoge.png であれば、そのマスク画像は hogehoge_m.png となります。この、メイン画像とマスク画像の分離した形式をメイン/マスク分離形式と呼んでいます。<r/>
<r/>
　マスク画像を使う利点は、前景を重ね合わせるときに自由に不透明度を指定できるのと、適切に処理したマスク画像とメイン画像を使えば、重ね合わせるときに、その縁をきれいにアンチエイリアスのかかった状態で重ね合わせることができると言うことです。<r/>
<descimg>
<dititle>マスク例 ( 左がメイン、右がマスク )</dititle>
<img src="ayari.png"/>
<img src="ayari_m.png"/>
</descimg>
</para>

<para>
<ptitle>前景を表示しよう</ptitle>
　では、これに従って適当な画像を用意してください ( 画像は各自でご用意願います... )。まず、カラーキーを使った前景の表示方法から・・・。<r/>
<bq>
[image storage="bg0" page=fore layer=base]<r/>
[wait time=200]<r/>
*start|スタート<r/>
[cm]<r/>
<b>[image layer=0 page=fore storage="as" visible=true key=0xff00ff left=340 top=100]</b><r/>
こんにちは。<r/>
</bq>
　太字で示されている部分が前景画像を表示している部分です。<kw>image</kw> タグは、<link href="DispBase"/> でも出てきました。画像を読み込むためのタグです。layer に 0 として、前景レイヤの 0 番を指定しています。<r/>
　ここで、 key という属性があります。key 属性は、抜き色を指定するための属性です。このように 0xRRGGBB という形式で 16 進数で抜き色を指定すると、RR(赤) GG(緑) BB(青)で塗られた部分を抜き色として透明にします。たとえば、key=0xff00ff では (r,g,b)=(255,0,255) つまり真マゼンダの部分を抜き色として透明にするという指定になります。もし、key=255 と指定すると、key には 255 で示されたパレットインデックスがカラーキーになります。詳しくは <link href="Tags"/> を参照してください。<r/>
<r/>
　storage="as" としてありますが、これは as という名の画像を読み込むという指令です。拡張子は指定しなくてかまいません。この場合は as という名のファイルのうち、読み込み可能な画像を自動的に探して読み込みます。<r/>
<r/>
　visible=true としているのは、KAG の前景レイヤは、標準では全部非表示なので、ここで表示する設定にしないと表示されないのです。<r/>
<r/>
　left=340 top=100 としているのは、前景レイヤの左端位置と上端位置を指定しています。前景レイヤは、image タグで読み込むときに表示位置を指定できます。<r/>
<note>
　PNG 画像中の表示オフセット指定は無視されます。
</note>
<r/>
　また、マスク画像を使うとなると以下のような指定の仕方になります。<r/>
<bq>
[image storage="bg0" page=fore layer=base]<r/>
[wait time=200]<r/>
*start|スタート<r/>
[cm]<r/>
<b>[image layer=0 page=fore storage="asm" visible=true left=340 top=100]</b><r/>
こんにちは。<r/>
</bq>
　といっても key 属性が無いだけですね。<r/>
　この例の場合、読み込まれる画像は asm_m という名の画像がマスク画像として、asm という名の画像がメイン画像として読み込まれます。<r/>
<r/>
　PNG のように画像中にアルファチャネル情報やカラーキーを持つことのできる画像形式を用いる場合は上記の例と同じで、key 属性を指定する必要はありません。<r/>
<descimg>
<dititle>実行結果</dititle>
<img src="LayerDisplayed.jpg"/>
</descimg>
</para>
</doc>
