Quickstart

Quickstart — Aspose.BarCode FOSS cho Python

Hướng dẫn này đi qua việc tạo mã thanh bằng cách sử dụng ba biểu tượng phổ biến nhất: Mã 128, Mục QR và EAN-13.Mỗi ví dụ cho thấy API cấp cao, tùy chọn mã hóa theo biểu trưng, và kiểm soát rendering.

Tạo mã 128 Barcode

Mã 128 là một biểu tượng 1D có chiều dài biến đổi được sử dụng trong logistics và vận chuyển. code128() Helper chấp nhận một dòng dữ liệu và tùy chọn 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 được tối ưu hóa cho dữ liệu chỉ số – nó mã hóa cặp chữ số như một điểm mã đơn, tạo ra mã thanh ngắn hơn.

Tạo một QR Code

QR Code là một biểu tượng 2D hỗ trợ sửa lỗi và nhiều chế độ mã hóa. QrOptions kiểm soát mức sửa lỗi, chế độ mã hóa, phiên bản và mô hình mặt nạ:

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

Tỷ lệ sửa lỗi: L (7% phục hồi), M (Trung Quốc) 15 %, Q 25 % (tạm dịch:, H 30 % ).

Tạo mã EAN-13 Barcode

EAN-13 là một biểu tượng 1D dài cố định được sử dụng trong bán lẻ. cung cấp 12 số tải — thư viện tính toán tự động số kiểm tra 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)

Để cung cấp số kiểm toán trước tính năng của riêng bạn (13 chữ số tổng), thiết lập allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

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

Customize Đánh giá

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

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)

Tài sản có sẵn: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Sử dụng Generic Generate() API

Các generate() chức năng chấp nhận một dòng tên biểu tượng thay vì gọi một trợ lý dành riêng:

import aspose_barcode_foss as barcode

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

Tên biểu tượng hợp lệ: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Xử lý lỗi

Tất cả các xác thực xảy ra trước khi mã hóa.Nếu dữ liệu không hợp lệ hoặc tùy chọn không tương thích được cung cấp, thư viện sẽ đưa ra một ngoại lệ:

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

Tính năng hiến pháp ngoại lệ:

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

Symbolic hỗ trợ

Định dạng xuất: SVG và PNG.

Bước tiếp theo

• Hướng dẫn Developer: Per-symbology mã hóa tùy chọn, kiểm soát rendering, và kiến trúc
• Features: Tổng quan tính năng đầy đủ với ví dụ mã
• KB Bài viết: Cách làm hướng dẫn và FAQ

See Also

• Aspose.BarCode for Python — Enterprise Documentation