Mentor 工程批量导出 PDF 测试工具

独立 Windows 简易界面,扫描 DxDesigner 原理图工程,通过本机原生 sch2pdf.exe 串行导出 PDF。每个任务在独立工程副本中执行,不保存或改写源工程,不修改源工程的 dxpdf.ini。这是 v0.1.0 测试版,不是无需 Mentor 的独立转换器。

使用便携版

解压整个发行目录,双击 MentorPDFExporter.exe。不能只复制 exe,必须保留 _internal 文件夹。用户不需要安装 Python,但本机必须安装 Mentor、拥有有效许可证,工程引用的库必须可访问。

  1. 选择包含一个或多个工程的目录,点击“扫描工程”。排除 PCB、备份、输出、运行目录;会完整递归而不是根目录发现工程后提前结束。
  2. 选择源工程外部的 PDF 输出目录。工程名相同的项目通过路径摘要区分,不会互相覆盖。
  3. 检查自动发现的 sch2pdf.exe,必要时手动选择。
  4. 网络中心库不可达时,显式选择对应本地 .lmc。工具只修改工作副本的 CentralLibrary,不改源工程;不会自动选择可能不匹配的库。
  5. 勾选工程,确认配置,然后开始导出。默认不覆盖已有 PDF。失败项可通过“选中失败项重试”重新执行。
  6. 可以停止当前任务及后续队列;仅结束工具启动的引擎进程树,不关闭用户的 DxDesigner。

配置与安全

  • 默认白底彩色并保留彩色文字(-c 4)、器件弹出菜单开启、可见超链接关闭、URL-valued 清空、ICT 转原理图开启、线宽 1。
  • Use exclusion info 按截图保持勾选,它不等于“去掉文字掩盖”。不要为了掩盖问题直接关闭排除信息。
  • 整工程范围可能包含非顶层 Block;如只需要截图中的 Block 范围,选择“指定原理图 / Block”并填真实名称,例如 PON,不是 Board1。
  • 现有字体映射保留;笔画字体提供对照方式。不同工程的中文、特殊字符和背景掩盖效果仍须查看样张。PDF 结构成功不代表排版、中文及图页范围全部验收完成。
  • 源数据库必须在工程内部,含外部数据库路径或链接的工程不执行,以免副本反而写回原数据库。
  • 工作副本中排除 PCB、CES、ICXPro、Integration、备份与历史日志;不依赖这些目录的标准原理图工程已做验证,特殊外部依赖需要人工检查。
  • 已有输出只有显式勾选覆盖后才替换。引擎正常退出且 PDF 解析成功、至少一页、源内容指纹一致后,才发布新文件。

日志

默认保存到 %LOCALAPPDATA%\MentorPDFExporter\runs。每次记录源工程指纹、实际命令、副本配置、stdout/stderr、PDF 页数/摘要以及结果 JSON,失败输出不会成为正式 PDF。发布前以原子写入并刷盘方式持久化提交预记录;覆盖前保留旧 PDF 备份。若提交后结果记录写入失败,会返回“待核验”并保留真实输出路径,不能当作完整成功。工作副本包含工程数据,请按公司要求保存;测试版不自动删除运行记录。

已确认的真实测试

本机 EE 7.9.5;PON 示例工程原引用 192.168.0.252 的网络中心库,首次默认路径导出超时且只产生空 PDF;在副本中显式使用本地对应库后正常导出 24 页。源工程参与复制的文件内容指纹一致。样张外部 URL 数为零。

默认样张部分中文批注存在乱码、浅色原理图对象对白底对比度较低,因此该版本只标为测试版,不把 PDF 结构验证当作最终出图质量验收。

额外安全保护

  • 队列开始前统一检查全部源工程,防止 A 的输出目录误选到 B 的数据库中。
  • CLI 报告仅允许 .json,拒绝写入源工程/运行证据目录或覆盖非本工具的 JSON;自动测试截图也不能写入源目录。
  • 最后一次源内容核验在发布之前完成,不在覆盖旧 PDF 后才否决结果。
  • 批量队列预记录写入失败时不启动引擎;末尾记录更新失败仍保留计数、内存结果和逐工程提交预记录。
  • 打包排除构建机 PATH 中误发现的第三方 ICU DLL,使用与本机 Qt 轮子配套的 Windows 系统依赖。
  • 当前真实验收环境为 Windows 11;尚未对其他 Windows 版本做兼容性验收。

开发

Python 3.12。安装依赖后:

$env:PYTHONPATH = "$(Get-Location)\src"
.\.venv\Scripts\python.exe -m mentor_pdf_export
.\.venv\Scripts\python.exe -m pytest -q
.\.venv\Scripts\python.exe -m PyInstaller packaging\MentorPDFExporter.spec --distpath release --workpath build\pyinstaller --noconfirm

CLI:--self-check --report FILE;批量命令行:--export A.prj B.prj --output DIR --library LOCAL.lmc --report FILE;UI 自动测试:--project-root DIR --output DIR --library LOCAL.lmc --ui-smoke SCREENSHOT.png --ui-export-smoke --report FILE。

源码、测试和说明纳入 Git。原始文档、Mentor 工程、PDF、运行数据和发行产物不入 Git。无自动上传、联网更新或用户环境变量修改。

S
Description
Mentor / DxDesigner PDF batch exporter for Windows
Readme
181 KiB
0 Stars 8 Watchers 0 Forks
2026-10-10 16:28:18 +08:00
Languages
Python 99.8%
Batchfile 0.2%