Tạo PDF từ hình ảnh trong Python

Chuyển đổi một tập hợp các hình ảnh rải rác thành một tệp PDF duy nhất, có thể tìm kiếm là một yêu cầu thường gặp cho các công cụ báo cáo, trình tạo hoá đơn và hệ thống lưu trữ. Aspose.PDF for Python via .NET là một SDK mạnh mẽ giúp quá trình chuyển đổi này nhanh chóng và đáng tin cậy trong các ứng dụng Python. Hướng dẫn này sẽ đưa bạn qua các bước cài đặt SDK, tải hình ảnh bằng Python Imaging Library, xây dựng PDF trang từng trang, điều chỉnh các thiết lập nén, và cuối cùng lưu kết quả, tất cả đều kèm theo các ví dụ mã rõ ràng.

Trước khi bắt đầu: Các yêu cầu và cài đặt

Để làm theo hướng dẫn này, bạn cần:

Python 3.8 hoặc mới hơn được cài đặt trên máy phát triển của bạn.
Một IDE hoặc trình chỉnh sửa theo lựa chọn của bạn (VS Code, PyCharm, v.v.).
Truy cập internet để tải xuống gói SDK.

Cài đặt Aspose.PDF SDK và thư viện Pillow (thư viện Python Imaging Library chuẩn) bằng pip:

pip install aspose-pdf pillow

Bạn cũng có thể tải SDK theo cách thủ công từ trang phát hành chính thức: Aspose.PDF for Python via .NET Tải xuống. Sau khi cài đặt, hãy nhập các không gian tên cần thiết vào script của bạn.

Bây giờ môi trường đã sẵn sàng, chúng ta hãy đi sâu vào phần thực hiện.

Tạo PDF từ Hình ảnh trong Python: Hướng dẫn chi tiết từng bước

Bước 1: Tải các hình ảnh nguồn

Đầu tiên, sử dụng Pillow để mở mỗi tệp hình ảnh và giữ chúng trong một danh sách. Điều này chuẩn bị dữ liệu hình ảnh cho trình tạo PDF.

from PIL import Image
import os

image_folder = "input_images"
image_paths = [os.path.join(image_folder, f) for f in os.listdir(image_folder)
               if f.lower().endswith(('.png', '.jpg', '.jpeg', '.bmp', '.gif'))]

images = [Image.open(p) for p in image_paths]

Bước 2: Tạo tài liệu PDF mới

Khởi tạo đối tượng Document của Aspose.PDF sẽ chứa các trang.

import aspose.pdf as ap

pdf_doc = ap.Document()

Để biết thêm chi tiết về lớp Document, xem tài liệu tham chiếu API.

Bước 3: Thêm mỗi hình ảnh làm một trang riêng

Duyệt qua các hình ảnh đã tải, tạo một trang và nhúng hình ảnh. SDK tự động điều chỉnh kích thước hình ảnh để phù hợp với kích thước trang.

for img in images:
    page = pdf_doc.pages.add()
    # Convert Pillow image to a byte stream compatible with Aspose.PDF
    with io.BytesIO() as img_stream:
        img.save(img_stream, format='PNG')
        img_stream.seek(0)
        page.resources.images.add(ap.Image(img_stream))
        # Fit the image to the page dimensions
        page.page_info.width = img.width
        page.page_info.height = img.height

Bước 4: Cấu hình các tùy chọn nén

Điều chỉnh mức nén hình ảnh để giảm kích thước PDF cuối cùng mà không làm giảm chất lượng.

# Set JPEG compression for all images (if using JPEG format)
for img_res in pdf_doc.resources.images:
    img_res.compression = ap.ImageCompression.JPEG
    img_res.jpeg_quality = 80  # Quality range: 0‑100

Bước 5: Lưu tệp PDF

Cuối cùng, ghi tài liệu đã lắp ráp vào đĩa.

output_path = "output/result.pdf"
pdf_doc.save(output_path)
print(f"PDF generated successfully at {output_path}")

Với các bước này, bạn đã có một quy trình làm việc hoàn chỉnh để tạo PDF từ hình ảnh trong Python.

Tạo PDF từ Bộ sưu tập Hình ảnh trong Python - Ví dụ mã đầy đủ

Script sau đây ghép tất cả các phần lại thành một chương trình duy nhất, có thể chạy được.

import os
import io
from PIL import Image
import aspose.pdf as ap

# -------------------- Configuration --------------------
image_folder = "input_images"          # Folder containing source images
output_pdf = "output/result.pdf"       # Destination PDF file
jpeg_quality = 80                      # Compression quality (0‑100)

# -------------------- Load Images --------------------
image_paths = [os.path.join(image_folder, f) for f in os.listdir(image_folder)
               if f.lower().endswith(('.png', '.jpg', '.jpeg', '.bmp', '.gif'))]

images = [Image.open(p) for p in image_paths]

