Quickstart

دانلود نرم افزار Aspose.BarCode FOSS برای Python

این راهنمای از طریق تولید بارکد با استفاده از سه نماد رایج: کد 128، کد QR و EAN-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 یک نماد 2D است که از اصلاح خطا و حالت های چندگانه رمزگذاری پشتیبانی می کند. 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 ۱۵ درصد ), Q ۲۵ درصد،, 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),
)

رندرینگ Customize

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

و این 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.

قدم های بعدی

• راهنمای توسعه دهنده: گزینه های رمزگذاری Per-symbology، کنترل رندرینگ و معماری
• Features: بررسی کامل با نمونه های کد
• KB مقالات: چگونه راهنمای و FAQ

See Also

• Aspose.BarCode for Python — Enterprise Documentation