Quickstart

Quickstart — Aspose.BarCode FOSS עבור Python

מדריך זה עובר דרך ליצירת קודים בר באמצעות שלושת הסמולוגות הנפוצות ביותר: קוד 128, קוד QR, ו EAN-13.כל דוגמה מראה את הרמה הגבוהה של API, אפשרויות הקוד לפי סמבוולוגיה, ואת שליטה rendering.

מצא קוד 128 Barcode

קוד 128 הוא סימבוליקה 1D של אורך משתנה המשמשת לוגיסטיקה ולשירות. code128() עוזר מקבל רצועת נתונים ואופציונלית Code128Options:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import Code128Options, Code128EncodeMode

bc = barcode.code128(
    "1234567890",
    encode=Code128Options(encode_mode=Code128EncodeMode.CODE_C),
)
svg = bc.to_svg()

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

Code128EncodeMode.CODE_C הוא אופטימיזציה עבור נתונים דיגיטליים בלבד – הוא מקודד זוגות של מספרים כנקודות קוד יחידות, ויוצר קוד שורת קצר יותר.

יצירת קוד QR

QR Code הוא סימבוליקה 2D תומכת תיקון שגיאות ומצבי קוד מרובים. QrOptions בקרת רמת תיקון שגיאה, מצב הקוד, גרסה, ומודל מסכה:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel, QrEncodeMode

bc = barcode.qr(
    "https://example.com/product/12345",
    encode=QrOptions(
        error_correction_level=QrErrorCorrectionLevel.Q,
        encoding_mode=QrEncodeMode.BYTE,
    ),
)

with open("qr.png", "wb") as f:
    f.write(bc.to_png())

רמת תיקון שגיאות: L 7% התאוששות (התאוששויות של אחוזים), M 15 אחוזים ), Q 25 אחוזים ), H 30 אחוזים ).

הגדרת קוד EAN-13

EAN-13 הוא סימבוליקה קבועה-אורך 1D המשמשת במכירות סחורות.ספק 12 ציונים של משקל - הספרייה מחושבת באופן אוטומטי את הציון השלישי:

import aspose_barcode_foss as barcode

bc = barcode.ean13("590123412345")
svg = bc.to_svg()

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

כדי לספק את המספר הבדיקה שלך מראש מחשב (13 סימנים בסך הכל), allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

bc = barcode.ean13(
    "5901234123457",
    encode=Ean13Options(allow_check_digit_input=True),
)

קנדיז Rendering

RenderOptions מתייחסים לכל הסמבלולוגיות ומפקחים את היציאה החזותית. to_svg() או to_png():

import aspose_barcode_foss as barcode
from aspose_barcode_foss import RenderOptions

bc = barcode.upca("01234567890")
png = bc.to_png(options=RenderOptions(
    scale=3.0,
    dpi=300,
    foreground_color="#1a1a1a",
    background_color="#ffffff",
    show_text=True,
    font_family="Courier New",
))

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

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

שימוש ב- Generic Generate() API

The generate() הפונקציה מקבלת שורת שמות סימבוולוגיה במקום להתקשר לעוזר מוקדש:

import aspose_barcode_foss as barcode

bc = barcode.generate("code128", "ABC123")
svg = bc.to_svg()

שמות סימבוליים שווה: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

טיפול בשגיאות

אם נתונים לא תקינים או אפשרויות בלתי תואמות מוצעים, הספרייה מעלה את ההפרדה הנבחרת:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import InvalidInputError

try:
    bc = barcode.ean13("ABC")  # EAN-13 requires digits
except InvalidInputError as e:
    print(f"Invalid input: {e}")

היתרונות של ייראקיה:

כל המעמדות היחידים שנשארים על ידי BarcodeError.

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

פורמטים: SVG ו- PNG.

שלבים הבאים

• מדריך מפתחים: אפשרויות קוד Per-symbology, שליטה בהפצה ואדריכלות
• Features: סקירה מלאה של תכונות עם דוגמאות קוד
• KB מאמרים:כיצד להציג מדריכים ו-FAQ

See Also

• Aspose.BarCode for Python — Enterprise Documentation