======================================================================
       the GIMP G-Pen + MixBrushパッチ（2.4移植＆勝手改造版）
======================================================================

これは、しげっち氏のMixBrushツールとG-Penツールをthe GIMP 2.4.0に移植
し、Windows用にビルドしたものです。
MixBrushツールについては、当方で勝手に改造を加えてあります。


■G-Pen + MixBrushパッチ

イラストを描くという用途においては、機能的に不十分とされることもあるthe 
GIMPを拡張して、よりハッピーになろうというようなプロジェクトの初期成果物
です。
現在はしげっち氏がバージョン2.2系→2.4系への移行作業を行っています。こち
らの勝手移植版でのアイデアのうちいくつかは、より整理・改良の上組み込まれ
ているようです。

プロジェクトホームページ
http://sourceforge.jp/projects/gimp-painter/

しげっち氏のWikiサイト（各ツールの説明など）
http://www24.atwiki.jp/sigetch_2007/pages/20.html


■インストール

どこかからWindows版の2.4.1を見つけてきてインストールし、アーカイブ内の
gimp-2.4.exeを差し替えてください。
起動しないなどのトラブルをできるだけ避けたい方は、

http://www.geocities.jp/bitcase0312/index.html

で配布されている全部入りを拾ってくるのがいいかもしれません（圧縮ファイル
を解凍するのに7-zipまたは7z形式に対応したソフトが必要です）。ある程度自
分で何とかできるという方は公式？ビルドをインストールされることをお勧めし
ます。

※GTK+などのライブラリが入っているフォルダ（公式ビルドはGIMP本体のバイナ
リと同じ場所）にlibfreetype-6.dllが見つからない場合は、freetype6.dllを複
製の上リネームしてください。

以前の版の勝手改造GIMPを使っていて、新しい版に差し替え後動作がおかしいと
感じられる場合は、一度ツールオプションをリセットしてGIMPを再起動すると改
善することがあります。


■改造箇所と設定の解説

-Minimum scale
ブラシサイズを筆圧でコントロールする際の、（最大筆圧時のサイズを基準にし
た）最小倍率です。
例えば、1.0を指定すると圧力感度の筆圧をオフにするのと同じことになります
し、0を指定すれば従来どおりの変化の仕方をします。0.5を指定した場合には、
最も軽い筆圧で最大筆圧時の50%サイズになります。

-Main color(density)
Main colorは筆の穂に含まれる塗料のコントロールになります。
Densityは塗料の量を指定するもので、0では全く着色する能力がなくなり、1.0
にすると下地の色が混ざらなくなります。

-Main color(rate)
塗料の中に前回打った描点のカラーが混じってくる割合を指定します。
値が小さいほどより多く混じるようになります。
※現在の版では、ストローク開始時の描点カラーは無色透明と見なされます。

-Dryout
Painterの「色の伸び」に相当するパラメータです（単位はピクセル）。ストロ
ークの長さに比例してMain colorのDensityが下がっていき、指定値に達すると0
になります。
Dryoutの値が0の場合は例外として、全く減衰しません。

-Canvas color(density)
下地のカラーが混じる分量を指定します。あえて例えるなら、水や溶剤の分量と
言えるかもしれません。
Main color、Canvas color双方のDensityが0の場合には、ペイントしても何も起
こらなくなります。

-Canvas color(rate)
下地のカラーとして、ストロークを描画する前のカラーを加味する割合を指定し
ます。値が小さいほどより多く加味されるようになります。

-Pressure

-Delay
ストロークを描画する前のカラーを得る際に、ストロークを開始する前のデータ
からカラーを取得してしまうと、自分自身のストロークをにじませることができ
ません。
そのため、ストロークの開始後、実際に描点を打ち込むのを一時保留することで
適切なカラーを取得できるようにしています。
Delayパラメータは、処理を保留する描点の数を指示するものです。大きな値を
指定すると、スタイラスの動きに対して実際の描画が追いかけてくるようになる
ので多少の違和感があるかもしれません。逆に小さな値を指定すると違和感が軽
減されますが、直前の描点のカラーを拾ってしまうため、Canvas color(rate)の
効果が得られなくなります。

-Paint the tail of stroke (delay > 0)
ストロークの終端Delay個分の描点を処理するように指示します。Delayを1以上
にしている場合の描画が気になる方はチェックを外すと気分的には改善されます。

-Sample size
カラーを拾う範囲（直径）の上限をピクセル数で指定します。
GIMPに元々あるAPI関数で平均を取っているのですが、結構重たいのでこのパラ
メータで制限をかけています。

-Use merged color
描画対象レイヤーのカラーではなく、全てのレイヤーを統合した結果のカラーが
混じってきます。ブラシサイズがある程度大きくなってくると重くなるので注意。
本来なら、Painterの「下の色を拾う」にならって、描画対象のレイヤーより上
位のレイヤーを除いた統合カラーを使用したいところですが、知識不足と手抜き
のため現在の仕様になっています。何もないよりはマシだろうということで。あ
と、制限事項として、レイヤーのキャンバス外にあるピクセルカラーが拾えず、
白か黒が混じってくる、というのがあります。

-Assume that the hidden color is
レイヤーの透明部分にペイントするとき、白または背景色が混じります。normal
は単に（半）透明色として処理します。
このオプションをwhiteにしておくと、Painterでレイヤーにペイントするのと大
体同じ感じになり、乗算モードのレイヤーにペイントするときにはいい塩梅です。

