كيفية عرض الباركود باستخدام 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 باستخدام أدوات خارجية.