Quickstart

Quickstart Aspose.BarCode FOSS per a Python

Aquesta guia fa un recorregut per la generació de codis de barres utilitzant les tres simbologies més comuns: Code 128, QR Code i EAN-13. Cada exemple demostra l’API d’alt nivell, opcions de codificació per símbol i controls de renderizació.

Generar un codi de barres 128

El codi 128 és una simbologia 1D de longitud variable utilitzada en la logística i el transport marítim. code128() l’ajutador accepta una cadena de dades i opcional 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 està optimitzat per a dades amb només dígits codifica parelles de dígens com punts d’un únic còde, produint un codi de barres més curt.

Generar un codi QR

El codi QR és una simbologia 2D que dóna suport a la correcció d’errors i múltiples modes de codificació. QrOptions controla el nivell de correcció d’errors, la modalitat d’encriptació, versió i model de màscara:

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

Nius de correcció d’errors: L (7% de recuperació), M (15%), Q (25%), H (30%).

Generar un codi de barres EAN-13

EAN-13 és una simbologia 1D de longitud fixa utilitzada en el comerç minorista. Sumen 12 xifres de càrrega útil la biblioteca calcula automàticament el 13è xifra d’avaluació:

import aspose_barcode_foss as barcode

bc = barcode.ean13("590123412345")
svg = bc.to_svg()

with open("ean13.svg", "w") as f:
    f.write(svg)

Per subministrar el seu propi dígit de verificació precomputat (13 dígits en total), fixar allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

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

Personalizar la representació

RenderOptions s’aplica a totes les simbologies i controla la sortida visual. Passa-la al to_svg() o de la seva 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)

Propietats disponibles: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

Utilitzar l’API generada genèric (Generic generate)

El generate() la funció accepta una cadena de noms simbòlics en comptes d’acudir a un auxiliar dedicat:

import aspose_barcode_foss as barcode

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

Noms de simbologia vàlids: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

Mànter d’errors

Si es proporcionen dades invàlides o opcions incompatibles, la biblioteca planteja una excepció mecanitzada:

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

Jerarquia d’excepcions:

Totes les classes d’excepció hereten de: BarcodeError.

Simbolicies recolzades

Formats de sortida: SVG i PNG.

Primiers passos

• Guia de desenvolupadors: Opcions d’encodatge per-simbolisme, controls de renderizació i arquitectura
• Features: Vista general completa de les característiques amb exemples de codi
• KB Articles: Guia de com fer i FAQ

See Also

• Aspose.BarCode for Python — Enterprise Documentation