ImageMagick による画像操作

このスキルは、Windows、Linux、macOS システム全体で ImageMagick を使用した画像処理および操作タスクを実現します。

このスキルを使用する場合

次の場合にこのスキルを使用してください:

• 画像のリサイズ (単一またはバッチ)
• 画像の寸法とメタデータの取得
• 画像形式間の変換
• サムネイルの作成
• 異なる画面サイズ向けの壁紙処理
• 特定の条件に基づいた複数の画像のバッチ処理

前提条件

• システムに ImageMagick がインストール済み
• Windows: PowerShell で ImageMagick が magick として利用可能 (または C:\Program Files\ImageMagick-*\magick.exe に配置)
• Linux/macOS: Bash で ImageMagick がパッケージマネージャー (apt、brew など) 経由でインストール済み

コア機能

1. 画像情報

• 画像寸法 (幅 x 高さ) の取得
• 詳細なメタデータ (形式、色空間など) の取得
• 画像形式の識別

2. 画像のリサイズ

• 単一の画像をリサイズ
• 複数の画像をバッチリサイズ
• 指定した寸法でサムネイルを作成
• アスペクト比を維持

3. バッチ処理

• 寸法に基づいて画像を処理
• 特定のファイル形式をフィルタリングして処理
• 複数のファイルに変換を適用

使用例

例 0: magick 実行ファイルの解決

PowerShell (Windows):

# PATH 上の ImageMagick を優先
$magick = (Get-Command magick -ErrorAction SilentlyContinue)?.Source

# フォールバック: Program Files の一般的なインストールパターン
if (-not $magick) {
    $magick = Get-ChildItem "C:\\Program Files\\ImageMagick-*\\magick.exe" -ErrorAction SilentlyContinue |
        Select-Object -First 1 -ExpandProperty FullName
}

if (-not $magick) {
    throw "ImageMagick not found. Install it and/or add 'magick' to PATH."
}

Bash (Linux/macOS):

# magick が PATH に存在するかチェック
if ! command -v magick &> /dev/null; then
    echo "ImageMagick not found. Install it using your package manager:"
    echo "  Ubuntu/Debian: sudo apt install imagemagick"
    echo "  macOS: brew install imagemagick"
    exit 1
fi

例 1: 画像の寸法を取得

PowerShell (Windows):

# 単一の画像の場合
& $magick identify -format "%wx%h" path/to/image.jpg

# 複数の画像の場合
Get-ChildItem "path/to/images/*" | ForEach-Object { 
    $dimensions = & $magick identify -format "%f: %wx%h`n" $_.FullName
    Write-Host $dimensions 
}

Bash (Linux/macOS):

# 単一の画像の場合
magick identify -format "%wx%h" path/to/image.jpg

# 複数の画像の場合
for img in path/to/images/*; do
    magick identify -format "%f: %wx%h\n" "$img"
done

例 2: 画像をリサイズ

PowerShell (Windows):

# 単一の画像をリサイズ
& $magick input.jpg -resize 427x240 output.jpg

# 複数の画像をバッチリサイズ
Get-ChildItem "path/to/images/*" | ForEach-Object { 
    & $magick $_.FullName -resize 427x240 "path/to/output/thumb_$($_.Name)"
}

Bash (Linux/macOS):

# 単一の画像をリサイズ
magick input.jpg -resize 427x240 output.jpg

# 複数の画像をバッチリサイズ
for img in path/to/images/*; do
    filename=$(basename "$img")
    magick "$img" -resize 427x240 "path/to/output/thumb_$filename"
done

例 3: 詳細な画像情報を取得

PowerShell (Windows):

# 画像の詳細情報を取得
& $magick identify -verbose path/to/image.jpg

Bash (Linux/macOS):

# 画像の詳細情報を取得
magick identify -verbose path/to/image.jpg

例 4: 寸法に基づいて画像を処理

PowerShell (Windows):

Get-ChildItem "path/to/images/*" | ForEach-Object { 
    $dimensions = & $magick identify -format "%w,%h" $_.FullName
    if ($dimensions) {
        $width,$height = $dimensions -split ','
        if ([int]$width -eq 2560 -or [int]$height -eq 1440) {
            Write-Host "Processing $($_.Name)"
            & $magick $_.FullName -resize 427x240 "path/to/output/thumb_$($_.Name)"
        }
    }
}

Bash (Linux/macOS):

for img in path/to/images/*; do
    dimensions=$(magick identify -format "%w,%h" "$img")
    if [[ -n "$dimensions" ]]; then
        width=$(echo "$dimensions" | cut -d',' -f1)
        height=$(echo "$dimensions" | cut -d',' -f2)
        if [[ "$width" -eq 2560 || "$height" -eq 1440 ]]; then
            filename=$(basename "$img")
            echo "Processing $filename"
            magick "$img" -resize 427x240 "path/to/output/thumb_$filename"
        fi
    fi
done

ガイドライン

1. 常にファイルパスを引用符で囲む - スペースを含む可能性があるファイルパスは引用符で囲んでください
2. & 演算子を使用 (PowerShell) - PowerShell で magick 実行ファイルを呼び出す際は & を使用してください
3. パスを変数に保存 (PowerShell) - ImageMagick パスを $magick に割り当ててよりクリーンなコードにしてください
4. ループでラップ - 複数のファイルを処理する場合、ForEach-Object (PowerShell) または for ループ (Bash) を使用してください
5. 処理前に寸法を確認 - 不要な操作を避けるため、処理前に画像の寸法を確認してください
6. 適切なリサイズフラグを使用 - 厳密な寸法を強制する場合は ! を、最小寸法を指定する場合は ^ を使用することを検討してください

一般的なパターン

PowerShell パターン

パターン: ImageMagick パスを保存

$magick = (Get-Command magick).Source

パターン: 寸法を変数として取得

$dimensions = & $magick identify -format "%w,%h" $_.FullName
$width,$height = $dimensions -split ','

パターン: 条件付き処理

if ([int]$width -gt 1920) {
    & $magick $_.FullName -resize 1920x1080 $outputPath
}

パターン: サムネイルを作成

& $magick $_.FullName -resize 427x240 "thumbnails/thumb_$($_.Name)"

Bash パターン

パターン: ImageMagick インストールをチェック

command -v magick &> /dev/null || { echo "ImageMagick required"; exit 1; }

パターン: 寸法を変数として取得

dimensions=$(magick identify -format "%w,%h" "$img")
width=$(echo "$dimensions" | cut -d',' -f1)
height=$(echo "$dimensions" | cut -d',' -f2)

パターン: 条件付き処理

if [[ "$width" -gt 1920 ]]; then
    magick "$img" -resize 1920x1080 "$outputPath"
fi

パターン: サムネイルを作成

filename=$(basename "$img")
magick "$img" -resize 427x240 "thumbnails/thumb_$filename"

制限事項

• 大規模なバッチ操作はメモリを大量に消費する可能性があります
• 複雑な操作の中には追加の ImageMagick デリゲートが必要な場合があります
• 古い Linux システムでは、magick の代わりに convert を使用してください (ImageMagick 6.x vs 7.x)