-Remove the background color
最終的に計算された描画色から、 白または任意のカラーを除去して（半）透明
化します。除去処理のコードは、colortoalpha.c（「色を透明度に」プラグイン）
から拝借しました。
MixBrushは、重ね塗りのチェックを入れておかないと本来の効果が得られません
が、この機能を有効にしている場合はチェックを外した方が、一般にきれいな仕
上がりとなります。好みに応じて切り替えてください。
除去するカラーの指定は"Assume that..."の選択を参照します。今のところ、
NormalはWhiteと同じ扱いです。


■以前の版からの修正点

-11月7日版

混色の処理を書き直しました。パラメータの項目もあれこれ変わっています。今
回の変更により、透明レイヤーにペイントしても破綻することはなくなったと言
えるでしょう。ただし、レイヤーのアルファチャンネルは基本的に不透明になっ
ていく方向にしか干渉できないので、ベタの地に直接ペイントするのと異なる結
果になるのは避けられません（不透明度の変化が不自然）。
レイヤーのアルファを描点のアルファ値に置き換えることができれば、違いがあ
る程度埋められるのではないかと思うので、どうやって差し替えようかと現在考
えているところです。

今回の版では次の機能が使えません。
・筆圧の反転
・Assume that the hidden color is
・Remove the background color

また、次の機能が使えるようになっています。
・色の筆圧感知
・グラデーション色でペイント

-11月4日版

重ね塗りのチェックを外した際に、ストロークの重なる部分や交差する部分のカ
ラーが壊れる仕様を改善し、壊れないようにしました（まだ若干不具合が残って
いるかもしれませんが、おおむね「使える」状態にはなっていると思います）。
従来はこの仕様のため、「圧力感度」の「色」や「グラデーションの色を使う」
を有効にすると重ね塗りモードが強制されるようになっていました（素のGIMPの
仕様が元々そういう風になっています）。

-10月29日版

Canvas colorの筆圧の適用方法を元に戻しました。ただし、正負を逆にしてあり
ますので注意してください（10月25日版を基準にした場合、29日版の正負は同じ
となります。多分……）。
デフォルト値は10月22日版以前と同じになるように、-0.8を設定してあります。

グレースケールの画像またはチャンネルにペイントする際、不透明度を正しく扱
えていなかったので修正しました。

10月25日版では、Remove the background colorがグレースケールやインデック
スカラーでも動作していましたが、RGBモードに特化した処理なので適切な結果
は得られませんでした。10月29日版ではRGBモードのみで処理を行うように修正
しました。他のモードでチェックが入っていても、処理はスキップされます。

-10月25日版

Canvas colorの筆圧の利き方が期待する内容と異なるようなので、変更を加えま
した。また、Bleedの筆圧の利き方が不自然だったので調整しました。いずれも
まだ確定ではありませんので、しばらく様子を見て必要なら再修正します。

ブラシオプションに「重ね塗り」の項目が、これまではありませんでした。内部
的には常にオンになっていたのですが、今回の版からはオフにできるように変更
しました。描画色が途中で変化するような設定で描くときちんとペイントできな
い（GIMP本体に原因がある）場合があるので、その際は重ね塗りをオンに戻して
ください。
※重ね塗りオプションはMixBrush固有のオプションではないので、デフォルトは
「オフ」になっています。環境設定でツールオプションの設定を保存するよう変
更すれば起動の度にオンにする必要がなくなります。

Windowsバイナリを2.4.0正式版にしました。

-10月22日版

10月21日版では、Canvas colorのRate（割合）が0になっているとDryoutが無視
されてしまっていたので、これを修正しました。また、必要のないAPI関数の呼
び出しとメモリリークがあったので修正しました。

-10月21日版（Windowsバイナリのみ）

GIMP 2.4ではツールのクラスによって、基本的なオプション項目の表示内容をコ
ントロールしているようです。そのため、以前の版では「圧力感度」の「大きさ」
チェックボックスが表示されなくなっていました。10月21日版ではこの点が修正
されています。

Bleedの動作が変更されたのに伴い、より強く混ぜられるように値の上限を0.3ま
で引き上げました。
ただし、Bleedの値を高くすると下地のカラーを取り込む力が強くなるので、伸
びが悪くなり固まりはじめた絵の具のような感じになりますので注意してくださ
い。また、このときブラシの不透明度が高いと直前の描点の形が見えてしまい不
自然に感じられるかもしれません。
実際のところ、従来の上限である0.2あたりまでにしておいた方が無難でしょう。


■気になる点

筆圧を軽くするときなどにグレーっぽくなったり変な色づきが出ることがありま
す。恐らく精度落ちというか小数点以下の切捨ての影響だと思われます（Painter
でも同様の現象はあります）。Bleedの処理では多少対策を施してあるのですが、
オリジナルから引き継いでいる箇所はそのままにしてあるので、十分に改善され
ていません。

Sample sizeを大きくしていると、透明部分のペイントで余計な色が混じること
があります。これは平均を取ったあとに透明部分を白（背景色）に置き換える処
理をしているのが関係していそうです。
いずれは、自前の平均処理を入れないとだめかなあという感じですね（範囲が広
い場合は適当に間引かないと重くなるし）。


まあ、そんな感じで……

やまかわ
yam at yellowmagic.info
（プロバイダの規制により、自宅サーバからの送信ができないので、返信させて
いただく場合は他のメールアドレスになります）
