Add undo redo page reorder and handwritten signatures

This commit is contained in:
2026-06-29 15:38:36 +08:00
parent 736f9249b9
commit 33d2c15630
6 changed files with 305 additions and 9 deletions
+101 -3
View File
@@ -40,6 +40,8 @@ class PdfDocument:
self.path: Path | None = None
self._doc: fitz.Document | None = None
self._revision = 0
self._undo_stack: list[bytes] = []
self._redo_stack: list[bytes] = []
self._render_cache: OrderedDict[tuple[int, int, float], QImage] = OrderedDict()
self._thumbnail_cache: OrderedDict[tuple[int, int, int], QImage] = OrderedDict()
@@ -65,12 +67,14 @@ class PdfDocument:
if not password or not self._doc.authenticate(password):
self.close()
raise EncryptedPdfError("该 PDF 需要密码。")
self.clear_history()
def close(self) -> None:
if self._doc:
self._doc.close()
self._doc = None
self.path = None
self.clear_history()
self.clear_cache()
def render_page(self, page_index: int, zoom: float) -> QImage:
@@ -128,6 +132,7 @@ class PdfDocument:
return matches
def rotate_page(self, page_index: int, degrees: int = 90) -> None:
self.snapshot()
page = self._page(page_index)
page.set_rotation((page.rotation + degrees) % 360)
self.mark_changed()
@@ -135,6 +140,8 @@ class PdfDocument:
def highlight_text(self, page_index: int, text: str) -> int:
page = self._page(page_index)
rects = page.search_for(text.strip())
if rects:
self.snapshot()
for rect in rects:
annot = page.add_highlight_annot(rect)
annot.update()
@@ -145,6 +152,8 @@ class PdfDocument:
def underline_text(self, page_index: int, text: str) -> int:
page = self._page(page_index)
rects = page.search_for(text.strip())
if rects:
self.snapshot()
for rect in rects:
annot = page.add_underline_annot(rect)
annot.update()
@@ -155,6 +164,8 @@ class PdfDocument:
def strikeout_text(self, page_index: int, text: str) -> int:
page = self._page(page_index)
rects = page.search_for(text.strip())
if rects:
self.snapshot()
for rect in rects:
annot = page.add_strikeout_annot(rect)
annot.update()
@@ -163,6 +174,7 @@ class PdfDocument:
return len(rects)
def add_note(self, page_index: int, text: str) -> None:
self.snapshot()
page = self._page(page_index)
point = fitz.Point(72, 72)
annot = page.add_text_annot(point, text)
@@ -170,12 +182,14 @@ class PdfDocument:
self.mark_changed()
def add_text(self, page_index: int, text: str) -> None:
self.snapshot()
page = self._page(page_index)
point = fitz.Point(72, 96)
page.insert_text(point, text, fontsize=14, fontname="china-s", color=(0, 0, 0))
self.mark_changed()
def insert_image(self, page_index: int, image_path: str | Path) -> None:
self.snapshot()
page = self._page(page_index)
page_rect = page.rect
width = page_rect.width * 0.35
@@ -185,6 +199,7 @@ class PdfDocument:
self.mark_changed()
def add_signature(self, page_index: int, image_path: str | Path) -> None:
self.snapshot()
page = self._page(page_index)
page_rect = page.rect
width = page_rect.width * 0.28
@@ -200,6 +215,7 @@ class PdfDocument:
self.mark_changed()
def add_rectangle(self, page_index: int) -> None:
self.snapshot()
page = self._page(page_index)
rect = self._default_rect(page)
annot = page.add_rect_annot(rect)
@@ -209,6 +225,7 @@ class PdfDocument:
self.mark_changed()
def add_circle(self, page_index: int) -> None:
self.snapshot()
page = self._page(page_index)
rect = self._default_rect(page)
annot = page.add_circle_annot(rect)
@@ -218,6 +235,7 @@ class PdfDocument:
self.mark_changed()
def add_line(self, page_index: int, arrow: bool = False) -> None:
self.snapshot()
page = self._page(page_index)
rect = self._default_rect(page)
start = fitz.Point(rect.x0, rect.y0)
@@ -231,6 +249,7 @@ class PdfDocument:
self.mark_changed()
def add_cover_area(self, page_index: int) -> None:
self.snapshot()
page = self._page(page_index)
rect = self._default_rect(page)
annot = page.add_rect_annot(rect)
@@ -242,6 +261,7 @@ class PdfDocument:
def insert_blank_page(self, after_page_index: int | None = None) -> int:
if not self._doc:
raise RuntimeError("没有打开 PDF")
self.snapshot()
if self.page_count:
source = self._page(after_page_index if after_page_index is not None else self.page_count - 1)
width = source.rect.width
@@ -257,6 +277,7 @@ class PdfDocument:
def insert_pdf(self, source_path: str | Path, after_page_index: int | None = None) -> int:
if not self._doc:
raise RuntimeError("没有打开 PDF")
self.snapshot()
insert_at = self.page_count if after_page_index is None else after_page_index + 1
with fitz.open(source_path) as source:
count = source.page_count
@@ -362,6 +383,7 @@ class PdfDocument:
) -> None:
if not self._doc:
raise RuntimeError("没有打开 PDF")
self.snapshot()
metadata = self.metadata()
metadata.update(
{
@@ -399,6 +421,7 @@ class PdfDocument:
annot = page.first_annot
while annot:
if annot.xref == xref:
self.snapshot()
page.delete_annot(annot)
self.mark_changed()
return True
@@ -432,6 +455,7 @@ class PdfDocument:
widgets = self._page(page_index).widgets() or []
for widget in widgets:
if widget.field_name == field_name:
self.snapshot()
widget.field_value = value
widget.update()
self.mark_changed()
@@ -441,9 +465,23 @@ class PdfDocument:
def delete_page(self, page_index: int) -> None:
if not self._doc:
raise RuntimeError("没有打开 PDF")
self.snapshot()
self._doc.delete_page(page_index)
self.mark_changed()
def move_page(self, from_page_index: int, to_page_index: int) -> None:
if not self._doc:
raise RuntimeError("没有打开 PDF")
if from_page_index < 0 or from_page_index >= self.page_count:
raise IndexError("源页码超出范围")
if to_page_index < 0 or to_page_index >= self.page_count:
raise IndexError("目标页码超出范围")
if from_page_index == to_page_index:
return
self.snapshot()
self._doc.move_page(from_page_index, to_page_index)
self.mark_changed()
def save(self) -> None:
if not self.path:
raise RuntimeError("没有原始文件路径")
@@ -456,7 +494,13 @@ class PdfDocument:
target = Path(path)
target.parent.mkdir(parents=True, exist_ok=True)
original_path = self.path
if original_path and target.resolve() == original_path.resolve():
can_incremental = (
original_path
and target.resolve() == original_path.resolve()
and self._doc.name
and Path(self._doc.name).resolve() == target.resolve()
)
if can_incremental:
self._doc.saveIncr()
self._doc.close()
self.path = target
@@ -479,7 +523,14 @@ class PdfDocument:
if temp_path.exists():
temp_path.unlink()
def save_encrypted(self, path: str | Path, password: str) -> None:
def save_encrypted(
self,
path: str | Path,
password: str,
allow_print: bool = True,
allow_copy: bool = True,
allow_modify: bool = False,
) -> None:
if not self._doc:
raise RuntimeError("没有打开 PDF")
if not password:
@@ -487,6 +538,13 @@ class PdfDocument:
target = Path(path)
target.parent.mkdir(parents=True, exist_ok=True)
permissions = fitz.PDF_PERM_ACCESSIBILITY
if allow_print:
permissions |= fitz.PDF_PERM_PRINT
if allow_copy:
permissions |= fitz.PDF_PERM_COPY
if allow_modify:
permissions |= fitz.PDF_PERM_MODIFY
self._doc.save(
target,
garbage=4,
@@ -494,7 +552,7 @@ class PdfDocument:
encryption=fitz.PDF_ENCRYPT_AES_256,
owner_pw=password,
user_pw=password,
permissions=fitz.PDF_PERM_ACCESSIBILITY | fitz.PDF_PERM_PRINT,
permissions=permissions,
)
def _page(self, page_index: int) -> fitz.Page:
@@ -508,6 +566,46 @@ class PdfDocument:
self._revision += 1
self.clear_cache()
def snapshot(self) -> None:
if not self._doc:
return
self._undo_stack.append(self._doc.tobytes(garbage=4, deflate=True))
if len(self._undo_stack) > 20:
self._undo_stack.pop(0)
self._redo_stack.clear()
def can_undo(self) -> bool:
return bool(self._undo_stack)
def can_redo(self) -> bool:
return bool(self._redo_stack)
def undo(self) -> bool:
if not self._doc or not self._undo_stack:
return False
self._redo_stack.append(self._doc.tobytes(garbage=4, deflate=True))
data = self._undo_stack.pop()
self._replace_with_bytes(data)
return True
def redo(self) -> bool:
if not self._doc or not self._redo_stack:
return False
self._undo_stack.append(self._doc.tobytes(garbage=4, deflate=True))
data = self._redo_stack.pop()
self._replace_with_bytes(data)
return True
def clear_history(self) -> None:
self._undo_stack.clear()
self._redo_stack.clear()
def _replace_with_bytes(self, data: bytes) -> None:
if self._doc:
self._doc.close()
self._doc = fitz.open("pdf", data)
self.mark_changed()
def clear_cache(self) -> None:
self._render_cache.clear()
self._thumbnail_cache.clear()