条件を満たす色を透明にする簡易ツール（複数ファイル一括処理版）

このプログラムは、フォルダ内にある全ての画像ファイル（PNG形式またはJPEG形式）を開き、条件に一致する範囲の色を透明に置き換えた上で、別のフォルダに保存する、VCSSL製の簡易ツールです。

グラフィック作業や画像解析などで、画像内の特定の部分だけを残して、 それ以外の部分を透明化したいといった場面はよくありますね。 前回は、そのような処理を行う簡単なツールとして、 画像内の特定色を透明で置き換えるものを公開しました：

• 前回: 特定の色を透明にする簡易ツール

上記ような、単色を透明で置き換えるツールは、透明化したい部分を均一な色で着色できるような場合には、単純で便利です。 自分で元の画像を描いていて、「 緑色で塗った部分を透明にしたい 」といった用途であれば、このページのツールよりも、上記のツールの方がおすすめです。

しかし、「 カメラで撮影した写真の中で、緑っぽい部分を透明にしたい 」といった場合には、 透明化対象の部分にはある程度の色ムラがあって、「 この色 」と1個に定める事ができないため、 上記のような単純な方式はあまり役に立ちません。

そこで今回のプログラムでは、透明化対象を単色ではなく、 RGB成分が満たす条件で指定できるようになっています。 例えば、「 赤色成分が50以下、かつ緑色成分が100以上の部分を透明化 」といった処理が可能です。

これなら、透明化対象の色に幅をもたせる事ができるので、元の画像にある程度の色ムラがあっても、透明化したい部分と残したい部分を、条件指定によって自由に調整できます。

なお、画像ファイル1個だけに対して、同様の処理を行うプログラムは、既に「 特定の色を透明にする簡易ツール 」の回で扱いました。 ファイルを1個だけ処理したい場合は、そちらをご利用ください。 今回のプログラムは、それをフォルダ内の複数ファイルに対して一括処理したい場合のために、少し改造したものです。

使用方法

ダウンロードと展開方法

まず、PC（スマホは未対応）で上の画面の「 ダウンロードして実行 」ボタンを押してください。 するとZIP形式で圧縮されたファイルがダウンロードされるので、そのZIPファイルを右クリックして「すべて展開」や「ここに展開」などで展開してください。 展開が成功すると、ZIPファイルと同じ名前のフォルダができ、その中にZIPファイルの中身が入っています。

» 展開がエラーで止まってしまう場合は…

なお、Linux® 等をご使用で、右クリックメニューから展開するとファイル名が文字化けしてしまう場合は、 コマンドライン端末でZIPファイルのある場所まで cd した上で「 unzip -O cp932 ZIPファイル名 」で展開してみてください。

起動方法

Microsoft® Windows® をご使用の場合

上記の通りにZIPファイルを展開したフォルダ内にある、 「 VCSSL.bat（種類はバッチファイル） 」をダブルクリック実行してください。 もしプログラムの内容を書き変えながら使いたい場合は、代わりに「 VCSSL_Editor.bat 」を実行してください。

実行すると、最初にメモリー使用量や、（必要な場合のみ）Java®実行環境を自動で入手するか※ 等を尋ねられるので、適時答えると、プログラムが起動します。2回目以降はすぐに起動します。

※ ここで入手したJava®実行環境は、ZIPファイルを展開した中の「 jre 」フォルダ内にダウンロードされ、このプログラムの実行のみに使用されます。PC全体に影響する形でインストールされる事はありません。

Linux® 等やその他のOSをご使用の場合

ZIPファイルを展開したフォルダ内へコマンドライン端末で cd して、以下の通り入力して実行してください：

» javaコマンドが使用できない等のエラーが表示される場合は…

実行中にメモリー容量が不足する場合は…

このプログラムは、使い方によっては、それなりに多くのメモリーを使用します。 そのため、デフォルトのメモリー容量設定では不足する場合があります。 その場合は以下の対処方法をご参照ください：

» 実行中にメモリー容量が不足する場合（Microsoft® Windows® をご使用の場合）
» 実行中にメモリー容量が不足する場合（Linux® 等やその他のOSをご使用の場合）

