Fitur dan Fungsionalitas

Fitur dan Fungsionalitas

Aspose.BarCode FOSS untuk Python menyediakan API tingkat tinggi untuk menghasilkan tujuh simbologi barcode dengan opsi enkode per-simbologi dan kontrol rendering. Halaman ini merupakan referensi utama untuk semua area fitur.

Simbologi yang Didukung

Pustaka ini mendukung tujuh simbologi melalui fungsi pembantu khusus dan titik masuk generik generate():

import aspose_barcode_foss as barcode

# Per-symbology helpers
bc_128 = barcode.code128("ABC123")
bc_qr = barcode.qr("https://example.com")

# Generic API
bc_gen = barcode.generate("ean13", "590123412345")

Mode Enkode Code 128

Code128Options mengontrol set karakter Code 128 mana yang digunakan enkoder. Properti encode_mode menerima nilai enum Code128EncodeMode:

• AUTO — secara otomatis memilih enkoding paling kompak
• CODE_A, CODE_B, CODE_C — batasi ke satu set karakter
• CODE_AB, CODE_AC, CODE_BC — izinkan beralih antara dua set karakter

from aspose_barcode_foss import Code128Options, Code128EncodeMode

bc = barcode.code128(
    "1234567890",
    encode=Code128Options(encode_mode=Code128EncodeMode.CODE_C),
)

Enkoding Code 39

Code39Options mengontrol apakah encoder menggunakan set karakter dasar 43 atau ekstensi Full ASCII:

• full_ascii — setel ke True untuk mengenkode seluruh rentang ASCII 128 karakter menggunakan pasangan shift
• add_check_digit — menambahkan digit cek modulo-43

from aspose_barcode_foss import Code39Options

bc = barcode.code39(
    "Hello",
    encode=Code39Options(full_ascii=True, add_check_digit=True),
)

Konfigurasi QR Code

QrOptions menyediakan konfigurasi paling banyak di antara semua simbolologi:

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

Digit Pemeriksaan EAN dan UPC

Ean13Options, Ean8Options, UpcaOptions, dan UpceOptions masing-masing memiliki properti allow_check_digit_input. Secara default, perpustakaan menghitung digit pemeriksaan secara otomatis. Atur allow_check_digit_input=True jika data Anda sudah menyertakannya.

from aspose_barcode_foss import Ean13Options

# Automatic check digit (12 digits in, library appends the 13th)
bc = barcode.ean13("590123412345")

# Pre-computed check digit (13 digits, library validates)
bc2 = barcode.ean13(
    "5901234123457",
    encode=Ean13Options(allow_check_digit_input=True),
)

Kontrol Rendering

RenderOptions berlaku untuk semua simbolologi dan mengontrol output visual. Lewatkan ke to_svg() atau to_png():

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

Format Output

Kedua metode menerima parameter RenderOptions opsional.

Penanganan Kesalahan

Semua validasi opsi enkode terjadi pada waktu parsing. Perpustakaan mengeluarkan pengecualian bertipe sebelum proses enkode dimulai:

Semua kelas pengecualian mewarisi dari BarcodeError.

from aspose_barcode_foss import InvalidInputError

try:
    bc = barcode.ean13("ABC")
except InvalidInputError as e:
    print(f"Invalid input: {e}")

Validasi Input

Setiap simbologi memiliki InputParser khusus yang memvalidasi data sebelum pengkodean. Parser memeriksa set karakter, panjang, dan persyaratan format yang spesifik untuk setiap simbologi. Code128InputParser, Code39InputParser, Ean13InputParser, Ean8InputParser, QrInputParser, UpcaInputParser, dan UpceInputParser digunakan secara internal oleh fungsi pembantu masing-masing.

Objek Barcode

Objek Barcode yang dikembalikan oleh semua fungsi pembantu menyediakan:

• to_svg(options) — render ke string SVG
• to_png(options) — render ke byte PNG
• render(renderer, options) — render menggunakan implementasi Renderer tertentu
• symbol — EncodedSymbol yang berisi matriks modul dan metadata
• profile — SymbologyProfile dengan nilai default dan kemampuan

Ringkasan API Reference

Lihat Juga

• Aspose.BarCode for Python — Enterprise Documentation