الأسئلة المتكررة
الترخيص ومصدر مفتوح
ما الرخصة التي يستخدمها 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 | النوع | فئة الخيارات |
|---|---|---|
| Code 128 | 1D | Code128Options |
| Code 39 | 1D | Code39Options |
| EAN-13 | 1D | Ean13Options |
| EAN-8 | 1D | Ean8Options |
| QR Code | 2D | QrOptions |
| UPC-A | 1D | UpcaOptions |
| UPC-E | 1D | UpceOptions |
كل رمزية لها دالة مساعدة مخصصة (code128(), code39(), ean13(), ean8(), qr(), upca(), upce()) ودالة عامة generate() تقبل اسم الرمزية كسلسلة نصية.
ما صيغ الإخراج المتاحة؟
المكتبة تقوم بتحويل الباركود إلى SVG و PNG:
to_svg()— تُعيد سلسلة SVGto_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 هي مكتبة توليد فقط. إنها تُنشئ باركود من البيانات لكنها لا تتضمن التعرف على الباركود أو إمكانيات المسح.
