مقدمه
Aspose.BarCode FOSS برای Python کلاسهای گزینهای مخصوص هر سمبولی را فراهم میکند که رفتار رمزگذاری را در تمام هفت فرمت بارکد پشتیبانیشده کنترل میکنند. هر کلاس گزینهای از EncodeOptions ارث میبرد و ویژگیهای خاص سمبولی خود را اضافه میکند — حالتهای رمزگذاری Code 128، انتخاب ASCII Code 39، سطوح تصحیح خطا QR، و مدیریت رقم کنترل EAN/UPC.
این پست هر کلاس گزینهای، ویژگیهای آن و مثالهای کد عملی را پوشش میدهد. کلاسها از بسته سطح بالایی aspose_barcode_foss در دسترس هستند.
ویژگیهای کلیدی
حالتهای رمزگذاری Code 128
Code128Options تعیین میکند که کدگذار از کدام مجموعه کاراکترهای Code 128 استفاده کند. ویژگی encode_mode یک مقدار enum از نوع 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 فعال شود، که بازه کامل 128 کاراکتر ASCII را با جفتهای شیفت رمزگذاری میکند. ویژگی اختیاری 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",
))
مدیریت خطا
تمام اعتبارسنجی گزینههای رمزگذاری در زمان تجزیه انجام میشود. اگر داده نامعتبر یا گزینههای ناسازگار ارائه شود، کتابخانه قبل از شروع هر گونه رمزگذاری، یک استثنای typed exception پرتاب میکند:
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 | نوع | کلاس Options | ویژگیهای کلیدی |
|---|---|---|---|
| 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 موجود است؛ از منبع ساخته شود. بدون وابستگیهای بومی، بدون ردیابی، بدون محدودیت استفاده.