# 功能總覽

ConvertX-CN 內建 25+ 種轉換引擎，支援 1000+ 種檔案格式轉換。

---

## 目錄

- [轉換引擎總覽](#轉換引擎總覽)
- [影音轉換](#影音轉換)
- [圖片處理](#圖片處理)
- [文件轉換](#文件轉換)
- [PDF 進階處理](#pdf-進階處理)
- [OCR 文字辨識](#ocr-文字辨識)
- [電子書轉換](#電子書轉換)
- [其他轉換器](#其他轉換器)

---

## 轉換引擎總覽

| 轉換器           | 用途          | 輸入格式數 | 輸出格式數 |
| ---------------- | ------------- | ---------- | ---------- |
| FFmpeg           | 影音          | 472        | 199        |
| ImageMagick      | 圖片          | 253        | 183        |
| GraphicsMagick   | 圖片          | 167        | 130        |
| Vips             | 高效圖片處理  | 45         | 23         |
| LibreOffice      | 文件          | 41         | 22         |
| Pandoc           | 文件          | 43         | 65         |
| Calibre          | 電子書        | 31         | 21         |
| Inkscape         | 向量圖形      | 7          | 17         |
| PDFMathTranslate | PDF 翻譯      | 1          | 15         |
| BabelDOC         | PDF 翻譯/轉換 | 1          | 45         |
| MinerU           | PDF → MD      | 7          | 2          |
| OCRmyPDF         | PDF OCR       | 1          | 8          |
| Assimp           | 3D 模型       | 77         | 23         |

---

## 影音轉換

### FFmpeg

最強大的影音轉換工具，支援幾乎所有影音格式。

**支援格式**：

| 類型 | 輸入                                 | 輸出                       |
| ---- | ------------------------------------ | -------------------------- |
| 影片 | MP4, MKV, AVI, MOV, WebM, FLV 等 65+ | MP4, MKV, WebM, AVI 等 50+ |
| 音訊 | MP3, FLAC, WAV, AAC, OGG 等 120+     | MP3, FLAC, WAV, AAC 等 85+ |
| 字幕 | SRT, ASS, VTT 等 25+                 | SRT, ASS, VTT 等 12+       |

**使用範例**：

```
輸入：video.mov (500 MB)
輸出：video.mp4 (200 MB, H.264 編碼)
```

```
輸入：audio.flac (50 MB)
輸出：audio.mp3 (8 MB, 320kbps)
```

**GPU 加速設定**：

```yaml
environment:
  - FFMPEG_ARGS=-hwaccel cuda
  - FFMPEG_OUTPUT_ARGS=-c:v h264_nvenc
```

---

## 圖片處理

### ImageMagick

通用圖片處理工具，支援 250+ 種格式。

**支援格式**：

| 類型      | 格式範例                         |
| --------- | -------------------------------- |
| 常見格式  | PNG, JPEG, GIF, WebP, AVIF, HEIC |
| RAW 相機  | CR2, CR3, NEF, ARW, DNG          |
| 向量/文件 | PDF, PSD, AI, EPS, SVG           |
| 科學格式  | FITS, EXR, DPX                   |

**使用範例**：

```
輸入：photo.heic (iPhone 照片)
輸出：photo.jpg (JPEG 格式，相容性更好)
```

```
輸入：screenshot.png (4 MB)
輸出：screenshot.webp (800 KB, 壓縮率更高)
```

### Vips

高效能圖片處理工具，適合大圖處理。

**特點**：

- 記憶體使用效率高
- 處理速度快
- 適合批次處理

---

## 文件轉換

### LibreOffice

Office 文件轉換引擎。

**支援格式**：

| 輸入           | 輸出           |
| -------------- | -------------- |
| DOC, DOCX, ODT | PDF, HTML, TXT |
| XLS, XLSX, ODS | PDF, CSV, HTML |
| PPT, PPTX, ODP | PDF, PNG, SVG  |

**使用範例**：

```
輸入：report.docx (Word 文件)
輸出：report.pdf (PDF 文件，保留排版)
```

```
輸入：data.xlsx (Excel 試算表)
輸出：data.csv (CSV 純文字)
```

### Pandoc

萬用文件轉換器，支援 Markdown、LaTeX、HTML 等。

**支援格式**：

| 類型     | 格式                                 |
| -------- | ------------------------------------ |
| 標記語言 | Markdown, reStructuredText, AsciiDoc |
| 網頁     | HTML, EPUB                           |
| 排版     | LaTeX, PDF, DOCX                     |
| 純文字   | TXT, RTF                             |

**使用範例**：

```
輸入：README.md (Markdown)
輸出：README.pdf (排版精美的 PDF)
```

```
輸入：thesis.tex (LaTeX)
輸出：thesis.docx (Word 文件)
```

---

## PDF 進階處理

### PDFMathTranslate

翻譯 PDF 並**保留數學公式與排版**。

**特點**：

- 保留原始排版
- 保留數學公式
- 保留圖表位置
- 支援多種翻譯引擎

**支援語言**：

- 英文 ↔ 中文
- 英文 ↔ 日文
- 其他語言組合

**使用範例**：

```
輸入：paper.pdf (英文學術論文，含數學公式)
輸出：paper_zh.pdf (中文翻譯，公式保留)
```

### BabelDOC

進階 PDF 翻譯與轉換引擎。

**特點**：

- 高品質翻譯
- 支援複雜排版
- 多格式輸出

**使用範例**：

```
輸入：manual.pdf (英文使用手冊)
輸出：manual_translated.pdf (繁體中文版)
```

### MinerU

**PDF 轉 Markdown**，智能擷取內容。

**特點**：

- 智能識別表格
- 保留公式（轉為 LaTeX）
- 擷取圖片
- 保持結構層次

**使用範例**：

```
輸入：textbook.pdf (教科書 PDF)
輸出：textbook.md (Markdown 格式)
        └── images/ (擷取的圖片)
```

輸出內容範例：

```markdown
# 第一章 緒論

## 1.1 背景

根據研究顯示...

| 項目 | 數值 | 說明 |
| ---- | ---- | ---- |
| A    | 100  | 描述 |
| B    | 200  | 描述 |

公式如下：

$$E = mc^2$$
```

---

## OCR 文字辨識

### OCRmyPDF

為 PDF 添加 OCR 文字層，讓掃描 PDF 可搜尋。

**特點**：

- 保留原始 PDF 外觀
- 添加隱藏文字層
- 支援多語言辨識

**支援語言（一般版）**：

| 語言     | 代碼      |
| -------- | --------- |
| 繁體中文 | `chi_tra` |
| 簡體中文 | `chi_sim` |
| 英文     | `eng`     |
| 日文     | `jpn`     |
| 韓文     | `kor`     |
| 法文     | `fra`     |
| 德文     | `deu`     |

**Full 版支援 65 種語言**。

**使用範例**：

```
輸入：scan.pdf (掃描版 PDF，無法選取文字)
輸出：scan_ocr.pdf (可搜尋、可複製的 PDF)
```

---

## 電子書轉換

### Calibre

電子書格式轉換器。

**支援格式**：

| 輸入             | 輸出            |
| ---------------- | --------------- |
| EPUB, MOBI, AZW3 | EPUB, MOBI, PDF |
| PDF, TXT, HTML   | AZW3, DOCX, TXT |
| CBZ, CBR (漫畫)  | PDF, EPUB       |

**使用範例**：

```
輸入：book.epub (EPUB 電子書)
輸出：book.mobi (Kindle 格式)
```

```
輸入：comic.cbz (漫畫壓縮檔)
輸出：comic.pdf (PDF 格式)
```

---

## 其他轉換器

### Inkscape

向量圖形編輯與轉換。

| 輸入         | 輸出          |
| ------------ | ------------- |
| SVG, AI, EPS | PNG, PDF, EPS |
| PDF          | SVG           |

### Assimp

3D 模型格式轉換。

| 輸入           | 輸出           |
| -------------- | -------------- |
| FBX, OBJ, GLTF | OBJ, STL, GLTF |
| 3DS, DAE       | FBX, PLY       |

### Potrace / VTracer

點陣圖轉向量圖。

```
輸入：logo.png (點陣圖)
輸出：logo.svg (向量圖，可無限放大)
```

### Dasel

資料檔案格式轉換。

| 輸入/輸出                  |
| -------------------------- |
| JSON, YAML, TOML, XML, CSV |

```
輸入：config.yaml
輸出：config.json
```

---

## 功能比較表

| 功能              | Lite 版 | 一般版 | Full 版 |
| ----------------- | ------- | ------ | ------- |
| FFmpeg 影音       | ✅      | ✅     | ✅      |
| ImageMagick 圖片  | ✅      | ✅     | ✅      |
| LibreOffice 文件  | ✅      | ✅     | ✅      |
| Pandoc 文件       | ✅      | ✅     | ✅      |
| Calibre 電子書    | ✅      | ✅     | ✅      |
| OCRmyPDF (7語言)  | ❌      | ✅     | ✅      |
| OCRmyPDF (65語言) | ❌      | ❌     | ✅      |
| PDFMathTranslate  | ❌      | ✅     | ✅      |
| BabelDOC          | ❌      | ✅     | ✅      |
| MinerU            | ❌      | ✅     | ✅      |
| 完整 TexLive      | ❌      | ❌     | ✅      |

---

[⬆️ 回到頂部](#功能總覽) | [📚 回到目錄](00-專案總覽.md)