convert-image-to-jpg

画像をJPGに変換

主な目的

• 1つのローカル画像、またはローカル画像を含むディレクトリツリーを.jpgに変換します。
• JPGのDPIメタデータは、デフォルトで96、または呼び出し元が指定した値に設定します。
• 入力パスがディレクトリの場合、相対ディレクトリ構造を保持します。

必須ツール

• scripts/convert_to_jpg.pyを使用します。
• Python標準ライブラリのモジュールのみを使用します。このスキルのためにPythonパッケージをインストールしないでください。
• magickがインストールされている場合は、優先して使用します。
• magickが利用できない場合は、macOSのsipsにフォールバックします。
• どちらのバックエンドも利用できない場合は、処理を停止して、不足している依存関係を報告します。

クイックスタート

1. 1つのファイルを指定したJPGパスに変換します。

python3 scripts/convert_to_jpg.py \
  --input-path /path/to/image.heic \
  --output-path /path/to/output.jpg

2. カスタムDPIでディレクトリを再帰的に変換します。

python3 scripts/convert_to_jpg.py \
  --input-path /path/to/input-images \
  --output-path /path/to/output-images \
  --dpi 300

3. 既存の出力を上書きするか、前回の実行結果を置き換えます。

python3 scripts/convert_to_jpg.py \
  --input-path /path/to/input-images \
  --output-path /path/to/output-images \
  --overwrite

4. ファイルを書き込まずに変換計画をプレビューします。

python3 scripts/convert_to_jpg.py \
  --input-path /path/to/input-images \
  --output-path /path/to/output-images \
  --dry-run

動作

• ディレクトリ入力は再帰的に処理し、出力ツリーでも同じ相対サブディレクトリを維持します。
• 単一ファイルの--output-pathに.jpgまたは.jpegの拡張子がない場合は、ディレクトリとして扱います。
• .jpgと.jpegの入力も変換します。出力名の統一やDPIメタデータの書き換えに利用できます。
• JPGの品質はデフォルトで95に設定します。
• GIFやTIFFなど、ソース形式に複数のフレームまたはページを含められる場合は、最初のフレームまたはページを使用します。
• 2つのソースファイルが同じ出力先の.jpgに変換される場合、曖昧なディレクトリ変換を拒否します。
• 必要に応じて、--extra-extension .extを指定して一般的でない拡張子を追加します。

主な引数

• --input-path：ソースファイルまたはソースディレクトリ
• --output-path：出力JPGファイルのパスまたは出力ディレクトリ
• --dpi：出力JPGのDPIメタデータ。デフォルトは96
• --quality：JPGの品質。1から100まで指定でき、デフォルトは95
• --backend：auto、magick、またはsips
• --extra-extension：ディレクトリのスキャン対象に追加する拡張子
• --overwrite：既存の出力を置き換えます
• --dry-run：ファイルを変換せずに計画を表示します
• --limit：簡易チェック中に処理するファイル数の上限

スクリプト

• scripts/convert_to_jpg.py