درج بارکدها به‌صورت مستقیم در فایل‌های PDF یک نیاز رایج برای ردیابی موجودی، صدور بلیت و گردش کارهای امن اسناد است. Aspose.PDF for Python via .NET یک SDK قدرتمند ارائه می‌دهد که افزودن بارکد به PDF در پایتون را ساده می‌کند. در این آموزش، خواهید آموخت که چگونه تصاویر بارکد تولید کنید، آن‌ها را بر روی PDFهای موجود قرار دهید و ظاهر آن‌ها را سفارشی کنید. در پایان، قادر خواهید بود به‌صورت برنامه‌نویسی بارکدها را به یک یا چند سند PDF با اطمینان اضافه کنید.

چگونه بارکد را به PDF در پایتون اضافه کنیم - گام به گام

  1. Install the required packages: پکیج‌های مورد نیاز را نصب کنید: از pip برای نصب Aspose.PDF و Aspose.BarCode استفاده کنید.

    pip install aspose-pdf
pip install aspose-barcode-for-python-via-net

  2. Generate the barcode image: تصویر بارکد را تولید کنید: با استفاده از Aspose.BarCode یک بارکد ایجاد کنید. تصویر تولید شده می‌تواند در یک جریان حافظه ذخیره شود.

    from aspose.barcode import generation

Generate the barcode image

generator = generation.BarcodeGenerator(generation.EncodeTypes.CODE39_STANDARD, “1234567”) generator.save(barcode_image, generation.BarCodeImageFormat.PNG)

<!--[CODE_SNIPPET_END]-->

