ServBay 組み込みコマンドライン画像処理ツール 利用ガイド

開発者向けに最適化されたローカルWeb開発環境であるServBayは、多彩な言語ランタイムやデータベースだけでなく、強力なコマンドライン画像処理ツールも複数内蔵しています。これらのツールは、Web開発で頻繁に発生する画像フォーマット変換、圧縮最適化、サイズ変更、ウォーターマーク追加などの作業に不可欠です。本ガイドでは、ServBayにプリインストールされている主要な画像処理ツールの特徴と代表的な使い方を詳しく説明し、開発環境で手早く画像処理を行うためのコマンド操作テクニックもご紹介します。

前提条件

ServBayが正常にインストール・起動済みであることをご確認ください。本ガイドで紹介するすべてのツールはServBayに組み込まれており、別途インストールや設定は必要ありません。

主な画像処理ツール一覧

ServBayは以下の主要なコマンドライン画像処理ツールを最初から搭載しています。

ImageMagick

ImageMagickは多機能で歴史ある画像処理ツールセット・ライブラリで、ほぼすべての主要画像フォーマットに対応しています。フォーマット変換、サイズ変更、エフェクト加工など多岐にわたる用途で開発者によく利用されます。

基本的な使い方

• 画像フォーマットの変換 JPEG画像をPNG形式へ変換：

  magick convert input.jpg output.png

• 画像サイズ変更 画像サイズを300×300ピクセルにリサイズ：

  magick convert input.jpg -resize 300x300 output.jpg

• ウォーターマーク追加 右下に"ServBay"のテキストウォーターマークを挿入：

  magick convert input.jpg -gravity southeast -draw "text 10,10 'ServBay'" output.jpg

cwebp

WebPはGoogleが開発した次世代画像フォーマットで、JPEGやPNGより優れた非可逆・可逆圧縮を実現します。cwebpは公式のコマンドラインツールで、様々な画像形式をWebPに変換できます。

基本的な使い方

• JPEG画像からWebP形式へ変換

  cwebp input.jpg -o output.webp

• PNG画像からWebP形式へ変換

  cwebp input.png -o output.webp

• 圧縮品質の設定-qオプションでWebPの品質（0～100）指定、例：80で出力

  cwebp -q 80 input.jpg -o output.webp

jpegtran

jpegtranはlibjpegライブラリ由来のツールで、JPEG画像の回転・反転・切り抜き等の無劣化変換を専門とします。画質を損なうことなく画像の方向修正や最適化に最適です。

基本的な使い方

• JPEG画像の回転 JPEG画像を無劣化で90度回転：

  jpegtran -rotate 90 input.jpg > output.jpg

  注意：出力はリダイレクト>でファイルへ書き出します。

• JPEG画像の左右反転

  jpegtran -flip horizontal input.jpg > output.jpg

djpeg

djpegはlibjpegライブラリに含まれるデコーダーツールで、JPEGファイルをPPM（Portable Pixmap）などの生ピクセルデータ形式にデコードします。ピクセル単位の加工や別形式への変換が目的です。

基本的な使い方

• JPEGをPPM形式へ展開

  djpeg input.jpg > output.ppm

cjpeg

cjpegはdjpegの逆で、生のピクセルデータ（例：PPM）からJPEGファイルをエンコード（圧縮）します。通常はdjpegとの組み合わせや、他ツールで生成した画像データのJPEG化に使われます。

基本的な使い方

• PPMをJPEG形式へ圧縮

  cjpeg input.ppm > output.jpg

img2webp

img2webpはWebPツールセットの一部で、複数枚の静止画像（PNGやJPEG等）を結合し、GIFのようなアニメーションWebP画像を生成します。

基本的な使い方

• 複数画像をアニメーションWebPとして合成frame1.png, frame2.png, frame3.pngをoutput.webpに合成：

  img2webp -o output.webp frame1.png frame2.png frame3.png

実用例＆高度なテクニック

これらのコマンドラインツールを使えば、複雑な画像処理も自動化して効率化できます。代表的な実用例をいくつかご紹介します。

複数画像の一括リサイズ

ImageMagickとShellスクリプトを組み合わせれば、カレントディレクトリ内の全JPEG画像を一括リサイズも簡単。例：幅を全て300ピクセル（縦横比は自動調整）に揃える：

