Quickstart

Quickstart — Aspose.BarCode FOSS για Python

Αυτό το οδηγό περνά μέσα από την παραγωγή κωδικών γραμμής χρησιμοποιώντας τα τρία πιο κοινά σύμβολα: Κωδικό 128, QR Code και EAN-13. Κάθε παράδειγμα αποδεικνύει το υψηλό επίπεδο API, επιλογές κώδικα ανά συμβολισμό, και ελέγχους rendering.

Δημιουργία κωδικού 128 barcode

Ο κωδικός 128 είναι ένα σύμβολο 1D μεταβλητού μήκους που χρησιμοποιείται στη λογιστική και τη ναυτιλία. code128() Ο βοηθός δέχεται μια γραμμή δεδομένων και προαιρετική 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 βελτιστοποιείται για ψηφιακά μόνο δεδομένα - κωδικοποιεί ζεύγη αριθμών ως σημεία κώδικα, παράγοντας ένα μικρότερο σιδηροδρομικό κείμενο.

Δημιουργία QR κώδικα

QR Code είναι ένα 2D σύμβολο που υποστηρίζει την διόρθωση σφαλμάτων και πολλαπλές τρόπους κρυπτογράφησης. QrOptions ελέγχει το επίπεδο διόρθωσης σφάλματος, τη λειτουργία κρυπτογράφηση, την έκδοση και το πρότυπο μάσκας:

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

Επίπεδα διόρθωσης σφαλμάτων: L 7% ανάκαμψη, M 15 % ) , Q 25 % ) , H Το 30 %).

Εισαγωγή του EAN-13 Barcode

EAN-13 είναι ένα σύμβολο μόνιμης μήκους 1D που χρησιμοποιείται στο λιανικό. Παρέχει 12 αριθμούς φόρτωσης - η βιβλιοθήκη υπολογίζει αυτόματα τον 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)

Για να παρέχετε το δικό σας προεπιλεγμένο αριθμό ελέγχου (13 αριθμοί συνολικά), allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

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

Ετικέτες Rendering

RenderOptions εφαρμόζεται σε όλες τις συμβολαιολογίες και ελέγχει την οπτική απόδοση. to_svg() ή 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)

Διαθέσιμες ιδιότητες: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Χρησιμοποιήστε το Generic() API

Η generate() Η λειτουργία αποδέχεται μια σφραγίδα ονόματος συμβολαιολογίας αντί να καλεί έναν αφιερωμένο βοηθό:

import aspose_barcode_foss as barcode

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

Σημαντικές συμβολικές ονομασίες: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Λάθος χειρισμού

Όλες οι επικύρωση συμβαίνουν πριν από την κρυπτογράφηση.Εάν παρέχονται μη συμμορφούμενα δεδομένα ή επιλογές, η βιβλιοθήκη προβάλλει μια τυποποιημένη εξαίρεση:

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

Η ιεραρχία εξαιρέσεων:

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

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

Τρόπος εκκίνησης: SVG και PNG.

Επόμενο Βήματα

• Οδηγός Ανάπτυξης: Per-symbology κρυπτογράφηση επιλογές, ελέγχους rendering και αρχιτεκτονική
• Features: Πλήρης ανασκόπηση χαρακτηριστικών με παραδείγματα κώδικα
• KB άρθρα:Πως να κάνετε τα σχόλιά σας και το FAQ

See Also

• Aspose.BarCode for Python — Enterprise Documentation