convert は ImageMagick のコマンドラインツールで、画像形式の変換、リサイズ、トリミング、合成、テキスト描画など多用途に使えます。ImageMagick 7 では基本コマンドが magick に統合され、convert は互換目的で提供/非推奨扱いです（magick を優先）。(ImageMagick)
実務では「一括リサイズ」「サムネ生成」「透かし文字の付与」「PDF→画像化」などで活躍します。(ImageMagick)
構文（Syntax）
# ImageMagick 6（IM6）の代表的書式
convert INPUT [OPTIONS] OUTPUT
# ImageMagick 7（IM7）では 'magick' が推奨
magick INPUT [OPTIONS] OUTPUT
# 互換形（IM7でも動くが非推奨警告が出る）
magick convert INPUT [OPTIONS] OUTPUT
- IM7 では
magickが新たなメインコマンド。既存のconvertは互換用で、警告が出る環境があります。(ImageMagick)
主なオプション一覧
| オプション | 説明 | 使用例 |
|---|---|---|
-resize {WxH}{!^><} | リサイズ。> は拡大禁止、^ は短辺基準で切り抜き前提。 | magick in.jpg -resize 1280x720^ -gravity center -extent 1280x720 out.jpg (ImageMagick, Stack Overflow) |
-crop WxH+X+Y | 指定矩形で切り抜き。 | magick in.png -crop 640x360+100+50 out.png (ImageMagick) |
-extent WxH + -gravity | 余白を付けてキャンバス拡張（パディング）。 | magick in.jpg -background black -gravity center -extent 1920x1080 out.jpg (ImageMagick) |
-quality N | JPEG などの品質（1–100）。 | magick in.jpg -quality 85 out.jpg (ImageMagick) |
-strip | メタデータ/ICC等を削除（容量削減）。 | magick in.jpg -strip -quality 85 out.jpg (ImageMagick) |
-background COLOR | 背景色の指定（-extent などで使用）。 | magick in.png -background white -flatten out.jpg (ImageMagick) |
-font -pointsize -fill -annotate | テキスト描画（透かし等）。 | magick in.jpg -gravity southeast -pointsize 24 -fill white -annotate +10+10 "©2025" out.jpg (ImageMagick) |
-rotate N | 回転（度）。 | magick in.jpg -rotate 90 out.jpg (ImageMagick) |
-colorspace / -profile | 色空間/ICC プロファイル変換。 | magick in.tif -profile sRGB.icc out.jpg (ImageMagick) |
-density DPI（PDF等） | ベクタ入力のラスタライズ解像度。 | magick -density 300 in.pdf out.png (Stack Overflow) |
実行例
1) 形式変換と長辺リサイズ（Web向け）
説明: JPEG を 1280px の長辺に合わせて縮小し、PNG で出力。
コマンド:
magick in.jpg -resize 1280x1280\> out.png
（> で拡大を抑止。縮小時のみ適用） (ImageMagick)
2) サムネ用の「中央トリミング + パディング」
説明: 16:9 サムネを作る一般的手法。
コマンド:
magick in.jpg -resize 1280x720^ -gravity center -extent 1280x720 out.jpg
（^ は短辺基準 → はみ出し分は -extent で落とす） (Stack Overflow)
3) 透かし文字を右下に重ねる
説明: 白文字を10pxオフセットで配置。
コマンド:
magick in.jpg -gravity southeast -pointsize 24 -fill white -annotate +10+10 "© 2025 Example" out.jpg
テキスト描画は -font や -stroke で装飾も可能。(ImageMagick)
4) PDF を 300dpi で画像化（1ページ→1枚）
説明: Ghostscript が必要。高解像度レンダリング向け。
コマンド:
magick -density 300 input.pdf -quality 90 output-%03d.png
（IM は PDF/PS の処理に Ghostscript を利用します） (Synacktiv)
5) エラー例：Windowsで convert が別物を起動
説明: Windows には別の convert.exe（FAT→NTFS変換）があり、IM の convert より先に見つかることがあります。
コマンド:
convert
出力例（例）:
Converts FAT volumes to NTFS.
...
対処: IM7 では magick を使う、または PATH を調整/フルパス指定。(Super User, Stack Overflow)
関連コマンド
mogrify：上書きで一括処理（複数ファイルに同じ加工を適用）。identify：画像のメタ情報・寸法・プロファイル等を表示。composite：画像同士の合成（オーバーレイ）。(ImageMagick)montage：タイル状に並べて1枚にまとめる。magick：IM7 の統合コマンド（convert相当を含む）。(ImageMagick)
備考
- IM6 と IM7 の違い：IM7 では
convertは非推奨で、magickの使用が推奨。magick convert ...も互換として動きますが警告が出る場合があります。(ImageMagick) - オプション順序：ImageMagick は左から右へ処理します。入力→処理→出力の順に並べるのが基本です。(ImageMagick)
- PDF/PS 取扱い：Ghostscript が未導入だと PDF 変換が失敗します。また、セキュリティポリシーで PDF 読み込みが禁止されているディストリもあります（
policy.xml）。(Synacktiv, Stack Overflow) - Windows 衝突：
convert.exe（Windows標準）との名前衝突に注意。IM7 ではmagickを使うのが確実です。(Super User) - 色とプロファイル：厳密な色変換は
-profile（ICC）や-colorspaceを併用してください。(ImageMagick)
参考
- ImageMagick: Command-line Tools – Convert（IM7 では
magick推奨記載）
https://imagemagick.org/script/convert.php - Porting to ImageMagick v7（CLI が
magickに統合）
https://imagemagick.org/script/porting.php - Command-line Options 一覧
https://imagemagick.org/script/command-line-options.php - Resize/Scale の詳しい例
https://imagemagick.org/Usage/resize/ - Crop/Extent の詳しい例
https://imagemagick.org/Usage/crop/ - テキスト描画の例
https://imagemagick.org/Usage/text/ - Composite（画像合成）
https://imagemagick.org/script/composite.php - convert(1) man（Arch Linux）
https://man.archlinux.org/man/extra/imagemagick/convert.1.en - Windows の
convert.exeとの衝突（対処にmagick推奨）
https://stackoverflow.com/questions/38163849/imagemagick-issue-with-windows-and-convert-function - PDF→画像化のヒント（
-densityなど）
https://stackoverflow.com/questions/2869908/convert-pdf-to-png-using-imagemagick
コメント