※ 目安として、4288 x 2848 サイズ（約1200万画素）の写真データを加工する場合、大体 3GB（≒3000MB）くらい割り当てれば動くようです。

透明化したい部分を、RGB値の条件で指定

起動すると、まず 透明化したい部分の色が満たす条件 を尋ねられるので、 テキストフィールドに記入します。 条件は、以下の書き方に基づいて記述してください。

※「RGB値なんて初耳！よくわからない！」という方は、下記ページで詳しい解説と色表示ツールの公開を行っていますので、まずはそちらをご参照ください。

• RGBやカラーコードの色表示と相互変換ができる簡易ツール

ここでは、サンプル画像の緑っぽい部分から青っぽい部分にかけてを透明化してみましょう。 テキストフィールドに「 (r < 50 && g >= 80) || b > 100 」と入力して「 OK 」を押してください。 （試しやすいように、デフォルトでこの内容になっています。）

入力先フォルダの選択

その後は、入力先フォルダ（加工したい画像ファイルが入っているフォルダ） を指定するか尋ねられるので、 指定したい場合は「 はい 」を選択して、続けてフォルダの場所を選択してください。

「 いいえ 」を押してスキップすると、ダウンロード・展開したフォルダ内にある「 input 」という名前のフォルダが、自動的に入力先フォルダとみなされます。 この中には以下のサンプル画像「 sample.png 」が入っているので、初めての場合はここでは「 いいえ 」を選択してみましょう。 このサンプル画像の内容は下記の通り、様々な色がグラデーションで混ざっています。

なお、このツールではPNG形式の他にも、JPEG形式の画像もサポートしています。 ただ、JPEG形式は不可逆圧縮に際して色のむらが増加するため、PNG形式とJPEG形式のどちらのファイルもある場合は、PNG形式の方が無難だと思います。 （※ だからといって、既にJPEG形式になっているファイルをPNG形式で保存しなおす必要はありません。JPEG画像しか無い場合はJPEGのままでOKです。）

出力先フォルダの選択

続いて同様に、出力先フォルダ（加工済みの画像ファイルを保存するフォルダ） を指定するか尋ねられるので、 指定したい場合は「 はい 」を選択して、続けてフォルダの場所を選択してください。

ここでも「 いいえ 」を押してスキップすると、ダウンロード・展開したフォルダ内にある「 output 」という名前のフォルダが、自動的に入力先フォルダとみなされます。 初めての場合はここでも「 いいえ 」を選択してみましょう。

透明化処理の実行

あとは放っておけばOKです。入力先フォルダ内にある全てのPNG形式画像ファイルが、 指定色を透明化した上で、出力先フォルダ内に自動で保存されます。 その際、保存されるファイル名は、元のファイル名の末尾に「 _clear.png 」が付いたものになります。 画像形式はPNGになります。

入力先＆出力先フォルダの指定を「 いいえ 」でスキップした場合は、 「 input 」フォルダ内にある先ほどのサンプル画像を透明化したものが、 「 output 」フォルダ内に保存されているはずです。 その内容は下図の通りです（実際にこのツールで変換したファイルそのものを表示しています）。 ちゃんと、一部が透明化されていますね。この透明になった部分が、先ほど入力した条件が満たしていた部分です。

コード解説

このプログラムのコードはVCSSLで記述されています。

条件を満たす色を、透明ではなく別の色に置き換えたいといった場合には、 プログラムのコード「 ConditionedColorToClearMulti.vcssl 」をテキストエディタで開いて改造してください。 スクリプト言語なので、コンパイラなどの別ソフトは不要で、コードを書き換えるだけでOKです。 VCSSLはC系の単純な文法の言語なので、C言語などに触れた事のある方なら簡単に読めると思います。

なお、このコードは「 条件を満たす色を透明にする簡易ツール 」の回のコードを土台に、 複数ファイルを一括処理するように改造したものです。 具体的には、上記の回のコードの処理を関数にまとめて、フォルダ内の全ファイルに対して毎回呼び出して実行しているような流れです。 なので、最初に上記の回のコードから読み進めるほうがスムーズかもしれません。

