Як відображати штрих-коди за допомогою Aspose.BarCode FOSS

Problem

Після створення штрихкоду вам потрібно відобразити його у вигляді файлу зображення. Aspose.BarCode FOSS для Python рендерить штрихкоди у формати SVG та PNG за допомогою методів to_svg() і to_png() об’єкта Barcode. Клас RenderOptions керує візуальними властивостями, такими як масштаб, DPI, кольори, тиху зону та відображення людсько-читабельного тексту.

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

Вимоги

Python 3.12 або пізніше
менеджер пакетів pip
aspose-barcode-foss зібраний з вихідного коду

Виведення SVG

Викличте to_svg(), щоб отримати штрих-код у вигляді рядка SVG. Вивід SVG є векторним і масштабується без втрати якості.

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)

Виведення PNG

Викличте to_png(), щоб отримати штрих-код у вигляді PNG-байтів. Вивід PNG растерується з вказаним масштабом і DPI.

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)

Керування масштабом та DPI

Використовуйте RenderOptions для встановлення scale (множник типу float для розміру модуля) та dpi (точок на дюйм для растрового виводу). Ви також можете встановити module_width і module_height безпосередньо для точного керування розмірами окремих модулів.

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)

Встановлення кольорів

Встановіть foreground_color і background_color як рядки кольорів CSS. Використовуйте transparent_background=True для PNG-виводу без заповнення фону.

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)

Тихий простір

Властивість quiet_zone контролює відступ простору навколо штрих-коду у модулях. Стандарти штрих-кодів зазвичай вимагають мінімальну тиху зону для надійного сканування.

from aspose_barcode_foss import RenderOptions

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

Текст, зрозумілий людині

Встановіть show_text=True, щоб відображати текст, зрозумілий людині, під штрих-кодом. Керуйте шрифтом за допомогою font_family та 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

Властивість	Тип	Опис
`scale`	`float`	Множник розміру модуля
`dpi`	`int`	Точки на дюйм (растровий вивід)
`module_width`	`float`	Ширина одного модуля
`module_height`	`float`	Висота одного модуля
`quiet_zone`	`float`	Відступ пробілу в одиницях модуля
`foreground_color`	`str`	CSS колір для панелей/модулів
`background_color`	`str`	CSS колір для фону
`transparent_background`	`bool`	Прозоре PNG фон
`show_text`	`bool`	Показати читабельний для людей текст
`font_family`	`str`	Шрифт для читабельного тексту
`font_size`	`float`	Розмір шрифту для читабельного тексту

Відомі обмеження

Метод to_pdf() та клас PdfRenderer існують у API, проте викликають NotImplementedError. Використовуйте замість них to_svg() або to_png(). Вивід SVG можна вбудовувати у PDF-документи за допомогою зовнішніх інструментів.