Quickstart

Quickstart — Aspose.BarCode FOSS için Python

Bu rehber, üç en yaygın sembolü kullanarak çubuk kodları oluşturur: Kodu 128, QR Kodi ve EAN-13. Her örnek yüksek düzeyde API’yi, per-symbology kod seçeneklerini ve rendering kontrolünü gösterir.

Bir kod oluşturun 128 barkod

Kod 128 değişken uzunluğu 1D sembolojisidir ve logistik ve gemi alanlarında kullanılır. code128() yardımcı bir veri çubuğu ve seçmeli kabul eder 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 Digit-sadece veriler için optimize edilmiştir - tek kod noktaları olarak sayı çiftlerini şifreler ve daha kısa bir çubuk kodu üretir.

QR Kodu oluşturmak

QR kodu, hata düzeltme ve çoklu kodlama modlarını destekleyen 2D sembolüdür. QrOptions hatayı düzeltme düzeyi, kodlama modu, versiyonu ve maske desenini kontrol eder:

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

Hataların düzeltilmesi düzeyi: L %7 iyileşme oranı, M %15 İle İlgili Yazılar, Q %25 İle İlgili Yazılar, H %30 ile ilgili olarak.

EAN-13 Barkodları oluşturun

EAN-13 sabit uzunluk 1D sembolojisidir. 12 payload sayısını sağlar - kütüphane otomatik olarak 13’üncü kontrol sayısını hesaplar:

import aspose_barcode_foss as barcode

bc = barcode.ean13("590123412345")
svg = bc.to_svg()

with open("ean13.svg", "w") as f:
    f.write(svg)

Kendi önceden bilgisayarlı kontrol numaranızı (toplam 13 sayı) sağlamak için, set allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

bc = barcode.ean13(
    "5901234123457",
    encode=Ean13Options(allow_check_digit_input=True),
)

Customize Rendering için

RenderOptions Tüm simgelere uygulanır ve görsel çıkış kontrol eder. to_svg() veya 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)

Mevcut Mülkiyetler : scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Genetik Generate() API kullanın

O zamanlar generate() fonksiyon, bir yardımcının çağrısı yerine bir simbolik isim çubuğunu kabul eder:

import aspose_barcode_foss as barcode

bc = barcode.generate("code128", "ABC123")
svg = bc.to_svg()

Simbolik isimler için: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Hata İşleme

Eğer geçersiz veriler veya uyumsuz seçenekler sağlanırsa, kütüphane bir istisna oluşturur:

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}")

Bir ayrımcılık hierarşisi:

Tüm sınıflar, her türlü BarcodeError.

Desteklenen Simbollar

Çıkış biçimleri: SVG ve PNG.

Sonraki adımlar

• Geliştirici Rehberi: Per-symbology kodlama seçenekleri, render kontrolü ve mimarisi
• Features: Kod örnekleri ile tam özellik genel bakış
• KB Yazıları: Nasıl rehberlik ve FAQ

See Also

• Aspose.BarCode for Python — Enterprise Documentation