Python 實戰：從零生成多頁 PDF，並將每一頁高畫質轉為圖片; mat = fitz .Matrix( zoom_x , zoom_y) ; pix = page .get_pixmap( matrix=mat )

pip install pymupdf

import fitz  # 匯入 PyMuPDF

def create_sample_pdf(filename="sample.pdf"):
    # 1. 建立一個空白的 PDF 文件物件
    doc = fitz.open()

    # 2. 新增第一頁，並寫入文字
    page1 = doc.new_page()
    page1.insert_text(
        fitz.Point(50, 100),  # 文字的 X, Y 座標
        "這是第一頁 (Page 1)", 
        fontsize=24,
        fontname="helv" # 使用內建字體 Helvetica
    )

    # 3. 新增第二頁，並寫入文字
    page2 = doc.new_page()
    page2.insert_text(
        fitz.Point(50, 100), 
        "這是第二頁 (Page 2) - 準備轉成圖片！", 
        fontsize=24,
        fontname="helv"
    )

    # 4. 儲存並關閉檔案
    doc.save(filename)
    doc.close()
    
    print(f"✅ 成功建立 PDF 檔案：{filename}")

# 執行生成 PDF 的函數
create_sample_pdf()

import fitz

def pdf_to_images(pdf_path="sample.pdf"):
    # 1. 打開剛剛建立的 PDF 檔案
    doc = fitz.open(pdf_path)
    
    # 2. 設定解析度放大倍率 (長寬各放大 2 倍，讓圖片更清晰)
    zoom_x = 2.0  
    zoom_y = 2.0  
    mat = fitz.Matrix(zoom_x, zoom_y)

    # 3. 使用迴圈遍歷 PDF 的每一頁
    # len(doc) 會回傳這份 PDF 總共有幾頁
    for i in range(len(doc)):
        
        # 使用直覺的寫法獲取頁面 (等同於 doc.load_page(i))
        page = doc[i] 
        
        # 將該頁面渲染成圖片 (Pixmap)，並套用我們設定的放大矩陣
        pix = page.get_pixmap(matrix=mat)
        
        # 設定輸出的圖片檔名 (i 從 0 開始，所以檔名 +1 比較符合人類閱讀習慣)
        output_filename = rf"output_page_{i + 1}.png"
        
        # 儲存圖片
        pix.save(output_filename)
        print(f"🖼️ 已成功將第 {i + 1} 頁儲存為：{output_filename}")

    # 4. 關閉文件釋放記憶體
    doc.close()

# 執行轉換圖片的函數
pdf_to_images()

import fitz  # PyMuPDF
import os

def create_sample_pdf(filename: str = "sample.pdf") -> None:
    """
    建立一份包含兩頁的簡單 PDF 檔案。
    
    :param filename: 輸出的 PDF 檔案名稱或路徑
    """
    # 宣告 doc 為 fitz.Document 型別
    doc: fitz.Document = fitz.open()

    # 宣告 page1 為 fitz.Page 型別
    page1: fitz.Page = doc.new_page()
    page1.insert_text(
        fitz.Point(50, 100),  
        "這是第一頁 (Page 1)", 
        fontsize=24,
        fontname="helv"
    )

    # 宣告 page2 為 fitz.Page 型別
    page2: fitz.Page = doc.new_page()
    page2.insert_text(
        fitz.Point(50, 100), 
        "這是第二頁 (Page 2) - 準備轉成圖片！", 
        fontsize=24,
        fontname="helv"
    )

    doc.save(filename)
    doc.close()
    
    print(f"✅ 成功建立 PDF 檔案：{filename}")


def pdf_to_images(pdf_path: str = "sample.pdf", output_dir: str = r"D:\Temp") -> None:
    """
    將 PDF 的每一頁轉換為高解析度圖片。
    
    :param pdf_path: 來源 PDF 檔案的路徑
    :param output_dir: 圖片輸出的目標資料夾路徑
    """
    # 確保輸出資料夾存在，若無則建立
    if not os.path.exists(output_dir):
        os.makedirs(output_dir)

    # 宣告 doc 為 fitz.Document 型別
    doc: fitz.Document = fitz.open(pdf_path)
    
    # 宣告放大倍率為浮點數 (float)
    zoom_x: float = 2.0  
    zoom_y: float = 2.0  
    
    # 宣告 mat 為 fitz.Matrix 型別
    mat: fitz.Matrix = fitz.Matrix(zoom_x, zoom_y)

    # i 為整數 (int)
    for i in range(len(doc)):
        
        # 宣告 page 為 fitz.Page 型別
        page: fitz.Page = doc[i] 
        
        # 宣告 pix 為 fitz.Pixmap 型別 (渲染出的圖片物件)
        pix: fitz.Pixmap = page.get_pixmap(matrix=mat)
        
        # 宣告 output_filename 為字串 (str)
        # 這裡完美結合了 f-string (變數替換) 與 r-string (處理 Windows 路徑反斜線)
        output_filename: str = fr"{output_dir}\output_page_{i + 1}.png"
        
        pix.save(output_filename)
        print(fr"🖼️ 已成功將第 {i + 1} 頁儲存為：{output_filename}")

    doc.close()


if __name__ == "__main__":
    # 宣告測試用的檔案名稱為字串
    test_pdf_file: str = "sample.pdf"
    
    # 執行生成 PDF
    create_sample_pdf(filename=test_pdf_file)
    
    # 執行 PDF 轉圖片，並指定輸出到 D:\Temp
    pdf_to_images(pdf_path=test_pdf_file, output_dir=r"D:\Temp")