Comment rendre les codes-barres avec Aspose.BarCode FOSS

Problem

Après avoir généré un code-barres, vous devez le rendre sous forme de fichier image. Aspose.BarCode FOSS pour Python rend les codes-barres aux formats SVG et PNG via les méthodes to_svg() et to_png() sur l’objet Barcode. La classe RenderOptions contrôle les propriétés visuelles telles que l’échelle, le DPI, les couleurs, la zone silencieuse et l’affichage du texte lisible par l’homme.

import aspose_barcode_foss as barcode
from aspose_barcode_foss import RenderOptions

bc = barcode.code128("RENDER-ME")
png = bc.to_png(options=RenderOptions(scale=2.0, dpi=300))

Prérequis

Python 3.12 ou version ultérieure
gestionnaire de paquets pip
aspose-barcode-foss construit à partir du code source

Sortie SVG

Appelez to_svg() pour obtenir le code-barres sous forme de chaîne SVG. La sortie SVG est vectorielle et s’adapte sans perte de qualité.

import aspose_barcode_foss as barcode

bc = barcode.qr("https://example.com")
svg_string = bc.to_svg()

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

Sortie PNG

Appelez to_png() pour obtenir le code-barres sous forme d’octets PNG. La sortie PNG est rasterisée à l’échelle et à la résolution DPI spécifiées.

import aspose_barcode_foss as barcode

bc = barcode.code128("PNG-OUTPUT")
png_bytes = bc.to_png()

with open("barcode.png", "wb") as f:
    f.write(png_bytes)

Contrôle de l’échelle et du DPI

Utilisez RenderOptions pour définir scale (un multiplicateur flottant pour la taille du module) et dpi (points par pouce pour la sortie raster). Vous pouvez également définir module_width et module_height directement pour un contrôle précis des dimensions de chaque module.

from aspose_barcode_foss import RenderOptions

options = RenderOptions(
    scale=3.0,
    dpi=300,
    module_width=1.5,
    module_height=25.0,
)
png = bc.to_png(options=options)

Définition des couleurs

Définissez foreground_color et background_color en tant que chaînes de couleur CSS. Utilisez transparent_background=True pour la sortie PNG sans remplissage d’arrière-plan.

from aspose_barcode_foss import RenderOptions

options = RenderOptions(
    foreground_color="#003366",
    background_color="#FFFFFF",
)
svg = bc.to_svg(options=options)

# Transparent background for PNG
options_transparent = RenderOptions(
    foreground_color="#000000",
    transparent_background=True,
)
png = bc.to_png(options=options_transparent)

Zone silencieuse

La propriété quiet_zone contrôle la marge d’espace blanc autour du code-barres en unités de module. Les normes de code-barres exigent généralement une zone silencieuse minimale pour un décodage fiable.

from aspose_barcode_foss import RenderOptions

options = RenderOptions(quiet_zone=10.0)
svg = bc.to_svg(options=options)

Texte lisible par l’homme

Définissez show_text=True pour afficher le texte lisible par l’homme sous le code-barres. Contrôlez la police avec font_family et font_size.

from aspose_barcode_foss import RenderOptions

options = RenderOptions(
    show_text=True,
    font_family="monospace",
    font_size=12.0,
)
svg = bc.to_svg(options=options)

RenderOptions Propriétés

Propriété	Type	Description
`scale`	`float`	Multiplicateur de la taille du module
`dpi`	`int`	Points par pouce (sortie raster)
`module_width`	`float`	Largeur d’un module
`module_height`	`float`	Hauteur d’un module
`quiet_zone`	`float`	Marge d’espace blanc en unités de module
`foreground_color`	`str`	Couleur CSS pour les barres/modules
`background_color`	`str`	Couleur CSS pour l’arrière-plan
`transparent_background`	`bool`	Arrière-plan PNG transparent
`show_text`	`bool`	Afficher le texte lisible
`font_family`	`str`	Police pour le texte lisible
`font_size`	`float`	Taille de police pour le texte lisible par l’homme

Limitations connues

La méthode to_pdf() et la classe PdfRenderer existent dans le API mais déclenchent NotImplementedError. Utilisez to_svg() ou to_png() à la place. La sortie SVG peut être intégrée dans des documents PDF à l’aide d’outils externes.