Các tính năng và chức năng

Các tính năng và chức năng

Aspose.BarCode FOSS for Python provides a high-level API for generating seven barcode symbologies with per-symbology encode options and rendering controls. This page is the primary reference for all feature areas.

Symbolic hỗ trợ

Thư viện hỗ trợ bảy biểu tượng thông qua các chức năng giúp đỡ chuyên dụng và các tính năng chung. generate() Điểm nhập:

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

Mã 128 Encode Modes

Code128Options điều khiển mà mã 128 ký tự đặt coder sử dụng. encode_mode Tài sản chấp nhận A Code128EncodeMode Giá trị Enum:

• AUTO - Chọn mã hóa nhỏ gọn nhất tự động
• CODE_A, CODE_B, CODE_C - Giới hạn cho một bộ nhân vật duy nhất
• CODE_AB, CODE_AC, CODE_BC - cho phép chuyển đổi giữa hai bộ nhân vật

from aspose_barcode_foss import Code128Options, Code128EncodeMode

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

39 mã hóa

Code39Options kiểm tra xem mã hóa có sử dụng bộ định dạng 43 nhân vật cơ bản hay phần mở rộng ASCII đầy đủ:

• full_ascii - Set to True để mã hóa toàn bộ phạm vi ASCII 128 tính bằng cách sử dụng cặp chuyển đổi
• add_check_digit - Tích hợp modulo-43 check digit

from aspose_barcode_foss import Code39Options

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

QR Code cấu hình

QrOptions cung cấp cấu hình nhiều nhất trong số tất cả các biểu tượng:

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

EAN và UPC Check Digits

Ean13Options, Ean8Options, UpcaOptions, và UpceOptions Mỗi người có một allow_check_digit_input theo mặc định, thư viện tính toán số kiểm tự động. allow_check_digit_input=True Nếu dữ liệu của bạn đã bao gồm nó.

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

kiểm soát rendering

RenderOptions áp dụng cho tất cả các biểu tượng và kiểm soát kết quả thị giác. to_svg() hoặc 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,
))

định dạng output

Cả hai phương pháp đều chấp nhận một tùy chọn RenderOptions Parameter của bạn.

Xử lý lỗi

Tất cả các tùy chọn mã hóa xác thực xảy ra vào thời điểm rảnh. Thư viện làm tăng ngoại lệ được viết trước khi mã hoá bắt đầu:

Tất cả các lớp ngoại lệ được thừa hưởng từ BarcodeError.

from aspose_barcode_foss import InvalidInputError

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

nhập Validation

Mỗi biểu tượng có một đặc điểm dành riêng cho InputParser Parser kiểm tra các yêu cầu định dạng, chiều dài và biểu tượng cụ thể cho mỗi biểu trưng. Code128InputParser, Code39InputParser, Ean13InputParser, Ean8InputParser, QrInputParser, UpcaInputParser, và UpceInputParser được sử dụng trong nội bộ bởi các chức năng trợ giúp của họ.

Barcode đối tượng

Các Barcode đối tượng được trả lại bởi tất cả các chức năng trợ giúp cung cấp:

• to_svg(options) - Đổi sang SVG string
• to_png(options) - Đưa đến PNG byte
• render(renderer, options) - Sử dụng một cụ thể Renderer thực hiện
• symbol - The EncodedSymbol - Có chứa module matrix và metadata
• profile - The SymbologyProfile Với các yếu tố và khả năng

Tóm tắt Tham chiếu API

See Also

• Aspose.BarCode for Python — Enterprise Documentation