المقدمة

Aspose.BarCode FOSS لـ Python يوفر فئات خيارات لكل رموز الباركود تتحكم في سلوك الترميز عبر جميع الصيغ السبعة المدعومة للباركود. كل فئة خيار ترث من EncodeOptions وتضيف خصائص مخصصة لرمزها — أوضاع ترميز Code 128، اختيار ASCII Code 39، مستويات تصحيح الأخطاء QR، ومعالجة رقم التحقق EAN/UPC.

تغطي هذه المشاركة كل فئة خيار، خصائصها، وأمثلة على الشيفرة العملية. الفئات متاحة من حزمة aspose_barcode_foss الأعلى مستوى.


الميزات الرئيسية

أوضاع ترميز Code 128

Code128Options يتحكم في مجموعات الأحرف Code 128 التي يستخدمها المشفر. خاصية encode_mode تقبل قيمة تعداد Code128EncodeMode: AUTO، CODE_A، CODE_B، CODE_C، CODE_AB، CODE_AC أو CODE_BC. AUTO يختار أكثر الترميزات كثافة تلقائيًا. CODE_C مُحسّن للبيانات التي تحتوي على أرقام فقط (أزواج من الأرقام تُشفّر كنقطة شفرة واحدة).

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()

Code 128 يدعم أيضًا خصائص gs1_enabled وeci_assignment_number الموروثة من EncodeOptions لـ GS1 وبيانات التعريف ECI.

Code 39 ترميز

Code39Options يحدد ما إذا كان المشفر يستخدم مجموعة الأحرف الأساسية المكوّنة من 43 حرفًا أو امتداد Full ASCII. اضبط full_ascii=True لتمكين وضع Full ASCII، الذي يشفّر النطاق الكامل لـ ASCII المكوّن من 128 حرفًا باستخدام أزواج الإزاحة. الخاصية الاختيارية add_check_digit تُضيف رقم تحقق modulo-43.

import aspose_barcode_foss as barcode
from aspose_barcode_foss import Code39Options

bc = barcode.code39(
    "Hello",
    encode=Code39Options(full_ascii=True, add_check_digit=True),
)
svg = bc.to_svg()

QR Code تكوين

QrOptions يقدم أغنى مجموعة تكوين بين الرموز المدعومة:

  • error_correction_level: QrErrorCorrectionLevel.L (7٪)، .M (15٪)، .Q (25٪)، .H (30٪)
  • encoding_mode: QrEncodeMode.AUTO، .NUMERIC، .ALPHANUMERIC، .BYTE، .KANJI
  • version: نسخة QR (1–40)، تتحكم في حجم الرمز
  • mask: نمط القناع (0–7) للاختيار اليدوي
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,
    ),
)
png_bytes = bc.to_png()

أرقام التحقق EAN و UPC

Ean13Options، Ean8Options، UpcaOptions، وUpceOptions كل منها يمتلك خاصية allow_check_digit_input. بشكل افتراضي، تقوم المكتبة بحساب رقم التحقق تلقائيًا من البيانات. اضبط allow_check_digit_input=True إذا كانت بياناتك تتضمن رقم التحقق بالفعل.

import aspose_barcode_foss as barcode
from aspose_barcode_foss import Ean13Options

# Automatic check digit (12 digits in, library appends the 13th)
bc = barcode.ean13("590123412345")
svg = bc.to_svg()

# Pre-computed check digit (13 digits, library validates)
bc2 = barcode.ean13(
    "5901234123457",
    encode=Ean13Options(allow_check_digit_input=True),
)

خيارات العرض

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

الخاصيةالنوعوصف
scalefloatمضاعف مقياس موحد
dpiintدقة إخراج PNG
module_widthfloatعرض وحدة الباركود
module_heightfloatارتفاع وحدة الباركود
quiet_zonefloatحشو مساحة بيضاء حول الباركود
foreground_colorstrلون سداسي عشري للأشرطة (مثال، "#000000")
background_colorstrلون سداسي عشري للخلفية
transparent_backgroundboolخلفية شفافة لملف PNG
show_textboolإظهار النص القابل للقراءة للإنسان أسفل الباركود
font_familystrالخط للنص القابل للقراءة للإنسان
font_sizefloatحجم الخط للنص القابل للقراءة للإنسان
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",
))

معالجة الأخطاء

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

  • InvalidInputError — البيانات تحتوي على أحرف غير مدعومة من قبل الرمز
  • EncodingError — فشل الترميز (مثال: البيانات تتجاوز السعة)
  • SymbologyNotFoundError — اسم ترميز غير معروف تم تمريره إلى generate()
  • UnsupportedCapabilityError — الميزة المطلوبة غير متوفرة لهذا الترميز

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


البدء السريع

git clone https://github.com/aspose-barcode-foss/Aspose.BarCode-FOSS-for-Python.git
cd Aspose.BarCode-FOSS-for-Python
pip install -e .

إنشاء الباركود باستخدام خيارات ترميز مختلفة وحفظها:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import (
    Code128Options, Code128EncodeMode,
    QrOptions, QrErrorCorrectionLevel,
    RenderOptions,
)

# Code 128 in CODE_C mode (compact digit encoding)
c128 = barcode.code128(
    "9876543210",
    encode=Code128Options(encode_mode=Code128EncodeMode.CODE_C),
)
with open("code128.svg", "w") as f:
    f.write(c128.to_svg())

# QR with high error correction
qr = barcode.qr(
    "https://example.com",
    encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)
with open("qr.png", "wb") as f:
    f.write(qr.to_png(options=RenderOptions(scale=4.0)))

# EAN-13 with custom colors
ean = barcode.ean13("590123412345")
with open("ean13.svg", "w") as f:
    f.write(ean.to_svg(options=RenderOptions(
        foreground_color="#003366",
        show_text=True,
    )))

الصيغ المدعومة

Symbologyالنوعفئة الخياراتالخصائص الرئيسية
Code 1281DCode128Optionsencode_mode
Code 391DCode39Optionsfull_ascii, add_check_digit
EAN-131DEan13Optionsallow_check_digit_input
EAN-81DEan8Optionsallow_check_digit_input
QR Code2DQrOptionserror_correction_level, encoding_mode, version, mask
UPC-A1DUpcaOptionsallow_check_digit_input
UPC-E1DUpceOptionsallow_check_digit_input

صيغ الإخراج:

تنسيقملحقExport
SVG.svg✓
PNG.png✓

المصدر المفتوح والترخيص

Aspose.BarCode FOSS لـ Python مرخص بموجب MIT. المصدر متاح على GitHub؛ ابنِ من المصدر. لا تبعيات أصلية، لا تتبع، ولا حدود للاستخدام.


البدء

الموارد ذات الصلة