また、似たような「単一ファイル処理 → 複数ファイル一括処理」への改造を、 ちょうど前回 「 特定の色を透明にする簡易ツール（複数ファイル一括処理版） 」 のコードでも行いました。実は今回のコードは、それをかなりコピペして流用しています。 なので、今回のコードが長く感じる場合は、そちらも先に読んでおくとスムーズかもしれません。

[前提となるコード]

• 条件を満たす色を透明にする簡易ツール
• 特定の色を透明にする簡易ツール（複数ファイル一括処理版）

コード全体

それでは、まずはコード全体を見てみましょう。

以上です。140行程度のコードですね。 上から下へ順に読むと、トップダウンで処理階層が深く＆細かくなる流れになっています。 各部で行っている処理はコード内のコメントの通りですが、 以下では順を追ってもう少し詳しく説明します。

先頭領域

まずは、先頭の5行です。

1行目では、コードのファイルで使用している文字コード（Shift_JIS）を宣言しています。 書かなくても動きますが、書いておくと文字化けを防げます。Shift_JISの他にUTF-8も使用できます。

2行目では、グラフィックスリソースを扱うための機能を提供する Graphics ライブラリを読み込んでいます。 ここで「 グラフィックスリソースって一体何？ 」となるかと思いますが、いわゆる画像データの事だと思ってください。 VCSSLでは、画像を読み込んだり表示したり描画したりといった事に必要なデータを、まとめてグラフィックスリソースという形で扱います。

その後に読み込んでいる File ライブラリは、ファイルシステムや各ファイルの情報等にアクセスする機能を提供してくれるものです。 今回はフォルダのフルパスを取得したり、フォルダ内のファイル名の一覧を取得したり、そのファイル名が指す対象がフォルダかどうかを判定するため等に使用します。

Text ライブラリは文字列処理機能を提供してくれるもので、 今回はファイルのパスの末端に付いている拡張子が、このツールが対応しているPNG形式のもの（ .png ）かどうかを判定するのに使用します。

最後の行では、各種の数学関数を提供する Math ライブラリを読み込んでいます。 と言っても、このコード内では特に使っていません。 ユーザー側が指定する条件式の中で、もしかしたら sin や cos などを使いたいという場合もあるかもしれないので、 そのために読み込んでいます。

グローバル変数

続いて、グローバル変数の宣言部分です。

先頭では、入出力フォルダの指定を「 いいえ 」でスキップした際に使用する、デフォルトの入出力フォルダを、定数（const）として定義しています。 なお、名前の末尾に付いている「 DIRECTORY 」は「 ディレクトリ 」と読みますが、これは「 フォルダ 」のちょっと堅い読み方のようなものと思ってください。

その後は、透明化したい色のRGBA値に関する条件式を格納する、文字列の変数を宣言しています。 ユーザーによる条件式の入力も、宣言行で input 関数を呼んでその場で行ってしまっています。 このようにグローバル領域に書いた処理は、タイミング的には main 関数の実行よりも先に行われます。 その後も続いて、変換後の色のRGBA値を格納する変数 toRed, toRed, toRed, toRed を宣言しています。

本当はこれらの条件式やRGBA値などはグローバル変数である必要は無く、main 関数内でローカルに宣言して下層の関数の引数に渡せば（行儀的にも）よいのですが、 こういう短い簡易ツールのコードであまり堅くするのも改造や流用時に面倒になりそうなので、パラメータのまとめ書きっぽくグローバルに置いています。 もし透明化する色の条件式を決め打ちしたかったり、変換後の色を（透明ではなく）別の色にしたい場合は、このあたりの宣言行の右辺を書き換えてください。

全体の処理の大枠になっている main 関数

続いて main 関数です。C言語などではおなじみですが、 main 関数は、プログラム実行時に自動で呼び出される関数です。 ここには処理全体の最も上層になる、大枠的な処理を書いています。

頭のほうでは、まず入出力フォルダのフルパスを格納する変数を宣言し、そこにデフォルトの入出力フォルダのフルパスを getFilePath 関数で取得して代入しています。 続いて、ユーザーに入出力フォルダを指定したいか尋ねて、「 はい 」が選択された場合は、choose 関数でユーザーに選んでもらったフォルダのパスで上書きしています。

