Quickstart

Quickstart Aspose.BarCode FOSS لـ Python

يقدم هذا الدليل تحديدًا حول إنشاء رموز القضبان باستخدام ثلاثة من أكثر الرموز شيوعًة: رمز 128 ، ورمز QR ، وإيه إيه أن 13 . كل مثال يدل على واجهة برمجة التطبيقات (API) عالية المستوى وخيارات ترميز لكل رمزية ومراقبة التصوير.

إنشاء رمز 128 باركود

رمز 128 هو رموز متغيرة الطول 1D المستخدمة في الخدمات اللوجستية والشحن. code128() يوافق المُساعد على سلاسل بيانات وخيارية Code128Options:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import Code128Options, Code128EncodeMode

bc = barcode.code128(
    "1234567890",
    encode=Code128Options(encode_mode=Code128EncodeMode.CODE_C),
)
svg = bc.to_svg()

with open("code128.svg", "w") as f:
    f.write(svg)

Code128EncodeMode.CODE_C يتم تحسينها للبيانات التي تحتوي على رقائق فقط إنها ترميز أزواج الرقمات كنقاط رمز واحدة ، مما ينتج بروكود أقصر.

إنشاء رمز QR

رمز QR هو رموز ثنائية الأبعاد تدعم تصحيح الأخطاء وطرق ترميز متعددة. QrOptions يسيطر على مستوى تصحيح الأخطاء، وضع التشفير، الإصدار، ونمط القناع:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel, QrEncodeMode

bc = barcode.qr(
    "https://example.com/product/12345",
    encode=QrOptions(
        error_correction_level=QrErrorCorrectionLevel.Q,
        encoding_mode=QrEncodeMode.BYTE,
    ),
)

with open("qr.png", "wb") as f:
    f.write(bc.to_png())

مستويات تصحيح الأخطاء: L (7% استرداد) ،, M (15%) ،, Q (25%) ،, H (30%).

إنشاء رمز شريط EAN-13

EAN-13 هو رمز 1D ثابت يستخدم في تجارة التجزئة. إمداد 12 رقم حمولة مفيدة المكتبة تحسب الرقم 13 تلقائيا:

import aspose_barcode_foss as barcode

bc = barcode.ean13("590123412345")
svg = bc.to_svg()

with open("ean13.svg", "w") as f:
    f.write(svg)

لتزويد رقم الفحص الخاص بك المحدد مسبقاً (مجموع 13 رقما) ، يضع allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

bc = barcode.ean13(
    "5901234123457",
    encode=Ean13Options(allow_check_digit_input=True),
)

تخصيص التصوير

RenderOptions ينطبق على جميع الرموز ويتحكم في الناتج البصري. to_svg() أو to_png():

import aspose_barcode_foss as barcode
from aspose_barcode_foss import RenderOptions

bc = barcode.upca("01234567890")
png = bc.to_png(options=RenderOptions(
    scale=3.0,
    dpi=300,
    foreground_color="#1a1a1a",
    background_color="#ffffff",
    show_text=True,
    font_family="Courier New",
))

with open("upca.png", "wb") as f:
    f.write(png)

خصائص متوفرة: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

استخدم API Generic لتوليد ((()

المجلس الوزاري generate() تستقبل الدالة سلسلة اسم رمزية بدلاً من استدعاء مساعدة مخصصة:

import aspose_barcode_foss as barcode

bc = barcode.generate("code128", "ABC123")
svg = bc.to_svg()

أسماء رمزية صالحة: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

خطأ التعامل مع

يتم التحقق من صحة جميع المعلومات قبل التعديل. إذا تم تقديم بيانات غير صحيحة أو خيارات لا تتوافق مع النظام، فإن المكتبة ستقوم بإثارة استثناء مكتوب:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import InvalidInputError

try:
    bc = barcode.ean13("ABC")  # EAN-13 requires digits
except InvalidInputError as e:
    print(f"Invalid input: {e}")

تسلسل التسلسل الهرمي للإستثناءات:

جميع فئات الاستثناء ترث من: BarcodeError.

الرموز المدعومة

تنسيقات الإخراج: SVG و PNG.

الخطوات التالية

• دليل المطورين: خيارات ترميز رمزية، وتحكمات التصوير، والهندسة المعمارية
• Features: نظرة عامة كاملة للميزات مع أمثلة للشفرة
• المواد KB: أدلة التوجيهات و الأسئلة الشائعة

See Also

• Aspose.BarCode for Python — Enterprise Documentation