כיצד להציג קודי ברקוד עם 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 (מכפיל נקודתי לגודל המודול) ואת 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 באמצעות כלים חיצוניים.