そして、入出力フォルダのフルパスを引数として processAllFiles 関数を呼び出しています。 これはこのコード内で宣言されている関数で、詳細はすぐ後で解説しますが、 フォルダ内の全ファイルを走査し、それぞれに透過処理を実行する処理をまとめたものです。 このツールの目的となっている処理ですね。

その処理が終わると、ユーザーに pop 関数で処理完了を通知しています。 大枠の処理はこれで終わりです。

最後に exit 関数などでプログラムを実行終了してもいいのですが、 そうすると自動でウィンドウが閉じてしまい、ユーザーが処理済みファイルの一覧を確認できなくなってしまうので、 ここでは処理完了メッセージを出すのに留めています。 ユーザーがウィンドウを手で閉じた時点で、プログラムが終了します。

フォルダ内の全ファイルを走査し、透過処理を実行する processAllFiles 関数

続いて、上で見た main 関数の中から呼んでいた、processAllFiles 関数を見てみましょう。 この関数は、引数 inputFilePath に入力先フォルダ、 outputPath に出力先フォルダを受け取ります。 そして、入力先フォルダの中にある全てのPNG形式画像ファイルに対して、透過処理を実行した上で、出力先フォルダに保存します。

先頭では、まず入力先フォルダ内の全ファイルの名前一覧を、listDirectory 関数で配列として取得し、 その要素数 = ファイルの個数を変数 fileN に控えています。 続く for 文で、それらのファイル名を1個1個辿っていっています。

for 文の冒頭で、ファイル名に入力フォルダのパスを結合し、ファイルパスに変換した変数 inputFilePath を宣言しています。 そして、直後の if 文でその内容を検査し、このツールの処理対象ファイルかどうかを判定しています。

if 文の条件式を日本語にすると「 inputFilePath の指すファイルがフォルダではなく、かつ、inputFilePath の内容が『 .png 』または『 .jpg 』で終わる場合」となります。 前半の条件は、入力フォルダ内でさらにフォルダがある場合に、それを処理対象から除外するためのものです（当然、フォルダを画像ファイルとして開く事はできません）。 後半の条件は、フォルダ内の色々なファイルの中で、PNG形式かJPEG形式の画像ファイルだけを処理対象に含めるためのもので、拡張子の一致確認（ .png か .jpg なら通す）をしています。 このように、文字列に対して複数通りの一致確認をするには正規表現が便利で、 実際にこの条件「 .(png|jpg) 」も正規表現で書いてあります （ checkText 関数の最後の引数に渡している END_PATTERNは、文字列の終端に対して正規表現でパターンマッチ判定するオプションです ）。

if 文の { 〜 } の内側は、処理対象ファイルに対して行う処理が書かれています。 まず出力ファイル名とそのフルパスを用意した上で、 ユーザーが処理結果を確認しやすいように、処理対象ファイルの入出力先パスを println関数で画面上に表示しています。

そして、引数に処理対象ファイルの入出力先パスを渡して、processFile 関数を呼び出しています。 これもこのコード内で宣言されている関数で、詳しくはすぐ後で説明しますが、このツールの中核である、ファイルの透過処理を行います。

processAllFiles 関数の中身は以上です。 つまるところ、このプログラムの流れとしては、入力先フォルダ内の全ファイルに対して、処理対象ファイルかどうかを確認し、 もしそうであれば、そのファイルに processFile 関数の処理を適用する、という具合になっています。

画像ファイル1個を読み込み、透過処理を行って保存する processFile 関数

それでは最後に、肝心の processFile 関数の中身を見てみましょう。 この関数は、引数 inputFilePath に入力ファイルのパス、outputFilePath に出力ファイルのパスを受け取ります。 そして、入力ファイルを画像ファイルとして開いて、色の変換処理（＝透過処理）を行い、 それを出力ファイルパスの場所に、PNG形式画像ファイルとして保存します。

なお、この関数は、条件を満たす色を透明にする簡易ツール の回のコードで行った処理をまとめたものです。詳しい説明については、そちらをご参照ください。 フルで説明するとここだけで結構長くになってしまうので、以下では要点をピックアップして見ていきます。

