---
# System prepended metadata

title: imageMagcick
tags: [app]

---

# ImageMagick 常用參數與範例速查表

---

## 基本用法
```bash
magick input.jpg [參數...] output.jpg
```
- `input.jpg`：輸入檔案
- `output.jpg`：輸出檔案（可轉換格式，例如 JPG → PNG）

---

## 顏色與色彩空間
- `-colorspace Gray`   
  將影像轉為灰階。  
  範例：
  ```bash
  magick input.jpg -colorspace Gray output.jpg
  ```
- `-colors N`（建議：8~256，減色用）  
  限制顏色數量（減色處理）。

---

## 對比與亮度調整
- `-auto-level`   
  自動調整亮度範圍（黑變黑、白變白）。
- `-contrast-stretch 黑% x 白%`（建議：`1%x1%`，雜訊多可用 `2%x2%`）  
  拉伸對比，忽略極暗與極亮的百分比。  
  範例：`-contrast-stretch 1%x1%` → 忽略最暗與最亮的 1% 像素。
- `-brightness-contrast BxC`（建議：`10x15` 內，避免過曝或過暗）  
  調整亮度與對比，例：`-brightness-contrast 10x15`

---

## 銳化與模糊
- `-sharpen 半徑x標準差`（建議：`0x2` 一般；`0x1` 輕微；`0x3~0x5` 強化邊緣）  
  銳化影像，例：`-sharpen 0x2`
- `-blur 半徑x標準差`（建議：`0x1` 輕微降噪）  
  模糊影像，例：`-blur 0x1`

---

## 尺寸與裁切
- `-resize WxH`（建議：只給一邊，另一邊自動等比）  
  調整大小。
- `-crop WxH+X+Y`  
  裁切影像，`W` 寬，`H` 高，`X` 與 `Y` 為偏移量。
- 旋轉與裁切：
  ```bash
  convert -rotate 50 -crop 1920x1080+50+50 Z:\input.png Z:\output.png
  ```

---

## 去除多餘資訊與空白
- `-strip`（建議：攝影存檔不建議）  
  移除 EXIF 與附加資訊（可減少檔案大小）。
- 去除空白：
  ```bash
  convert -trim -fuzz 1% +repage Z:\input.png Z:\output.png
  ```

---

## 邊框與形態學處理
- 增加邊框：
  ```bash
  convert -mattecolor #ffffff -frame 10x10 Z:\input.png Z:\output.png
  ```
- **形態學閉運算（Morphology Close）**（建議：`Disk:1` 去除小洞、補齊邊緣）  
  ```bash
  magick input.png -morphology Close Disk:1 output.png
  ```
  - 適合去除細小黑洞或斷裂邊界，讓物體輪廓更完整。

---

## 降噪
- 增加躁點並模糊（建議：適合製作效果圖）：
  ```bash
  convert -noise 2 +noise gaussian -blur 0x1 Z:\input.png Z:\output.png
  ```
- **去除雜點（Despeckle）**（建議：物件邊緣不破壞時可用）  
  ```bash
  magick input.png -despeckle output.png
  ```
  - 對小雜點有效，但可能會稍微平滑細節。

---

## 合併圖片
```bash
magick composite -dissolve 50% Z:\input1.png Z:\input2.png Z:\output.png
```

---

## 壓縮與品質
- JPEG 壓縮（建議：`85` 平衡畫質與檔案大小）：
  ```bash
  magick input.jpg -quality 85 output.jpg
  ```
- PNG 壓縮（pngquant，有損減色，建議：`--quality=70-90`）：
  ```bash
  pngquant.exe --force --quality=100 Z:\input.png -o Z:\output.png
  ```

---

## 批次處理範例
```bash
magick mogrify -path output_folder -resize 800x -quality 85 *.jpg
```
將資料夾內所有 JPG 縮放至寬 800px，並輸出到 `output_folder`。

---

## 常見前處理流程（物件辨識用）
```bash
magick input.jpg -auto-level -contrast-stretch 1%x1% -sharpen 0x2 -morphology Close Disk:1 -despeckle -strip -quality 85 output.jpg
```
步驟：
1. 轉灰階  
2. 自動亮度  
3. 對比增強（1%x1%）  
4. 銳化（0x2）  
5. 形態學閉運算（Disk:1 補邊）  
6. 去雜點（Despeckle）  
7. 移除 EXIF  
8. JPEG 壓縮（85）
