إدراج الباركود مباشرةً في ملفات PDF هو مطلب شائع لتتبع المخزون، وإصدار التذاكر، وتدفقات العمل الآمنة للوثائق. يوفر Aspose.PDF for Python via .NET مجموعة تطوير برمجيات قوية تُبسّط إضافة الباركود إلى PDF باستخدام بايثون. في هذا البرنامج التعليمي ستتعلم كيفية إنشاء صور الباركود، ووضعها على ملفات PDF الموجودة، وتخصيص مظهرها. في النهاية، ستكون قادرًا على إضافة الباركود برمجيًا إلى مستند PDF واحد أو متعدد بثقة.

كيفية إضافة الباركود إلى PDF في بايثون - خطوة بخطوة

  1. تثبيت الحزم المطلوبة: استخدم pip لتثبيت Aspose.PDF و Aspose.BarCode.

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

  2. إنشاء صورة الباركود: أنشئ باركود باستخدام 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. **إنشاء مستند 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. إدراج صورة الباركود على الصفحة المطلوبة: استخدم ImageStamp لوضع الباركود. اضبط الموقع والحجم حسب الحاجة.

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

  2. حفظ ملف 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 runtime مثبتين. ثم قم بتثبيت الحزم عبر 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. تتيح لك ميزات معالجة PDF القوية في SDK، إلى جانب توليد الرموز الشريطية في Aspose.BarCode، تنفيذ سير عمل كامل لإضافة رمز شريطي إلى PDF ببضع أسطر من الشيفرة فقط. سواءً كنت تقوم بتحديث مستند واحد أو تنفيذ إضافة رموز شريطية جماعية إلى PDF في بايثون لمجموعات كبيرة، توفر المكتبة الأداء والمرونة التي تحتاجها. تذكر أن تحصل على ترخيص مناسب للاستخدام في الإنتاج؛ يمكنك استكشاف خيارات التسعير المعقولة على صفحة التسعير أو الحصول على ترخيص تقييم مؤقت من صفحة الترخيص المؤقت.

الأسئلة الشائعة

  • كيف يمكنني إضافة رمز شريطي إلى ملف PDF موجود في Python؟
    استخدم Aspose.PDF لتحميل ملف PDF، وقم بإنشاء الرمز الشريطي باستخدام Aspose.BarCode، ودمجه باستخدام add_image(). العملية الكاملة موضحة في مثال الشيفرة أعلاه.

  • ما هو النهج الموصى به لإضافة Barcode إلى PDF بشكل جماعي في Python؟
    قم بالتنقل عبر مجموعة ملفات PDF الخاصة بك، وأعد استخدام كائن BarcodeGenerator واحد، واعمل مع التدفقات. طبّق نصائح الأداء من قسم “اعتبارات الأداء” للحفاظ على انخفاض استهلاك الذاكرة.

  • هل هناك طريقة لتخصيص حجم الباركود وموقعه برمجيًا؟
    بالتأكيد. قم بضبط خصائص width و height و x و y و rotation للـ barcode.

اقرأ المزيد