المقدمة
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،.KANJIversion: نسخة 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():
| الخاصية | النوع | وصف |
|---|---|---|
scale | float | مضاعف مقياس موحد |
dpi | int | دقة إخراج PNG |
module_width | float | عرض وحدة الباركود |
module_height | float | ارتفاع وحدة الباركود |
quiet_zone | float | حشو مساحة بيضاء حول الباركود |
foreground_color | str | لون سداسي عشري للأشرطة (مثال، "#000000") |
background_color | str | لون سداسي عشري للخلفية |
transparent_background | bool | خلفية شفافة لملف PNG |
show_text | bool | إظهار النص القابل للقراءة للإنسان أسفل الباركود |
font_family | str | الخط للنص القابل للقراءة للإنسان |
font_size | float | حجم الخط للنص القابل للقراءة للإنسان |
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 128 | 1D | Code128Options | encode_mode |
| Code 39 | 1D | Code39Options | full_ascii, add_check_digit |
| EAN-13 | 1D | Ean13Options | allow_check_digit_input |
| EAN-8 | 1D | Ean8Options | allow_check_digit_input |
| QR Code | 2D | QrOptions | error_correction_level, encoding_mode, version, mask |
| UPC-A | 1D | UpcaOptions | allow_check_digit_input |
| UPC-E | 1D | UpceOptions | allow_check_digit_input |
صيغ الإخراج:
| تنسيق | ملحق | Export |
|---|---|---|
| SVG | .svg | ✓ |
| PNG | .png | ✓ |
المصدر المفتوح والترخيص
Aspose.BarCode FOSS لـ Python مرخص بموجب MIT. المصدر متاح على GitHub؛ ابنِ من المصدر. لا تبعيات أصلية، لا تتبع، ولا حدود للاستخدام.