PPTX to Image Converter

Convert PowerPoint PPTX files to high-quality JPG or PNG images with customizable DPI, maintaining original slide proportions and orientation on Windows.

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	95	JPG 质量 (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