pptx-to-image Skill#

将 PowerPoint (PPTX) 演示文稿转换为高质量图片（JPG/PNG），支持自定义 DPI 和保持原始比例。

---

功能#

• 高 DPI 输出：支持 72-600 DPI 自定义，默认 300 DPI
• 保持比例：自动检测原 PPT 页面尺寸，保持原始宽高比
• 方向自适应：横版/竖版自动识别
• 多格式支持：JPG、PNG 可选
• 批量转换：支持多页幻灯片批量导出
• 质量检查：输出前自动验证 DPI 和尺寸

---

使用方式#

作为 Python 脚本调用#

bash

py pptx_to_image.py --input presentation.pptx --output ./slides --dpi 300 --format jpg

参数说明#

参数默认值说明--input / -i(必填)输入的 PPTX 文件路径--output / -o``./output输出文件夹路径--dpi``300输出图片 DPI (72-600)--format``jpg输出格式： jpg 或 png``--quality``95JPG 质量 (1-100)--verbose / -v``False显示详细信息

---

示例#

基础转换（300 DPI）#

bash

py pptx_to_image.py -i my_presentation.pptx -o ./slides

高清转换（600 DPI，PNG 格式）#

bash

py pptx_to_image.py -i my_presentation.pptx -o ./slides --dpi 600 --format png

快速预览（150 DPI）#

bash

py pptx_to_image.py -i my_presentation.pptx -o ./preview --dpi 150

---

依赖#

• Python 3.10+
• Windows 系统（需要 PowerPoint COM 接口）
• pywin32 库

安装依赖：

bash

pip install pywin32

---

输出示例#

text

============================================================
PPTX → JPG | 保持原始比例 | 300 DPI
============================================================
原始尺寸：1700.75 x 2267.75 点
原始比例：0.7500
方向：竖版 (Portrait)

目标 DPI: 300
目标尺寸：7086 x 9448 像素
实际 DPI X: 300.0
实际 DPI Y: 300.0

幻灯片数量：5

[OK] 已导出第 1 页
  路径：./slides/slide_001.jpg
  尺寸：7086 x 9448 像素
  大小：6117.7 KB

...

============================================================
[DONE] 完成！共导出 5 张图片
  slide_001.jpg: 5.97 MB
  slide_002.jpg: 4.23 MB
  slide_003.jpg: 5.81 MB
  slide_004.jpg: 3.92 MB
  slide_005.jpg: 6.15 MB

---

技术细节#

DPI 计算#

python

# 1 点 = 1/72 英寸
# 像素 = 点 × (DPI / 72)
scale_factor = dpi / 72.0
target_width = int(orig_width * scale_factor)
target_height = int(orig_height * scale_factor)

导出方法#

使用 PowerPoint COM 接口的 Slide.Export() 方法，直接指定像素尺寸，确保精确的 DPI 输出。

---

注意事项#

1. Windows 专用：依赖 PowerPoint COM 接口，仅支持 Windows
2. 需要安装 PowerPoint：必须有 Microsoft PowerPoint 2010+
3. 窗口可见：转换时 PowerPoint 窗口会短暂显示（COM 限制）
4. 大文件处理：高 DPI 转换可能产生大文件（单页 5-10 MB）

---

常见问题#

Q: 为什么输出 DPI 不是 300？ A: 确保使用 --dpi 300 参数，脚本会自动计算正确的像素尺寸。

Q: 可以批量转换多个 PPTX 吗？ A: 当前版本单文件处理，可配合批处理脚本使用。

Q: 支持 Mac 吗？ A: 不支持，Mac 需要不同的实现方式（AppleScript）。

---

版本历史#

• v1.0.0 (2026-03-20) - 初始版本

  • 基础 PPTX → JPG/PNG 转换
  • 自定义 DPI 支持
  • 自动比例保持
  • 详细输出报告

---

License#

MIT License