发布 PDFReaderLite 0.2.2
This commit is contained in:
@@ -2,20 +2,27 @@
|
||||
|
||||
PDFReaderLite 是一个面向 Windows 的轻量 PDF 阅读与覆盖式编辑工具,目标是提供 Adobe Acrobat 常用功能的轻量替代版。
|
||||
|
||||
当前稳定版本:`0.2.1`
|
||||
当前稳定版本:`0.2.2`
|
||||
|
||||
## 当前能力
|
||||
|
||||
- 多标签打开 PDF。
|
||||
- 连续阅读、缩放、适应宽度、适应页面、页码跳转。
|
||||
- 左侧自适应缩略图。
|
||||
- 阅读、编辑PDF、页面、工具、注释模式切换。
|
||||
- 文本搜索。
|
||||
- 指针/手形工具切换,阅读、编辑PDF、页面、工具、注释模式切换。
|
||||
- 文本搜索,搜索结果跳转并临时高亮。
|
||||
- PDF 自带目录/书签显示与跳转。
|
||||
- 真实文本选择,支持复制、右键高亮、添加注释。
|
||||
- 高亮、下划线、删除线、批注、自由画笔、矩形、圆形、线条、箭头。
|
||||
- 注释列表、注释跳转、注释删除。
|
||||
- 添加文本、放置文本、插入图片、放置图片、遮盖区域。
|
||||
- 高亮颜色支持橙色、黄色、绿色、浅蓝色、粉色、红色。
|
||||
- 注释列表、注释筛选、搜索、排序、仅当前页、导出、跳转、删除。
|
||||
- 注释属性修改,支持内容、颜色、字号、线宽、透明度等常见属性。
|
||||
- 鼠标悬停注释符号显示注释内容,双击注释符号可修改注释。
|
||||
- 添加文本、插入图片、遮盖区域。
|
||||
- 图片签名、放置签名、手写签名。
|
||||
- 对象选择、移动、缩放、删除、复制粘贴、图层顺序、对齐与分布。
|
||||
- 页面旋转、删除、移动、插入、提取、拆分、合并。
|
||||
- 页面管理支持网格缩略图、多选、批量删除、批量旋转、批量提取、拖入 PDF 插入页面。
|
||||
- 基础表单填写。
|
||||
- 导出页面图片、批量导出图片、图片合成 PDF。
|
||||
- 保存、另存为、加密另存为、移除密码另存为。
|
||||
@@ -23,26 +30,26 @@ PDFReaderLite 是一个面向 Windows 的轻量 PDF 阅读与覆盖式编辑工
|
||||
- 深色模式、窗口状态记忆、异常日志。
|
||||
- 单文件 exe 打包。
|
||||
|
||||
## 第二版计划
|
||||
## 当前版本重点
|
||||
|
||||
第二版重点提升注释和编辑能力:
|
||||
`0.2.2` 在 `0.2.1` 的阅读、页面管理和基础编辑能力上,重点完善 Acrobat 风格的常用审阅流程:
|
||||
|
||||
- 第二版先支持框选区域高亮、下划线、删除线;真实文本选区标注留到第三版。
|
||||
- 注释属性面板。
|
||||
- 注释列表筛选和搜索。
|
||||
- 图章工具。
|
||||
- 文本框二次编辑,以及新建文本默认字号、颜色。
|
||||
- 未保存图片、签名、图章对象支持旋转、透明度、裁剪。
|
||||
- 文本、图片、签名、遮盖、图形注释统一对象选择,常见注释支持复制粘贴。
|
||||
- 右键菜单、Esc 取消、Delete 删除、方向键微调。
|
||||
- 未保存状态进一步完善。
|
||||
- 指针模式下可选择 PDF 真实文本,支持逐字/逐字母选取。
|
||||
- 双栏文档选择文字时优先按左栏、右栏阅读顺序处理。
|
||||
- 选择文字后的右键菜单支持多色高亮、复制、添加注释。
|
||||
- 添加注释后自动高亮所选文字,并保留注释符号和悬停提示。
|
||||
- 注释模式下可捕捉已有注释,进行属性修改、删除和内容编辑。
|
||||
- Ctrl+滚轮缩放、页面旋转等操作尽量保持当前页和视图位置。
|
||||
|
||||
文档入口:
|
||||
|
||||
- [开发计划](docs/development_plan.md)
|
||||
- [V2 注释与编辑专项计划](docs/v2_annotation_edit_plan.md)
|
||||
- [V2 需求清单](docs/v2_requirements_checklist.md)
|
||||
- [V1 发布说明](docs/release_v0.2.1.md)
|
||||
- [V3 Acrobat 工作流增强计划](docs/v3_acrobat_workflow_plan.md)
|
||||
- [V4 可选高级能力探索计划](docs/v4_optional_advanced_plan.md)
|
||||
- [V0.2.2 发布说明](docs/release_v0.2.2.md)
|
||||
- [V0.2.1 发布说明](docs/release_v0.2.1.md)
|
||||
|
||||
V2 验收:
|
||||
|
||||
|
||||
Vendored
BIN
Binary file not shown.
+41
-12
@@ -7,7 +7,8 @@ PDFReaderLite 是面向 Windows 的轻量 PDF 阅读与覆盖式编辑工具,
|
||||
核心边界:
|
||||
|
||||
- 重点做阅读、注释、覆盖式编辑、页面管理、基础表单、视觉签名、导出、密码保护。
|
||||
- 不做复杂 OCR、PDF 原文重排编辑、数字证书签名、真正永久擦除敏感信息。
|
||||
- V3 已完成,当前稳定版本为 `v0.2.2`,重点做更像 Acrobat 的常用审阅和编辑流程。
|
||||
- V4 可重新评估 OCR、导出文本/图片、遮盖标记、签名记录等可选增强,但仍保持轻量边界。
|
||||
- 打包形态以单文件 exe 为主。
|
||||
|
||||
## V1:稳定可用版
|
||||
@@ -44,9 +45,9 @@ V1 已发布为 `v0.2.1`,发布产物为 `dist/PDFReaderLite.exe`。
|
||||
|
||||
## V2:注释与编辑增强版
|
||||
|
||||
V2 目标是把“能用”提升为“顺手”,重点参考 Acrobat 的注释审阅和覆盖式编辑工作流。
|
||||
V2 已并入当前 `v0.2.2` 代码。目标是把“能用”提升为“顺手”,重点参考 Acrobat 的注释审阅和覆盖式编辑工作流。
|
||||
|
||||
主线:
|
||||
已完成主线:
|
||||
|
||||
- 注释主线:文本选择标注、注释属性、注释列表筛选搜索、图章。
|
||||
- 编辑主线:文本框二次编辑、对象属性、统一对象选择、复制删除移动缩放。
|
||||
@@ -54,18 +55,46 @@ V2 目标是把“能用”提升为“顺手”,重点参考 Acrobat 的注
|
||||
|
||||
优先功能包见 [V2 注释与编辑专项计划](v2_annotation_edit_plan.md)。
|
||||
|
||||
## V3:实用工具增强版
|
||||
## V3:Acrobat 常用审阅与编辑流程增强版
|
||||
|
||||
候选方向:
|
||||
V3 已并入当前 `v0.2.2` 代码。目标是让高频工作流更接近 Acrobat,但继续坚持“简单、实用、轻量”的原则。
|
||||
|
||||
- 水印工具:文字水印、图片水印,支持全部页/指定页。
|
||||
- 图像编辑增强:裁剪、替换、透明度、旋转。
|
||||
- 页面对象列表:显示当前页新增对象,点击选中。
|
||||
- 注释导出:导出为 txt/html/json。
|
||||
- 简单测量工具:两点距离、线段长度。
|
||||
- 更完整的表单支持。
|
||||
已完成主线:
|
||||
|
||||
## 长期不纳入范围
|
||||
- 真实文本选择:选中 PDF 真实文本后直接高亮、下划线、删除线。
|
||||
- 选区右键菜单:选中文本后弹出多色高亮、复制、添加注释等常用动作。
|
||||
- 文本框样式:已有 FreeText 文本框支持修改内容、字号和文字颜色。
|
||||
- 注释列表增强:按页码、类型、创建顺序排序,只看当前页注释,导出 txt/json。
|
||||
- 页面管理增强:页面管理视图支持多选、批量删除、批量旋转、批量提取。
|
||||
- 搜索与导航:搜索结果显示上下文,点击跳转并临时高亮;支持 PDF 自带目录/书签面板。
|
||||
- 对象操作增强:对象复制粘贴尽量保留样式,支持简单对齐和分布。
|
||||
|
||||
缺陷修复与体验改进:
|
||||
|
||||
- 指针和手形工具互斥,右侧模式按钮互斥,两组状态互不干扰。
|
||||
- 软件启动默认手形工具,指针工具用于文字选择和复制。
|
||||
- Ctrl+鼠标滚轮缩放、页面旋转、页面操作后尽量保留当前页和视图位置。
|
||||
- 双栏文档文字选择优先按栏位处理,降低跨栏误选。
|
||||
- 对水印、行号、页边元素进行选择过滤,降低误选概率。
|
||||
- 鼠标悬停注释符号时显示注释内容;双击注释符号可编辑注释。
|
||||
- 已有文本高亮支持重新选中并修改颜色。
|
||||
|
||||
专项计划见 [V3 Acrobat 工作流增强计划](v3_acrobat_workflow_plan.md)。
|
||||
|
||||
## V4:可选高级能力探索版
|
||||
|
||||
V4 允许重新讨论部分之前不做的功能,但必须保持明确边界,不承诺 Acrobat Pro 级完整能力。
|
||||
|
||||
可选方向:
|
||||
|
||||
- OCR:可做外部 OCR 插件或可选安装,不内置到单 exe。
|
||||
- PDF 导出:可做导出文本、导出图片,不承诺 PDF 转 Word 并保持原排版。
|
||||
- 敏感信息处理:可做遮盖标记和风险提示,不宣称真正永久擦除。
|
||||
- 签名:可做签名图片和签名记录,不做数字证书级签名。
|
||||
|
||||
专项计划见 [V4 可选高级能力探索计划](v4_optional_advanced_plan.md)。
|
||||
|
||||
## 长期保持谨慎的范围
|
||||
|
||||
- PDF 转 Word 并保持原排版。
|
||||
- PDF 转 Excel 并保持表格结构。
|
||||
|
||||
@@ -0,0 +1,54 @@
|
||||
# PDFReaderLite v0.2.2 发布说明
|
||||
|
||||
发布日期:2026-07-01
|
||||
|
||||
## 发布产物
|
||||
|
||||
当前为源码版本升级。打包后产物仍为:
|
||||
|
||||
```text
|
||||
dist\PDFReaderLite.exe
|
||||
```
|
||||
|
||||
版本信息:
|
||||
|
||||
- 应用版本:`0.2.2`
|
||||
- exe 版本:`0.2.2`
|
||||
- 文件大小:`49,463,139 bytes`
|
||||
- SHA256:`0A7701E9F10D23009CF22C8188A094DA1DDBCAF8C2455D352546EB65A9B74CBA`
|
||||
- Git 标签:待发布后填写
|
||||
|
||||
## 本版定位
|
||||
|
||||
`0.2.2` 是第三版审阅与编辑流程增强后的稳定版本,重点完善 Acrobat 风格的文本选择、注释、页面管理和视图保持体验。
|
||||
|
||||
## 主要新增与完善
|
||||
|
||||
- 指针模式支持选择 PDF 真实文本,并支持逐字、逐字母选择。
|
||||
- 选中文本后右键菜单支持复制、多色高亮、下划线、删除线、添加注释。
|
||||
- 高亮颜色支持橙色、黄色、绿色、浅蓝色、粉色、红色。
|
||||
- 添加注释时可自动高亮所选文字,并在页面上保留注释符号。
|
||||
- 鼠标悬停注释符号显示注释内容;双击注释符号可修改注释内容。
|
||||
- 注释模式下可捕捉已有注释,进行属性修改和删除。
|
||||
- 已有文本高亮可重新选中并修改颜色。
|
||||
- 双栏文档文字选择按栏位优化,降低左栏、右栏混选。
|
||||
- 带水印、行号文档的文字选择增加过滤,降低误选页边内容。
|
||||
- 左侧目录页签支持读取 PDF 自带书签并跳转。
|
||||
- 注释列表支持类型筛选、关键字搜索、仅当前页、排序和导出 JSON/TXT。
|
||||
- 页面管理支持多选、批量删除、批量旋转、批量提取,以及拖入 PDF 插入页面。
|
||||
- 对象操作支持多选后的对齐和分布。
|
||||
- Ctrl+鼠标滚轮缩放、页面旋转、页面操作后尽量保留当前页和视图位置。
|
||||
- 指针/手形工具互斥,右侧阅读、编辑PDF、页面、工具、注释模式互斥,两组状态互不干扰。
|
||||
|
||||
## 已验证
|
||||
|
||||
- 源码冒烟测试通过。
|
||||
- Python 编译检查通过。
|
||||
- 版本号已同步到应用、包元数据和 Windows exe 版本资源。
|
||||
|
||||
## 已知边界
|
||||
|
||||
- 当前编辑仍属于覆盖式编辑,不是 PDF 原文段落级重排编辑。
|
||||
- 遮盖区域是视觉遮盖,不是敏感信息永久擦除。
|
||||
- 选区快捷操作当前采用右键菜单,悬浮迷你工具条保留为后续可选优化。
|
||||
- OCR、数字证书签名、自动更新不在当前版本范围。
|
||||
@@ -1,5 +1,11 @@
|
||||
# V2 注释与编辑专项计划
|
||||
|
||||
## 当前状态
|
||||
|
||||
V2 已并入当前 `v0.2.2` 代码。原 V2 目标中的框选区域标注、注释属性、注释列表、图章、文本框二次编辑、统一对象选择、右键菜单、键盘操作和未保存提示均已完成。
|
||||
|
||||
后续 V3 已继续补齐真实文本选择、多色高亮、选区添加注释、目录面板、页面管理批处理、注释导出和对象对齐分布等能力。本文档保留为 V2 需求来源和验收记录。
|
||||
|
||||
## 目标
|
||||
|
||||
V2 重点提升注释和编辑体验,让 PDFReaderLite 从“功能可用”进入“审阅和覆盖式编辑顺手”的阶段。
|
||||
@@ -20,19 +26,19 @@ V2 重点提升注释和编辑体验,让 PDFReaderLite 从“功能可用”
|
||||
第二版实施边界:
|
||||
|
||||
- 第二版先做框选区域标注,可用于普通文本 PDF 和扫描/图片型 PDF。
|
||||
- 真正识别 PDF 文本选区、选中文本后的迷你工具条,延期到第三版。
|
||||
- 真正识别 PDF 文本选区、选中文本后的快捷操作已在 V3 / `v0.2.2` 中完成,当前以右键菜单形式提供。
|
||||
|
||||
目标:
|
||||
|
||||
- 鼠标选中页面文字后,可直接执行高亮、下划线、删除线。
|
||||
- 选中文本后可出现迷你工具条,提供高亮、下划线、删除线、复制、添加批注。
|
||||
- 选中文本后可通过右键菜单执行高亮、下划线、删除线、复制、添加批注;悬浮迷你工具条作为后续可选优化。
|
||||
- 对无法识别文本的扫描页,保留现有输入文字标注方式。
|
||||
|
||||
验收标准:
|
||||
|
||||
- 可在普通文本 PDF 中选中一段文字并直接添加标注。
|
||||
- 标注后注释列表自动刷新。
|
||||
- Esc 可取消当前选区或迷你工具条。
|
||||
- Esc 可取消当前选区或快捷菜单相关状态。
|
||||
|
||||
### 2. 注释属性面板
|
||||
|
||||
@@ -77,7 +83,7 @@ V2 重点提升注释和编辑体验,让 PDFReaderLite 从“功能可用”
|
||||
- 支持拖动、缩放、删除。
|
||||
- 双击文本框可修改内容。
|
||||
- 第二版支持设置新建文本框的默认字号、颜色。
|
||||
- 已有文本框样式编辑和中文文本加粗延期到第三版。
|
||||
- 已有文本框内容、字号、文字颜色编辑已完成;中文文本加粗暂不作为当前承诺能力。
|
||||
|
||||
验收标准:
|
||||
|
||||
@@ -97,7 +103,7 @@ V2 重点提升注释和编辑体验,让 PDFReaderLite 从“功能可用”
|
||||
|
||||
- 文本、图片、签名、遮盖、图形注释使用统一选择框和控制点。
|
||||
- 右键菜单支持删除、复制、属性。
|
||||
- 第二版支持常见注释对象复制粘贴;复杂 PDF 原生对象复制延期到第三版。
|
||||
- 当前支持常见注释对象复制粘贴并尽量保留样式;复杂 PDF 原生对象仍不承诺完整编辑。
|
||||
- 键盘 Delete 删除,Esc 取消选择。
|
||||
- 方向键微调位置,Shift+方向键大步移动。
|
||||
|
||||
|
||||
@@ -1,12 +1,14 @@
|
||||
# V2 需求清单
|
||||
|
||||
当前状态:V2 已完成并并入 `v0.2.2`;V3 又补齐了真实文本选择、选区右键菜单、注释导出、目录面板和页面管理批处理等增强能力。
|
||||
|
||||
## 注释:新增功能
|
||||
|
||||
- [x] 框选区域后直接高亮。
|
||||
- [x] 框选区域后直接下划线。
|
||||
- [x] 框选区域后直接删除线。
|
||||
- [ ] 鼠标选择真实文本后直接高亮、下划线、删除线。(V3)
|
||||
- [ ] 选中文本后的迷你工具条。(V3)
|
||||
- [x] 鼠标选择真实文本后直接高亮、下划线、删除线。(V3 / 0.2.2)
|
||||
- [x] 选中文本后的快捷操作菜单。(V3 / 0.2.2,当前为右键菜单;悬浮迷你工具条保留为后续可选优化)
|
||||
- [x] 注释属性面板。
|
||||
- [x] 注释颜色设置。
|
||||
- [x] 注释线宽设置。
|
||||
@@ -35,7 +37,7 @@
|
||||
- [x] 文本框双击编辑内容。
|
||||
- [x] 新建文本框默认字号设置。
|
||||
- [x] 新建文本框默认颜色设置。
|
||||
- [ ] 文本框加粗设置。(V3,需确认中文 FreeText 加粗方案)
|
||||
- [ ] 文本框加粗设置。(暂不承诺,需确认中文 FreeText 加粗方案)
|
||||
- [x] 添加文本后自动选中新对象。
|
||||
- [x] 图片替换。
|
||||
- [x] 未保存图片/签名/图章对象旋转。
|
||||
@@ -78,7 +80,10 @@
|
||||
## 验收测试建议
|
||||
|
||||
- [x] 普通文本 PDF:框选区域后高亮、下划线、删除线。
|
||||
- [ ] 普通文本 PDF:选择真实文字后高亮、下划线、删除线。(V3)
|
||||
- [x] 普通文本 PDF:选择真实文字后高亮、下划线、删除线。(V3 / 0.2.2)
|
||||
- [x] 普通文本 PDF:选择文字后右键多色高亮、复制、添加注释。
|
||||
- [x] 双栏文本 PDF:选择文字时优先按栏位处理,降低跨栏误选。
|
||||
- [x] 带水印、行号 PDF:选择文字时过滤常见页边和水印干扰。
|
||||
- [x] 扫描/图片型 PDF:区域高亮、图章、画笔仍可使用。
|
||||
- [x] 多页 PDF:注释列表筛选、搜索、跳转、属性编辑正确。
|
||||
- [x] 多标签 PDF:每个标签的未保存状态独立。
|
||||
|
||||
@@ -0,0 +1,182 @@
|
||||
# V3 Acrobat 工作流增强计划
|
||||
|
||||
## 当前实现进度
|
||||
|
||||
- 当前 V3 能力已并入 `v0.2.2`。
|
||||
- 已完成:真实文本框选识别、选区高亮、下划线、删除线、复制文字、选区批注。
|
||||
- 已完成:选区快捷操作以轻量右键菜单实现;后续如需要,可再升级为悬浮迷你工具条。
|
||||
- 已完成:右键高亮颜色支持橙色、黄色、绿色、浅蓝色、粉色、红色。
|
||||
- 已完成:添加注释时自动高亮所选文字,并保留注释符号和悬停提示。
|
||||
- 已完成:选中注释符号后双击可编辑注释内容。
|
||||
- 已完成:已有 FreeText 文本框可在右侧属性中修改内容、字号和文字颜色。
|
||||
- 已完成:注释列表支持类型筛选、关键字搜索、仅当前页、排序、导出 JSON/TXT。
|
||||
- 已完成:搜索结果点击后在页面上临时高亮命中区域。
|
||||
- 已完成:左侧新增目录页签,可读取 PDF 自带书签并跳转。
|
||||
- 已完成:页面管理支持多选、批量删除、批量左旋/右旋、提取所选页面。
|
||||
- 已完成:常见注释复制粘贴时尽量保留颜色、填充色、线宽、透明度和内容。
|
||||
- 已完成:页面对象支持多选后的左/中/右、顶/中/底对齐,以及水平/垂直分布。
|
||||
- 已完成:页面管理支持从资源管理器拖入 PDF,并按释放位置插入外部 PDF 页面。
|
||||
- 已完成:Ctrl+滚轮缩放、旋转页面、页面操作后尽量保持当前页和视图位置。
|
||||
- 已完成:双栏文档文字选择按栏位优化,带水印和行号文档选择时过滤常见干扰。
|
||||
- 当前 V3 计划项已完成,后续进入打包、人工验收和缺陷修复。
|
||||
|
||||
## 目标
|
||||
|
||||
V3 目标是让 PDFReaderLite 的高频审阅和覆盖式编辑流程更接近 Adobe Acrobat 常用操作,但继续保持轻量、中文、Windows 单机使用优先。
|
||||
|
||||
核心原则:
|
||||
|
||||
- 优先做简单实用的常用功能。
|
||||
- 真实文本选择和注释快捷操作优先于复杂格式转换。
|
||||
- 继续保留扫描件/图片型 PDF 的框选区域标注作为兜底方案。
|
||||
- 不做 PDF 原文段落级重排编辑。
|
||||
- 所有新增功能都要能保存、撤销或明确提示不可撤销边界。
|
||||
|
||||
## 第一优先级
|
||||
|
||||
### 1. 真实文本选择与快捷标注
|
||||
|
||||
目标:
|
||||
|
||||
- 鼠标拖选 PDF 真实文本后,可直接高亮、下划线、删除线。
|
||||
- 支持复制选中文本。
|
||||
- 支持对选中文本添加批注。
|
||||
- 扫描件或无法识别文本时,继续使用 V2 的框选区域标注。
|
||||
|
||||
建议实现:
|
||||
|
||||
- 在页面视图中维护文本选区。
|
||||
- 使用 PyMuPDF 的文本块/词坐标识别选中区域对应文字。
|
||||
- 对真实文本使用 PDF 原生 highlight/underline/strikeout 注释。
|
||||
- 选区取消支持 Esc、点击空白处、切换模式。
|
||||
|
||||
验收标准:
|
||||
|
||||
- 普通文本 PDF 可拖选一段文字并添加三种标注。
|
||||
- 标注后右侧注释列表和属性面板自动刷新。
|
||||
- 扫描件上不崩溃,并能继续使用区域标注。
|
||||
|
||||
### 2. 选中文本后的快捷操作
|
||||
|
||||
目标:
|
||||
|
||||
- 选中文本后提供快捷操作。
|
||||
- 快捷操作包含:多色高亮、下划线、删除线、复制、批注。
|
||||
- Esc、点击空白处或切换操作后取消选区。
|
||||
|
||||
建议实现:
|
||||
|
||||
- 当前实现为右键菜单,稳定后可再评估是否升级为悬浮迷你工具条。
|
||||
- 注释操作需在可编辑模式下执行;阅读模式仍保留文本选择和复制能力。
|
||||
|
||||
验收标准:
|
||||
|
||||
- 菜单不会遮挡主要阅读流程。
|
||||
- 菜单动作与右侧注释列表同步。
|
||||
- 切换页码、缩放、滚动后选区状态保持可控。
|
||||
|
||||
### 3. 已有文本框样式编辑
|
||||
|
||||
目标:
|
||||
|
||||
- 已写入 PDF 的 FreeText 文本框可编辑字号、颜色、加粗、对齐方式。
|
||||
- 新建文本框继续使用默认文本样式。
|
||||
|
||||
边界:
|
||||
|
||||
- 中文加粗需要优先验证 PyMuPDF FreeText 的稳定方案。
|
||||
- 如果中文加粗不稳定,可采用“仅新建文本支持样式预设,已有文本暂不强制加粗”的降级方案。
|
||||
|
||||
验收标准:
|
||||
|
||||
- 双击文本框可修改内容。
|
||||
- 选中文本框后右侧属性可修改字号、颜色。
|
||||
- 保存重开后样式存在。
|
||||
|
||||
## 第二优先级
|
||||
|
||||
### 4. 注释列表增强
|
||||
|
||||
目标:
|
||||
|
||||
- 支持按页码、类型、创建顺序排序。
|
||||
- 支持只显示当前页注释。
|
||||
- 支持导出注释为 txt/json。
|
||||
|
||||
建议导出内容:
|
||||
|
||||
- 页码。
|
||||
- 注释类型。
|
||||
- 注释内容。
|
||||
- 矩形坐标。
|
||||
- 导出时间。
|
||||
|
||||
验收标准:
|
||||
|
||||
- 多页 PDF 中筛选、排序、搜索组合使用正确。
|
||||
- 导出文件中文正常。
|
||||
|
||||
### 5. 页面管理多选与批处理
|
||||
|
||||
目标:
|
||||
|
||||
- 页面管理视图支持多选。
|
||||
- 支持批量删除、批量旋转、批量提取。
|
||||
- 拖拽重排时显示插入位置。
|
||||
- 支持从资源管理器拖入 PDF 到页面管理视图并插入。
|
||||
|
||||
验收标准:
|
||||
|
||||
- 多选页面批处理后页码顺序正确。
|
||||
- 保存重开后页面顺序和内容正确。
|
||||
- 操作前有明确确认,避免误删。
|
||||
|
||||
### 6. 搜索结果上下文与目录面板
|
||||
|
||||
目标:
|
||||
|
||||
- 搜索结果显示命中页码和前后上下文。
|
||||
- 点击搜索结果跳转并临时高亮命中区域。
|
||||
- 如果 PDF 自带目录/书签,则显示目录面板。
|
||||
|
||||
验收标准:
|
||||
|
||||
- 多页搜索结果定位准确。
|
||||
- 没有目录的 PDF 不显示空白噪音。
|
||||
|
||||
## 第三优先级
|
||||
|
||||
### 7. 对象对齐与分布
|
||||
|
||||
目标:
|
||||
|
||||
- 多对象选择后支持左对齐、居中、右对齐。
|
||||
- 支持水平/垂直分布。
|
||||
|
||||
边界:
|
||||
|
||||
- V3 可先支持当前会话对象和常见注释对象。
|
||||
- 复杂 PDF 原生对象仍不承诺完整编辑。
|
||||
|
||||
### 8. 复制粘贴保留样式
|
||||
|
||||
目标:
|
||||
|
||||
- 注释对象复制粘贴时尽量保留颜色、线宽、透明度、内容。
|
||||
- 文本框复制粘贴尽量保留字号、颜色。
|
||||
|
||||
验收标准:
|
||||
|
||||
- 常见注释复制后视觉效果接近原对象。
|
||||
- 不支持的对象类型给出提示,不静默失败。
|
||||
|
||||
## 建议实施顺序
|
||||
|
||||
1. 真实文本选择基础能力。
|
||||
2. 真实文本高亮、下划线、删除线。
|
||||
3. 选区右键快捷菜单。
|
||||
4. 已有文本框样式编辑。
|
||||
5. 注释列表排序、当前页过滤、导出。
|
||||
6. 页面管理多选和批处理。
|
||||
7. 搜索上下文和目录面板。
|
||||
8. 对象对齐、样式复制等增强。
|
||||
@@ -0,0 +1,116 @@
|
||||
# V4 可选高级能力探索计划
|
||||
|
||||
## 目标
|
||||
|
||||
V4 用于探索部分更高级但仍保持轻量边界的功能。V4 不追求完整替代 Acrobat Pro,也不承诺复杂版面重建、证书签名或真正永久擦除。
|
||||
|
||||
核心原则:
|
||||
|
||||
- 高风险能力采用可选安装、外部工具或明确降级方案。
|
||||
- 不把大型 OCR 引擎内置进单文件 exe。
|
||||
- 对用户可能误解的安全能力必须给出明确提示。
|
||||
- 优先提供“可用、可解释、不会误导”的轻量能力。
|
||||
|
||||
## 可选方向
|
||||
|
||||
### 1. OCR 外部插件或可选安装
|
||||
|
||||
目标:
|
||||
|
||||
- 支持调用外部 OCR 工具识别当前页或指定页。
|
||||
- 可选生成简单文本层或导出 OCR 文本。
|
||||
|
||||
边界:
|
||||
|
||||
- 不内置完整 OCR 到单 exe。
|
||||
- 不承诺高质量可搜索 PDF。
|
||||
- 不承诺扫描件自动版面分析。
|
||||
|
||||
建议方案:
|
||||
|
||||
- 软件设置中配置外部 OCR 程序路径。
|
||||
- 支持按页导出图片后交给外部 OCR。
|
||||
- OCR 结果先以 txt 或侧边栏文本方式展示。
|
||||
|
||||
验收标准:
|
||||
|
||||
- 未配置外部 OCR 时界面给出清晰提示。
|
||||
- OCR 失败不影响原 PDF。
|
||||
|
||||
### 2. PDF 导出文本/图片
|
||||
|
||||
目标:
|
||||
|
||||
- 支持导出当前页或全部页文本。
|
||||
- 支持导出当前页或全部页图片。
|
||||
- 可选将导出的文本按页分段保存。
|
||||
|
||||
边界:
|
||||
|
||||
- 不承诺 PDF 转 Word 并保持原排版。
|
||||
- 不承诺 PDF 转 Excel 并保持表格结构。
|
||||
- 表格导出仅作为后续探索,不放入 V4 必做项。
|
||||
|
||||
验收标准:
|
||||
|
||||
- 普通文本 PDF 能导出可读 txt。
|
||||
- 扫描件无文本时给出提示。
|
||||
- 图片导出沿用已有页面图片导出能力,不重复造复杂流程。
|
||||
|
||||
### 3. 敏感信息遮盖标记
|
||||
|
||||
目标:
|
||||
|
||||
- 在遮盖工具基础上增加“敏感信息遮盖标记”模式。
|
||||
- 遮盖对象有特殊名称或列表标识,便于检查。
|
||||
- 保存前提示:这是视觉遮盖,不是真正永久擦除。
|
||||
|
||||
边界:
|
||||
|
||||
- 不宣称真正永久擦除敏感信息。
|
||||
- 不自动删除 PDF 内部文本、对象、元数据。
|
||||
- 如果未来做真正擦除,需要单独设计和专项验证。
|
||||
|
||||
验收标准:
|
||||
|
||||
- 用户能区分普通遮盖和敏感信息遮盖标记。
|
||||
- 导出或保存前有明确风险提示。
|
||||
|
||||
### 4. 签名图片与签名记录
|
||||
|
||||
目标:
|
||||
|
||||
- 在现有图片签名、点击放置签名、手写签名基础上增加签名记录。
|
||||
- 记录签名时间、页码、位置、签名图片名称或摘要。
|
||||
- 可导出签名记录 txt/json。
|
||||
|
||||
边界:
|
||||
|
||||
- 不做数字证书级签名。
|
||||
- 不做法律意义上的签名验证。
|
||||
- 不承诺防篡改。
|
||||
|
||||
验收标准:
|
||||
|
||||
- 添加签名后可在签名记录列表中看到记录。
|
||||
- 保存重开后签名图片仍在 PDF 中。
|
||||
- 签名记录导出中文正常。
|
||||
|
||||
## 暂不纳入 V4 必做项
|
||||
|
||||
- PDF 转 Word 并保持原排版。
|
||||
- PDF 转 Excel 并保持表格结构。
|
||||
- OCR 生成高质量可搜索 PDF。
|
||||
- 扫描件自动版面分析。
|
||||
- 数字证书签名。
|
||||
- 敏感信息真正永久擦除。
|
||||
- 自动更新。
|
||||
- 单 exe 内置完整 OCR。
|
||||
|
||||
## 建议实施顺序
|
||||
|
||||
1. 导出文本能力。
|
||||
2. 敏感信息遮盖标记和风险提示。
|
||||
3. 签名记录列表与导出。
|
||||
4. 外部 OCR 配置和单页 OCR 文本导出。
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
# UTF-8
|
||||
VSVersionInfo(
|
||||
ffi=FixedFileInfo(
|
||||
filevers=(0, 2, 1, 0),
|
||||
prodvers=(0, 2, 1, 0),
|
||||
filevers=(0, 2, 2, 0),
|
||||
prodvers=(0, 2, 2, 0),
|
||||
mask=0x3f,
|
||||
flags=0x0,
|
||||
OS=0x40004,
|
||||
@@ -17,11 +17,11 @@ VSVersionInfo(
|
||||
[
|
||||
StringStruct("CompanyName", "PDFReaderLite"),
|
||||
StringStruct("FileDescription", "PDFReaderLite"),
|
||||
StringStruct("FileVersion", "0.2.1"),
|
||||
StringStruct("FileVersion", "0.2.2"),
|
||||
StringStruct("InternalName", "PDFReaderLite"),
|
||||
StringStruct("OriginalFilename", "PDFReaderLite.exe"),
|
||||
StringStruct("ProductName", "PDFReaderLite"),
|
||||
StringStruct("ProductVersion", "0.2.1"),
|
||||
StringStruct("ProductVersion", "0.2.2"),
|
||||
],
|
||||
)
|
||||
]),
|
||||
|
||||
@@ -1 +1 @@
|
||||
__version__ = "0.2.1"
|
||||
__version__ = "0.2.2"
|
||||
|
||||
+926
-30
File diff suppressed because it is too large
Load Diff
+1146
-142
File diff suppressed because it is too large
Load Diff
@@ -1,14 +1,21 @@
|
||||
from __future__ import annotations
|
||||
|
||||
from PySide6.QtCore import QSize, Qt
|
||||
from PySide6.QtGui import QDragEnterEvent, QDropEvent, QIcon, QPixmap
|
||||
from pathlib import Path
|
||||
|
||||
import fitz
|
||||
from PySide6.QtCore import QSize, Qt, Signal
|
||||
from PySide6.QtGui import QDragEnterEvent, QDropEvent, QIcon, QImage, QPixmap
|
||||
from PySide6.QtWidgets import (
|
||||
QAbstractItemView,
|
||||
QDialog,
|
||||
QDialogButtonBox,
|
||||
QFileDialog,
|
||||
QHBoxLayout,
|
||||
QLabel,
|
||||
QListWidget,
|
||||
QListWidgetItem,
|
||||
QMessageBox,
|
||||
QPushButton,
|
||||
QVBoxLayout,
|
||||
)
|
||||
|
||||
@@ -16,6 +23,8 @@ from pdfreaderlite.core.document import PdfDocument
|
||||
|
||||
|
||||
class PageGrid(QListWidget):
|
||||
pdf_files_dropped = Signal(list, int)
|
||||
|
||||
def __init__(self) -> None:
|
||||
super().__init__()
|
||||
self.setViewMode(QListWidget.ViewMode.IconMode)
|
||||
@@ -28,32 +37,82 @@ class PageGrid(QListWidget):
|
||||
self.setGridSize(QSize(178, 230))
|
||||
self.setDragDropMode(QAbstractItemView.DragDropMode.InternalMove)
|
||||
self.setDefaultDropAction(Qt.DropAction.MoveAction)
|
||||
self.setSelectionMode(QAbstractItemView.SelectionMode.SingleSelection)
|
||||
self.setSelectionMode(QAbstractItemView.SelectionMode.ExtendedSelection)
|
||||
|
||||
def dropEvent(self, event: QDropEvent) -> None:
|
||||
paths = self._dropped_pdf_paths(event)
|
||||
if paths:
|
||||
row = self.indexAt(event.position().toPoint()).row()
|
||||
self.pdf_files_dropped.emit(paths, row if row >= 0 else self.count())
|
||||
event.acceptProposedAction()
|
||||
return
|
||||
super().dropEvent(event)
|
||||
self._renumber_items()
|
||||
|
||||
def dragEnterEvent(self, event: QDragEnterEvent) -> None:
|
||||
if self._dropped_pdf_paths(event):
|
||||
event.acceptProposedAction()
|
||||
return
|
||||
event.acceptProposedAction()
|
||||
|
||||
def dragMoveEvent(self, event) -> None:
|
||||
if self._dropped_pdf_paths(event):
|
||||
event.acceptProposedAction()
|
||||
return
|
||||
super().dragMoveEvent(event)
|
||||
|
||||
def _dropped_pdf_paths(self, event: QDragEnterEvent | QDropEvent) -> list[str]:
|
||||
if not event.mimeData().hasUrls():
|
||||
return []
|
||||
paths: list[str] = []
|
||||
for url in event.mimeData().urls():
|
||||
if not url.isLocalFile():
|
||||
continue
|
||||
path = Path(url.toLocalFile())
|
||||
if path.suffix.lower() == ".pdf":
|
||||
paths.append(str(path))
|
||||
return paths
|
||||
|
||||
def _renumber_items(self) -> None:
|
||||
for row in range(self.count()):
|
||||
item = self.item(row)
|
||||
original_page = item.data(Qt.ItemDataRole.UserRole) + 1
|
||||
item.setText(f"位置 {row + 1}\n原第 {original_page} 页")
|
||||
entry = item.data(Qt.ItemDataRole.UserRole)
|
||||
if isinstance(entry, dict) and entry.get("source") == "external":
|
||||
item.setText(
|
||||
f"位置 {row + 1}\n插入 {Path(str(entry['path'])).name}\n第 {int(entry['page_index']) + 1} 页"
|
||||
)
|
||||
else:
|
||||
original_page = int(entry) + 1
|
||||
item.setText(f"位置 {row + 1}\n原第 {original_page} 页")
|
||||
|
||||
|
||||
class PageManagerDialog(QDialog):
|
||||
def __init__(self, document: PdfDocument, parent=None) -> None:
|
||||
super().__init__(parent)
|
||||
self.document = document
|
||||
self.rotations: dict[int, int] = {}
|
||||
self.setWindowTitle("页面管理")
|
||||
self.resize(920, 680)
|
||||
|
||||
self.grid = PageGrid()
|
||||
hint = QLabel("拖拽缩略图调整页面顺序,点击“应用”后写入当前 PDF。")
|
||||
self.grid.pdf_files_dropped.connect(self.insert_external_pdfs)
|
||||
hint = QLabel("拖拽缩略图调整页面顺序,可多选后批量删除、旋转或提取,点击“应用”后写入当前 PDF。")
|
||||
hint.setWordWrap(True)
|
||||
delete_button = QPushButton("删除所选")
|
||||
rotate_left_button = QPushButton("左旋所选")
|
||||
rotate_right_button = QPushButton("右旋所选")
|
||||
extract_button = QPushButton("提取所选")
|
||||
delete_button.clicked.connect(self.delete_selected_pages)
|
||||
rotate_left_button.clicked.connect(lambda: self.rotate_selected_pages(-90))
|
||||
rotate_right_button.clicked.connect(lambda: self.rotate_selected_pages(90))
|
||||
extract_button.clicked.connect(self.extract_selected_pages)
|
||||
|
||||
action_layout = QHBoxLayout()
|
||||
action_layout.addWidget(delete_button)
|
||||
action_layout.addWidget(rotate_left_button)
|
||||
action_layout.addWidget(rotate_right_button)
|
||||
action_layout.addWidget(extract_button)
|
||||
action_layout.addStretch(1)
|
||||
|
||||
buttons = QDialogButtonBox(
|
||||
QDialogButtonBox.StandardButton.Apply | QDialogButtonBox.StandardButton.Cancel
|
||||
@@ -64,6 +123,7 @@ class PageManagerDialog(QDialog):
|
||||
|
||||
layout = QVBoxLayout(self)
|
||||
layout.addWidget(hint)
|
||||
layout.addLayout(action_layout)
|
||||
layout.addWidget(self.grid, 1)
|
||||
layout.addWidget(buttons)
|
||||
|
||||
@@ -73,8 +133,98 @@ class PageManagerDialog(QDialog):
|
||||
return [
|
||||
self.grid.item(row).data(Qt.ItemDataRole.UserRole)
|
||||
for row in range(self.grid.count())
|
||||
if isinstance(self.grid.item(row).data(Qt.ItemDataRole.UserRole), int)
|
||||
]
|
||||
|
||||
def page_plan(self) -> list[dict[str, object]]:
|
||||
plan: list[dict[str, object]] = []
|
||||
for row in range(self.grid.count()):
|
||||
entry = self.grid.item(row).data(Qt.ItemDataRole.UserRole)
|
||||
if isinstance(entry, dict):
|
||||
plan.append(entry)
|
||||
else:
|
||||
plan.append({"source": "current", "page_index": int(entry)})
|
||||
return plan
|
||||
|
||||
def selected_pages(self) -> list[int]:
|
||||
pages = [
|
||||
item.data(Qt.ItemDataRole.UserRole)
|
||||
for item in self.grid.selectedItems()
|
||||
if isinstance(item.data(Qt.ItemDataRole.UserRole), int)
|
||||
]
|
||||
return sorted(set(pages))
|
||||
|
||||
def delete_selected_pages(self) -> None:
|
||||
selected_items = self.grid.selectedItems()
|
||||
if not selected_items:
|
||||
return
|
||||
if self.grid.count() - len(selected_items) <= 0:
|
||||
QMessageBox.information(self, "删除页面", "PDF 至少需要保留一页。")
|
||||
return
|
||||
reply = QMessageBox.question(
|
||||
self,
|
||||
"删除页面",
|
||||
f"确定从当前页面管理列表中删除 {len(selected_items)} 页吗?",
|
||||
QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No,
|
||||
)
|
||||
if reply != QMessageBox.StandardButton.Yes:
|
||||
return
|
||||
for item in selected_items:
|
||||
self.grid.takeItem(self.grid.row(item))
|
||||
self.grid._renumber_items()
|
||||
|
||||
def insert_external_pdfs(self, paths: list[str], insert_row: int) -> None:
|
||||
row = max(0, min(insert_row, self.grid.count()))
|
||||
inserted = 0
|
||||
for path in paths:
|
||||
try:
|
||||
with fitz.open(path) as source:
|
||||
for page_index in range(source.page_count):
|
||||
item = self._external_page_item(path, source, page_index)
|
||||
self.grid.insertItem(row + inserted, item)
|
||||
inserted += 1
|
||||
except Exception as exc:
|
||||
QMessageBox.warning(self, "插入 PDF", f"无法读取外部 PDF:\n{path}\n\n{exc}")
|
||||
if inserted:
|
||||
self.grid._renumber_items()
|
||||
|
||||
def rotate_selected_pages(self, degrees: int) -> None:
|
||||
pages = self.selected_pages()
|
||||
if not pages:
|
||||
return
|
||||
for page_index in pages:
|
||||
self.rotations[page_index] = (self.rotations.get(page_index, 0) + degrees) % 360
|
||||
self._renumber_with_rotation()
|
||||
|
||||
def extract_selected_pages(self) -> None:
|
||||
pages = self.selected_pages()
|
||||
if not pages:
|
||||
return
|
||||
target, _ = QFileDialog.getSaveFileName(
|
||||
self,
|
||||
"提取所选页面",
|
||||
"PDFReaderLite_提取页面.pdf",
|
||||
"PDF 文件 (*.pdf)",
|
||||
)
|
||||
if not target:
|
||||
return
|
||||
try:
|
||||
self.document.extract_pages([page + 1 for page in pages], target)
|
||||
QMessageBox.information(self, "提取页面", "所选页面已提取为新 PDF。")
|
||||
except Exception as exc:
|
||||
QMessageBox.critical(self, "提取失败", f"无法提取所选页面:\n{exc}")
|
||||
|
||||
def _renumber_with_rotation(self) -> None:
|
||||
self.grid._renumber_items()
|
||||
for row in range(self.grid.count()):
|
||||
item = self.grid.item(row)
|
||||
original_page = item.data(Qt.ItemDataRole.UserRole)
|
||||
if not isinstance(original_page, int):
|
||||
continue
|
||||
rotation = self.rotations.get(original_page, 0)
|
||||
if rotation:
|
||||
item.setText(f"{item.text()}\n旋转 {rotation}°")
|
||||
|
||||
def _load_pages(self) -> None:
|
||||
for page_index in range(self.document.page_count):
|
||||
image = self.document.render_thumbnail(page_index, width=150)
|
||||
@@ -85,3 +235,25 @@ class PageManagerDialog(QDialog):
|
||||
item.setData(Qt.ItemDataRole.UserRole, page_index)
|
||||
item.setTextAlignment(Qt.AlignmentFlag.AlignCenter)
|
||||
self.grid.addItem(item)
|
||||
|
||||
def _external_page_item(self, path: str, source: fitz.Document, page_index: int) -> QListWidgetItem:
|
||||
page = source.load_page(page_index)
|
||||
zoom = 150 / page.rect.width
|
||||
pixmap = page.get_pixmap(matrix=fitz.Matrix(zoom, zoom), alpha=False)
|
||||
image = QImage(
|
||||
pixmap.samples,
|
||||
pixmap.width,
|
||||
pixmap.height,
|
||||
pixmap.stride,
|
||||
QImage.Format.Format_RGB888,
|
||||
).copy()
|
||||
item = QListWidgetItem(
|
||||
QIcon(QPixmap.fromImage(image)),
|
||||
f"插入 {Path(path).name}\n第 {page_index + 1} 页",
|
||||
)
|
||||
item.setData(
|
||||
Qt.ItemDataRole.UserRole,
|
||||
{"source": "external", "path": path, "page_index": page_index},
|
||||
)
|
||||
item.setTextAlignment(Qt.AlignmentFlag.AlignCenter)
|
||||
return item
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
from __future__ import annotations
|
||||
|
||||
from PySide6.QtCore import QPoint, QPointF, QRectF, Qt, Signal
|
||||
from PySide6.QtCore import QPoint, QPointF, QRectF, Qt, QTimer, Signal
|
||||
from PySide6.QtGui import QColor, QContextMenuEvent, QMouseEvent, QPainter, QPen, QPixmap, QWheelEvent
|
||||
from PySide6.QtWidgets import QGraphicsDropShadowEffect, QLabel, QScrollArea, QSizePolicy, QVBoxLayout, QWidget
|
||||
|
||||
@@ -10,31 +10,57 @@ from pdfreaderlite.core.document import PdfDocument
|
||||
class PageLabel(QLabel):
|
||||
stroke_finished = Signal(list)
|
||||
placement_requested = Signal(QPointF)
|
||||
hand_pan_delta = Signal(QPointF)
|
||||
area_selection_finished = Signal(QRectF)
|
||||
text_selection_preview_changed = Signal(QRectF, QPointF, QPointF)
|
||||
text_selection_finished = Signal(QRectF, QPointF, QPointF)
|
||||
text_selection_click_requested = Signal(QPointF)
|
||||
text_selection_context_requested = Signal(QPointF)
|
||||
shape_placement_finished = Signal(str, QPointF, QPointF)
|
||||
object_select_requested = Signal(QPointF)
|
||||
object_rect_changed = Signal(QRectF)
|
||||
object_context_requested = Signal(QPointF)
|
||||
object_double_clicked = Signal(QPointF)
|
||||
annotation_double_clicked = Signal(QPointF)
|
||||
annotation_hover_requested = Signal(QPointF)
|
||||
|
||||
def __init__(self, text: str = "") -> None:
|
||||
super().__init__(text)
|
||||
self.drawing_enabled = False
|
||||
self.placement_enabled = False
|
||||
self.area_selection_enabled = False
|
||||
self.text_selection_enabled = False
|
||||
self.shape_placement_enabled = False
|
||||
self.shape_placement_kind = ""
|
||||
self.hand_pan_enabled = False
|
||||
self.object_edit_enabled = False
|
||||
self.selected_rect: QRectF | None = None
|
||||
self.selected_rects: list[QRectF] = []
|
||||
self.overlay_images: list[dict[str, object]] = []
|
||||
self.search_highlights: list[tuple[float, float, float, float]] = []
|
||||
self.text_selection_highlights: list[tuple[float, float, float, float]] = []
|
||||
self._drawing = False
|
||||
self._selecting_area = False
|
||||
self._selecting_text = False
|
||||
self._placing_shape = False
|
||||
self._hand_panning = False
|
||||
self._stroke: list[QPointF] = []
|
||||
self._area_start = QPointF()
|
||||
self._area_rect = QRectF()
|
||||
self._shape_start = QPointF()
|
||||
self._shape_end = QPointF()
|
||||
self._dragging_object = False
|
||||
self._resizing_object = False
|
||||
self._drag_start = QPointF()
|
||||
self._drag_origin_rect = QRectF()
|
||||
self._hand_last_pos = QPointF()
|
||||
|
||||
def mousePressEvent(self, event: QMouseEvent) -> None:
|
||||
if self.hand_pan_enabled and event.button() == Qt.MouseButton.LeftButton:
|
||||
self._hand_panning = True
|
||||
self._hand_last_pos = event.position()
|
||||
self.setCursor(Qt.CursorShape.ClosedHandCursor)
|
||||
return
|
||||
if self.placement_enabled and event.button() == Qt.MouseButton.LeftButton:
|
||||
self.placement_requested.emit(event.position())
|
||||
return
|
||||
@@ -44,6 +70,30 @@ class PageLabel(QLabel):
|
||||
self._area_rect = QRectF(self._area_start, self._area_start)
|
||||
self.update()
|
||||
return
|
||||
if self.text_selection_enabled and event.button() == Qt.MouseButton.LeftButton:
|
||||
self._selecting_text = True
|
||||
self._area_start = event.position()
|
||||
self._area_rect = QRectF(self._area_start, self._area_start)
|
||||
self.text_selection_preview_changed.emit(self._area_rect, self._area_start, event.position())
|
||||
self.update()
|
||||
return
|
||||
if self.shape_placement_enabled and event.button() == Qt.MouseButton.LeftButton:
|
||||
if not self._placing_shape:
|
||||
self._placing_shape = True
|
||||
self._shape_start = event.position()
|
||||
self._shape_end = event.position()
|
||||
self.update()
|
||||
return
|
||||
self._placing_shape = False
|
||||
self._shape_end = event.position()
|
||||
self.update()
|
||||
if (self._shape_end - self._shape_start).manhattanLength() >= 8:
|
||||
self.shape_placement_finished.emit(
|
||||
self.shape_placement_kind,
|
||||
self._shape_start,
|
||||
self._shape_end,
|
||||
)
|
||||
return
|
||||
if self.object_edit_enabled and event.button() == Qt.MouseButton.LeftButton:
|
||||
if self.selected_rect and self._resize_handle_rect().contains(event.position()):
|
||||
self._resizing_object = True
|
||||
@@ -68,9 +118,17 @@ class PageLabel(QLabel):
|
||||
if self.object_edit_enabled and event.button() == Qt.MouseButton.LeftButton:
|
||||
self.object_double_clicked.emit(event.position())
|
||||
return
|
||||
if event.button() == Qt.MouseButton.LeftButton:
|
||||
self.annotation_double_clicked.emit(event.position())
|
||||
return
|
||||
super().mouseDoubleClickEvent(event)
|
||||
|
||||
def mouseMoveEvent(self, event: QMouseEvent) -> None:
|
||||
if self._hand_panning:
|
||||
delta = event.position() - self._hand_last_pos
|
||||
self._hand_last_pos = event.position()
|
||||
self.hand_pan_delta.emit(delta)
|
||||
return
|
||||
if self._dragging_object and self.selected_rect:
|
||||
delta = event.position() - self._drag_start
|
||||
self.selected_rect = self._drag_origin_rect.translated(delta)
|
||||
@@ -92,9 +150,24 @@ class PageLabel(QLabel):
|
||||
self._area_rect = QRectF(self._area_start, event.position()).normalized()
|
||||
self.update()
|
||||
return
|
||||
if self._selecting_text:
|
||||
self._area_rect = QRectF(self._area_start, event.position()).normalized()
|
||||
self.text_selection_preview_changed.emit(self._area_rect, self._area_start, event.position())
|
||||
self.update()
|
||||
return
|
||||
if self._placing_shape:
|
||||
self._shape_end = event.position()
|
||||
self.update()
|
||||
return
|
||||
self.annotation_hover_requested.emit(event.position())
|
||||
super().mouseMoveEvent(event)
|
||||
|
||||
def mouseReleaseEvent(self, event: QMouseEvent) -> None:
|
||||
if self._hand_panning and event.button() == Qt.MouseButton.LeftButton:
|
||||
self._hand_panning = False
|
||||
if self.hand_pan_enabled:
|
||||
self.setCursor(Qt.CursorShape.OpenHandCursor)
|
||||
return
|
||||
if self._dragging_object and event.button() == Qt.MouseButton.LeftButton:
|
||||
self._dragging_object = False
|
||||
if self.selected_rect:
|
||||
@@ -120,9 +193,22 @@ class PageLabel(QLabel):
|
||||
if rect.width() >= 8 and rect.height() >= 8:
|
||||
self.area_selection_finished.emit(rect)
|
||||
return
|
||||
if self._selecting_text and event.button() == Qt.MouseButton.LeftButton:
|
||||
self._selecting_text = False
|
||||
rect = self._area_rect.normalized()
|
||||
self._area_rect = QRectF()
|
||||
self.update()
|
||||
if rect.width() >= 8 and rect.height() >= 8:
|
||||
self.text_selection_finished.emit(rect, self._area_start, event.position())
|
||||
else:
|
||||
self.text_selection_click_requested.emit(event.position())
|
||||
return
|
||||
super().mouseReleaseEvent(event)
|
||||
|
||||
def contextMenuEvent(self, event: QContextMenuEvent) -> None:
|
||||
if self.text_selection_enabled:
|
||||
self.text_selection_context_requested.emit(QPointF(event.pos()))
|
||||
return
|
||||
if self.object_edit_enabled:
|
||||
self.object_context_requested.emit(QPointF(event.pos()))
|
||||
return
|
||||
@@ -151,14 +237,35 @@ class PageLabel(QLabel):
|
||||
painter.setPen(QPen(Qt.GlobalColor.blue, 2, Qt.PenStyle.DashLine))
|
||||
painter.drawRect(self.selected_rect)
|
||||
painter.fillRect(self._resize_handle_rect(), Qt.GlobalColor.blue)
|
||||
for rect in self.selected_rects:
|
||||
painter.setPen(QPen(QColor("#1f6fd1"), 2, Qt.PenStyle.DashLine))
|
||||
painter.drawRect(rect)
|
||||
for x0, y0, x1, y1 in self.search_highlights:
|
||||
highlight_rect = QRectF(x0, y0, x1 - x0, y1 - y0)
|
||||
painter.setPen(QPen(QColor("#d18b00"), 1, Qt.PenStyle.SolidLine))
|
||||
painter.fillRect(highlight_rect, QColor(255, 214, 72, 95))
|
||||
painter.drawRect(highlight_rect)
|
||||
for x0, y0, x1, y1 in self.text_selection_highlights:
|
||||
selection_rect = QRectF(x0, y0, x1 - x0, y1 - y0)
|
||||
painter.setPen(Qt.PenStyle.NoPen)
|
||||
painter.fillRect(selection_rect, QColor(43, 120, 215, 118))
|
||||
if self._stroke:
|
||||
painter.setPen(QPen(Qt.GlobalColor.black, 2, Qt.PenStyle.SolidLine, Qt.PenCapStyle.RoundCap))
|
||||
for index in range(1, len(self._stroke)):
|
||||
painter.drawLine(self._stroke[index - 1], self._stroke[index])
|
||||
if not self._area_rect.isNull():
|
||||
if not self._area_rect.isNull() and not self._selecting_text:
|
||||
painter.setPen(QPen(QColor("#2d73c5"), 2, Qt.PenStyle.DashLine))
|
||||
painter.fillRect(self._area_rect, QColor(45, 115, 197, 38))
|
||||
painter.drawRect(self._area_rect)
|
||||
if self._placing_shape:
|
||||
painter.setPen(QPen(QColor("#2d73c5"), 2, Qt.PenStyle.DashLine))
|
||||
rect = QRectF(self._shape_start, self._shape_end).normalized()
|
||||
if self.shape_placement_kind == "circle":
|
||||
painter.drawEllipse(rect)
|
||||
elif self.shape_placement_kind in {"line", "arrow"}:
|
||||
painter.drawLine(self._shape_start, self._shape_end)
|
||||
else:
|
||||
painter.drawRect(rect)
|
||||
|
||||
def _resize_handle_rect(self) -> QRectF:
|
||||
if not self.selected_rect:
|
||||
@@ -205,10 +312,17 @@ class PdfViewer(QScrollArea):
|
||||
ink_stroke_finished = Signal(int, list)
|
||||
placement_requested = Signal(int, tuple)
|
||||
area_selection_finished = Signal(int, tuple)
|
||||
text_selection_preview_changed = Signal(int, tuple, tuple, tuple)
|
||||
text_selection_finished = Signal(int, tuple, tuple, tuple)
|
||||
text_selection_click_requested = Signal(int, tuple)
|
||||
text_selection_context_requested = Signal(int, tuple)
|
||||
shape_placement_finished = Signal(int, str, tuple, tuple)
|
||||
object_select_requested = Signal(int, tuple)
|
||||
object_rect_changed = Signal(int, tuple)
|
||||
object_context_requested = Signal(int, tuple)
|
||||
object_double_clicked = Signal(int, tuple)
|
||||
annotation_double_clicked = Signal(int, tuple)
|
||||
annotation_hover_requested = Signal(int, tuple)
|
||||
|
||||
def __init__(self) -> None:
|
||||
super().__init__()
|
||||
@@ -217,7 +331,10 @@ class PdfViewer(QScrollArea):
|
||||
self.zoom = 1.2
|
||||
self._page_labels: list[PageLabel] = []
|
||||
self._overlay_images: list[dict[str, object]] = []
|
||||
self._search_highlights: dict[int, list[tuple[float, float, float, float]]] = {}
|
||||
self._text_selection_highlights: dict[int, list[tuple[float, float, float, float]]] = {}
|
||||
self._selected_object_rect: tuple[float, float, float, float] | None = None
|
||||
self._selected_object_rects: list[tuple[float, float, float, float]] = []
|
||||
self._selected_object_page_index: int | None = None
|
||||
self._updating_scroll_page = False
|
||||
|
||||
@@ -242,7 +359,7 @@ class PdfViewer(QScrollArea):
|
||||
self.page_index = 0
|
||||
self.render()
|
||||
|
||||
def render(self) -> None:
|
||||
def render(self, scroll_to_page: bool = True) -> None:
|
||||
if not self.document or not self.document.is_open:
|
||||
self._clear_page_labels()
|
||||
self.page_label = self._make_empty_label()
|
||||
@@ -250,6 +367,7 @@ class PdfViewer(QScrollArea):
|
||||
return
|
||||
|
||||
previous_page = min(self.page_index, self.document.page_count - 1)
|
||||
self._updating_scroll_page = True
|
||||
self._clear_page_labels()
|
||||
for page_index in range(self.document.page_count):
|
||||
label = self._make_page_label(page_index)
|
||||
@@ -264,11 +382,51 @@ class PdfViewer(QScrollArea):
|
||||
self.content_layout.activate()
|
||||
self.content_widget.adjustSize()
|
||||
self._refresh_overlay_zoom()
|
||||
self._refresh_search_highlights()
|
||||
self._refresh_text_selection_highlights()
|
||||
self._apply_object_selection_to_labels()
|
||||
self._scroll_to_page(self.page_index)
|
||||
if scroll_to_page:
|
||||
self._scroll_to_page(self.page_index)
|
||||
else:
|
||||
QTimer.singleShot(0, self._finish_programmatic_scroll)
|
||||
self.page_changed.emit(self.page_index)
|
||||
self.zoom_changed.emit(self.zoom)
|
||||
|
||||
def render_preserving_scroll(self, page_index: int, scroll_value: int) -> None:
|
||||
if self.document and 0 <= page_index < self.document.page_count:
|
||||
self.page_index = page_index
|
||||
self.render()
|
||||
self._updating_scroll_page = True
|
||||
bar = self.verticalScrollBar()
|
||||
bar.setValue(max(bar.minimum(), min(bar.maximum(), scroll_value)))
|
||||
if self._page_labels and 0 <= self.page_index < len(self._page_labels):
|
||||
self.page_label = self._page_labels[self.page_index]
|
||||
QTimer.singleShot(0, self._finish_programmatic_scroll)
|
||||
|
||||
def refresh_page(self, page_index: int) -> None:
|
||||
if (
|
||||
not self.document
|
||||
or not self.document.is_open
|
||||
or page_index < 0
|
||||
or page_index >= len(self._page_labels)
|
||||
):
|
||||
return
|
||||
self._updating_scroll_page = True
|
||||
label = self._page_labels[page_index]
|
||||
image = self.document.render_page(page_index, self.zoom)
|
||||
label.setPixmap(QPixmap.fromImage(image))
|
||||
label.adjustSize()
|
||||
self.page_index = page_index
|
||||
self.page_label = label
|
||||
self.content_layout.activate()
|
||||
self._refresh_overlay_zoom()
|
||||
self._refresh_search_highlights()
|
||||
self._refresh_text_selection_highlights()
|
||||
self._apply_object_selection_to_labels()
|
||||
self.page_changed.emit(self.page_index)
|
||||
self.zoom_changed.emit(self.zoom)
|
||||
QTimer.singleShot(0, self._finish_programmatic_scroll)
|
||||
|
||||
def next_page(self) -> None:
|
||||
if self.document and self.page_index < self.document.page_count - 1:
|
||||
self.go_to_page(self.page_index + 1)
|
||||
@@ -291,8 +449,23 @@ class PdfViewer(QScrollArea):
|
||||
self.set_zoom(max(0.2, self.zoom - 0.15))
|
||||
|
||||
def set_zoom(self, zoom: float) -> None:
|
||||
self.zoom = max(0.2, min(3.0, zoom))
|
||||
self.render()
|
||||
new_zoom = max(0.2, min(3.0, zoom))
|
||||
if abs(new_zoom - self.zoom) < 0.001:
|
||||
return
|
||||
if not self.document or not self.document.is_open:
|
||||
self.zoom = new_zoom
|
||||
self.render()
|
||||
return
|
||||
|
||||
anchor = self._viewport_pdf_anchor()
|
||||
if anchor is not None:
|
||||
self.page_index = anchor[0]
|
||||
|
||||
self.zoom = new_zoom
|
||||
self.render(scroll_to_page=False)
|
||||
if anchor is not None:
|
||||
self._restore_pdf_anchor(anchor)
|
||||
QTimer.singleShot(0, lambda saved_anchor=anchor: self._restore_pdf_anchor(saved_anchor))
|
||||
|
||||
def wheelEvent(self, event: QWheelEvent) -> None:
|
||||
if event.modifiers() & Qt.KeyboardModifier.ControlModifier:
|
||||
@@ -304,10 +477,57 @@ class PdfViewer(QScrollArea):
|
||||
return
|
||||
super().wheelEvent(event)
|
||||
|
||||
def _viewport_pdf_anchor(self) -> tuple[int, float, float] | None:
|
||||
if not self._page_labels or self.zoom <= 0:
|
||||
return None
|
||||
viewport_center = QPoint(self.viewport().width() // 2, self.viewport().height() // 2)
|
||||
content_point = self.content_widget.mapFromGlobal(self.viewport().mapToGlobal(viewport_center))
|
||||
|
||||
best_index = self.page_index
|
||||
best_distance: int | None = None
|
||||
for index, label in enumerate(self._page_labels):
|
||||
geometry = label.geometry()
|
||||
if geometry.contains(content_point):
|
||||
local_x = content_point.x() - geometry.x()
|
||||
local_y = content_point.y() - geometry.y()
|
||||
return index, local_x / self.zoom, local_y / self.zoom
|
||||
distance = abs(geometry.center().y() - content_point.y())
|
||||
if best_distance is None or distance < best_distance:
|
||||
best_distance = distance
|
||||
best_index = index
|
||||
|
||||
if 0 <= best_index < len(self._page_labels):
|
||||
geometry = self._page_labels[best_index].geometry()
|
||||
local_x = min(max(content_point.x() - geometry.x(), 0), geometry.width())
|
||||
local_y = min(max(content_point.y() - geometry.y(), 0), geometry.height())
|
||||
return best_index, local_x / self.zoom, local_y / self.zoom
|
||||
return None
|
||||
|
||||
def _restore_pdf_anchor(self, anchor: tuple[int, float, float]) -> None:
|
||||
page_index, pdf_x, pdf_y = anchor
|
||||
if not (0 <= page_index < len(self._page_labels)):
|
||||
self._finish_programmatic_scroll()
|
||||
return
|
||||
self._updating_scroll_page = True
|
||||
self.page_index = page_index
|
||||
self.page_label = self._page_labels[page_index]
|
||||
geometry = self.page_label.geometry()
|
||||
target_x = geometry.x() + pdf_x * self.zoom - self.viewport().width() / 2
|
||||
target_y = geometry.y() + pdf_y * self.zoom - self.viewport().height() / 2
|
||||
hbar = self.horizontalScrollBar()
|
||||
vbar = self.verticalScrollBar()
|
||||
hbar.setValue(max(hbar.minimum(), min(hbar.maximum(), int(target_x))))
|
||||
vbar.setValue(max(vbar.minimum(), min(vbar.maximum(), int(target_y))))
|
||||
self.page_changed.emit(self.page_index)
|
||||
QTimer.singleShot(0, self._finish_programmatic_scroll)
|
||||
|
||||
def set_drawing_enabled(self, enabled: bool) -> None:
|
||||
if enabled:
|
||||
self.set_placement_enabled(False)
|
||||
self.set_area_selection_enabled(False)
|
||||
self.set_text_selection_enabled(False)
|
||||
self.set_shape_placement_enabled(False)
|
||||
self.set_hand_pan_enabled(False)
|
||||
for label in self._labels():
|
||||
label.drawing_enabled = enabled
|
||||
label.setCursor(Qt.CursorShape.CrossCursor if enabled else Qt.CursorShape.ArrowCursor)
|
||||
@@ -315,9 +535,12 @@ class PdfViewer(QScrollArea):
|
||||
|
||||
def set_placement_enabled(self, enabled: bool) -> None:
|
||||
if enabled:
|
||||
self.set_shape_placement_enabled(False)
|
||||
self.set_hand_pan_enabled(False)
|
||||
for label in self._labels():
|
||||
label.drawing_enabled = False
|
||||
label.area_selection_enabled = False
|
||||
label.text_selection_enabled = False
|
||||
self.set_object_edit_enabled(False)
|
||||
for label in self._labels():
|
||||
label.placement_enabled = enabled
|
||||
@@ -326,9 +549,12 @@ class PdfViewer(QScrollArea):
|
||||
|
||||
def set_area_selection_enabled(self, enabled: bool) -> None:
|
||||
if enabled:
|
||||
self.set_shape_placement_enabled(False)
|
||||
self.set_hand_pan_enabled(False)
|
||||
for label in self._labels():
|
||||
label.drawing_enabled = False
|
||||
label.placement_enabled = False
|
||||
label.text_selection_enabled = False
|
||||
self.set_object_edit_enabled(False)
|
||||
for label in self._labels():
|
||||
label.area_selection_enabled = enabled
|
||||
@@ -339,12 +565,69 @@ class PdfViewer(QScrollArea):
|
||||
label.setCursor(Qt.CursorShape.CrossCursor if enabled else Qt.CursorShape.ArrowCursor)
|
||||
self.viewport().setCursor(Qt.CursorShape.CrossCursor if enabled else Qt.CursorShape.ArrowCursor)
|
||||
|
||||
def set_object_edit_enabled(self, enabled: bool) -> None:
|
||||
def set_text_selection_enabled(self, enabled: bool) -> None:
|
||||
if enabled:
|
||||
self.set_shape_placement_enabled(False)
|
||||
self.set_hand_pan_enabled(False)
|
||||
for label in self._labels():
|
||||
label.drawing_enabled = False
|
||||
label.placement_enabled = False
|
||||
label.area_selection_enabled = False
|
||||
self.set_object_edit_enabled(False)
|
||||
for label in self._labels():
|
||||
label.text_selection_enabled = enabled
|
||||
if not enabled:
|
||||
label._selecting_text = False
|
||||
label._area_rect = QRectF()
|
||||
label.update()
|
||||
label.setCursor(Qt.CursorShape.IBeamCursor if enabled else Qt.CursorShape.ArrowCursor)
|
||||
self.viewport().setCursor(Qt.CursorShape.IBeamCursor if enabled else Qt.CursorShape.ArrowCursor)
|
||||
|
||||
def set_shape_placement_enabled(self, enabled: bool, kind: str = "") -> None:
|
||||
if enabled:
|
||||
self.set_hand_pan_enabled(False)
|
||||
for label in self._labels():
|
||||
label.drawing_enabled = False
|
||||
label.placement_enabled = False
|
||||
label.area_selection_enabled = False
|
||||
label.text_selection_enabled = False
|
||||
self.set_object_edit_enabled(False)
|
||||
for label in self._labels():
|
||||
label.shape_placement_enabled = enabled
|
||||
label.shape_placement_kind = kind if enabled else ""
|
||||
if not enabled:
|
||||
label._placing_shape = False
|
||||
label._shape_start = QPointF()
|
||||
label._shape_end = QPointF()
|
||||
label.update()
|
||||
label.setCursor(Qt.CursorShape.CrossCursor if enabled else Qt.CursorShape.ArrowCursor)
|
||||
self.viewport().setCursor(Qt.CursorShape.CrossCursor if enabled else Qt.CursorShape.ArrowCursor)
|
||||
|
||||
def set_hand_pan_enabled(self, enabled: bool) -> None:
|
||||
if enabled:
|
||||
for label in self._labels():
|
||||
label.drawing_enabled = False
|
||||
label.placement_enabled = False
|
||||
label.area_selection_enabled = False
|
||||
label.text_selection_enabled = False
|
||||
label.shape_placement_enabled = False
|
||||
self.set_object_edit_enabled(False)
|
||||
for label in self._labels():
|
||||
label.hand_pan_enabled = enabled
|
||||
if not enabled:
|
||||
label._hand_panning = False
|
||||
label.setCursor(Qt.CursorShape.OpenHandCursor if enabled else Qt.CursorShape.ArrowCursor)
|
||||
self.viewport().setCursor(Qt.CursorShape.OpenHandCursor if enabled else Qt.CursorShape.ArrowCursor)
|
||||
|
||||
def set_object_edit_enabled(self, enabled: bool) -> None:
|
||||
if enabled:
|
||||
self.set_shape_placement_enabled(False)
|
||||
self.set_hand_pan_enabled(False)
|
||||
for label in self._labels():
|
||||
label.drawing_enabled = False
|
||||
label.placement_enabled = False
|
||||
label.area_selection_enabled = False
|
||||
label.text_selection_enabled = False
|
||||
else:
|
||||
self.clear_object_selection()
|
||||
for label in self._labels():
|
||||
@@ -357,30 +640,70 @@ class PdfViewer(QScrollArea):
|
||||
label.drawing_enabled = False
|
||||
label.placement_enabled = False
|
||||
label.area_selection_enabled = False
|
||||
label.text_selection_enabled = False
|
||||
label.shape_placement_enabled = False
|
||||
label.shape_placement_kind = ""
|
||||
label.hand_pan_enabled = False
|
||||
label._hand_panning = False
|
||||
label.object_edit_enabled = False
|
||||
label._placing_shape = False
|
||||
label.setCursor(Qt.CursorShape.ArrowCursor)
|
||||
self.viewport().setCursor(Qt.CursorShape.ArrowCursor)
|
||||
self.clear_object_selection()
|
||||
self.clear_text_selection()
|
||||
|
||||
def set_selected_object_rect(self, rect: tuple[float, float, float, float] | None) -> None:
|
||||
if not rect:
|
||||
self.clear_object_selection()
|
||||
return
|
||||
self._selected_object_rect = rect
|
||||
self._selected_object_rects = []
|
||||
self._selected_object_page_index = self.page_index
|
||||
self._apply_object_selection_to_labels()
|
||||
|
||||
def set_selected_object_rects(self, rects: list[tuple[float, float, float, float]]) -> None:
|
||||
self._selected_object_rect = None
|
||||
self._selected_object_rects = rects
|
||||
self._selected_object_page_index = self.page_index if rects else None
|
||||
self._apply_object_selection_to_labels()
|
||||
|
||||
def set_overlay_images(self, overlays: list[dict[str, object]]) -> None:
|
||||
self._overlay_images = overlays
|
||||
self._refresh_overlay_zoom()
|
||||
|
||||
def set_search_highlights(
|
||||
self,
|
||||
page_index: int | None,
|
||||
rects: list[tuple[float, float, float, float]] | None = None,
|
||||
) -> None:
|
||||
self._search_highlights.clear()
|
||||
if page_index is not None and rects:
|
||||
self._search_highlights[page_index] = rects
|
||||
self._refresh_search_highlights()
|
||||
|
||||
def set_text_selection_highlights(
|
||||
self,
|
||||
page_index: int | None,
|
||||
rects: list[tuple[float, float, float, float]] | None = None,
|
||||
) -> None:
|
||||
self._text_selection_highlights.clear()
|
||||
if page_index is not None and rects:
|
||||
self._text_selection_highlights[page_index] = rects
|
||||
self._refresh_text_selection_highlights()
|
||||
|
||||
def clear_object_selection(self) -> None:
|
||||
self._selected_object_rect = None
|
||||
self._selected_object_rects = []
|
||||
self._selected_object_page_index = None
|
||||
for label in self._labels():
|
||||
label.selected_rect = None
|
||||
label.selected_rects = []
|
||||
label.update()
|
||||
|
||||
def clear_text_selection(self) -> None:
|
||||
self._text_selection_highlights.clear()
|
||||
self._refresh_text_selection_highlights()
|
||||
|
||||
def fit_width(self) -> None:
|
||||
if not self.document or not self.document.is_open:
|
||||
return
|
||||
@@ -423,12 +746,25 @@ class PdfViewer(QScrollArea):
|
||||
|
||||
def _connect_page_label(self, label: PageLabel, page_index: int) -> None:
|
||||
label.stroke_finished.connect(lambda stroke, index=page_index: self._emit_ink_stroke_for_page(index, stroke))
|
||||
label.hand_pan_delta.connect(self._pan_by_delta)
|
||||
label.placement_requested.connect(lambda point, index=page_index: self._emit_placement_for_page(index, point))
|
||||
label.area_selection_finished.connect(lambda rect, index=page_index: self._emit_area_selection_for_page(index, rect))
|
||||
label.text_selection_preview_changed.connect(
|
||||
lambda rect, start, end, index=page_index: self._emit_text_selection_preview_for_page(index, rect, start, end)
|
||||
)
|
||||
label.text_selection_finished.connect(
|
||||
lambda rect, start, end, index=page_index: self._emit_text_selection_for_page(index, rect, start, end)
|
||||
)
|
||||
label.text_selection_click_requested.connect(lambda point, index=page_index: self._emit_text_selection_click_for_page(index, point))
|
||||
label.text_selection_context_requested.connect(lambda point, index=page_index: self._emit_text_selection_context_for_page(index, point))
|
||||
label.shape_placement_finished.connect(lambda kind, start, end, index=page_index: self._emit_shape_placement_for_page(index, kind, start, end))
|
||||
label.object_select_requested.connect(lambda point, index=page_index: self._emit_object_select_for_page(index, point))
|
||||
label.object_rect_changed.connect(lambda rect, index=page_index: self._emit_object_rect_changed_for_page(index, rect))
|
||||
label.object_context_requested.connect(lambda point, index=page_index: self._emit_object_context_for_page(index, point))
|
||||
label.object_double_clicked.connect(lambda point, index=page_index: self._emit_object_double_clicked_for_page(index, point))
|
||||
label.annotation_double_clicked.connect(lambda point, index=page_index: self._emit_annotation_double_clicked_for_page(index, point))
|
||||
label.annotation_hover_requested.connect(lambda point, index=page_index: self._emit_annotation_hover_for_page(index, point))
|
||||
label.setMouseTracking(True)
|
||||
|
||||
def _labels(self) -> list[PageLabel]:
|
||||
return self._page_labels or [self.page_label]
|
||||
@@ -445,7 +781,25 @@ class PdfViewer(QScrollArea):
|
||||
if not self._page_labels or page_index < 0 or page_index >= len(self._page_labels):
|
||||
return
|
||||
self._updating_scroll_page = True
|
||||
self.ensureWidgetVisible(self._page_labels[page_index], 0, 0)
|
||||
self.page_index = page_index
|
||||
self.page_label = self._page_labels[page_index]
|
||||
self._apply_scroll_to_page(page_index, attempts=3)
|
||||
|
||||
def _apply_scroll_to_page(self, page_index: int, attempts: int = 0) -> None:
|
||||
if not self._page_labels or page_index < 0 or page_index >= len(self._page_labels):
|
||||
self._finish_programmatic_scroll()
|
||||
return
|
||||
self.content_layout.activate()
|
||||
self.content_widget.adjustSize()
|
||||
target_y = self._page_labels[page_index].geometry().top()
|
||||
bar = self.verticalScrollBar()
|
||||
bar.setValue(max(bar.minimum(), min(bar.maximum(), target_y)))
|
||||
if attempts > 0:
|
||||
QTimer.singleShot(0, lambda: self._apply_scroll_to_page(page_index, attempts - 1))
|
||||
else:
|
||||
QTimer.singleShot(0, self._finish_programmatic_scroll)
|
||||
|
||||
def _finish_programmatic_scroll(self) -> None:
|
||||
self._updating_scroll_page = False
|
||||
|
||||
def _update_current_page_from_scroll(self) -> None:
|
||||
@@ -474,6 +828,32 @@ class PdfViewer(QScrollArea):
|
||||
]
|
||||
label.update()
|
||||
|
||||
def _refresh_search_highlights(self) -> None:
|
||||
for page_index, label in enumerate(self._labels()):
|
||||
label.search_highlights = [
|
||||
(
|
||||
float(x0) * self.zoom,
|
||||
float(y0) * self.zoom,
|
||||
float(x1) * self.zoom,
|
||||
float(y1) * self.zoom,
|
||||
)
|
||||
for x0, y0, x1, y1 in self._search_highlights.get(page_index, [])
|
||||
]
|
||||
label.update()
|
||||
|
||||
def _refresh_text_selection_highlights(self) -> None:
|
||||
for page_index, label in enumerate(self._labels()):
|
||||
label.text_selection_highlights = [
|
||||
(
|
||||
float(x0) * self.zoom,
|
||||
float(y0) * self.zoom,
|
||||
float(x1) * self.zoom,
|
||||
float(y1) * self.zoom,
|
||||
)
|
||||
for x0, y0, x1, y1 in self._text_selection_highlights.get(page_index, [])
|
||||
]
|
||||
label.update()
|
||||
|
||||
def _apply_object_selection_to_labels(self) -> None:
|
||||
for index, label in enumerate(self._labels()):
|
||||
if self._selected_object_rect and self._selected_object_page_index == index:
|
||||
@@ -486,6 +866,18 @@ class PdfViewer(QScrollArea):
|
||||
)
|
||||
else:
|
||||
label.selected_rect = None
|
||||
if self._selected_object_rects and self._selected_object_page_index == index:
|
||||
label.selected_rects = [
|
||||
QRectF(
|
||||
x0 * self.zoom,
|
||||
y0 * self.zoom,
|
||||
(x1 - x0) * self.zoom,
|
||||
(y1 - y0) * self.zoom,
|
||||
)
|
||||
for x0, y0, x1, y1 in self._selected_object_rects
|
||||
]
|
||||
else:
|
||||
label.selected_rects = []
|
||||
label.update()
|
||||
|
||||
def _set_current_page_from_interaction(self, page_index: int) -> None:
|
||||
@@ -500,6 +892,10 @@ class PdfViewer(QScrollArea):
|
||||
points = [(point.x() / self.zoom, point.y() / self.zoom) for point in stroke]
|
||||
self.ink_stroke_finished.emit(page_index, points)
|
||||
|
||||
def _pan_by_delta(self, delta: QPointF) -> None:
|
||||
self.horizontalScrollBar().setValue(self.horizontalScrollBar().value() - int(delta.x()))
|
||||
self.verticalScrollBar().setValue(self.verticalScrollBar().value() - int(delta.y()))
|
||||
|
||||
def _emit_placement_for_page(self, page_index: int, point: QPointF) -> None:
|
||||
self._set_current_page_from_interaction(page_index)
|
||||
self.placement_requested.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
|
||||
@@ -516,6 +912,69 @@ class PdfViewer(QScrollArea):
|
||||
),
|
||||
)
|
||||
|
||||
def _emit_text_selection_for_page(
|
||||
self,
|
||||
page_index: int,
|
||||
rect: QRectF,
|
||||
start: QPointF,
|
||||
end: QPointF,
|
||||
) -> None:
|
||||
self._set_current_page_from_interaction(page_index)
|
||||
self.text_selection_finished.emit(
|
||||
page_index,
|
||||
(
|
||||
rect.left() / self.zoom,
|
||||
rect.top() / self.zoom,
|
||||
rect.right() / self.zoom,
|
||||
rect.bottom() / self.zoom,
|
||||
),
|
||||
(start.x() / self.zoom, start.y() / self.zoom),
|
||||
(end.x() / self.zoom, end.y() / self.zoom),
|
||||
)
|
||||
|
||||
def _emit_text_selection_preview_for_page(
|
||||
self,
|
||||
page_index: int,
|
||||
rect: QRectF,
|
||||
start: QPointF,
|
||||
end: QPointF,
|
||||
) -> None:
|
||||
self._set_current_page_from_interaction(page_index)
|
||||
self.text_selection_preview_changed.emit(
|
||||
page_index,
|
||||
(
|
||||
rect.left() / self.zoom,
|
||||
rect.top() / self.zoom,
|
||||
rect.right() / self.zoom,
|
||||
rect.bottom() / self.zoom,
|
||||
),
|
||||
(start.x() / self.zoom, start.y() / self.zoom),
|
||||
(end.x() / self.zoom, end.y() / self.zoom),
|
||||
)
|
||||
|
||||
def _emit_text_selection_context_for_page(self, page_index: int, point: QPointF) -> None:
|
||||
self._set_current_page_from_interaction(page_index)
|
||||
self.text_selection_context_requested.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
|
||||
|
||||
def _emit_text_selection_click_for_page(self, page_index: int, point: QPointF) -> None:
|
||||
self._set_current_page_from_interaction(page_index)
|
||||
self.text_selection_click_requested.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
|
||||
|
||||
def _emit_shape_placement_for_page(
|
||||
self,
|
||||
page_index: int,
|
||||
kind: str,
|
||||
start: QPointF,
|
||||
end: QPointF,
|
||||
) -> None:
|
||||
self._set_current_page_from_interaction(page_index)
|
||||
self.shape_placement_finished.emit(
|
||||
page_index,
|
||||
kind,
|
||||
(start.x() / self.zoom, start.y() / self.zoom),
|
||||
(end.x() / self.zoom, end.y() / self.zoom),
|
||||
)
|
||||
|
||||
def _emit_object_select_for_page(self, page_index: int, point: QPointF) -> None:
|
||||
self._set_current_page_from_interaction(page_index)
|
||||
self.object_select_requested.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
|
||||
@@ -539,3 +998,10 @@ class PdfViewer(QScrollArea):
|
||||
def _emit_object_double_clicked_for_page(self, page_index: int, point: QPointF) -> None:
|
||||
self._set_current_page_from_interaction(page_index)
|
||||
self.object_double_clicked.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
|
||||
|
||||
def _emit_annotation_double_clicked_for_page(self, page_index: int, point: QPointF) -> None:
|
||||
self._set_current_page_from_interaction(page_index)
|
||||
self.annotation_double_clicked.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
|
||||
|
||||
def _emit_annotation_hover_for_page(self, page_index: int, point: QPointF) -> None:
|
||||
self.annotation_hover_requested.emit(page_index, (point.x() / self.zoom, point.y() / self.zoom))
|
||||
|
||||
@@ -6,7 +6,7 @@ from PySide6.QtCore import QSize, Qt, QTimer, Signal
|
||||
from PySide6.QtGui import QPixmap
|
||||
from PySide6.QtWidgets import QLabel, QListWidget, QListWidgetItem, QTabWidget, QWidget, QVBoxLayout
|
||||
|
||||
from pdfreaderlite.core.document import PdfDocument
|
||||
from pdfreaderlite.core.document import Bookmark, PdfDocument
|
||||
|
||||
|
||||
class ThumbnailItemWidget(QWidget):
|
||||
@@ -187,7 +187,10 @@ class Sidebar(QTabWidget):
|
||||
super().__init__()
|
||||
self.setObjectName("leftSidebar")
|
||||
self.thumbnails = ThumbnailList()
|
||||
self.bookmarks = QListWidget()
|
||||
self.bookmarks.setObjectName("bookmarkList")
|
||||
self.thumbnails.page_selected.connect(self.page_selected.emit)
|
||||
self.bookmarks.itemClicked.connect(self._emit_bookmark_page)
|
||||
|
||||
thumb_page = QWidget()
|
||||
layout = QVBoxLayout(thumb_page)
|
||||
@@ -195,11 +198,41 @@ class Sidebar(QTabWidget):
|
||||
layout.addWidget(self.thumbnails)
|
||||
|
||||
self.addTab(thumb_page, "缩略图")
|
||||
self.addTab(self.bookmarks, "目录")
|
||||
self.setMinimumWidth(150)
|
||||
self.setMaximumWidth(330)
|
||||
|
||||
def load_document(self, document: PdfDocument) -> None:
|
||||
self.thumbnails.load_document(document)
|
||||
self._load_bookmarks(document)
|
||||
|
||||
def select_page(self, page_index: int) -> None:
|
||||
self.thumbnails.select_page(page_index)
|
||||
|
||||
def _load_bookmarks(self, document: PdfDocument) -> None:
|
||||
self.bookmarks.clear()
|
||||
if not document.is_open:
|
||||
self._add_empty_bookmark_item("打开 PDF 后显示目录")
|
||||
return
|
||||
bookmarks = document.bookmarks()
|
||||
if not bookmarks:
|
||||
self._add_empty_bookmark_item("当前 PDF 没有目录")
|
||||
return
|
||||
for bookmark in bookmarks:
|
||||
item = QListWidgetItem(self._bookmark_text(bookmark))
|
||||
item.setData(Qt.ItemDataRole.UserRole, bookmark.page_index)
|
||||
self.bookmarks.addItem(item)
|
||||
|
||||
def _add_empty_bookmark_item(self, text: str) -> None:
|
||||
item = QListWidgetItem(text)
|
||||
item.setFlags(item.flags() & ~Qt.ItemFlag.ItemIsEnabled)
|
||||
self.bookmarks.addItem(item)
|
||||
|
||||
def _bookmark_text(self, bookmark: Bookmark) -> str:
|
||||
prefix = " " * max(0, bookmark.level - 1)
|
||||
return f"{prefix}{bookmark.title} 第 {bookmark.page_index + 1} 页"
|
||||
|
||||
def _emit_bookmark_page(self, item: QListWidgetItem) -> None:
|
||||
page_index = item.data(Qt.ItemDataRole.UserRole)
|
||||
if isinstance(page_index, int):
|
||||
self.page_selected.emit(page_index)
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
[project]
|
||||
name = "PDFReaderLite"
|
||||
version = "0.1.0"
|
||||
version = "0.2.2"
|
||||
description = "A lightweight Windows PDF reader and editor inspired by common Adobe Acrobat workflows."
|
||||
requires-python = ">=3.10"
|
||||
dependencies = [
|
||||
|
||||
Reference in New Issue
Block a user