מבוא
Aspose.BarCode FOSS עבור Python מספק מחלקות אפשרויות לכל סימבולוגיה השולטות בהתנהגות הקידוד בכל שבעת הפורמטים הנתמכים של ברקוד. כל מחלקת אפשרות יורשת מ-EncodeOptions ומוסיפה תכונות ספציפיות לסימבולוגיה שלה — מצבי קידוד Code 128, בחירת ASCII Code 39, רמות תיקון שגיאות QR, וטיפול ספרת ביקורת EAN/UPC.
פוסט זה מכסה כל מחלקת אפשרות, את התכונות שלה, ודוגמאות קוד עובדות. המחלקות זמינות מהחבילה ברמת העל aspose_barcode_foss.
תכונות מפתח
מצבי קידוד Code 128
Code128Options שולט באילו קבוצות תווים של Code 128 המשדר משתמש. המאפיין encode_mode מקבל ערך enum של Code128EncodeMode: AUTO, CODE_A, CODE_B, CODE_C, CODE_AB, CODE_AC או CODE_BC. AUTO בוחר באופן אוטומטי את הקידוד הדחוס ביותר. CODE_C מותאם לנתונים של ספרות בלבד (צמדים של ספרות מקודדים כנקודות קוד בודדות).
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()
Code 128 תומך גם בתכונות gs1_enabled ו-eci_assignment_number שהורשו מ-EncodeOptions עבור GS1 ונתוני מטא ECI.
Code 39 קידוד
Code39Options קובע האם המקודד משתמש במערך התווים הבסיסי של 43 תווים או בהרחבת Full ASCII. הגדר full_ascii=True כדי להפעיל מצב Full ASCII, שמקודד את טווח ה-ASCII המלא של 128 תווים באמצעות זוגות שינוי. המאפיין האופציונלי add_check_digit מוסיף ספרת ביקורת מודולו-43.
import aspose_barcode_foss as barcode
from aspose_barcode_foss import Code39Options
bc = barcode.code39(
"Hello",
encode=Code39Options(full_ascii=True, add_check_digit=True),
)
svg = bc.to_svg()
QR Code תצורה
QrOptions מציע את קבוצת התצורות העשירה ביותר בין הסימבולולוגיות הנתמכות:
error_correction_level:QrErrorCorrectionLevel.L(7%),.M(15%),.Q(25%),.H(30%)encoding_mode:QrEncodeMode.AUTO,.NUMERIC,.ALPHANUMERIC,.BYTE,.KANJIversion: גרסת QR (1–40), שולט בגודל הסימבולmask: תבנית מסכה (0–7) לבחירה ידנית
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,
),
)
png_bytes = bc.to_png()
ספרות ביקורת של EAN ו-UPC
Ean13Options, Ean8Options, UpcaOptions ו-UpceOptions לכל אחד יש תכונת allow_check_digit_input. כברירת מחדל, הספרייה מחשבת את ספרת הביקורת אוטומטית מהנתונים. הגדר allow_check_digit_input=True אם הנתונים שלך כבר כוללים את ספרת הביקורת.
import aspose_barcode_foss as barcode
from aspose_barcode_foss import Ean13Options
# Automatic check digit (12 digits in, library appends the 13th)
bc = barcode.ean13("590123412345")
svg = bc.to_svg()
# Pre-computed check digit (13 digits, library validates)
bc2 = barcode.ean13(
"5901234123457",
encode=Ean13Options(allow_check_digit_input=True),
)
אפשרויות רינדור
RenderOptions חלה על כל הסימבולוגיות ושולטת על הפלט החזותי. העבר אותה ל-to_svg() או ל-to_png():
| מאפיין | סוג | תיאור |
|---|---|---|
scale | float | מקדם קנה מידה אחיד |
dpi | int | רזולוציה לפלט PNG |
module_width | float | רוחב של מודול ברקוד אחד |
module_height | float | גובה של מודול ברקוד אחד |
quiet_zone | float | ריפוד רווח לבן סביב הברקוד |
foreground_color | str | צבע הקס עבור הפסים (לדוגמה, "#000000") |
background_color | str | צבע הקס לרקע |
transparent_background | bool | רקע שקוף עבור PNG |
show_text | bool | הצג טקסט קריא לבני אדם מתחת לברקוד |
font_family | str | גופן לטקסט קריא לבני אדם |
font_size | float | גודל גופן לטקסט קריא לבני אדם |
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",
))
טיפול בשגיאות
כל אימות אפשרויות הקידוד מתבצע בזמן הפענוח. אם מתקבלים נתונים בלתי חוקיים או אפשרויות שאינן תואמות, הספרייה זורקת חריגה מסווגת לפני שמתחיל קידוד כלשהו:
InvalidInputError— נתונים מכילים תווים שאינם נתמכים על ידי הסימבולוגיהEncodingError— הקידוד נכשל (לדוגמה, הנתונים חורגים מהקיבולת)SymbologyNotFoundError— שם סימבוליות לא מזוהה נמסר ל-generate()UnsupportedCapabilityError— תכונה מבוקשת אינה זמינה עבור סימבוליות זו
כל מחלקות החריגה יורשות מ-BarcodeError.
התחלה מהירה
git clone https://github.com/aspose-barcode-foss/Aspose.BarCode-FOSS-for-Python.git
cd Aspose.BarCode-FOSS-for-Python
pip install -e .יצירת ברקודים עם אפשרויות קידוד שונות ושמירתם:
import aspose_barcode_foss as barcode
from aspose_barcode_foss import (
Code128Options, Code128EncodeMode,
QrOptions, QrErrorCorrectionLevel,
RenderOptions,
)
# Code 128 in CODE_C mode (compact digit encoding)
c128 = barcode.code128(
"9876543210",
encode=Code128Options(encode_mode=Code128EncodeMode.CODE_C),
)
with open("code128.svg", "w") as f:
f.write(c128.to_svg())
# QR with high error correction
qr = barcode.qr(
"https://example.com",
encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)
with open("qr.png", "wb") as f:
f.write(qr.to_png(options=RenderOptions(scale=4.0)))
# EAN-13 with custom colors
ean = barcode.ean13("590123412345")
with open("ean13.svg", "w") as f:
f.write(ean.to_svg(options=RenderOptions(
foreground_color="#003366",
show_text=True,
)))
פורמטים נתמכים
| Symbology | סוג | מחלקת Options | תכונות מפתח |
|---|---|---|---|
| Code 128 | 1D | Code128Options | encode_mode |
| Code 39 | 1D | Code39Options | full_ascii, add_check_digit |
| EAN-13 | 1D | Ean13Options | allow_check_digit_input |
| EAN-8 | 1D | Ean8Options | allow_check_digit_input |
| QR Code | 2D | QrOptions | error_correction_level, encoding_mode, version, mask |
| UPC-A | 1D | UpcaOptions | allow_check_digit_input |
| UPC-E | 1D | UpceOptions | allow_check_digit_input |
פורמטים של פלט:
| פורמט | הרחבה | Export |
|---|---|---|
| SVG | .svg | ✓ |
| PNG | .png | ✓ |
קוד פתוח ורישוי
Aspose.BarCode FOSS עבור Python נמצא ברישיון MIT. המקור זמין ב-GitHub; בנייה מהמקור. ללא תלות מקומית, ללא טלמטריה, ללא מגבלות שימוש.