pptopic/README.md

pptopic

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

功能

• 📊 PPT 转长图：将 PPTX 文件导出为一张连续的长图
• 🖼️ 图片优化：支持使用 pngquant 进行无损压缩
• ⚙️ 灵活配置：可自定义输出尺寸、格式、保存路径等

环境要求

• Windows 系统（依赖 PowerPoint COM 接口）
• Python ≥ 3.13
• 已安装 Microsoft PowerPoint

安装

pip install pptopic

如需图片优化功能，请安装 pngquant：

scoop install pngquant

也可以使用你熟悉的图片优化引擎替代 pngquant ，但一般情况下，我更推荐 pngquant 。

使用

导出长图

# 基本用法
pptopic export presentation.pptx

# 指定输出文件名和目录
pptopic export presentation.pptx -o result.png -d ./output

# 自定义宽度并启用优化
pptopic export presentation.pptx --width 1200 --optimize

优化图片

# 优化现有图片
pptopic optimize image.png

# 指定输出路径和最大高度
pptopic optimize image.png -o optimized.png --max-height 20000

命令选项

export 命令

选项	简写	说明
--output	-o	输出文件名
--dir	-d	输出目录（默认当前目录）
--width	-w	导出图片宽度（像素）
--format	-f	输出格式：JPG 或 PNG（默认 PNG）
--optimize	-	启用图片优化
--max-height	-	优化时最大高度（默认 29999）

optimize 命令

选项	简写	说明
--output	-o	输出文件路径
--max-height	-	最大高度限制
--engine	-	优化引擎（默认 pngquant）

示例

# 导出并优化
pptopic export presentation.pptx --optimize

# 导出为 JPG 格式
pptopic export presentation.pptx -f JPG -o result

许可证

MIT License