前言

作為學(xué)生，想必大家都有過(guò)被海量手寫(xiě)實(shí)驗(yàn)報(bào)告、課程作業(yè)支配的痛苦。要花費(fèi)大量時(shí)間一筆一劃地抄寫(xiě)到紙質(zhì)文檔中再進(jìn)行掃描成pdf提交，不僅耗時(shí)耗力，手寫(xiě)的字跡還可能參差不齊，影響作業(yè)美觀(guān)度。

為了偷懶，博主開(kāi)發(fā)了一款基于python的PDF手寫(xiě)模擬器，它能夠模擬真實(shí)手寫(xiě)筆跡，將電腦上的文字批量填充到 PDF 指定區(qū)域，支持中文/英文分開(kāi)配置、手寫(xiě)擾動(dòng)效果自定義、配置模版復(fù)用等功能，生成的效果高度貼近真實(shí)手寫(xiě)，幫你徹底告別手動(dòng)抄寫(xiě)的煩惱。首先來(lái)個(gè)界面以及效果預(yù)覽：

流程思路總覽

這款 PDF 手寫(xiě)模擬器的整體運(yùn)作流程可以分為「用戶(hù)操作流程」和「技術(shù)實(shí)現(xiàn)流程」兩層，清晰易懂：

1. 用戶(hù)操作流程（簡(jiǎn)單易上手）

打開(kāi)目標(biāo) PDF：選擇需要填寫(xiě)的實(shí)驗(yàn)報(bào)告、作業(yè)等 PDF 文件；

框選填寫(xiě)區(qū)域：在 PDF 預(yù)覽界面拖動(dòng)鼠標(biāo)，框選出需要插入文字的區(qū)域（紅色矩形標(biāo)記）；

配置手寫(xiě)參數(shù)：分別在中文、英文/數(shù)字選項(xiàng)卡中調(diào)整字體、大小、顏色、擾動(dòng)效果等參數(shù)；

輸入并預(yù)覽文字：在右側(cè)文本框輸入需要填寫(xiě)的內(nèi)容，開(kāi)啟「實(shí)時(shí)預(yù)覽」查看手寫(xiě)效果；

不滿(mǎn)意可實(shí)時(shí)調(diào)整參數(shù)

確認(rèn)并保存：效果滿(mǎn)意后確認(rèn)應(yīng)用筆跡，支持撤銷(xiāo)、擦除錯(cuò)誤內(nèi)容，也可保存當(dāng)前配置為模版，最后導(dǎo)出填寫(xiě)完成的 PDF。

2. 技術(shù)實(shí)現(xiàn)流程（分層協(xié)作）

• UI 交互層：基于 tkinter 搭建可視化界面，提供按鈕、選項(xiàng)卡、文本框等交互組件，接收用戶(hù)操作；
• 參數(shù)配置層：管理中文/英文手寫(xiě)參數(shù)，支持配置保存（JSON）與加載，實(shí)現(xiàn)模版復(fù)用；
• PDF 操作層：基于 PyMuPDF 實(shí)現(xiàn) PDF 的讀取、頁(yè)面渲染、文字插入、擦除、保存等核心操作；
• 手寫(xiě)渲染層：核心邏輯層，實(shí)現(xiàn)文字排版、語(yǔ)言區(qū)分、手寫(xiě)擾動(dòng)效果生成，最終將模擬手寫(xiě)文字插入 PDF。

┌─────────────────────┐
│  UI交互層（tkinter） │  # 可視化交互，接收操作
└─────────────┬───────┘
              ▼
┌─────────────────────┐
│  參數(shù)配置層（JSON）  │  # 參數(shù)管理，模版復(fù)用
└─────────────┬───────┘
              ▼
┌─────────────────────┐
│ PDF操作層（PyMuPDF） │  # PDF核心操作（讀寫(xiě)/保存等）
└─────────────┬───────┘
              ▼
┌─────────────────────┐
│  手寫(xiě)渲染層（核心）  │  # 手寫(xiě)效果生成，文字插入
└─────────────────────┘