3. **Create the target PDF document**: سند PDF هدف را ایجاد کنید: PDF موجود را با Aspose.PDF باز کنید.  
<!--[CODE_SNIPPET_START]-->
```python
import aspose.pdf as ap

# Create a new PDF document and add a page
document = ap.Document("input.pdf")
page = document.pages.add()
page.set_page_size(595, 842)

  1. Insert the barcode image onto the desired page: تصویر بارکد را بر روی صفحه مورد نظر قرار دهید: از ImageStamp برای قرار دادن بارکد استفاده کنید. موقعیت و اندازه را بر حسب نیاز تنظیم کنید.

    # Add the barcode image at the specified coordinates
page.add_image(barcode_image, ap.Rectangle(100, 650, 300, 750, True))

  2. Save the updated PDF (or loop for bulk processing): PDF به‌روزرسانی‌شده را ذخیره کنید (یا برای پردازش دسته‌ای حلقه بزنید): تغییرات را ذخیره کنید یا بر روی چندین PDF برای افزودن دسته‌ای بارکد به PDF در Python تکرار کنید.

    document.save(output_pdf)

درج بارکد در PDF با Python - مثال کامل کد

مثال زیر یک جریان کاری کامل را نشان می‌دهد که یک بارکد تولید می‌کند، آن را در یک PDF موجود جاسازی می‌کند و نتیجه را ذخیره می‌نماید.

import aspose.pdf as ap
from aspose.barcode import generation

def add_barcode_to_new_pdf(output_pdf, barcode_image):
    # Generate the barcode image
    generator = generation.BarcodeGenerator(generation.EncodeTypes.CODE39_STANDARD, "1234567")
    generator.save(barcode_image, generation.BarCodeImageFormat.PNG)

# Create a new PDF document and add a page
    document = ap.Document()
    page = document.pages.add()
    page.set_page_size(595, 842)

# Add the barcode image at the specified coordinates
    page.add_image(barcode_image, ap.Rectangle(100, 650, 300, 750, True))

# Save the resulting PDF document
    document.save(output_pdf)

if __name__ == "__main__":
    add_barcode_to_new_pdf("AddBarcodeToNewPDF.pdf", "barcode.png")

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید مسیرهای فایل را به مکان‌های واقعی خود به‌روزرسانی کنید، اطمینان حاصل کنید تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند، و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه نمایید.

Aspose.PDF for Python via .NET - پیش‌نیازها و راه‌اندازی

برای شروع استفاده از SDK، اطمینان حاصل کنید که Python 3.6+ و زمان اجرا .NET نصب شده‌اند. سپس بسته‌ها را از طریق pip نصب کنید:

pip install aspose-pdf aspose-barcode

شما همچنین می‌توانید آخرین باینری‌ها را از صفحه دانلود دریافت کنید. برای ارزیابی نیازی به کد لایسنس اضافی نیست، اما برای استفاده در محیط تولید یک لایسنس معتبر لازم است (به صفحه لایسنس موقت و صفحه قیمت‌گذاری مراجعه کنید).

خواندن بارکد از سند PDF با استفاده از Python

ما می‌توانیم هر تصویر بارکد که در هر یک از صفحات سند PDF جاسازی شده است را با استفاده از مجموعه resources.images یک page شناسایی کنیم. این امکان استخراج تصاویر از PDF را فراهم می‌کند و سپس اطلاعات بارکد را از تصویر استخراج‌شده می‌خوانیم. می‌توانیم بارکدها را از اسناد PDF با دنبال کردن مراحل زیر بخوانیم:

  1. ابتدا، سند PDF ورودی را با استفاده از کلاس Document بارگذاری کنید.
  2. سپس، صفحه هدف را انتخاب کنید و مجموعه resources.images آن را دریافت کنید.
  3. سپس، هر تصویر جاسازی‌شده را در یک حلقه به یک فایل ذخیره کنید.
  4. سپس، یک نمونه از کلاس BarCodeReader را با مسیر تصویر و DecodeType به عنوان آرگومان‌ها ایجاد کنید.
  5. پس از آن، متد read_bar_codes() را فراخوانی کنید تا نتایج شناسایی به دست آید.
  6. در نهایت، بر روی نتایج حلقه بزنید و اطلاعات بارکد را نمایش دهید.

مثال کد زیر نشان می‌دهد چگونه یک تصویر بارکد را از یک سند PDF با استفاده از Python بخوانید.

import aspose.pdf as ap
from aspose.barcode import recognition
from io import FileIO

def read_barcode_from_pdf(input_pdf, extracted_image):
    # Load the input PDF document
    document = ap.Document(input_pdf)
    page = document.pages[1]

# Extract the first image from the page resources
    x_image = page.resources.images[1]
    with FileIO(extracted_image, "wb") as image_stream:
        x_image.save(image_stream)

# Read the barcode from the extracted image
    reader = recognition.BarCodeReader(extracted_image, recognition.DecodeType.CODE39_STANDARD)
    for result in reader.read_bar_codes():
        print(f"Codetext found: {result.code_text}")
        print(f"Symbology: {result.code_type_name}")

if __name__ == "__main__":
    read_barcode_from_pdf("AddBarcodeToExistingPDF.pdf", "extracted_barcode.png")

Codetext found: 1234567
Symbology: Code39Standard

نتیجه‌گیری

افزودن بارکد به PDF در پایتون به‌سادگی انجام می‌شود با Aspose.PDF for Python via .NET. ویژگی‌های قدرتمند SDK برای دستکاری PDF همراه با تولید بارکد Aspose.BarCode به شما امکان می‌دهد یک جریان کار کامل برای افزودن بارکد به PDF را تنها در چند خط کد پیاده‌سازی کنید. چه در حال به‌روزرسانی یک سند منفرد باشید و چه انجام افزودن دسته‌جمعی بارکد به PDF در پایتون برای حجم‌های بزرگ، این کتابخانه عملکرد و انعطاف‌پذیری مورد نیاز شما را ارائه می‌دهد. به یاد داشته باشید برای استفاده در محیط تولید یک لایسنس مناسب دریافت کنید؛ می‌توانید گزینه‌های قیمت‌گذاری مقرون‌به‌صرفه را در صفحه قیمت‌گذاری بررسی کنید یا یک لایسنس ارزیابی موقت را از صفحه لایسنس موقت دریافت کنید.

سوالات متداول

  • چگونه یک بارکد را به یک PDF موجود در Python اضافه کنم؟
    از Aspose.PDF برای بارگذاری PDF استفاده کنید، بارکد را با Aspose.BarCode تولید کنید، و آن را با استفاده از add_image() جاسازی کنید. فرآیند کامل در مثال کد بالا نشان داده شده است.

  • رویکرد پیشنهادی برای افزودن انبوه بارکد به PDF در پایتون چیست؟
    در مجموعه PDF خود حلقه بزنید، یک BarcodeGenerator واحد را مجدداً استفاده کنید و با استریم‌ها کار کنید. نکات عملکردی بخش “Performance Considerations” را اعمال کنید تا مصرف حافظه کم بماند.

  • آیا راهی برای سفارشی‌سازی اندازه و موقعیت بارکد به‌صورت برنامه‌نویسی وجود دارد؟
    مطمئناً. ویژگی‌های width، height، x، y و rotation را در barcode تنظیم کنید.

Read More