# -------------------- Create PDF Document --------------------
pdf_doc = ap.Document()

for img in images:
    page = pdf_doc.pages.add()
    with io.BytesIO() as img_stream:
        img.save(img_stream, format='PNG')
        img_stream.seek(0)
        pdf_image = page.resources.images.add(ap.Image(img_stream))
        page.page_info.width = img.width
        page.page_info.height = img.height
        # Apply compression if the original is JPEG
        if img.format == 'JPEG':
            pdf_image.compression = ap.ImageCompression.JPEG
            pdf_image.jpeg_quality = jpeg_quality

# -------------------- Save PDF --------------------
pdf_doc.save(output_pdf)
print(f"PDF generated successfully at {output_pdf}")

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy đảm bảo cập nhật các đường dẫn tệp (input_images, output/result.pdf), xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển của bạn. Nếu gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Cài đặt nâng cao cho việc tạo PDF: Tùy chọn và cấu hình

Ngoài quy trình làm việc cơ bản, Aspose.PDF cung cấp một số thuộc tính để tinh chỉnh đầu ra.

Mức nén hình ảnh

Kiểm soát sự đánh đổi giữa chất lượng và kích thước tệp.

pdf_image.compression = ap.ImageCompression.JPEG
pdf_image.jpeg_quality = 70   # Lower value = smaller file, lower quality

Kích thước trang và lề

Đặt kích thước trang tùy chỉnh nếu bạn cần bố cục đồng nhất.

page.page_info.width = 595   # A4 width in points
page.page_info.height = 842  # A4 height in points
page.page_info.margin = ap.MarginInfo(10, 10, 10, 10)

Độ phân giải (DPI)

DPI cao hơn tạo ra hình ảnh sắc nét hơn nhưng sẽ làm tăng kích thước PDF.

pdf_doc.page_info.dpi = 300

Để xem danh sách đầy đủ các thuộc tính có thể cấu hình, hãy tham khảo tài liệu tham khảo API.

Kết luận

Bạn bây giờ đã có một giải pháp lập trình hoàn chỉnh để tạo PDF từ hình ảnh trong Python bằng cách sử dụng Aspose.PDF for Python via .NET. SDK xử lý việc tải hình ảnh, tạo trang, nén và lưu chỉ với vài dòng mã, cho phép bạn tập trung vào logic nghiệp vụ thay vì xử lý PDF mức thấp. Khi đưa vào sản xuất, hãy nhớ mua giấy phép phù hợp; chi tiết có sẵn trên trang định giá và bạn có thể bắt đầu với một giấy phép tạm thời để đánh giá. Chúc bạn lập trình vui vẻ và tận hưởng sự đơn giản khi biến bộ sưu tập hình ảnh thành các PDF hoàn chỉnh!

FAQs

Làm thế nào để tôi tạo PDF từ hình ảnh trong Python bằng Aspose.PDF?
Sử dụng SDK Aspose.PDF để tạo một Document, thêm một trang cho mỗi hình ảnh được tải bằng Pillow, tùy chọn đặt mức nén, và gọi save() để ghi PDF. Ví dụ đầy đủ được bao gồm ở trên.
Các định dạng hình ảnh nào được hỗ trợ cho việc tạo PDF?
SDK chấp nhận PNG, JPG, JPEG, BMP, GIF, và TIFF trực tiếp. Pillow cũng có thể chuyển đổi các định dạng không được hỗ trợ sang một trong các định dạng này trước khi thêm chúng vào PDF.
Tôi có cần giấy phép cho việc sử dụng thương mại không?
Có. Lấy giấy phép đánh giá tạm thời từ trang giấy phép tạm thời và mua giấy phép đầy đủ thông qua trang giá cho các triển khai sản xuất.
Tôi có thể điều chỉnh kích thước trang PDF và độ phân giải không?
Chắc chắn. Sử dụng page.page_info.width, page.page_info.height và pdf_doc.page_info.dpi để kiểm soát kích thước và DPI, như đã trình bày trong phần Cấu hình / Tùy chọn.

Trước khi bắt đầu: Các yêu cầu và cài đặt#

Tạo PDF từ Hình ảnh trong Python: Hướng dẫn chi tiết từng bước#

Bước 1: Tải các hình ảnh nguồn#

Bước 2: Tạo tài liệu PDF mới#

Bước 3: Thêm mỗi hình ảnh làm một trang riêng#

Bước 4: Cấu hình các tùy chọn nén#

Bước 5: Lưu tệp PDF#

Tạo PDF từ Bộ sưu tập Hình ảnh trong Python - Ví dụ mã đầy đủ#

Cài đặt nâng cao cho việc tạo PDF: Tùy chọn và cấu hình#

Mức nén hình ảnh#

Kích thước trang và lề#

Độ phân giải (DPI)#

Kết luận#

FAQs#

Đọc thêm#