Χαρακτηριστικά και Λειτουργίες

Χαρακτηριστικά και Λειτουργίες

Aspose.BarCode FOSS για Python παρέχει ένα υψηλού επιπέδου API για τη δημιουργία επτά συμβολισμών barcode με επιλογές κωδικοποίησης ανά συμβολισμό και ελέγχους απόδοσης. Αυτή η σελίδα είναι η κύρια αναφορά για όλες τις περιοχές χαρακτηριστικών.

Υποστηριζόμενοι Συμβολισμοί

Η βιβλιοθήκη υποστηρίζει επτά συμβολισμούς μέσω αφιερωμένων βοηθητικών συναρτήσεων και του γενικού σημείου εισόδου 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")

Λειτουργίες Κωδικοποίησης Code 128

Code128Options ελέγχει ποια σύνολα χαρακτήρων Code 128 χρησιμοποιεί ο κωδικοποιητής. Η ιδιότητα encode_mode δέχεται μια τιμή enum Code128EncodeMode:

• AUTO — επιλέγει αυτόματα την πιο συμπαγή κωδικοποίηση
• CODE_A, CODE_B, CODE_C — περιορισμός σε ένα μόνο σύνολο χαρακτήρων
• CODE_AB, CODE_AC, CODE_BC — επιτρέπει εναλλαγή μεταξύ δύο συνόλων χαρακτήρων

from aspose_barcode_foss import Code128Options, Code128EncodeMode

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

Κωδικοποίηση Code 39

Code39Options ελέγχει εάν ο κωδικοποιητής χρησιμοποιεί το βασικό σύνολο 43 χαρακτήρων ή την επέκταση Full ASCII:

• full_ascii — ορίστε σε True για κωδικοποίηση του πλήρους εύρους 128 χαρακτήρων ASCII χρησιμοποιώντας ζεύγη αλλαγής
• add_check_digit — προσθέτει ένα ψηφίο ελέγχου modulo-43

from aspose_barcode_foss import Code39Options

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

Διαμόρφωση QR Code

QrOptions παρέχει τη μεγαλύτερη διαμόρφωση μεταξύ όλων των συμβολισμών:

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 και UPC

Ean13Options, Ean8Options, UpcaOptions και UpceOptions έχουν καθένα μια allow_check_digit_input property. Από προεπιλογή, η βιβλιοθήκη υπολογίζει αυτόματα τη check digit. Ορίστε allow_check_digit_input=True αν τα δεδομένα σας το περιλαμβάνουν ήδη.

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

Έλεγχοι Απόδοσης

RenderOptions ισχύει για όλες τις symbologies και ελέγχει την οπτική έξοδο. Περάστε το στο to_svg() ή 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,
))

Μορφές Εξόδου

Και οι δύο μέθοδοι δέχονται ένα προαιρετικό RenderOptions παράμετρο.

Διαχείριση Σφαλμάτων

Όλη η επικύρωση των επιλογών encode γίνεται κατά το χρόνο parse. Η βιβλιοθήκη εγείρει typed exceptions πριν ξεκινήσει η κωδικοποίηση:

Όλες οι κλάσεις εξαιρέσεων κληρονομούν από το BarcodeError.

from aspose_barcode_foss import InvalidInputError

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

Επικύρωση Εισόδου

Κάθε συμβολική γλώσσα έχει ένα αφιερωμένο InputParser που επικυρώνει τα δεδομένα πριν την κωδικοποίηση. Ο parser ελέγχει το σύνολο χαρακτήρων, το μήκος και τις απαιτήσεις μορφής που είναι ειδικές για κάθε συμβολική γλώσσα. Τα Code128InputParser, Code39InputParser, Ean13InputParser, Ean8InputParser, QrInputParser, UpcaInputParser και UpceInputParser χρησιμοποιούνται εσωτερικά από τις αντίστοιχες βοηθητικές συναρτήσεις τους.

Αντικείμενο Barcode

Το αντικείμενο Barcode που επιστρέφεται από όλες τις βοηθητικές συναρτήσεις παρέχει:

• to_svg(options) — απόδοση σε συμβολοσειρά SVG
• to_png(options) — απόδοση σε bytes PNG
• render(renderer, options) — απόδοση χρησιμοποιώντας μια συγκεκριμένη υλοποίηση Renderer
• symbol — το EncodedSymbol που περιέχει τη μήτρα του module και τα μεταδεδομένα
• profile — το SymbologyProfile με προεπιλογές και δυνατότητες

API Reference Περίληψη

Δείτε επίσης

• Aspose.BarCode for Python — Enterprise Documentation