مقدمه

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، .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",
))

مدیریت خطا

تمام اعتبارسنجی گزینه‌های رمزگذاری در زمان تجزیه انجام می‌شود. اگر داده نامعتبر یا گزینه‌های ناسازگار ارائه شود، کتابخانه قبل از شروع هر گونه رمزگذاری، یک استثنای 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 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 موجود است؛ از منبع ساخته شود. بدون وابستگی‌های بومی، بدون ردیابی، بدون محدودیت استفاده.


شروع کار

منابع مرتبط