# 画像のあるディレクトリへ移動（例：cd /Applications/ServBay/www/your-project/images）

for file in *.jpg; do
    # magick convertでサイズ変更、-resize 300xは高さを自動調整
    # 元ファイル名に保存、または新ディレクトリに保存して上書きを防止
    magick convert "$file" -resize 300x "${file%.*}-resized.jpg"
    echo "Processed: $file -> ${file%.*}-resized.jpg"
done

ヒント：${file%.*}はシェルのパラメータ展開で、拡張子を除去します。

一括フォーマット変換と最適化

cwebpで、カレントディレクトリ内のservbayで始まるPNG/JPEG画像をWebP化し、圧縮率45に設定：

# 画像のあるディレクトリへ移動
for file in servbay*.jpg servbay*.png; do
    # 出力ファイル名を.webp拡張子に置換して設定
    output_file="${file%.*}.webp"
    # cwebp変換、-qで品質指定
    cwebp -q 45 "$file" -o "$output_file"
    echo "Converted: $file -> $output_file (Quality 45)"
done

一括ウォーターマーク付与

ImageMagickとShellスクリプトで、カレントディレクトリ内すべてのJPEG画像に「ServBay」テキストウォーターマークを一括追加：

# 画像のあるディレクトリへ移動
for file in *.jpg; do
    # 右下にテキストウォーターマーク 'ServBay Demo'を追加
    # 新しいファイル名で保存
    magick convert "$file" -gravity southeast -pointsize 20 -fill white -annotate +10+10 'ServBay Demo' "${file%.*}-watermarked.jpg"
    echo "Watermarked: $file -> ${file%.*}-watermarked.jpg"
done

JPEG画像のファイルサイズ最適化

jpegtranを使い、JPEG画像の不要データを除去し、プログレッシブJPEG（Web表示の体感速度向上に有効）化：

jpegtran -optimize -progressive input.jpg > output.jpg

注意：jpegtranでは、標準出力をリダイレクトしてファイルに保存する必要があります。

注意事項

• PATH環境変数について: ServBayは組み込みツールのパスをシステムのPATHへ自動追加するため、ターミナルでmagickやcwebp、jpegtran等が直接利用できます。コマンドが見つからない場合、ServBayが正しく動作しているか、PATH設定をご確認ください。
• エラー処理: コマンドラインツールは実行時にエラー情報を出力します。バッチ用スクリプトではエラーチェック機構の導入推奨です。
• ファイル上書きについて: 多くのコマンドはデフォルトで出力ファイルを上書きします。一括処理時は注意し、別ディレクトリ保存や別名指定で結果を検証してから上書きを行ってください。

よくあるご質問（FAQ）

Q: ターミナルでmagickコマンドが見つからない場合は？

A: ServBayの環境変数が正しく設定されているかご確認ください。問題が解決しない場合、「設定」→「コマンドラインツール」で、zsh及びbashに対する設定を行い、ターミナルを再起動してください。

Q: どの画像フォーマットがサポートされていますか？

A: ImageMagickはJPEG、PNG、GIF、TIFF、BMP、SVG等を含む数百種類に対応しています。cwebpはWebP変換用、jpegtran、djpeg、cjpegは主にJPEGおよび関連生データへの対応です。詳細は各ツール公式ドキュメントをご確認ください。

Q: PHPやPythonなどのスクリプトからこれらツールを呼び出せますか？

A: はい、ServBay環境下のPHP（exec()、shell_exec()、proc_open()）、Python（subprocessモジュール）、Node.js（child_processモジュール）などから、画像処理やアップロード時にコマンドラインツールを利用できます。

まとめ

ServBayは統合型ローカル開発ソリューションとして、ImageMagick、cwebp、jpegtranなどの強力なコマンドライン画像処理ツールを組み込むことで、画像リソースの変換・最適化・自動バッチ処理などの開発作業を大幅に効率化します。面倒なセットアップや追加インストール不要で、すぐに使い始めることが可能です。これらツールを活用することで、Web開発プロジェクトの画像処理作業が劇的に効率化・柔軟化します。ぜひServBay上でこれらツールの実力を体感してください！