# pptopic

将 PowerPoint 演示文稿导出为长图的工具。

## 功能

- 将 PPTX 文件的所有幻灯片垂直拼接为一张长图
- 支持 JPG 和 PNG 格式输出
- 支持自定义输出宽度和目录
- 内置图片优化功能，使用图片优化引擎进行无损压缩

## 安装

### 安装 uv

```bash
# 使用 scoop
scoop install uv
```

### 安装 pptopic

```bash
uv pip install -e .
```

## 使用

### 导出 PPTX 为长图

```bash
# 基本用法
pptopic export presentation.pptx

# 指定输出文件名
pptopic export presentation.pptx --output result.png

# 优化导出的图片
pptopic export presentation.pptx --optimize

# 自定义宽度和最大高度
pptopic export presentation.pptx --width 1080 --optimize --max-height 20000
```

### 单独优化图片

```bash
# 优化图片
pptopic optimize image.png

# 指定输出文件
pptopic optimize image.png --output optimized.png

# 自定义优化参数
pptopic optimize image.png --max-height 20000 --engine pngquant
```

## 系统要求

- Windows 系统（使用 win32com 调用 PowerPoint）
- Python >= 3.13
- Microsoft PowerPoint

## 图片优化

推荐使用 [pngquant](https://pngquant.org/) 进行图片压缩。

### 自动安装脚本

使用提供的 PowerShell 脚本自动安装 pngquant：

```powershell
.\install-pngquant.ps1
```

该脚本会自动：
1. 检查 pngquant 是否已安装
2. 如果未安装，检查 scoop 是否已安装
3. 如果 scoop 未安装，自动安装 scoop
4. 使用 scoop 安装 pngquant

### 手动安装

```bash
scoop install pngquant
```