涉及的具體技術(shù)

這款工具基于 Python 生態(tài)的常用庫(kù)開(kāi)發(fā)，技術(shù)棧輕量化且實(shí)用性強(qiáng)，核心涉及以下技術(shù)：

• tkinter：Python 內(nèi)置 GUI 庫(kù)，無(wú)需額外安裝，負(fù)責(zé)搭建整個(gè)應(yīng)用的可視化界面，實(shí)現(xiàn)按鈕點(diǎn)擊、參數(shù)調(diào)整、文本輸入、PDF 預(yù)覽等交互功能；
• PyMuPDF（fitz）：核心 PDF 處理庫(kù)，提供高效的 PDF 讀取、寫(xiě)入、頁(yè)面渲染、文字插入、紅act標(biāo)注（擦除功能）等接口，是實(shí)現(xiàn) PDF 編輯的核心依賴(lài)；
• Pillow（PIL）：圖像處理庫(kù)，將 PyMuPDF 渲染出的 PDF 頁(yè)面像素?cái)?shù)據(jù)，轉(zhuǎn)換成 tkinter 畫(huà)布可顯示的圖像格式，實(shí)現(xiàn) PDF 頁(yè)面的可視化預(yù)覽；
• JSON：輕量級(jí)數(shù)據(jù)格式，用于保存用戶(hù)配置的手寫(xiě)參數(shù)模版（字體、大小、擾動(dòng)值等），方便后續(xù)直接復(fù)用，無(wú)需重復(fù)調(diào)整；
• Python 隨機(jī)數(shù)與數(shù)學(xué)計(jì)算：實(shí)現(xiàn)手寫(xiě)效果的「不規(guī)則擾動(dòng)」，模擬真實(shí)手寫(xiě)的位置偏移、大小波動(dòng)、行傾斜等特性；
• TTF 字體支持：讀取自定義 TrueType 字體文件，支持切換不同手寫(xiě)風(fēng)格字體，適配不同用戶(hù)的手寫(xiě)習(xí)慣。

最終效果演示

代碼原理簡(jiǎn)單講解（手寫(xiě)字體生成 + 擾動(dòng)效果）

我們重點(diǎn)講解核心功能 —— 手寫(xiě)字體生成與擾動(dòng)效果的實(shí)現(xiàn)，忽略 UI 搭建等輔助代碼，聚焦核心邏輯：

手寫(xiě)字體生成（文字插入 PDF 核心）

這部分的核心是將文字按規(guī)則排版后，插入到 PDF 指定區(qū)域，關(guān)鍵步驟如下：

1.文字與區(qū)域預(yù)處理

首先獲取文本框中的輸入文字，按換行符 \n 分割成多行，同時(shí)將用戶(hù)框選的預(yù)覽區(qū)域坐標(biāo)（帶縮放比例）轉(zhuǎn)換為 PDF 實(shí)際坐標(biāo)（除以縮放系數(shù) self.zoom），得到真實(shí)的填寫(xiě)范圍 (x1, y1, x2, y2)。

# 讀取輸入文字并分割行
text = self.text_editor.get("1.0", tk.END).strip("\n")
lines = text.split('\n')
# 轉(zhuǎn)換為 PDF 實(shí)際坐標(biāo)（去除預(yù)覽縮放影響）
x1, y1 = min(self.start_x, self.end_x)/self.zoom, min(self.start_y, self.end_y)/self.zoom
x2, y2 = max(self.start_x, self.end_x)/self.zoom, max(self.start_y, self.end_y)/self.zoom

2.語(yǔ)言區(qū)分與參數(shù)匹配

通過(guò) is_chinese 函數(shù)判斷單個(gè)字符是中文還是英文/數(shù)字，分別匹配對(duì)應(yīng)的配置參數(shù)（中文/英文獨(dú)立的字體、大小、字距等），確保不同語(yǔ)言的手寫(xiě)效果適配合理。

