Aspose.BarCode FOSS
שאלות נפוצות

שאלות נפוצות

רישוי וקוד פתוח

איזו רישיון משתמש Aspose.BarCode FOSS עבור Python?

Aspose.BarCode FOSS עבור Python משוחרר תחת רישיון MIT. טקסט הרישיון המלא נכלל בקובץ LICENSE המופץ עם החבילה. אתה חופשי להשתמש, לשנות ולהפיץ מחדש את הספרייה הן בפרויקטים קוד פתוח והן בפרויקטים קנייניים.

האם ניתן להשתמש ב-Aspose.BarCode FOSS במוצרים מסחריים?

כן. רישיון MIT מאפשר שימוש מסחרי ללא תמלוגים או דרישות ייחוס מעבר לכלול את הודעת הרישיון המקורית. אינך צריך להפוך את היישום שלך לקוד פתוח.

התקנה ודרישות

איך אני מתקין את Aspose.BarCode FOSS עבור Python?

התקן אותו עם הפקודה למטה:

git clone https://github.com/aspose-barcode-foss/Aspose.BarCode-FOSS-for-Python.git
cd Aspose.BarCode-FOSS-for-Python
pip install -e .

הספרייה דורשת Python 3.12 או גרסה מאוחרת יותר.

האם קיימות תלותיות מקומיות או חבילות מערכת נדרשות?

לא. Aspose.BarCode FOSS עבור Python היא חבילה pure-Python. אין לה הרחבות מקומיות, אין תלותיות C, ואין חבילות ברמת המערכת להתקנה. היא פועלת ב-Windows, macOS ו-Linux — כולל תמונות Docker רזות כמו python:3.12-slim.

תמיכת סימבולוגיה

אילו סימבולוגיות ברקוד נתמכות?

הספרייה תומכת בשבע סימבולוגיות:

Symbologyסוגמחלקת Options
Code 1281DCode128Options
Code 391DCode39Options
EAN-131DEan13Options
EAN-81DEan8Options
QR Code2DQrOptions
UPC-A1DUpcaOptions
UPC-E1DUpceOptions

לכל סימבוליה יש פונקציית עזר ייעודית (code128(), code39(), ean13(), ean8(), qr(), upca(), upce()) ופונקציה גנרית generate() שמקבלת מחרוזת של שם הסימבוליה.

אילו פורמטי פלט זמינים?

הספרייה מייצרת ברקודים ל-SVG ול-PNG:

  • to_svg() — מחזיר מחרוזת SVG
  • to_png() — מחזיר בתים של PNG

שתי השיטות מקבלות פרמטר RenderOptions אופציונלי לשליטה בקנה המידה, DPI, צבעים, אזור שקט, וטקסט קריא לבני אדם.

API Usage

איך אני מייצר ברקוד?

השתמש בפונקציית עזר לכל סימבולוגיה:

import aspose_barcode_foss as barcode

bc = barcode.code128("Hello World")
svg = bc.to_svg()

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

או השתמש בפונקציה הגנרית generate():

bc = barcode.generate("qr", "https://example.com")

איך אני מגדיר אפשרויות קידוד?

לכל סימבולוגיה יש מחלקת אפשרויות ייעודית. העבר אותה כפרמטר encode:

from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel

bc = barcode.qr(
    "https://example.com",
    encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)

איך אני שולט במראה החזותי של הברקוד?

השתמש ב-RenderOptions עם to_svg() או to_png():

from aspose_barcode_foss import RenderOptions

bc = barcode.code128("DATA")
png = bc.to_png(options=RenderOptions(
    scale=3.0,
    dpi=300,
    foreground_color="#003366",
    show_text=True,
))

תכונות זמינות: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

איך הספרייה מתמודדת עם ספרות ביקורת עבור ברקודים מסוג EAN ו-UPC?

בברירת מחדל, הספרייה מחשבת את ספרת הבדיקה באופן אוטומטי. ספק רק את ספרות המטען (12 עבור EAN-13, 7 עבור EAN-8, 11 עבור UPC-A):

bc = barcode.ean13("590123412345")  # 12 digits — check digit computed

כדי לספק ספרת בדיקה מחושבת מראש, הגדר את allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

bc = barcode.ean13(
    "5901234123457",  # 13 digits with check digit
    encode=Ean13Options(allow_check_digit_input=True),
)

הגבלות ידועות

האם פלט PDF נתמך?

לא. השיטה to_pdf() והמחלקה PdfRenderer קיימים במשטח API אך גורמים ל-NotImplementedError. השתמש ב-to_svg() או ב-to_png() במקום. פלט SVG ניתן לשלב במסמכי PDF באמצעות כלים חיצוניים.

האם תקני ECI ו-GS1 נתמכים?

עדיין לא. המחלקות EciHelper ו-Gs1Helper מכילות שלדים של שיטות שמעלים NotImplementedError. המאפיינים eci_assignment_number ו-gs1_enabled ב-EncodeOptions קיימים אך אינם פעילים בגרסה הנוכחית.

האם הספרייה יכולה לקרוא או לסרוק ברקודים?

מס’ Aspose.BarCode FOSS עבור Python היא ספרייה ליצירת קודים בלבד. היא יוצרת ברקודים מהנתונים אך אינה כוללת זיהוי ברקוד או אפשרויות סריקה.

ראה גם

 עברית