画像を任意サイズに拡大・縮小する簡易ツール（複数ファイル一括処理版）

このプログラムは、フォルダ内にある全ての画像ファイル（PNG形式またはJPEG形式）を開き、任意のサイズに拡大・縮小して、別のフォルダに保存する簡易ツールです。

使用方法

ダウンロードと展開（解凍）

まず、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万画素）の写真データを拡大・縮小する場合、大体 256MB くらい（以上）割り当てれば動くようです。

拡大・縮小後の画像の幅と高さを指定

起動すると、まず拡大・縮小後の画像の幅を尋ねられるので、幅のピクセル数を整数で入力してください。

続いて拡大・縮小後の画像の高さですが、これには以下のように2通りのモードがあるため、 まずどちらかを選択します（選択ウィンドウが表示されます）。

高さの値を手動で設定

幅と同様に、高さのピクセル数を整数で指定します。元の画像と縦横比が変わってもよく、とにかく目的のサイズにしたい場合に使用します。

縦横比が同じになる高さに設定

先に入力された幅の値に基づいて、縦横比が元の画像と同じになるように、自動で高さの値を求めて設定します。縦横比を歪めたくない場合に使用します。

「高さの値を手動で設定」を選んだ場合には、続いて高さの値を入力するウィンドウが表示されるので、高さのピクセル数を整数で入力してください。

保存するファイルの画像形式や画質を選択

さらに、保存するファイルの画質形式を PNG または JPEG 形式から選択し、JPEGを選んだ場合は画質をパーセントで指定します。 「 100.0 」が最高画質です。なお、PNGを選んだ場合は、そもそも画質が劣化しない（可逆圧縮）形式なので、画質の入力は不要です。

入力先フォルダの選択

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

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

なお、このツールでは、JPEG形式とPNG形式の画像の読み込みをサポートしています。

出力先フォルダの選択

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

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

拡大・縮小処理の実行

あとは放っておけばOKです。入力先フォルダ内にある全ての画像ファイル（PNG/JPEG形式）が、 指定したサイズに拡大・縮小された上で、出力先フォルダ内に自動で保存されます。 その際、保存されるファイル名は、元のファイル名の末尾に「 _scale.png 」または「 _scale.jpg 」が付いたものになります。

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

コード解説

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

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

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

また、似たような「単一ファイル処理 → 複数ファイル一括処理」への改造を、 ちょうど以前に 「 特定の色を透明にする簡易ツール（複数ファイル一括処理版） 」 のコードでも行いました。実は今回のコードは、それをかなりコピペして流用しています。 同じように、フォルダ内のファイルについて一括処理を行うプログラムを自作したい場合は、コピペのベースや参考などになるかもしれません。

[前提となるコード]

• 画像を任意サイズに拡大・縮小する簡易ツール
• 特定の色を透明にする簡易ツール（複数ファイル一括処理版）

コード全体

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

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

先頭領域

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

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

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

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

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

グローバル変数や入力部

続いて、グローバル変数の宣言や、その値の入力を行っている部分です。

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

その後に続けて、高さの設定モードの選択肢も文字列の定数（const）として定義しています。 これは選択肢としてユーザーに表示する他に、選択された値と if 文の中で比較して分岐するのにも用います。

その後は、画像の幅/高さや画質などをユーザーに値を入力してもらったり（input 関数を使用）、 高さの設定モードや保存画像形式をユーザーに選択してもらったり（select 関数を使用）しています。 このようにグローバル領域に書いた処理は、タイミング的には main 関数の実行よりも先に行われます。

本当はこれらの値はグローバル変数である必要は無く、main 関数内でローカルに宣言して下層の関数の引数に渡せば（行儀的にも）よいのですが、 こういう短い簡易ツールのコードであまり堅くするのも改造や流用時に面倒になりそうなので、パラメータのまとめ書きっぽくグローバルに置いています。 もし拡大・縮小後の幅/高さや、画像形式/画質などを、毎回尋ねずに決め打ちしたい場合は、このあたりの宣言行の右辺を書き換えてください。

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

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

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

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

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

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

フォルダ内の全ファイルを走査し、拡大・縮小して保存する処理を実行する processAllFiles 関数

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

先頭では、まず入力先フォルダ内の全ファイルの名前一覧を、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形式またはJPEG形式の画像ファイルとして保存します。

なお、この関数は、画像の矩形（四角形）領域を切り抜く簡易ツール の回のコードで行った処理をまとめたものです。詳しい説明については、そちらをご参照ください。 フルで説明するとここだけで結構長くになってしまうので、以下では要点をピックアップして見ていきます。

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

この newGraphics 関数は、生成したグラフィックスデータにID番号を割りふって返すので、その値をint型変数の inputGraphics に控えています。 このIDは、複数のグラフィックスデータを区別するのに使用します（実際に後で、内容を切り抜いた別のグラフィックスデータを生成します）。

その後の if 文では、もし高さの設定モードが「 HEIGHT_MODE_MANUAL （縦横比が同じになる高さに設定）」だった場合に、自動で高さを求める処理を行っています。 具体的な手順としては、まず入力された拡大・縮小後の幅（outputWidth）を、元画像の幅（inputWidth）で割って、拡大率を求めます （ここで両者は int 型なので、そのまま除算すると結果も整数になってしまい、小数点以下が落ちてしまうので、float 型にキャストした上で除算しています）。 そして、求めた拡大率を元画像の高さにかけて、拡大・縮小後の高さを求めています。 こうすると、幅の拡大率と高さの拡大率が同じになるので、画像の縦横比を保ったまま拡大・縮小できます。

続いて、このツールの要の処理である、画像の拡大・縮小処理を行っている部分です。 と言っても以下の通り、少し多い引数で newGraphics 関数を呼んでいるだけです。

この引数の組み合わせで newGraphics 関数を呼ぶと、 既にあるグラフィックスデータの内容を、 指定サイズに拡大・縮小した上で、その内容を保持するグラフィックスデータを生成してくれます。 最初の引数（inputGraphics）に元のグラフィックスデータのIDを渡します。 その後に続けて、拡大・縮小後の幅と高さを渡します。 最後の引数には、画像を滑らかにするアンチエイリアス処理の有無を指定します。 ここに true を指定すると滑らかに拡大・縮小できますが、処理時間が少し長くなるので、不要な場合は false を指定してください。

この関数は、生成した新しいグラフィックスデータにID番号を割りふって返すので、 それをint型変数 outputGraphics に控えています（ファイルの保存の際に使います）。

あとは、生成した（切り抜いた領域の内容を保持する）グラフィックスデータの内容を画像ファイルとして保存した上で、 グラフィックスデータを破棄して終了です。

と、以上の通り説明した processFile 関数内の処理が、フォルダ内の全ての画像ファイルに対して（processAllFiles関数内のループから呼び出される事によって）実行されます。 全画像ファイルに対して処理が終わると、processAllFiles関数のループを抜けて、main 関数の終端に達し、全体の処理は終了します。

（ ただし、プログラムを終了させる exit 関数などは呼んでいないので、その後もユーザーがコンソール画面を手動で閉じるまでは、プログラムは「何もしない」状態で待機し続けます。 これは、処理された画像ファイルの一覧を、ユーザーがコンソール画面上でゆっくり確認できるように、あえてそうしています。）

コードのライセンス

コード内容は以上です。

ライセンス

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

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

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

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