# 判斷是否為中文（含中文標(biāo)點(diǎn)）
def is_chinese(self, char):
    if '\u4e00' <= char <= '\u9fff': return True
    if char in "。，、？?。?；“”‘'（）《》【】": return True
    return False

# 遍歷字符時(shí)匹配對(duì)應(yīng)語(yǔ)言參數(shù)
lang = 'zh' if self.is_chinese(char) else 'en'
p = self.params[lang]  # 獲取對(duì)應(yīng)語(yǔ)言的配置參數(shù)

3.PDF 文字插入核心 API

使用 PyMuPDF 的 page.insert_text 方法實(shí)現(xiàn)文字插入，這是手寫(xiě)字體生成的關(guān)鍵，核心參數(shù)說(shuō)明如下：

• fitz.Point(final_x, final_y)：文字的實(shí)際插入坐標(biāo)（經(jīng)排版和擾動(dòng)調(diào)整后）；
• char：要插入的單個(gè)字符（逐字符插入實(shí)現(xiàn)精細(xì)排版）；
• fontsize：字符的實(shí)際大?。◣Т笮《秳?dòng)）；
• fontfile：TTF 手寫(xiě)字體文件路徑，決定字體風(fēng)格；
• color：文字顏色（默認(rèn)純黑，支持用戶(hù)自定義）；
• morph：變換矩陣，實(shí)現(xiàn)字符旋轉(zhuǎn)效果（疊加行傾斜與字符旋轉(zhuǎn)抖動(dòng)）。

4.行與字符排版

按行遍歷文字，逐字符計(jì)算插入坐標(biāo)，處理空格（單獨(dú)預(yù)留間距），當(dāng)字符橫坐標(biāo)超出框選區(qū)域右側(cè)時(shí)自動(dòng)換行，同時(shí)根據(jù)「行距參數(shù)」調(diào)整下一行的縱坐標(biāo)，確保文字排版規(guī)整且不超出框選范圍。

擾動(dòng)效果實(shí)現(xiàn)（模擬真實(shí)手寫(xiě)不規(guī)則性）

這是工具的靈魂所在，通過(guò)「行級(jí)擾動(dòng)」和「字符級(jí)擾動(dòng)」兩層效果，徹底擺脫打印體的規(guī)整感，貼近真實(shí)手寫(xiě)，對(duì)應(yīng)代碼中的配置參數(shù)：

行級(jí)擾動(dòng)（整行不規(guī)則性）：針對(duì)每一行文字，添加整體的偏移和傾斜，模擬手寫(xiě)時(shí)「行不直、略有偏移」的特點(diǎn)，對(duì)應(yīng)三個(gè)參數(shù)：

# 行級(jí)擾動(dòng)參數(shù)計(jì)算
line_dx = random.uniform(-p_line['line_jitter_x'].get(), p_line['line_jitter_x'].get())
line_dy = random.uniform(-p_line['line_jitter_y'].get(), p_line['line_jitter_y'].get())
line_angle_deg = random.uniform(-p_line['line_tilt'].get(), p_line['line_tilt'].get())
line_angle_rad = math.radians(line_angle_deg)

• 行左右平移（line_jitter_x）：隨機(jī)生成 -line_jitter_x ~ line_jitter_x 范圍內(nèi)的偏移量 line_dx，使每行文字左右輕微晃動(dòng)；
• 行上下平移（line_jitter_y）：隨機(jī)生成 -line_jitter_y ~ line_jitter_y 范圍內(nèi)的偏移量 line_dy，使行與行之間的間距略有差異；
• 行整行傾斜（line_tilt）：隨機(jī)生成傾斜角度 line_angle_deg，轉(zhuǎn)換為弧度后，通過(guò) tilt_y_offset = (curr_x - line_start_x) * math.tan(line_angle_rad) 計(jì)算每個(gè)字符的Y軸偏移，實(shí)現(xiàn)整行輕微傾斜。

字符級(jí)擾動(dòng)（單個(gè)字符不規(guī)則性）：針對(duì)每個(gè)字符，添加位置、大小、旋轉(zhuǎn)的細(xì)微差異，模擬手寫(xiě)時(shí)「每個(gè)字大小不一、略有晃動(dòng)」的特點(diǎn)，對(duì)應(yīng)三個(gè)參數(shù)：