まずは、引数に受け取った画像ファイルのパス inputFilePath を newGraphics 関数の引数に渡していますが、 これによってファイルが画像として開かれ、その内容を保持するグラフィックスリソースが生成されます。 要するに画像データがメモリー上に展開されます。

画像ファイルを開いた直後には、幅（width）や高さ（height）、 および全ピクセルの色を格納する配列※（pixel[][][]）など、 変換処理に必要なデータを取りだしています。

（※「 全ピクセルの色を格納する配列 」という概念が分かりづらい方は、この記事の末尾にある解説をご参照ください。）

ここからがいよいよ処理の中核です。 画像の縦方向および横方向のループを回して、 画像内の全ピクセルを一つ一つ巡って、処理していきます。

まずは、各ピクセルについて、色のRGBA各成分を変数 r, g, b, a として取り出しています。 そして、取り出したRGBA各成分 r, g, b, a の値が、ユーザーに指定された透明化条件を満たすかどうかを判定しています。

ただし透明化条件は、ただの文字列として変数 condition に格納してあるので、 その内容をプログラムのコードと見なして実行する必要があります。 VCSSLでは、eval 関数がそれを行ってくれます。

ただ、ユーザーが色々とおかしな条件式を入力してしまう事もあるので、 ここではまず、変数 condition に控えられた条件式がコードとして正しいかどうか evaluable 関数で確認した上で、 eval 関数で実行（評価）し、結果を bool 型変数 shouldReplaceColor に控えています。

ここでは、まず変数 condition に控えられた条件式がコードとして正しいかどうか確認した上で、 eval 関数で実行（評価）し、結果を bool 型変数 shouldReplaceColor に控えています。 「 shouldReplaceColor 」は「 色を置き換えるべきか 」という意味で、 これが true なら、このピクセルの色は透明化条件を満たしているので、透明色で置き換えるべきだ、という事になります。

後は本当に素直に if 文で、shouldReplaceColor が true ならピクセルの色を透明で置き換えるだけです。 透明の色は、このプログラムの冒頭で変数 toRed 〜 toAlpha に用意しておいたので、 その値をピクセル配列の各色成分に代入しています。

ここまでの処理を全ピクセルについて行えばいいだけなので、for 文もここで閉じていますね。

以上で重要な部分は終わりです。 あとは、変換済みのピクセル配列データから、 画像保存用にグラフィックスリソースを生成し、 実際にPNG形式の画像ファイルとして保存した上で、 グラフィックスリソースを破棄して終了です。

コードのライセンス

コード内容は以上です。

このVCSSLコードは著作権フリー（パブリックドメイン）で公開しています。 そのままでのご利用はもちろん、言語の種類を問わず、改造や流用などもご自由に行ってください。

ライセンス

このVCSSLコード（ 拡張子が「.vcssl」のファイル ）は実質的な著作権フリー（パブリックドメイン) である CC0 の状態で公開しています。 そのままでのご利用はもちろん、言語の種類を問わず、改造や流用などもご自由に行ってください。

※ ただし、このVCSSLコードの配布フォルダ内には、ダウンロード後すぐに実行できるように、 VCSSLの実行環境も同梱されており、そのライセンス文書は「 License 」フォルダ内に同梱されています （要約すると、商用・非商用問わず自由に使用できますが、使用の結果に対して開発元は一切の責任を負いません、といった具合の内容です）。 配布フォルダ内の各構成物の一覧やライセンスについては「 ReadMe_使用方法_必ずお読みください.txt 」をご参照ください。

この記事中の商標などについて

• OracleとJavaは、Oracle Corporation 及びその子会社、関連会社の米国及びその他の国における登録商標です。文中の社名、商品名等は各社の商標または登録商標である場合があります。
• Windows は、米国 Microsoft Corporation の米国およびその他の国における登録商標です。この記事は独立著作物であり、Microsoft Corporation と関連のある、もしくはスポンサーを受けるものではありません。
• Linux は、Linus Torvalds 氏の米国およびその他の国における商標または登録商標です。
• その他、文中に使用されている商標は、その商標を保持する各社の各国における商標または登録商標です。