ppt2fig 1.1.0__tar.gz

ppt2fig-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ElliottZheng
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ppt2fig-1.1.0/PKG-INFO

@@ -0,0 +1,240 @@
+Metadata-Version: 2.4
+Name: ppt2fig
+Version: 1.1.0
+Summary: 导出 PowerPoint 页面为 PDF，支持 Windows GUI 和跨平台 CLI。
+Home-page: https://github.com/elliottzheng/ppt2fig
+Author: Elliot Zheng
+Author-email: admin@hypercube.top
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: comtypes; platform_system == "Windows"
+Requires-Dist: pdfCropMargins
+Requires-Dist: pypdf
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# PPT2Fig
+
+PPT2Fig 是一个用于将 PPT 页面导出为 PDF 并自动裁剪白边的工具。
+
+- Windows 下保留原有 GUI，可直接导出当前打开的 PowerPoint 当前页
+- 新增跨平台 CLI，可直接指定 `pptx` 文件路径和页码
+- CLI 不依赖 Microsoft PowerPoint，可自动检测本机候选后端
+
+PPT2Fig exports PowerPoint slides to PDF and can automatically crop white margins.
+
+
+
+## 功能特点
+
+- Windows GUI 一键导出当前 PowerPoint 当前页为 PDF
+- 跨平台 CLI，支持指定 PPT/PPTX/ODP 文件和页码
+- CLI 不依赖 Microsoft PowerPoint
+- 自动检测系统中的候选后端
+- 自动裁剪白边
+- 可展开的高级裁剪设置：
+  - 快速预设：紧密裁剪、小白边、中白边、保留原边距
+  - 可调整保留原始边距的百分比
+  - 可设置额外的白边大小
+  - 可调整背景检测阈值
+  - 支持统一裁剪和统一页面大小选项
+- Windows GUI 智能记忆上次保存路径
+- Windows GUI 始终置顶显示，方便操作
+
+
+
+## 安装方法
+
+1. 直接下载[Releases](https://github.com/elliottzheng/ppt2fig/releases)中的exe文件，双击即可运行
+
+2. 如果你有python环境，可以使用pip安装
+
+```bash
+pip install ppt2fig
+```
+然后运行
+```bash
+ppt2fig
+```
+或者
+```bash
+python -m ppt2fig
+```
+
+如果你要在 Linux/macOS 上使用 CLI，推荐安装 LibreOffice，并确保命令行里能找到 `soffice` 或 `libreoffice`。
+
+## 使用方法
+
+### Windows GUI
+
+程序运行后会出现一个简洁的界面：
+
+![screenshot](./assets/screenshot.png)
+
+### 基本使用（适合大多数用户）：
+
+1. 点击"转PDF"按钮（请确保点击时PowerPoint是打开的）
+2. 选择保存位置并点击"保存"，则**当前活跃的PPT页面**会导出为PDF文件并自动裁剪白边
+3. 默认保存路径为当前活跃PPT文件所在目录
+
+### 高级设置（需要精细控制时）：
+
+点击"▼ 显示高级设置"展开详细参数控制：
+
+#### 快速设置预设：
+- **紧密裁剪**: 完全去除白边
+- **小白边**: 保留约1mm白边  
+- **中白边**: 保留约2mm白边
+- **保留原边距**: 保留10%的原始边距
+
+#### 详细参数设置：
+
+1. **保留原始边距(%)**: 设置保留原PDF边距的百分比
+   - 0% = 完全去除边距（紧密裁剪）
+   - 10% = 保留10%的原始边距
+   - 适合对有一定边距的PDF进行微调
+
+2. **额外白边(bp)**: 在裁剪后额外增加的白边大小
+   - 单位为 bp (big points)，1bp ≈ 0.35mm
+   - 适合需要为图片添加统一白边的场景
+
+3. **检测阈值**: 背景检测的阈值设置 (0-255)
+   - 默认值191适合大多数情况
+   - 值越小检测越严格，适合灰色背景
+   - 值越大检测越宽松
+
+4. **裁剪选项**:
+   - **统一裁剪**: 所有页面使用相同的裁剪量
+   - **统一页面大小**: 所有页面设为相同尺寸
+
+### CLI
+
+CLI 适用于 Linux、macOS、Windows，不依赖 PowerPoint。
+程序会自动检测本机候选后端。
+当前已实现的自动导出后端是：
+
+- `LibreOffice`: Windows / Linux / macOS
+- `PowerPoint`: Windows / macOS
+- `WPS`: Windows
+
+`--list-backends` 会尽量按当前平台列出已检测到的候选程序，即使该平台暂时还没有实现对应的自动导出驱动。
+在 `auto` 模式下，默认优先级是 `LibreOffice > WPS > PowerPoint`。
+
+基本示例：
+
+```bash
+ppt2fig ./demo.pptx --pages 3
+```
+
+导出多个页码：
+
+```bash
+ppt2fig ./demo.pptx --pages 1,3,5-7 -o ./figure.pdf
+```
+
+关闭裁剪：
+
+```bash
+ppt2fig ./demo.pptx --pages 2 --no-crop
+```
+
+指定 LibreOffice 可执行文件：
+
+```bash
+ppt2fig ./demo.pptx --pages 4 --office-bin /usr/bin/soffice
+```
+
+强制使用 PowerPoint 后端：
+
+```bash
+ppt2fig ./demo.pptx --pages 2 --backend powerpoint
+```
+
+强制使用 WPS 后端：
+
+```bash
+ppt2fig ./demo.pptx --pages 2 --backend wps
+```
+
+使用 PowerPoint 的打印质量导出：
+
+```bash
+ppt2fig ./demo.pptx --pages 2 --backend powerpoint --powerpoint-intent print
+```
+
+查看当前机器检测到的候选后端：
+
+```bash
+ppt2fig --list-backends
+```
+
+常用参数：
+
+- `--pages`: 必填，支持 `1,3,5-7`
+- `--output`: 输出 PDF 路径
+- `--office-bin`: 指定 `soffice` 或 `libreoffice`
+- `--backend`: 选择 `auto`、`libreoffice`、`powerpoint` 或 `wps`
+- `--powerpoint-intent`: PowerPoint 后端使用 `print` 或 `screen`
+- `--bitmap-missing-fonts`: 字体无法嵌入时将文字转为位图
+- `--list-backends`: 查看当前检测到的候选后端
+- `--no-crop`: 不裁剪白边
+- `--percent-retain`: 保留原始边距百分比
+- `--margin-size`: 额外白边，单位 bp
+- `--threshold`: 背景检测阈值
+- `--no-uniform`: 禁用统一裁剪
+- `--no-same-size`: 禁用统一页面大小
+
+
+## 系统要求
+
+- GUI:
+  - Windows
+  - Microsoft PowerPoint
+- CLI:
+  - Windows / Linux / macOS
+  - 推荐 LibreOffice
+- Python 3.8+
+
+## 依赖项（安装时自动安装）
+
+- comtypes: Windows GUI 下用于与PowerPoint交互
+- pdfCropMargins: 裁剪PDF白边
+- pypdf: 从导出的整份 PDF 中提取指定页
+- tkinter: Python 自带，仅 GUI 使用
+
+
+## 注意事项
+
+- GUI 使用前请确保已经打开 PowerPoint
+- GUI 依赖当前活动演示文稿
+- CLI 会先自动检测候选后端；不同平台上的自动导出支持范围不同
+- `--list-backends` 中的 `detected` 表示发现了候选程序，但当前平台未必已经实现自动导出
+- CLI 当前通过导出整份 PDF 后再抽取指定页，因此页码以导出后的 PDF 页序为准
+- 如果系统里没有可用的 LibreOffice 兼容后端，请安装 LibreOffice 或用 `--office-bin` 显式指定路径
+
+
+## 编译指南
+
+1. 下载源码
+2. 创建一个环境，只安装本项目依赖和pyinstaller
+3. 参考[配置upx](https://blog.csdn.net/JiuShu110/article/details/132625538)配置upx，用于压缩exe文件
+4. 编译
+```cmd
+pyinstaller -F -w -n ppt2fig --optimize=2 ppt2fig/main.py 
+```
+
+## 许可证
+
+[MIT License](LICENSE)

ppt2fig-1.1.0/README.md

@@ -0,0 +1,213 @@
+# PPT2Fig
+
+PPT2Fig 是一个用于将 PPT 页面导出为 PDF 并自动裁剪白边的工具。
+
+- Windows 下保留原有 GUI，可直接导出当前打开的 PowerPoint 当前页
+- 新增跨平台 CLI，可直接指定 `pptx` 文件路径和页码
+- CLI 不依赖 Microsoft PowerPoint，可自动检测本机候选后端
+
+PPT2Fig exports PowerPoint slides to PDF and can automatically crop white margins.
+
+
+
+## 功能特点
+
+- Windows GUI 一键导出当前 PowerPoint 当前页为 PDF
+- 跨平台 CLI，支持指定 PPT/PPTX/ODP 文件和页码
+- CLI 不依赖 Microsoft PowerPoint
+- 自动检测系统中的候选后端
+- 自动裁剪白边
+- 可展开的高级裁剪设置：
+  - 快速预设：紧密裁剪、小白边、中白边、保留原边距
+  - 可调整保留原始边距的百分比
+  - 可设置额外的白边大小
+  - 可调整背景检测阈值
+  - 支持统一裁剪和统一页面大小选项
+- Windows GUI 智能记忆上次保存路径
+- Windows GUI 始终置顶显示，方便操作
+
+
+
+## 安装方法
+
+1. 直接下载[Releases](https://github.com/elliottzheng/ppt2fig/releases)中的exe文件，双击即可运行
+
+2. 如果你有python环境，可以使用pip安装
+
+```bash
+pip install ppt2fig
+```
+然后运行
+```bash
+ppt2fig
+```
+或者
+```bash
+python -m ppt2fig
+```
+
+如果你要在 Linux/macOS 上使用 CLI，推荐安装 LibreOffice，并确保命令行里能找到 `soffice` 或 `libreoffice`。
+
+## 使用方法
+
+### Windows GUI
+
+程序运行后会出现一个简洁的界面：
+
+![screenshot](./assets/screenshot.png)
+
+### 基本使用（适合大多数用户）：
+
+1. 点击"转PDF"按钮（请确保点击时PowerPoint是打开的）
+2. 选择保存位置并点击"保存"，则**当前活跃的PPT页面**会导出为PDF文件并自动裁剪白边
+3. 默认保存路径为当前活跃PPT文件所在目录
+
+### 高级设置（需要精细控制时）：
+
+点击"▼ 显示高级设置"展开详细参数控制：
+
+#### 快速设置预设：
+- **紧密裁剪**: 完全去除白边
+- **小白边**: 保留约1mm白边  
+- **中白边**: 保留约2mm白边
+- **保留原边距**: 保留10%的原始边距
+
+#### 详细参数设置：
+
+1. **保留原始边距(%)**: 设置保留原PDF边距的百分比
+   - 0% = 完全去除边距（紧密裁剪）
+   - 10% = 保留10%的原始边距
+   - 适合对有一定边距的PDF进行微调
+
+2. **额外白边(bp)**: 在裁剪后额外增加的白边大小
+   - 单位为 bp (big points)，1bp ≈ 0.35mm
+   - 适合需要为图片添加统一白边的场景
+
+3. **检测阈值**: 背景检测的阈值设置 (0-255)
+   - 默认值191适合大多数情况
+   - 值越小检测越严格，适合灰色背景
+   - 值越大检测越宽松
+
+4. **裁剪选项**:
+   - **统一裁剪**: 所有页面使用相同的裁剪量
+   - **统一页面大小**: 所有页面设为相同尺寸
+
+### CLI
+
+CLI 适用于 Linux、macOS、Windows，不依赖 PowerPoint。
+程序会自动检测本机候选后端。
+当前已实现的自动导出后端是：
+
+- `LibreOffice`: Windows / Linux / macOS
+- `PowerPoint`: Windows / macOS
+- `WPS`: Windows
+
+`--list-backends` 会尽量按当前平台列出已检测到的候选程序，即使该平台暂时还没有实现对应的自动导出驱动。
+在 `auto` 模式下，默认优先级是 `LibreOffice > WPS > PowerPoint`。
+
+基本示例：
+
+```bash
+ppt2fig ./demo.pptx --pages 3
+```
+
+导出多个页码：
+
+```bash
+ppt2fig ./demo.pptx --pages 1,3,5-7 -o ./figure.pdf
+```
+
+关闭裁剪：
+
+```bash
+ppt2fig ./demo.pptx --pages 2 --no-crop
+```
+
+指定 LibreOffice 可执行文件：
+
+```bash
+ppt2fig ./demo.pptx --pages 4 --office-bin /usr/bin/soffice
+```
+
+强制使用 PowerPoint 后端：
+
+```bash
+ppt2fig ./demo.pptx --pages 2 --backend powerpoint
+```
+
+强制使用 WPS 后端：
+
+```bash
+ppt2fig ./demo.pptx --pages 2 --backend wps
+```
+
+使用 PowerPoint 的打印质量导出：
+
+```bash
+ppt2fig ./demo.pptx --pages 2 --backend powerpoint --powerpoint-intent print
+```
+
+查看当前机器检测到的候选后端：
+
+```bash
+ppt2fig --list-backends
+```
+
+常用参数：
+
+- `--pages`: 必填，支持 `1,3,5-7`
+- `--output`: 输出 PDF 路径
+- `--office-bin`: 指定 `soffice` 或 `libreoffice`
+- `--backend`: 选择 `auto`、`libreoffice`、`powerpoint` 或 `wps`
+- `--powerpoint-intent`: PowerPoint 后端使用 `print` 或 `screen`
+- `--bitmap-missing-fonts`: 字体无法嵌入时将文字转为位图
+- `--list-backends`: 查看当前检测到的候选后端
+- `--no-crop`: 不裁剪白边
+- `--percent-retain`: 保留原始边距百分比
+- `--margin-size`: 额外白边，单位 bp
+- `--threshold`: 背景检测阈值
+- `--no-uniform`: 禁用统一裁剪
+- `--no-same-size`: 禁用统一页面大小
+
+
+## 系统要求
+
+- GUI:
+  - Windows
+  - Microsoft PowerPoint
+- CLI:
+  - Windows / Linux / macOS
+  - 推荐 LibreOffice
+- Python 3.8+
+
+## 依赖项（安装时自动安装）
+
+- comtypes: Windows GUI 下用于与PowerPoint交互
+- pdfCropMargins: 裁剪PDF白边
+- pypdf: 从导出的整份 PDF 中提取指定页
+- tkinter: Python 自带，仅 GUI 使用
+
+
+## 注意事项
+
+- GUI 使用前请确保已经打开 PowerPoint
+- GUI 依赖当前活动演示文稿
+- CLI 会先自动检测候选后端；不同平台上的自动导出支持范围不同
+- `--list-backends` 中的 `detected` 表示发现了候选程序，但当前平台未必已经实现自动导出
+- CLI 当前通过导出整份 PDF 后再抽取指定页，因此页码以导出后的 PDF 页序为准
+- 如果系统里没有可用的 LibreOffice 兼容后端，请安装 LibreOffice 或用 `--office-bin` 显式指定路径
+
+
+## 编译指南
+
+1. 下载源码
+2. 创建一个环境，只安装本项目依赖和pyinstaller
+3. 参考[配置upx](https://blog.csdn.net/JiuShu110/article/details/132625538)配置upx，用于压缩exe文件
+4. 编译
+```cmd
+pyinstaller -F -w -n ppt2fig --optimize=2 ppt2fig/main.py 
+```
+
+## 许可证
+
+[MIT License](LICENSE)

ppt2fig-1.1.0/ppt2fig/__main__.py

@@ -0,0 +1,4 @@
+from .main import main
+
+if __name__=="__main__":
+    main()

ppt2fig-1.1.0/ppt2fig/cli.py

@@ -0,0 +1,130 @@
+import argparse
+from pathlib import Path
+
+from .core import detect_backends, export_selected_pages, parse_page_range
+
+
+def build_parser():
+    parser = argparse.ArgumentParser(
+        prog="ppt2fig",
+        description="将指定 PPTX 的指定页导出为 PDF，并可选自动裁剪白边。",
+    )
+    parser.add_argument("pptx", nargs="?", help="输入的 PPTX 文件路径")
+    parser.add_argument(
+        "-p",
+        "--pages",
+        help="要导出的页码，支持 1,3,5-7 这种格式，页码从 1 开始",
+    )
+    parser.add_argument(
+        "-o",
+        "--output",
+        help="输出 PDF 路径，默认在输入文件同目录下生成",
+    )
+    parser.add_argument(
+        "--office-bin",
+        help="手动指定导出后端可执行文件路径，例如 soffice 或 libreoffice",
+    )
+    parser.add_argument(
+        "--backend",
+        choices=["auto", "libreoffice", "powerpoint", "wps"],
+        default="auto",
+        help="选择导出后端，默认 auto",
+    )
+    parser.add_argument(
+        "--list-backends",
+        action="store_true",
+        help="列出当前系统检测到的候选后端并退出",
+    )
+    parser.add_argument(
+        "--powerpoint-intent",
+        choices=["print", "screen"],
+        default="print",
+        help="PowerPoint 后端的导出意图，默认 print",
+    )
+    parser.add_argument(
+        "--bitmap-missing-fonts",
+        action="store_true",
+        help="PowerPoint 后端在字体无法嵌入时将文字位图化",
+    )
+    parser.add_argument("--no-crop", action="store_true", help="导出后不裁剪白边")
+    parser.add_argument(
+        "--percent-retain",
+        type=float,
+        default=0.0,
+        help="保留原始边距的百分比，默认 0",
+    )
+    parser.add_argument(
+        "--margin-size",
+        type=float,
+        default=0.0,
+        help="裁剪后额外增加的白边，单位 bp，默认 0",
+    )
+    parser.add_argument(
+        "--threshold",
+        type=int,
+        default=191,
+        help="背景检测阈值，默认 191",
+    )
+    parser.add_argument(
+        "--no-uniform",
+        action="store_true",
+        help="禁用统一裁剪",
+    )
+    parser.add_argument(
+        "--no-same-size",
+        action="store_true",
+        help="禁用统一页面大小",
+    )
+    return parser
+
+
+def default_output_path(pptx_path, pages):
+    source = Path(pptx_path).resolve()
+    page_label = "_".join(str(page) for page in pages)
+    return source.with_name(f"{source.stem}.pages_{page_label}.pdf")
+
+
+def main(argv=None):
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    if args.list_backends:
+        backends = detect_backends(explicit_path=args.office_bin)
+        if not backends:
+            print("未检测到任何候选后端")
+            return
+        for backend in backends:
+            status = "supported" if backend.supported else "detected"
+            suffix = f" ({backend.detail})" if backend.detail else ""
+            print(f"{backend.name}\t{status}\t{backend.path}{suffix}")
+        return
+
+    if not args.pptx:
+        parser.error("缺少输入文件 pptx")
+    if not args.pages:
+        parser.error("missing required argument: -p/--pages")
+
+    pages = parse_page_range(args.pages)
+    source = Path(args.pptx).resolve()
+    if not source.exists():
+        parser.error(f"输入文件不存在: {source}")
+    if source.suffix.lower() not in {".pptx", ".ppt", ".odp"}:
+        parser.error("输入文件必须是 .pptx、.ppt 或 .odp")
+
+    output = Path(args.output).resolve() if args.output else default_output_path(source, pages)
+    export_selected_pages(
+        source,
+        output,
+        pages,
+        backend=args.backend,
+        office_bin=args.office_bin,
+        powerpoint_intent=args.powerpoint_intent,
+        bitmap_missing_fonts=args.bitmap_missing_fonts,
+        no_crop=args.no_crop,
+        percent_retain=args.percent_retain,
+        margin_size=args.margin_size,
+        use_uniform=not args.no_uniform,
+        use_same_size=not args.no_same_size,
+        threshold=args.threshold,
+    )
+    print(output)