# 字符級(jí)擾動(dòng)參數(shù)計(jì)算
char_jitter_x = random.uniform(-p['jitter_pos'].get(), p['jitter_pos'].get())
char_jitter_y = random.uniform(-p['jitter_pos'].get(), p['jitter_pos'].get())
char_jitter_rot = random.uniform(-p['jitter_rot'].get(), p['jitter_rot'].get())
char_jitter_fs = f_size + random.uniform(-p['jitter_size'].get(), p['jitter_size'].get())

• 字位置抖動(dòng)（jitter_pos）：隨機(jī)生成 (-jitter_pos ~ jitter_pos) 的X、Y偏移量，使字符脫離嚴(yán)格的水平對(duì)齊；
• 字大小抖動(dòng)（jitter_size）：在基礎(chǔ)字體大小上，隨機(jī)增減 (-jitter_size ~ jitter_size) 的數(shù)值，生成 char_jitter_fs，使字符大小略有差異；
• 字旋轉(zhuǎn)抖動(dòng)（jitter_rot）：隨機(jī)生成 (-jitter_rot ~ jitter_rot) 的旋轉(zhuǎn)角度，疊加行傾斜角度后，通過(guò) morph 參數(shù)實(shí)現(xiàn)字符輕微旋轉(zhuǎn)。

隨機(jī)數(shù)控制（預(yù)覽穩(wěn)定 + 實(shí)際隨機(jī)）：為了保證實(shí)時(shí)預(yù)覽時(shí)效果穩(wěn)定可調(diào)整，設(shè)置隨機(jī)數(shù)種子 random.seed(42) 固定擾動(dòng)效果；實(shí)際應(yīng)用筆跡時(shí)，不設(shè)置種子 random.seed()，生成隨機(jī)的擾動(dòng)效果，讓每次生成的手寫(xiě)風(fēng)格略有差異，更貼近真實(shí)場(chǎng)景。

if is_preview: random.seed(42)  # 預(yù)覽模式：固定隨機(jī)數(shù)，效果穩(wěn)定
else: random.seed()  # 實(shí)際生成：隨機(jī)種子，效果更真實(shí)

總結(jié)

這款 PDF 手寫(xiě)模擬器完美解決了手寫(xiě)作業(yè)、實(shí)驗(yàn)報(bào)告的痛點(diǎn)，兼具「實(shí)用性」和「靈活性」：

• 實(shí)用性拉滿(mǎn)：無(wú)需手動(dòng)抄寫(xiě)，一鍵生成手寫(xiě)風(fēng)格 PDF，節(jié)省大量時(shí)間和精力，生成效果高度貼近真實(shí)手寫(xiě)；
• 自定義性強(qiáng)：中文/英文獨(dú)立配置，支持字體、顏色、大小、字距行距調(diào)整，多層擾動(dòng)參數(shù)可精細(xì)調(diào)控手寫(xiě)風(fēng)格；
• 操作便捷：可視化界面友好，支持實(shí)時(shí)預(yù)覽、撤銷(xiāo)、擦除、模版復(fù)用，零基礎(chǔ)用戶(hù)也能快速上手；
• 技術(shù)輕量化：基于 Python 常用庫(kù)開(kāi)發(fā)，無(wú)需復(fù)雜環(huán)境配置，代碼可靈活修改擴(kuò)展。

當(dāng)然，這款工具還有優(yōu)化空間，比如支持連筆效果、筆跡粗細(xì)變化、批量處理多個(gè) PDF 等。如果大家有類(lèi)似需求，可以基于這份代碼進(jìn)行二次開(kāi)發(fā)，適配自己的使用場(chǎng)景。

以上就是基于Python打造一個(gè)PDF手寫(xiě)模擬器的詳細(xì)內(nèi)容，更多關(guān)于Python PDF手寫(xiě)模擬器的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論