From 40a86cd97215e59ad96a68fafbddabd95bfb5a73 Mon Sep 17 00:00:00 2001 From: Muhammad Adil Date: Sat, 22 Aug 2026 14:46:21 +0000 Subject: [PATCH] Add 1 barcode python tutorials Categories: general Source: AI Search API Tutorials: - How to generate DataMatrix barcode in Python with Aspose.BarCode Auto-generated by Professionalize.Tutorials Agent --- .../_index.md | 248 +++++++++++++++++ .../_index.md | 246 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 250 +++++++++++++++++ .../og-image.png | Bin 0 -> 48952 bytes .../_index.md | 248 +++++++++++++++++ .../_index.md | 251 ++++++++++++++++++ .../_index.md | 249 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 246 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 246 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ .../_index.md | 248 +++++++++++++++++ 24 files changed, 5704 insertions(+) create mode 100644 barcode/arabic/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/chinese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/czech/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/dutch/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/english/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/english/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/og-image.png create mode 100644 barcode/french/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/german/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/greek/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/hindi/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/hongkong/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/hungarian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/indonesian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/italian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/japanese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/korean/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/polish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/portuguese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/russian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/spanish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/swedish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/thai/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/turkish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md create mode 100644 barcode/vietnamese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md diff --git a/barcode/arabic/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/arabic/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..07f389865 --- /dev/null +++ b/barcode/arabic/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: تعلم كيفية إنشاء رمز DataMatrix في بايثون وترميز النص الروسي باستخدام + Aspose.BarCode – دليل خطوة بخطوة. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: ar +lastmod: 2026-08-22 +og_description: إنشاء رمز DataMatrix في بايثون وترميز النص الروسي باستخدام Aspose.BarCode. + اتبع المثال الكامل وشغّله فورًا. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: إنشاء باركود DataMatrix في بايثون – دليل Aspose.BarCode الكامل +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: كيفية إنشاء باركود DataMatrix في بايثون باستخدام Aspose.BarCode +url: /ar/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# كيفية إنشاء باركود DataMatrix في بايثون باستخدام Aspose.BarCode + +إذا كنت بحاجة إلى **إنشاء باركود DataMatrix** في بايثون مع **ترميز النص الروسي**، فإن هذا الدليل يوضح لك الخطوات الدقيقة. سترى مثالًا كاملاً قابلًا للتنفيذ يبني نصًا موسعًا، يضبط الباركود، ويحفظ الصورة في سكريبت واحد. + +إنشاء باركود يحتوي على أحرف غير ASCII غالبًا ما يثير أسئلة حول مجموعات الأحرف وترميز البيانات. باستخدام `ExtCodetextBuilder` من Aspose.BarCode، يمكنك تضمين نص UTF‑8 مثل الأحرف السيريالية داخل رمز DataMatrix بأمان. النتيجة تعمل مع أي ماسح يدعم معيار DataMatrix. + +في هذا الدرس ستقوم بـ: + +* تثبيت حزمة Aspose.BarCode المطلوبة. +* بناء نص موسع يجمع بين البيانات العادية والنص الروسي. +* **إنشاء باركود DataMatrix** باستخدام السلسلة الموسعة. +* تعديل معلمات الباركود مثل حجم الوحدة. +* حفظ الباركود كملف PNG. + +لا توجد خدمات خارجية مطلوبة؛ كل شيء يعمل محليًا على جهازك. + +## المتطلبات المسبقة + +قبل البدء، تأكد من أن لديك: + +* Python 3.8 أو أحدث مثبت. +* ترخيص فعال لـ Aspose.BarCode للبايثون (إصدار تجريبي مجاني يكفي للتطوير). +* إلمام أساسي ببرمجة بايثون. + +يمكنك تثبيت مكتبة Aspose.BarCode عبر pip: + +```bash +pip install aspose-barcode +``` + +## الخطوة 1: بناء سلسلة نص موسع + +المهمة الأولى هي إنشاء سلسلة واحدة تحتوي على معرف المنتج العادي والعبارة الروسية. يسمح لك `ExtCodetextBuilder` بدمج أجزاء نصية مختلفة مع الحفاظ على معلومات الترميز الخاصة بها. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**لماذا هذه الخطوة مهمة** – رموز DataMatrix تخزن بايتات خام. عندما تحتاج إلى دمج أبجديات مختلفة، يجب إبلاغ المُشفّر أي مجموعة أحرف تنطبق على كل جزء. تُدخل طريقة `add_eci_codetext` مؤشر ECI قبل النص الروسي، مما يضمن أن الماسحات تفسّر البايتات كـ UTF‑8. بدون ECI، ستظهر الأحرف السيريالية كبيانات مشوشة. + +## الخطوة 2: إنشاء مولّد باركود DataMatrix + +بعد تجهيز النص الموسع، أنشئ كائن `BarcodeGenerator` مع تحديد النوع `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**لماذا DataMatrix؟** – DataMatrix هو باركود ثنائي الأبعاد يمكنه تخزين ما يصل إلى 2,335 حرفًا أبجديًا رقميًا أو 1,556 بايت. إنه مثالي للأشياء الصغيرة، الأجزاء الصناعية، والحالات التي تحتاج فيها إلى تضمين نص متعدد اللغات. + +## الخطوة 3: (اختياري) ضبط معلمات الباركود + +يوفر Aspose.BarCode العديد من المعلمات. بالنسبة لمعظم الاستخدامات، الإعدادات الافتراضية تنتج رمزًا قابلًا للقراءة. ومع ذلك، قد ترغب في التحكم في حجم كل وحدة (أصغر مربع في المصفوفة) لتتناسب مع متطلبات الطباعة. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +تشمل المعلمات المفيدة الأخرى مستوى تصحيح الأخطاء، الهامش، ولون الخلفية. قم بضبطها فقط إذا كان بيئة المسح المستهدفة تتطلب تحمّلات محددة. + +## الخطوة 4: حفظ صورة الباركود + +أخيرًا، احفظ الباركود إلى ملف. تدعم طريقة `save` صيغ PNG، JPEG، BMP، وعدة صيغ متجهية. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +عند فتح `extended_codetext.png`، سترى رمز DataMatrix واضحًا. مسحه باستخدام قارئ DataMatrix قياسي يعيد الجزأين: + +1. **ABC123** – المعرف العادي. +2. **Привет** – التحية الروسية، تم فك ترميزها بشكل صحيح كـ UTF‑8. + +## مثال كامل قابل للتنفيذ + +فيما يلي السكريبت الكامل الذي يمكنك نسخه ولصقه في ملف باسم `generate_datamatrix.py`. استبدل `YOUR_DIRECTORY` بمسار مجلد موجود على نظامك. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Run the script from the command line: + +```bash +python generate_datamatrix.py +``` + +You should see console output similar to: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## التحقق من النتيجة + +لتأكيد أن الباركود يرمّز العبارة الروسية بشكل صحيح: + +1. افتح ملف PNG في عارض صور. +2. استخدم أي تطبيق مسح DataMatrix (العديد من التطبيقات المحمولة تدعم ذلك) أو ماسحًا ماديًا. +3. يجب أن تعرض السلسلة المفكوكة `ABC123Привет` (أو الجزأين منفصلين حسب واجهة المستخدم في الماسح). + +إذا ظهرت الأحرف الروسية كرموز غير مفهومة، تحقق مرة أخرى من أن الماسح يدعم ECI UTF‑8. معظم القارئات الحديثة تدعم ذلك، لكن الأجهزة القديمة قد تحتاج إلى تكوين صريح. + +## المشكلات الشائعة وكيفية تجنّبها + +| المشكلة | السبب | الحل | +|-------|-------|-----| +| نص سيريالي مشوش | مؤشر ECI مفقود | استخدم `add_eci_codetext` مع `eci_encoding=3`. | +| الباركود صغير جدًا للطابعة | حجم الوحدة الافتراضي دقيق جدًا لدقة DPI منخفضة | زيادة `x_dimension` (مثلاً `3.0` أو `4.0`). | +| الملف غير محفوظ | مسار المجلد غير صالح | تأكد من وجود `YOUR_DIRECTORY` وأنه قابل للكتابة. | +| الماسح لا يستطيع القراءة | كثافة البيانات مفرطة | قلل كمية البيانات المشفرة أو زد مستوى تصحيح الأخطاء (`generator.parameters.barcode.error_correction_level`). | + +## توسيع المثال + +يمكنك تعديل هذا النمط للغات أو أنواع بيانات أخرى: + +* **ترميز النص الياباني أو العربي** – غيّر `eci_encoding` إلى القيمة المناسبة (مثلاً 5 لـ ISO‑8859‑5، 6 لـ ISO‑8859‑7). +* **إضافة مقاطع ECI متعددة** – استدعِ `add_eci_codetext` عدة مرات، كل مرة بترميز مختلف. +* **إنشاء رمز QR بدلاً من ذلك** – استبدل `EncodeTypes.DATA_MATRIX` بـ `EncodeTypes.QR`. + +جميع الخطوات الأخرى تبقى كما هي لأن `ExtCodetextBuilder` يختصر التعامل مع البايتات منخفضة المستوى. + +## الخلاصة + +أنت الآن تعرف كيفية **إنشاء باركود DataMatrix** في بايثون و**ترميز النص الروسي** باستخدام ميزة النص الموسع في Aspose.BarCode. السكريبت الكامل يتعامل مع تفاوض مجموعة الأحرف، إنشاء الباركود، وإخراج الصورة ببضع أسطر من الشيفرة فقط. + +بعد ذلك، استكشف رموز باركود أخرى (PDF417، Aztec) أو دمج المولد في خدمة ويب تُعيد صور PNG عند الطلب. نفس المبادئ—بناء نص موسع واختيار `EncodeTypes` المناسب—تنطبق على كامل مجموعة Aspose.BarCode. + +برمجة سعيدة، واستمتع بقوة إنشاء باركود متعدد اللغات! + +## ما الذي ينبغي أن تتعلمه بعد ذلك؟ + +الدروس التالية تغطي مواضيع ذات صلة وثيقة تبني على التقنيات الموضحة في هذا الدليل. كل مصدر يتضمن أمثلة شيفرة كاملة مع شروحات خطوة بخطوة لمساعدتك على إتقان ميزات API إضافية واستكشاف أساليب تنفيذ بديلة في مشاريعك. + +- [كيفية إنشاء باركود DataMatrix باستخدام Aspose.BarCode لـ .NET – دليل خطوة بخطوة](/barcode/english/net/datamatrix-barcode-configuration/) +- [إنشاء باركود DataMatrix في وضع ASCII باستخدام Aspose.BarCode لـ .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [كيفية إنشاء باركود DataMatrix (ECC 200) باستخدام Aspose.BarCode لـ .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/chinese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/chinese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..38ae261a1 --- /dev/null +++ b/barcode/chinese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,246 @@ +--- +category: general +date: 2026-08-22 +description: 学习在 Python 中生成 DataMatrix 条码并使用 Aspose.BarCode 编码俄文文本——一步一步的指南。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: zh +lastmod: 2026-08-22 +og_description: 在 Python 中生成 DataMatrix 条码并使用 Aspose.BarCode 对俄文文本进行编码。遵循完整示例并立即运行。 +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: 在Python中生成DataMatrix条码 – 完整的Aspose.BarCode教程 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: 如何使用 Aspose.BarCode 在 Python 中生成 DataMatrix 条码 +url: /zh/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 Python 中使用 Aspose.BarCode 生成 DataMatrix 条码 + +如果您需要在 Python 中 **生成 DataMatrix 条码** 并 **对俄文文本进行编码**，本指南将展示完整的步骤。您将看到一个可直接运行的示例，构建扩展的 codetext、配置条码并在单个脚本中保存图像。 + +创建包含非 ASCII 字符的条码时，常会遇到字符集和数据编码的问题。通过使用 Aspose.BarCode 的 `ExtCodetextBuilder`，您可以安全地在 DataMatrix 符号中嵌入 UTF‑8 文本（如西里尔字母）。该结果可被任何支持 DataMatrix 标准的扫描仪读取。 + +在本教程中，您将： + +* 安装所需的 Aspose.BarCode 包。 +* 构建混合普通数据和俄文文本的扩展 codetext。 +* **生成 DataMatrix 条码** 并使用扩展字符串。 +* 调整条码参数，如模块大小。 +* 将条码保存为 PNG 文件。 + +无需任何外部服务；所有操作均在本机本地完成。 + +## 前提条件 + +开始之前，请确保您具备： + +* 已安装 Python 3.8 或更高版本。 +* 有效的 Aspose.BarCode for Python 许可证（免费试用版可用于开发）。 +* 基本的 Python 脚本编写经验。 + +您可以通过 pip 安装 Aspose.BarCode 库： + +```bash +pip install aspose-barcode +``` + +## 第一步：构建扩展 codetext 字符串 + +首要任务是创建一个包含普通产品标识符和俄文短语的单一字符串。`ExtCodetextBuilder` 允许您在保留各段编码信息的前提下拼接不同的 codetext 部分。 + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**此步骤的重要性** – DataMatrix 符号存储的是原始字节。当需要混合不同字母表时，必须告诉编码器每个段使用的字符集。`add_eci_codetext` 方法会在俄文文本前插入 ECI 指示符，确保扫描仪将这些字节解释为 UTF‑8。若未使用 ECI，西里尔字符将显示为乱码。 + +## 第二步：创建 DataMatrix 条码生成器 + +准备好扩展 codetext 后，实例化一个指定 `EncodeTypes.DATA_MATRIX` 类型的 `BarcodeGenerator`。 + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**为何选择 DataMatrix？** – DataMatrix 是一种二维条码，可存储最多 2,335 个字母数字字符或 1,556 字节。它非常适合小件商品、工业部件以及需要嵌入多语言文本的场景。 + +## 第三步：（可选）配置条码参数 + +Aspose.BarCode 提供了众多参数。对于大多数使用场景，默认设置即可生成可读的符号。但您可能需要控制每个模块（矩阵中最小的方块）的大小，以满足打印需求。 + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +其他有用的参数包括错误纠正级别、边距和背景颜色。仅在目标扫描环境对容差有特定要求时才进行调整。 + +## 第四步：保存条码图像 + +最后，将条码写入文件。`save` 方法支持 PNG、JPEG、BMP 以及多种矢量格式。 + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +打开 `extended_codetext.png`，您将看到清晰的 DataMatrix 符号。使用标准 DataMatrix 读取器扫描后，会得到两部分内容： + +1. **ABC123** – 普通标识符。 +2. **Привет** – 俄文问候语，已正确解码为 UTF‑8。 + +## 完整、可运行的示例 + +下面是完整脚本，您可以复制粘贴到名为 `generate_datamatrix.py` 的文件中。将 `YOUR_DIRECTORY` 替换为系统中实际存在的文件夹路径。 + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +在命令行运行脚本： + +```bash +python generate_datamatrix.py +``` + +您应看到类似以下的控制台输出： + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## 验证结果 + +确认条码正确编码俄文短语的步骤： + +1. 在图像查看器中打开 PNG 文件。 +2. 使用任意 DataMatrix 扫描应用（许多移动应用均支持）或硬件扫描仪。 +3. 解码后的字符串应显示为 `ABC123Привет`（或根据扫描器 UI 将两部分分开显示）。 + +如果俄文字符出现乱码，请再次确认扫描仪支持 ECI UTF‑8。大多数现代读取器都支持，但旧设备可能需要显式配置。 + +## 常见问题及解决方案 + +| 问题 | 原因 | 解决方案 | +|------|------|----------| +| 西里尔字符乱码 | 缺少 ECI 指示符 | 使用 `add_eci_codetext` 并将 `eci_encoding=3` | +| 条码对打印机太小 | 默认模块尺寸对低 DPI 打印机过细 | 增大 `x_dimension`（例如 `3.0` 或 `4.0`） | +| 文件未保存 | 目录路径无效 | 确认 `YOUR_DIRECTORY` 存在且可写 | +| 扫描仪无法读取 | 数据密度过高 | 减少编码数据量或提升错误纠正级别 (`generator.parameters.barcode.error_correction_level`) | + +## 扩展示例 + +您可以将此模式用于其他语言或数据类型： + +* **编码日文或阿拉伯文** – 将 `eci_encoding` 改为相应的值（例如 ISO‑8859‑5 为 5，ISO‑8859‑7 为 6）。 +* **添加多个 ECI 段** – 多次调用 `add_eci_codetext`，每次使用不同的编码。 +* **改为生成 QR 码** – 将 `EncodeTypes.DATA_MATRIX` 替换为 `EncodeTypes.QR`。 + +其他步骤保持不变，因为 `ExtCodetextBuilder` 已抽象了底层字节处理。 + +## 结论 + +现在，您已经掌握了如何在 Python 中使用 Aspose.BarCode 的扩展 codetext 功能 **生成 DataMatrix 条码** 并 **对俄文文本进行编码**。完整脚本仅用几行代码就完成了字符集协商、条码创建和图像输出。 + +接下来，您可以探索其他条码符号（PDF417、Aztec），或将生成器集成到返回 PNG 图像的 Web 服务中。同样的原理——构建扩展 codetext 并选择合适的 `EncodeTypes`——在整个 Aspose.BarCode 套件中均适用。 + +祝编码愉快，尽情享受多语言条码生成的强大功能！ + +## 接下来您应该学习什么？ + +以下教程涵盖与本指南技术紧密相关的主题，帮助您进一步掌握 API 功能并在项目中探索替代实现方式，每篇资源均提供完整可运行的代码示例和逐步说明。 + +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) +- [Generate a DataMatrix barcode in ASCII mode with Aspose.BarCode for .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [How to Generate DataMatrix Barcodes (ECC 200) with Aspose.BarCode for .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/czech/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/czech/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..fecbd24f9 --- /dev/null +++ b/barcode/czech/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Naučte se generovat DataMatrix čárový kód v Pythonu a kódovat ruský text + pomocí Aspose.BarCode – krok za krokem průvodce. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: cs +lastmod: 2026-08-22 +og_description: Vygenerujte DataMatrix čárový kód v Pythonu a zakódujte ruský text + pomocí Aspose.BarCode. Postupujte podle kompletního příkladu a spusťte jej okamžitě. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Generování čárového kódu DataMatrix v Pythonu – kompletní tutoriál Aspose.BarCode +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Jak v Pythonu generovat DataMatrix čárový kód pomocí Aspose.BarCode +url: /cs/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak vygenerovat DataMatrix čárový kód v Pythonu s Aspose.BarCode + +Pokud potřebujete **vygenerovat DataMatrix čárový kód** v Pythonu a **zakódovat ruský text**, tento návod vám ukáže přesné kroky. Uvidíte kompletní, spustitelný příklad, který vytvoří rozšířený kódový text, nakonfiguruje čárový kód a uloží obrázek v jediném skriptu. + +Vytváření čárových kódů obsahujících ne‑ASCII znaky často vyvolává otázky ohledně znakových sad a kódování dat. Pomocí `ExtCodetextBuilder` z Aspose.BarCode můžete bezpečně vložit UTF‑8 text, například cyrilické znaky, do symbolu DataMatrix. Výsledek funguje s jakýmkoli skenerem, který podporuje standard DataMatrix. + +V tomto tutoriálu se naučíte: + +* Nainstalovat požadovaný balíček Aspose.BarCode. +* Vytvořit rozšířený kódový text, který kombinuje prostá data a ruský text. +* **Vygenerovat DataMatrix čárový kód** s rozšířeným řetězcem. +* Upravit parametry čárového kódu, jako je velikost modulu. +* Uložit čárový kód jako PNG soubor. + +Žádné externí služby nejsou potřeba; vše běží lokálně na vašem počítači. + +## Požadavky + +Než začnete, ujistěte se, že máte: + +* Python 3.8 nebo novější nainstalovaný. +* Aktivní licenci Aspose.BarCode pro Python (bezplatná zkušební verze stačí pro vývoj). +* Základní znalosti skriptování v Pythonu. + +Knihovnu Aspose.BarCode můžete nainstalovat pomocí pip: + +```bash +pip install aspose-barcode +``` + +## Krok 1: Vytvořit rozšířený řetězec kódového textu + +Prvním úkolem je vytvořit jeden řetězec, který obsahuje jak prostý identifikátor produktu, tak ruskou frázi. `ExtCodetextBuilder` vám umožní spojit různé části kódového textu a zachovat informace o jejich kódování. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Proč je tento krok důležitý** – Symboly DataMatrix ukládají surové bajty. Když potřebujete kombinovat různé abecedy, musíte kodéru říct, která znaková sada platí pro každý segment. Metoda `add_eci_codetext` vloží před ruský text indikátor ECI, což zajistí, že skenery interpretují bajty jako UTF‑8. Bez ECI by se cyrilické znaky zobrazily jako poškozená data. + +## Krok 2: Vytvořit generátor DataMatrix čárového kódu + +Jakmile máte rozšířený kódový text připravený, vytvořte instanci `BarcodeGenerator` a specifikujte typ `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Proč DataMatrix?** – DataMatrix je dvourozměrný čárový kód, který může uložit až 2 335 alfanumerických znaků nebo 1 556 bajtů. Je ideální pro malé položky, průmyslové součásti a situace, kde potřebujete vložit vícejazyčný text. + +## Krok 3: (Volitelné) Konfigurace parametrů čárového kódu + +Aspose.BarCode nabízí mnoho parametrů. Pro většinu případů výchozí nastavení vytvoří čitelný symbol. Přesto můžete chtít ovládat velikost každého modulu (nejmenší čtvereček v mřížce), aby odpovídala požadavkům tisku. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Další užitečné parametry zahrnují úroveň korekce chyb, okraj a barvu pozadí. Upravujte je jen tehdy, když vaše cílové skenovací prostředí vyžaduje konkrétní tolerance. + +## Krok 4: Uložit obrázek čárového kódu + +Nakonec zapište čárový kód do souboru. Metoda `save` podporuje PNG, JPEG, BMP a několik vektorových formátů. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Když otevřete `extended_codetext.png`, uvidíte ostrý DataMatrix symbol. Skenováním standardním čtečkou DataMatrix získáte dvě části: + +1. **ABC123** – prostý identifikátor. +2. **Привет** – ruský pozdrav, správně dekódovaný jako UTF‑8. + +## Kompletní, spustitelný příklad + +Níže je celý skript, který můžete zkopírovat do souboru pojmenovaného `generate_datamatrix.py`. Nahraďte `YOUR_DIRECTORY` existujícím adresářem ve vašem systému. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Spusťte skript z příkazové řádky: + +```bash +python generate_datamatrix.py +``` + +Měli byste vidět výstup v konzoli podobný tomuto: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Ověření výsledku + +Pro potvrzení, že čárový kód správně kóduje ruskou frázi: + +1. Otevřete PNG soubor v prohlížeči obrázků. +2. Použijte libovolnou aplikaci pro skenování DataMatrix (mnoho mobilních aplikací to podporuje) nebo hardwarový skener. +3. Dekódovaný řetězec by měl zobrazit `ABC123Привет` (nebo dvě části oddělené podle UI skeneru). + +Pokud se ruské znaky zobrazí jako nesmyslné, zkontrolujte, že skener podporuje ECI UTF‑8. Většina moderních čteček to podporuje, ale starší zařízení mohou vyžadovat explicitní nastavení. + +## Časté problémy a jak se jim vyhnout + +| Problém | Příčina | Řešení | +|-------|-------|-----| +| Zkreslený cyrilický výstup | Chybějící indikátor ECI | Použijte `add_eci_codetext` s `eci_encoding=3`. | +| Čárový kód příliš malý pro tiskárnu | Výchozí velikost modulu příliš jemná pro nízké DPI | Zvyšte `x_dimension` (např. `3.0` nebo `4.0`). | +| Soubor se neuložil | Neplatná cesta adresáře | Ujistěte se, že `YOUR_DIRECTORY` existuje a je zapisovatelný. | +| Skener nedokáže přečíst | Přehnaná hustota dat | Snižte množství kódovaných dat nebo zvyšte úroveň korekce chyb (`generator.parameters.barcode.error_correction_level`). | + +## Rozšíření příkladu + +Můžete tento vzor přizpůsobit pro jiné jazyky nebo typy dat: + +* **Kódovat japonský nebo arabský text** – změňte `eci_encoding` na odpovídající hodnotu (např. 5 pro ISO‑8859‑5, 6 pro ISO‑8859‑7). +* **Přidat více ECI segmentů** – zavolejte `add_eci_codetext` vícekrát, každý s vlastní znakovou sadou. +* **Vytvořit QR kód místo toho** – nahraďte `EncodeTypes.DATA_MATRIX` za `EncodeTypes.QR`. + +Všechny ostatní kroky zůstávají stejné, protože `ExtCodetextBuilder` abstrahuje nízkoúrovňové zpracování bajtů. + +## Závěr + +Nyní víte, jak **vygenerovat DataMatrix čárový kód** v Pythonu a **zakódovat ruský text** pomocí rozšířené funkce kódového textu v Aspose.BarCode. Kompletní skript řeší vyjednávání znakových sad, tvorbu čárového kódu a výstup obrázku během několika řádků kódu. + +Dále můžete prozkoumat další symbologie čárových kódů (PDF417, Aztec) nebo integrovat generátor do webové služby, která na vyžádání vrací PNG obrázky. Stejné principy – tvorba rozšířeného kódového textu a výběr vhodného `EncodeTypes` – platí napříč celým portfoliem Aspose.BarCode. + +Šťastné programování a užijte si sílu vícejazyčného generování čárových kódů! + +## Co byste se měli naučit dál? + +Následující tutoriály pokrývají úzce související témata, která staví na technikách předvedených v tomto průvodci. Každý zdroj obsahuje kompletní funkční příklady kódu s podrobnými vysvětleními, aby vám pomohl zvládnout další funkce API a prozkoumat alternativní implementační přístupy ve vašich projektech. + +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) +- [Generate a DataMatrix barcode in ASCII mode with Aspose.BarCode for .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [How to Generate DataMatrix Barcodes (ECC 200) with Aspose.BarCode for .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/dutch/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/dutch/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..511b64647 --- /dev/null +++ b/barcode/dutch/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Leer hoe je een DataMatrix‑barcode genereert in Python en Russische tekst + codeert met Aspose.BarCode – stapsgewijze handleiding. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: nl +lastmod: 2026-08-22 +og_description: Genereer een DataMatrix-barcode in Python en codeer Russische tekst + met Aspose.BarCode. Volg het volledige voorbeeld en voer het meteen uit. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Genereer DataMatrix-barcode in Python – volledige Aspose.BarCode-tutorial +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Hoe DataMatrix-barcode te genereren in Python met Aspose.BarCode +url: /nl/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hoe DataMatrix-barcode te genereren in Python met Aspose.BarCode + +Als je een **DataMatrix-barcode wilt genereren** in Python terwijl je **Russische tekst codeert**, laat deze gids je de exacte stappen zien. Je ziet een volledig, uitvoerbaar voorbeeld dat een uitgebreide codetext opbouwt, de barcode configureert en de afbeelding opslaat in één script. + +Het maken van barcodes die niet‑ASCII tekens bevatten, roept vaak vragen op over tekensets en data‑codering. Door gebruik te maken van Aspose.BarCode’s `ExtCodetextBuilder`, kun je veilig UTF‑8‑tekst zoals Cyrillische tekens in een DataMatrix‑symbool insluiten. Het resultaat werkt met elke scanner die de DataMatrix‑standaard ondersteunt. + +In deze tutorial zul je: + +* Het vereiste Aspose.BarCode‑pakket installeren. +* Een uitgebreide codetext bouwen die gewone data en Russische tekst combineert. +* **DataMatrix-barcode genereren** met de uitgebreide string. +* Barcode‑parameters aanpassen zoals module‑grootte. +* De barcode opslaan als een PNG‑bestand. + +Er zijn geen externe services nodig; alles draait lokaal op je machine. + +## Vereisten + +Voordat je begint, zorg ervoor dat je het volgende hebt: + +* Python 3.8 of nieuwer geïnstalleerd. +* Een actieve Aspose.BarCode‑licentie voor Python (een gratis proefversie werkt voor ontwikkeling). +* Basiskennis van Python‑scripting. + +Je kunt de Aspose.BarCode‑bibliotheek installeren via pip: + +```bash +pip install aspose-barcode +``` + +## Stap 1: Een uitgebreide codetext‑string bouwen + +De eerste taak is om een enkele string te maken die zowel de gewone product‑identificatie als de Russische zin bevat. `ExtCodetextBuilder` laat je verschillende codetext‑delen aan elkaar plakken terwijl de coderingsinformatie behouden blijft. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Waarom deze stap belangrijk is** – DataMatrix‑symbolen slaan ruwe bytes op. Wanneer je alfabetten moet combineren, moet je de encoder vertellen welke tekenset op elk segment van toepassing is. De `add_eci_codetext`‑methode voegt een ECI‑indicator toe vóór de Russische tekst, waardoor scanners de bytes interpreteren als UTF‑8. Zonder ECI zouden de Cyrillische tekens als onleesbare data verschijnen. + +## Stap 2: Een DataMatrix‑barcode‑generator maken + +Met de uitgebreide codetext klaar, maak je een `BarcodeGenerator` aan en specificeer je het type `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Waarom DataMatrix?** – DataMatrix is een tweedimensionale barcode die tot 2.335 alfanumerieke tekens of 1.556 bytes kan opslaan. Het is ideaal voor kleine objecten, industriële onderdelen en situaties waarin je meertalige tekst moet insluiten. + +## Stap 3: (Optioneel) Barcode‑parameters configureren + +Aspose.BarCode biedt veel parameters. Voor de meeste toepassingen leveren de standaardinstellingen een leesbaar symbool op. Je wilt echter mogelijk de grootte van elke module (het kleinste vierkant in de matrix) aanpassen om aan de printvereisten te voldoen. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Andere nuttige parameters zijn onder meer het foutcorrectieniveau, de marge en de achtergrondkleur. Pas ze alleen aan als je doel‑scanomgeving specifieke toleranties vereist. + +## Stap 4: De barcode‑afbeelding opslaan + +Schrijf tenslotte de barcode naar een bestand. De `save`‑methode ondersteunt PNG, JPEG, BMP en verschillende vectorformaten. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Wanneer je `extended_codetext.png` opent, zie je een scherp DataMatrix‑symbool. Het scannen ervan met een standaard DataMatrix‑lezer geeft de twee delen terug: + +1. **ABC123** – de gewone identificatie. +2. **Привет** – de Russische groet, correct gedecodeerd als UTF‑8. + +## Volledig, uitvoerbaar voorbeeld + +Hieronder staat het volledige script dat je kunt kopiëren‑plakken in een bestand met de naam `generate_datamatrix.py`. Vervang `YOUR_DIRECTORY` door een bestaande map op je systeem. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Voer het script uit vanaf de opdrachtregel: + +```bash +python generate_datamatrix.py +``` + +Je zou console‑output moeten zien die lijkt op: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Het resultaat verifiëren + +Om te bevestigen dat de barcode de Russische zin correct codeert: + +1. Open het PNG‑bestand in een afbeeldingsviewer. +2. Gebruik een DataMatrix‑scanapp (veel mobiele apps ondersteunen dit) of een hardware‑scanner. +3. De gedecodeerde string moet `ABC123Привет` weergeven (of de twee delen gescheiden, afhankelijk van de scanner‑UI). + +Als de Russische tekens als onzin verschijnen, controleer dan of de scanner ECI UTF‑8 ondersteunt. De meeste moderne lezers doen dat, maar oudere apparaten hebben mogelijk expliciete configuratie nodig. + +## Veelvoorkomende valkuilen en hoe ze te vermijden + +| Probleem | Oorzaak | Oplossing | +|-------|-------|-----| +| Vervormde Cyrillische output | Ontbrekende ECI‑indicator | Gebruik `add_eci_codetext` met `eci_encoding=3`. | +| Barcode te klein voor printer | Standaard module‑grootte te fijn voor lage DPI | Verhoog `x_dimension` (bijv. `3.0` of `4.0`). | +| Bestand niet opgeslagen | Ongeldig mappad | Zorg dat `YOUR_DIRECTORY` bestaat en schrijfbaar is. | +| Scanner kan niet lezen | Overmatige datadichtheid | Verminder de hoeveelheid gecodeerde data of verhoog het foutcorrectieniveau (`generator.parameters.barcode.error_correction_level`). | + +## Het voorbeeld uitbreiden + +Je kunt dit patroon aanpassen voor andere talen of datatypes: + +* **Japanse of Arabische tekst coderen** – wijzig `eci_encoding` naar de juiste waarde (bijv. 5 voor ISO‑8859‑5, 6 voor ISO‑8859‑7). +* **Meerdere ECI‑segmenten toevoegen** – roep `add_eci_codetext` meerdere keren aan, elk met zijn eigen codering. +* **In plaats daarvan een QR‑code maken** – vervang `EncodeTypes.DATA_MATRIX` door `EncodeTypes.QR`. + +Alle andere stappen blijven identiek omdat de `ExtCodetextBuilder` de low‑level byte‑afhandeling abstraheert. + +## Conclusie + +Je weet nu hoe je **DataMatrix‑barcode kunt genereren** in Python en **Russische tekst kunt coderen** met de uitgebreide codetext‑functie van Aspose.BarCode. Het volledige script behandelt tekenset‑onderhandeling, barcode‑creatie en afbeeldingsoutput met slechts een paar regels code. + +Verken vervolgens andere barcode‑symbologieën (PDF417, Aztec) of integreer de generator in een webservice die PNG‑afbeeldingen op aanvraag retourneert. Dezelfde principes — het bouwen van een uitgebreide codetext en het selecteren van de juiste `EncodeTypes` — zijn van toepassing op de volledige Aspose.BarCode‑suite. + +Veel programmeerplezier, en geniet van de kracht van meertalige barcode‑generatie! + +## Wat moet je hierna leren? + +De volgende tutorials behandelen nauw verwante onderwerpen die voortbouwen op de technieken die in deze gids worden gedemonstreerd. Elke bron bevat volledige werkende code‑voorbeelden met stapsgewijze uitleg om je te helpen extra API‑functies onder de knie te krijgen en alternatieve implementatie‑benaderingen in je eigen projecten te verkennen. + +- [Hoe DataMatrix‑barcodes te genereren met Aspose.BarCode voor .NET – Stapsgewijze gids](/barcode/english/net/datamatrix-barcode-configuration/) +- [Genereer een DataMatrix‑barcode in ASCII‑modus met Aspose.BarCode voor .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [Hoe DataMatrix‑barcodes (ECC 200) te genereren met Aspose.BarCode voor .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/english/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/english/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..a891c14d6 --- /dev/null +++ b/barcode/english/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,250 @@ +--- +category: general +date: 2026-08-22 +description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: en +lastmod: 2026-08-22 +og_description: Generate DataMatrix barcode in Python and encode Russian text with + Aspose.BarCode. Follow the full example and run it instantly. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Generate DataMatrix barcode in Python – complete Aspose.BarCode tutorial +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: How to generate DataMatrix barcode in Python with Aspose.BarCode +url: /python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# How to generate DataMatrix barcode in Python with Aspose.BarCode + +If you need to **generate DataMatrix barcode** in Python while **encoding Russian text**, this guide shows you the exact steps. You’ll see a complete, runnable example that builds an extended codetext, configures the barcode, and saves the image in a single script. + +Creating barcodes that contain non‑ASCII characters often raises questions about character sets and data encoding. By using Aspose.BarCode’s `ExtCodetextBuilder`, you can safely embed UTF‑8 text such as Cyrillic characters inside a DataMatrix symbol. The result works with any scanner that supports the DataMatrix standard. + +In this tutorial you will: + +* Install the required Aspose.BarCode package. +* Build an extended codetext that mixes plain data and Russian text. +* **Generate DataMatrix barcode** with the extended string. +* Adjust barcode parameters like module size. +* Save the barcode as a PNG file. + +No external services are required; everything runs locally on your machine. + +## Prerequisites + +Before you start, make sure you have: + +* Python 3.8 or newer installed. +* An active Aspose.BarCode for Python license (a free trial works for development). +* Basic familiarity with Python scripting. + +You can install the Aspose.BarCode library via pip: + +```bash +pip install aspose-barcode +``` + +## Step 1: Build an extended codetext string + +The first task is to create a single string that contains both the plain product identifier and the Russian phrase. `ExtCodetextBuilder` lets you concatenate different codetext parts while preserving their encoding information. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Why this step matters** – DataMatrix symbols store raw bytes. When you need to mix alphabets, you must tell the encoder which character set applies to each segment. The `add_eci_codetext` method inserts an ECI indicator before the Russian text, ensuring that scanners interpret the bytes as UTF‑8. Without ECI, the Cyrillic characters would appear as garbled data. + +## Step 2: Create a DataMatrix barcode generator + +With the extended codetext ready, instantiate a `BarcodeGenerator` specifying the `EncodeTypes.DATA_MATRIX` type. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Why DataMatrix?** – DataMatrix is a two‑dimensional barcode that can store up to 2,335 alphanumeric characters or 1,556 bytes. It’s ideal for small items, industrial parts, and situations where you need to embed multilingual text. + +## Step 3: (Optional) Configure barcode parameters + +Aspose.BarCode exposes many parameters. For most use cases, the default settings produce a readable symbol. However, you may want to control the size of each module (the smallest square in the matrix) to match printing requirements. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Other useful parameters include error correction level, margin, and background color. Adjust them only if your target scanning environment demands specific tolerances. + +## Step 4: Save the barcode image + +Finally, write the barcode to a file. The `save` method supports PNG, JPEG, BMP, and several vector formats. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +When you open `extended_codetext.png`, you’ll see a crisp DataMatrix symbol. Scanning it with a standard DataMatrix reader returns the two parts: + +1. **ABC123** – the plain identifier. +2. **Привет** – the Russian greeting, correctly decoded as UTF‑8. + +## Full, runnable example + +Below is the complete script you can copy‑paste into a file named `generate_datamatrix.py`. Replace `YOUR_DIRECTORY` with an existing folder on your system. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Run the script from the command line: + +```bash +python generate_datamatrix.py +``` + +You should see console output similar to: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Verifying the result + +To confirm that the barcode correctly encodes the Russian phrase: + +1. Open the PNG file in an image viewer. +2. Use any DataMatrix scanning app (many mobile apps support it) or a hardware scanner. +3. The decoded string should display `ABC123Привет` (or the two parts separated depending on the scanner UI). + +If the Russian characters appear as gibberish, double‑check that the scanner supports ECI UTF‑8. Most modern readers do, but legacy devices may need explicit configuration. + +## Common pitfalls and how to avoid them + +| Issue | Cause | Fix | +|-------|-------|-----| +| Garbled Cyrillic output | Missing ECI indicator | Use `add_eci_codetext` with `eci_encoding=3`. | +| Barcode too small for printer | Default module size too fine for low DPI | Increase `x_dimension` (e.g., `3.0` or `4.0`). | +| File not saved | Invalid directory path | Ensure `YOUR_DIRECTORY` exists and is writable. | +| Scanner cannot read | Excessive data density | Reduce the amount of encoded data or increase error correction level (`generator.parameters.barcode.error_correction_level`). | + +## Extending the example + +You can adapt this pattern for other languages or data types: + +* **Encode Japanese or Arabic text** – change `eci_encoding` to the appropriate value (e.g., 5 for ISO‑8859‑5, 6 for ISO‑8859‑7). +* **Add multiple ECI segments** – call `add_eci_codetext` multiple times, each with its own encoding. +* **Create a QR code instead** – replace `EncodeTypes.DATA_MATRIX` with `EncodeTypes.QR`. + +All other steps remain identical because the `ExtCodetextBuilder` abstracts the low‑level byte handling. + +## Conclusion + +You now know how to **generate DataMatrix barcode** in Python and **encode Russian text** using Aspose.BarCode’s extended codetext feature. The complete script handles character‑set negotiation, barcode creation, and image output with just a few lines of code. + +Next, explore other barcode symbologies (PDF417, Aztec) or integrate the generator into a web service that returns PNG images on demand. The same principles—building an extended codetext and selecting the appropriate `EncodeTypes`—apply across the entire Aspose.BarCode suite. + +Happy coding, and enjoy the power of multilingual barcode generation! + + +## What Should You Learn Next? + + +The following tutorials cover closely related topics that build on the techniques demonstrated in this guide. Each resource includes complete working code examples with step-by-step explanations to help you master additional API features and explore alternative implementation approaches in your own projects. + +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) +- [Generate a DataMatrix barcode in ASCII mode with Aspose.BarCode for .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [How to Generate DataMatrix Barcodes (ECC 200) with Aspose.BarCode for .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/english/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/og-image.png b/barcode/english/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/og-image.png new file mode 100644 index 0000000000000000000000000000000000000000..671ee80f484fdd26968d0f15b3b007d865806be1 GIT binary patch literal 48952 zcmbTd1yEc|)HMpp#ezc;f;O-WJyE_9U5D1>&?ykX|3Bd<3L0Vi?&0}tF(OnOJlN{xU*5v2ql5S8aU6rV)<6&!=>(uB}q+u}W)Pa$$ z^m@Sc3&+<_7-U6E4u9bE9!AYPkCFW#hWEs0iPaD^+T8E#J}fxAc-rcHz^l`x z<}TKCpht}eybuAwKT`Io_MbZhe}A06H#j(tjRCGFVt@aNh@k$xK}G%h6apgU-vSDX zfBxS56ZrRU=F+R)KTj{8PWau|P}CNq(Nme`F8ok=iK6)D>E(#{!V%~PLV7CLMLPT6 zSA4IdE}prdQ;~#xXtY(8{2yM2`YrNfR^eOb@9e-2ZBzbxwoI^iCjP%?PNq2p zEjG%ezWm!*J~jc$zpeaV^kZb{ZRc<{rTgDr{r{@sf3~NRGe)JeMK8&p%KalT{u%}W z;s0*<%%?^afQta*Hmv$^KK^B*m?k$o_J@;{j5f*NUi$OsWQ+L$CJ&FD_lDq&FyuF> z4*e81{5t*`cua&g92x2PN%)gLgHlH?8$|o>z@hElYa$E{wk1aw#Abpkoujl;d7XCwlqm-8n=0C}>m|e)q z_LlXPPw+hH$lt3Hn>>0+jWy{J8fCWVmW__;1}^67cx0gPpFj)3r!L*mQ69)|AKi?C zLYxzIgs@-uHDTwU#*)%LmQaA0MKA&qAAQ#UW2`dp2e|&W9Vq#~`|>{dQ|-)+Gaj0e zv+&}LtCJmT_0#tVGB4C?dsv~k$%R>><5QoKQeJuR&1)qS(z`{lo`h8_%4|Fc7W>&# zJ=G^c`uByIEXm0pT(x`2bJ?W}*<|UFZ3YTe`A5T*7I5;D`#*z>g9B0Yn}462?*=P9 z$o;%n7lKejrJq_B0BSz+$jxnG*ievBmnWrMH?peBOUkNke0zcd)SlV;i$8Fu+)7jg zR>QJ&foAnhlFF?62EM3|q?&FH7OQ(~K@HUw`!j^HPiEPySIybQ@i5ssqC`ZT@P+Q~{HNw?#0?RF-wl?At|egC5~g3ELUMz?iOGWx-oKYANNwe_Ucd$$V`*!&w{KQZkVCB{xz*a) z-tkaT}DW1zaNn1 z8rig$RM;{MtqC=aI(QnY_Q^_vqwQRoY2Z*HNqN(Y6uEk*b;p^ABKIBahuPRuHIF=2Hp~}yk!|LwDL7A-2ER5B7tJgT460& z_k#=QC&`WQC1ngS{9G5js>e^qU0&@rb$`Jozj@w4lAKPdKm7e*ebC`h`}E!gt(jtQ zCs$F=``~im8(IZ{vE^GYsqO2)$veJ!PY-(eeCcXQOlRG+;W}$A-unbJH+@c87o#hQ zNjO_hmq7zjJQiPu-Q-V~JA3GU)6cyoi+5g=@T+)%9`}p-Qs0<=Zig_4CEPE|uD!kt z70hq3R5&M^*|Zbga1RbN9aLPdGdVLB+@#$P>tD8jdf=p2;vYL`00DDN0IR^Y|&y$tUk*oIcJ#2nH%Y-%uPVmGM@Gmn?i; z+#-37@98MP}H&hf*MODzl~ z@cL`sWbHXHZV?gkycIHmFJsaZO3HG|c!ig|fn~~aIoi*=5KoLu*qan{XV>Z!YB@1x z5_IE9*6fnfLj^oUzwJ2)b&aKwe;k#60!J7IzT(@m2&UB zAGeU-uZ*#)*XqgN-zQH>XL!6{=(`aV1{=_cTgGW}|IUXJ zsK{}eVYY!TzqhhY_v+Kc+(K`!NPSCHP!H8`mBIO$8-$q-=0uD}naq?QP@7b0T~o(~ zcURW;=_G)MJ6IOga+y0`eFAlgQA^HHQ&v;Aq^T|)M@378UN!mAlBlSo4@I?G28e+; zLz7SMELOn3md{>J9eEPPM{*j=ivAQuUC~>j(r;naVceGI)-;B?k? z6t;rM(7>N2-P3Sy2*K3j`l^VTD->=zc{klT9}EpZn45E=gUW|&El;lzvtpB`R*4AP zKxmYhJdtSG?bFswj23du{ab`tD+}_!brUc$j;2#a_Yi7Nu1?&KBB;brE2_kCFyZ|7 zXlNwaMm8+=jjEP|lOvgymQ_r07y^1WrAv2gtqEcKgD8qU#=O>JXYPV5Prb{Hio`qr@8csBs(s+%Wta39W%&UBGVAj#7BJb|J-BEFz_QAQDOSpgfT}K^_(av`4d%THUBH26~G^X zEg*t*jEIArCx2;WshQz9YhOLzHom=A5zSm4+Dx|B)o+f{ITF{l3NJ;f-QOu)O{k+-FO0IEH%|M)J zCa`Bb_3Xz+FH&^$=ES5Af7}Xb=N6%;`+hqHVS8w5Z%IWNv{G!VFOH-nhV__72lfyN zer=jx+ad|)pi2&#(GU)povWglKZf;jx856%a4nFOr3(yG2QGLWg+mP|CO!;zDk)a- zwwsJZV7l}(Sff%_g!Utimssyw?-*dyS{qsUR}&!kpD`fGkIIU?kQzp zKJ}dhJ0`mKHoheTNPMc~h9XD&m0}~EuQckY!wF6OaEPuXVNZR)u~V(Q^f2rg?(IN(>D`3+NX!$<=W&*N`S=+u-L8s}C)z%?n!A?Ct zr1ZzbC$ehjo8Hc0rD*`85;;VVj7EcNPZ%tHE(o;Y+8sWOR@ec8I{u3(V;6&%I zCIsSWbpDeZKa_$f`hIQPJ5X}mpeFiYSyW4hXi7n6T-Y4bQ}#xjXjSnT5@vx+17L-` z=5q=Rn!#Q@=QFXv6=yWcR1RI(%yReMbFpt54VS=t<76gHu0-OnsX5r3M{E7M$-qZ$ zJCb~Ywm5Fs(HS~I$oZZ_V_iJRoq{sA=BQZQ0zWKZ>M4zD+{>L`kT zYjd+#!_1b2^_UJ%X_z5TLi>tf>fV5BEf*K31x8a)R$F93$$l@qb>EbH;yFSlKHh#( zeqo!{ztdK`YG}zcHpLB;vRcVbCZX=K2=Fec?k!h@9jH7D|>h~v3o1qF{iPskq1ZEYDcfnz#ajb`b#)| zp@i&Wzp*XNxJwQ0wK_JR+21YpM_7iG>7~_#@NjW2yz3_74t~JchYFNc=-=W-o!(I9 z0;~E7Q3}zn2Fu8`3CChl$wjl@Gv@9RIy?FkyHfqy51ZAtL@zJIgg0rRv6ia*81F%8 z_1$N2=bBR+k{C_M^_3wws|Oa$O$aff*gGp^6CL_4@d34jFd`}JqXNBzyrdtn6soj3 zA$bJ;(Uk+{OF{yAe zkOkk3JWL`&x^geaIuUn``r+q6{dIUIWw^mTfc`lJ*YY9J`I_2*5xExlXpLlZ_0rBl zrfuO>#}Y)0PG5rZs46}$CPx1fy3nlp;&402UdiK=kEIL@)$atprM1$8Uh0KC-$xGAg{LcNK$^HM{4Df zSlJKCN-C=&$AcXIHfkPHe9i!rTSRewM?y&BrV*#1pnZ%G0p5rr8gczGtap(lHCH11 z;%J&V9#b(_{L!CKJOC(0*pc4j53F%(;J_lVGN7Od9D=NfMfglkp(;nTSp4CZEH?Rc z5|o48u0G-;P?JACgM*W8is8?W{diwI{#Ka(^Tpf8djyd%HVECHyZ;55<$s~@+nm;- zm-Nqr{#gGjeg;<*t~s~unLu}+U1YKAkOKWtZP z!N0^xu5AcIo#21O3hw_v!9B^Q(xS7HL;pYC{fDyq|By17>T<3HsVfeZFAF68r!I(? z{}y=(d?`Y^vbyKON~z)EWu&Z3aF{;hWO19%8=#z;A;H@}I@p|@jhFWv2S)~Wa;@5W zPZz4MpkQ}tAj%B)*;x;{0AaCL(IkvwQ#kX?=cv zeoJ0hSTS(4@b)8(Rx|FCJI^y z#Uf_qeZBrk8SujxV2!9--lIa;oo`}Kvh_y&Ql=gv1`uPfBL`<@EV^sxHxAxem@i39 zT{vj{a_whrZB0x}teu#GbaRP?j!7n9;U8E(jVyV7>)WN70XoKvj9gese(MS&_v7K_ zRvB`2cKvZ8*ikpXTPOUCFlknD<6^)1&BzFQd!G1Ul&g2SVH(jRW9Of`v$JE+HsE)} zX1Nx>&#{ya<)E?Ls$CF=neCO%tIe#w_c z_G*Ox4IKsB2y|&^XlAB&rnfNbv#N%Mfev7To3o9wz?p`W;c<@dn)`2M%b1uYqln(x z^omGHp~%XH0dM~D<#$gXeUD;#n-h#Lr9-(_$AVMG9-Q7TibyGn7>R||P1D`oEg7L_ zCoOHM?AX_Oi*4W8Z5Y*c3xz~9 zUtbzBa%nR`Onu=i^WTM(V}~0i?zRg1HU>erWgOC)VnQT;4y914zkVLv#Y9FT3UVuLK^gJw8j-qn|=m}q>?tKYZIT#30^Z+CP@x8bec`h4zU z7N2Yu23K-uLs@J-W@cP-hA0%E%Y#9*jw2&)o!0LLwpBGAj!S%`%Brd$?UTAl+H*2; zG;51phdw9AD$Mfo5Tuh+Ll7Jmx<;$W@hW`vP7Y#9ve+aeglk=;6+;v0?SA~kokz28 zUR7Ve)pJ)EXjHsUp1Y%4Q-a73+OHB_`YqmgV%awmcXw;gcr*zh89ba0JT`MTgYLp1 zyCqW_^U$tE+qEXJ*Ub$o^U>yxE7a#QX4%hvv0-(4RwAFuKwTZQJ`+OjtD~)^S6anh zafG3E9OBYl)93eaozl=)y}=~lds4II!X?c23@Tvh)SUUVckFk|^>ebQO@bL(Dh}D? zG?2QIg{dWFa;Z|Q1*?=O<>u#?__$Z=IhP5bi^{ENiLNfnm8YGg<8N~$ZJ<>OE`alg z5OK0^J60{IS9LLGaGS1%!uki~#!6&ZPKXIZW}%Uhhv3&$J$gMzw8D4#-; zc=(w(wIK4CQ6x+&ICQm@?I!H;ZOvP2QA-5w)l9UsmocV>8T@|IWklG|So3V>-yu4V zn5wk{eedkiySeUpF_tQiO8EnKr3Y(&vC1)`yqpF0#2xQ&YHCUaIdt{OhtZH$@5^if z#IOG#g-Qkle&0%Lz)H<4%PK1aoh_$VfUnf_I6t6P*452by53(hwnaDZ#uo&8pT#+s zJY3aw;qy_7D=HoaToOPd!E^PBi3|03;Om{!4ivW#{uMYeGV4s6X&NUvw$kwhzSxty zdzK7g`nmAsLw!c`)e21V{Ol-DiO|y*cGKzivF;`U2|La`t5b_F=e_xvQ6E$TJ7&ZyCebvarE^UGujN>%r{@Y3@Zvk5}E2SH#hgb zxoQVid0BGIIwRxvnwpoLKkf~E;KGih6qKDyOLow5+kWs}DTg6{?A$xVe*ziUEq~9T zn@95V^7YI{0cS*!e=h(X} zGsO{ybqTcinR{q`<3wlG=6slk8TMAjXT3)@Xm*jDBCg4&p^?HqNI$*6m{n|8uTTdw zf$V>9qDPSkxwN;;TGieM;z*&~-Z$5)YM>yob92wNd4j|Z^S}@JHyCQsaV4F;Rsx)F zdS_+|1<6P!?G4~1nwvw0c**ZvuyDu{4jp~Yr2<~rLR7P6>m7Psp2SVuAoE30Ji zQS0y5p#=u-k+BnbL7^76t{ut3;o%q(3BtZ7XH)ylu~T+505afmtx_WmLctE7YXrrx z>kOCCBUF*K39V!~PO}F6gHjjP9Yho6y8erWzWxI6jfyKTZSyuax+2FXsHp0>iXL0Z zVBdt>?v#|0{?CH*t}ZUQ7{i>LoL`>YeWe-Ob{P%vF;c4}hksJ z$nsF`u4E{ytI2O(@xz!_wXI*KV7%Vez}(0#za?T~bTo<0F8sy@+?b^8pyXfb-M+#p z-qY!O+rg@8HgJI*>2P{hTLpB@&CTH)>)CGo$I)8?R>K$dO`gt6I|E1}G(1IKJV)0T zTT5+`3dD8>0}&18!{c9RhAgM7Cnh>g&I(t=&`J2+s!B^+NcYVc=Odj`QF5P?;@{q8 zSc@0z?(EoUT^1}W>uTCpuqJ@Sl49(K^|jR1%QObFD&j$_TOTWEkVNu33Q9`6Eug~B zY;G8vD_6!_=bOU_GLJKD@Q7&r{gqsW^qLZ@5>P2~o0@KdGknoeLu#s=on3bMY$pDJ zj6T1jQFyfrgHdw6y_S9k3!BS+n;y8S3CsvFcd*!(Cv=7sYBBI^nL!oamS&I74fa;k z6B9m{9TmQxK}@##ivl3?7D2-{0*NKv6D-*Fm9&hNMFyhvl&x2Kdi#b$aY>1>U1vlF zr*X%IZ8rMu?k?!6z1gW$aDV%>ev@U@@H_`Os>O?0av}O@&g)5sTLARA?=5fuZ6m-Y zXXLLpKwMd)9h|8#l`@49A3}w_)8WSjh7BH9;Y2*9lNr`SY2dRxPcKJlX~C31m=hyo ziOP67={pyf)!2F=cx+S8VW4A9oZ7}b_tQAh1$;5FZ}{rQYH3lxfRIJ?%-0#$k902i z3L=5T&E+zfZazhCIZJRs<-dME5uhl^@Y8?ccUre~mWkl!o50O1KgdiB&-W4BD}g}; zJrZ-17o!?+d5livXfN&J>&jaLZhQgDOioUGE{u<#;y*Pn(M9~ean#yu(H00#s(AJc z{BS%C50HH4zHMi=zqh(FUI6_bC8X^pc!LZxHh96wy`7mdI{=k=E(m;6~Tt_+$)+A5v)SO=fx)owzcmV}F-Rs3~q&o|v5YMp$Mfm&i1? zA=hN4_gFDQh#Q2 zfP#rre;g1T(VFHUbp&RN_d8ySb{8i=-{oh!mX_H)wc0qN_fu|l^V>SAyhew{-08kB zDJpfxi6LLi+EY|fR_3)?_sAkKW+!ZZm}Pem@vAH|`tkWUuv*5D(|o(&U2z~1yA@Z) zvX?Iyx9>3oaNf)0p$&&7w@X%fW?P}ruGww7FEdKQEbys@kn!2UZp?!5?VhN;oIN!? zC8e#|K}CyC^LBowrju8F90v=^4w{?%_1O|o)6HX#ax$UVVFMts9+&p{nZS>Y_4S*x zXshSJBi}Q})dJq&iJW&j>ePu-qT1 zVq!*kyMOwcej(tI_?(a{7N^Sceg{o04edd%)$VJevgG779o@PB1kC1vfdVYK1%!hFx}JJGo9Bnk$t(S zwDe?eLsL_;pz6uUO@}#v8}Hae6{BvBm$N#0mTs40Zf?9FjaV0M{X(}M=gF9gDk|zz zGi*E@-gj)DtB#e_^aM<1X3oNSB=ILlMrK+Z2WLj9CJK%-3so4(ed(JWpQ!xC7eo3M zzL!I9HqfUi{GfAYBZjJ7Z5Pv!6^bH$jt|0<;2j|ZmU)aLYhN-nEU&dV)2v$~v0-d_ za@v$sODK289wYI*e2M^d{kvr)JuzL11>nfISkT0qh)n+N@#ibVRdou>D9ey z$U=|?e?zUVw{HJ2ll=LNF6fy*XE1A(J-OrP^4G8g0wym*Jckg+i*jXuLtY$$bH3lBb5u9+~|Hj8a8;*>cZP?&9M90m_mAx%MZof%LUT?DoeG5Pg9x`~X&MzCBSSamMSj z-Vj@|RBP^MWb|X}OiDVc>%MbjL}aUJK4_kt6yJMg)l@sGC@V|!!56pn-m9s(k&l;` z=+&#O9Sb0=mgTrg52>ugv-?t`jm!YhXEtUsLc@jgqsqa9^G&v!;g&Heile~pC*bI# z_JEp2-QUkBp3`$tmEsh0C_oX@uUUTI>Xu_M3=FLG=vQK*hU!fgwb@{Bz0G}ahh=7J zt^GsRi+*q>$uEvy;QGMft)eP~51v;yVXHKTl8(@yh0Z|mX-B(TkTBRKs5U3Pae~^jQtA#`Icg%6_@8{B_wTz7`w$nFc}#> zF|83odVfNNG&xQvv9a+Yv}FAitato<(B}fh3|`iQQ0fEP8!s;;q_0+0_qSLi@yw3H zEd4_F9=*$mPQpAId$jm-0#Dw#-m*)$pbV=+ zctDvAUeUF(Qm?0o5cK{?)*%xN_Um69YrDSaX}%;Yw7IM>Ah`YXBBi6zmH+d}iy%Aw z*2&yQOLeBv<`~#f8D4ni_LF-?*DI?Ok_mq5OQBG1fb}5HC~`mITIwcn zEJtEHKd~fgQPv&;OLbGALxsVpFJePaoz|Qht2bHgj$Qpv30TVJe`=fFF3rp&QjT38MaaHT zpOz9sg(Z;9{bvjOgN5^n@#P0q599ZorrX5Ct3=p}8G;3J*U+`Rwg{B#6K$bqmZ@~E zDf7k3$z&o9p8VKULs3c0sxV+3Hs86_}l@XtE=m3P!?67LnEeD+kHet zg!U|JuAaxzg0`?PSdY-q#ICgtB9gbWsJn+lnk^-t78RLnv!qPl_Qp|=k6Ztf&4};r zx9p*(Ww9wK^;fOf)T}>0bk9S|)YR3PR~+#vbF;tPd@`{y$%Q;w&dwQybeJ>HT#Xje z*)2tDd^FDSv>JSfud1XhKUPv!re`sQ>z%i_eV8%(s;ago?m53e2B-)N%T2D;?Br}n zOi_@1E0kFkv9okR01Czz`?O})hKm#Q53ZPtiwoWDEAbL3Kjk=6%U$U$6)_zzS(&0l zCdQr)_|R#_v-4CDjU^hWrIA1pe1Pq<}ve373nLS$Ptk{D_@rhlhYZSi*yhQ zHEXr&t?)jG2Nw2C&9hCu#T#5zC9|+lQ!uP^iu6H!6*pZ8Q7fzF2}PEE$x%l^A$N@h z--G-QpdV&$W#yBj>$E+mv7{Tb{&^fb`^T|6K?b;RctspPwQOB%2%+?F?~KxkPGGk` zE*(8{o|dd9FKl{W?EM$ih`^w>(Ic7RUM4!GH=KChrx6A@pAlQPF}xgb&d~!$c~;dN zpXa{ADehC*ehBfNGPf|HSkaX14jS7Ou`ChB8*!phl`4yNYbgpT*q9%-wD^8Pp^zkC zAT`h%9~G0qq<12!_@Kn-&0~!2-3|tP6`~geV?HhJ6`4%`;C*qnz4HFv2|b}-{)3#2 zl#~>R+kQSW4KI1f(~}j*xiej|l>C|ZndkGFqSG@qMqIF0%s%(G5==hkS4_o1eyj-^jbOzBI=fY{l@hBb0!np;pDdk_|Cu8Gdt3Y&5( z94SKlUa3hUhRVt?F*A!7c)R>KvttSCa&dBbo58o>ZDP zRZ$Nux|lwk7>aZ6npl0l+L{`G;Nd2>tMMe!Qc|Kj6Oy)Yz=5F$Mny+Y79@m0s?=m+ zht1F^jk4PDmTJH4kkj|Gs8;;e9N>6)UV^mKcApKkTD!fjS6?+yByjILOeLg?0qAcM zb`SrCMt=D0Vq0XSj%|8_LKY_GLR#~s>oQ+9me`l4!q*m-VPTb81GXvCKx|WF)A9N? zC@dwf?-Nq!wbR(zIxPbu!m|+Rz@}vMtKhHNb2Gh_EPWA}qb^sfx%M`wu%9APzi_g; z-=Dgk@8i$iSO=TeAB09Acfo@ARF}Bxdtz~M7}6S|{sH28&WD|V??CjdqEJy@-sXKM z1S`GLMH3_6@>#q{=6Y|z32rbGl=x~uMe;5aY#&9I9ikVde1smj+Sc>yBl`rcY@Q4M z3Kq--0IXR7C@MqjZ@JS299zyx8l3j|U}uiTQng_^necg5yN_An15A)@{iX(9UcSQ8 zf%?lQBMUY3_#E#AxLLlFbg|8Q`E^0qL$C^F1t?ca5x6V|}hooOcv_74{b$u6X zGy5}0p+L6!XG~5<2Kb@4$~NWpLe7yAk{hztd2aulXkK*|i6W=2c7KlXQ(IZjM>ZjY zW6}rTO1ZMlm&C+_s`z)zAmg>V#6x{;twiq&VzJrP>B-47KF?3PtZh#v!&N+(M3ad3 z>1b?N8%Jrb!~K;I%MBv(!^cr6!FOk6%_)qgTd&K9hr9Zx8}xQ$X;KE;%lqat6_3xeTiX{~8#BjPkM zmA-@I?4WPkbLX!hioxec+d__aTJ-ovm5Chr@=HH2hPfM!_`>DGb_imPoPr z>`@Ei>3fM;L&yD_!B}$2SNvX`^Y-$ZgBy*_&G$$9PNCuF4iCWGiWLT;h^BM1FtIX7 zW8xLFq#o|GUGmzq1a)n_O5<#;#FYE%Th=9m^eP}dQj&7@ux?=^F4Yt2-EcF0$v9(n zF{nxtXklS-*LY%%j($32=p)$VdP*puvoej9wP3;eHY>WWQ4o+qD}~6&$ky*?!Vh8^ zlV;=43xxG<%9~S4Xu|R;DhTjM8eGSl$icb_jRH|UxA#$#(Xa7~5C3_#_%qy(Wc zi0^z8>kf8H3Q9J0&tDLzDqLQi+*!@i4k<+9C5IOes946v$B_#9M&HO-+PdzaB)M-4 zJG%TduS^6;zm8z6HXrzNn5I899U~*O!IU3XI_Y=E=d<;(PuShr_4>?@d_nP>?tPCv zK;#xzAnkzf8wU@fIeGjJ=CkpIfyL-YM{se~K>hfW%)C5PTU*$C&h1^J{UO|3cC{=K z;Ql{o`F7-&#n!J+0@;g?rzTa_mqJ+@W>$0KS1I-UZlspFhpgH&V8g(zvrg|z@by8@ z^Rl5i4aG!j38o=N&T~4l!1~*HqvgV4R&0LM{5A97&e6B2; zv7&p)=P8|oY43dZ?gMAA6WZp-r+a#PzqfyUMM&u7=_QxKew<-TOfKAT3gp|w_Nh&I zxI;t36w~?MlV<898a6t39sl;c>kg=_9L@Z!ys1D+C~Q|F=Q*}SjGaltRv7;2?s$3* z=#a_MV>+SKy#o6vQF&@d* zc&l#8^b;;9e0P*bK#;B*Es@>wOIsV<(67SpW=~rczoMXGIQr|UX~gCWm5q5>#Gm!m zjEn<6)`AmQ4DSI#WPWW_xqYKA_h;eE*iat+)Q`GV==@>WFnxN^TvfjFyRFx7jtR|wdxN6F6)2}C{pbavR~R9#H% z&F8_!(@UPtX37R}!Puk=tF~&E0H9<#l^OcQ?FOvJjp$2&?2*1+elRNX8MmTie}6{l z%``4jT91irXK$|qKn}-hW)HVr(NJ-uJd_B-b*5RfD@G9P199Bl>!E)4jw{jF&s`>- zuQikV4MK)+Wt6UwL=b~3^7GwRC$!BK$>QAy$W|~_-Hg|iRZgJ0+{_?%qh?zHx}ULQ z&ntayo9}ATx7dr>rj0*AZw$eH3#=PiE1769u5rjdGpjB@aR$9`K_WhkX91n7dIEUoA1P9_1 z-Mal)-|LB*0wk3UgLIt=;l_JJ+7F> zTMy9H8=9L)VF?;)YN0H=o~sS?G2M*z=wYFt^NMgRY z%tAje7@B{8ogA|0wY(mT2FM<%h!hoSv$H38f3^_u;Sb6IQoax4_IMDV=68<_)&wqB zjYB&LBrDgjl|k!f#as;E+4)rH>WTy6q5(evlvO3s+|fO2%m7t;j}rBv`lw4*(|jnM zwOpt!!HLY7N{Gp6WKj1R@vTTv1SWSd2hbV%dbh)!;xv|s$V?mcQZqRT**VZI zr#$|$&V_H}!k!!R&IB6j(%u?zcbu$|R(hWo7Fq~+8&`dus94&%>XLl`QlMZU5wzE7 z$u+F9JvliUk-~XDPwxA}ft*G7VX~C>(C2;-+pB4UR0mK^xYp)w#sf5E6p?__XfwHx z&zaVZZAnoPuiwhaEx9kBZFg#28Io1=y&jAEoUXIq?L8}ZFqKgf^E^C+NI<3y_wI3- z@J6HvjE##sTxhi)`T4d(N-_4tHwFNyFKp8JELdH|xd3pegf-f?cKovSmJ-I(6P5O^ z)%}5TbeoTlkH4<8U~jab@M*n6AIhQMRZ#~1TBK!^z4P@2_q@`v30R9;nQ`G~ke@!V9*SY20U(rB%L4Pv*^elW~K>$L=6o}*a zbg-)n>Vz|H3iEO)J#oqbSdxnt2}aGbbT(hPLxVQEauy(+26VwHF0abK{o%@bf9XEB zJCf|J%aI7J6pAzYDbR#R#X(d?>O0qqlQ`=;j<$v$IkGY`p3G^7ys1GT6s$vjhlY}R zO$Q~BOmIeUaC7C4A6Z#hk&$j75J=uu-&6ZKEH$-sk3dmn?BLCkth78n=^(hQaQ_03 zUBIvU4|U!5lHb}oiD$3@Nop#p9DvsPot+K%1Td#~K^H#0@Dgs;QvmEY=&>a9+gdDZ zXlf>CssSY8I+&q%$oEJ356?q*2Qa4vW{J7}!lIqb)(Kow4nSp5=Sd1HEZF6-dvSTs zC)P`w;Ya#>>u`1N4d>!~|LG>V#y9W4LL7egLw=vL&gIYdQW)erfV^OAOzdBI0mtrM zV;CSWU|?X`{s3z!D%ze%axNH3b#`_|15^e_mjL-_YGd;le3z5}8Fp1=ZEXVsWi73% zcf7EboZR3jGF4v+ajpnVtb&z#=)+v=C@AflV4E|&+tidv&~5l6O&vs9%izqZcXIs=#=aZIw1yGMbTKX))o4g!ST z^2zySXGIve76T}JJkFK5NGw3dAixypG}YCw`9t`>;X}FRrZzZ{kWcsQ#$YL_o`El>TF_Ug}3HwEaLfCb0Cennw*#TGx2N@FOoae9#&f zr{0VCSPrP?Mj|D!UTtiTcFp&9jOTVVZgtWD#|M|2b%jXm~6<1Xi*VODu%j^UM zONRh;_?*2;dORxZ3;89i8#N?uIa0D9&=4k`Fgu3RmnudCOocbGKY0oP*dKzxHvc#O9`^vqLFVN&&LNgH{yA2QAR?*kojVKg*B;wCu{MHxrTl9x^ue>7tad+I;Yx z!`2p%!pK}lKqxfkf2K`Qtf>gaw0;n9vxrJ7lTWev1<>EJ=v5LAwtANYkyx1&Av^Q5 z0}x2nSAU1QSI^Ou7>FXK<|{Vgi}UUe)!Mqc%>ik0pUTr?xQJ}ZOX>+^fYZZIeqT&? z3i#a=2DFk^JrNm{Pk&e5Wty5s^7N?}RfPyr5Ehxo$3ra42rQ?s_XjDg4?5@QrsTk> zPGHwz8OKN}qpz&jdJ$Ed>6m)m_stf}svXq{k;b zdHH$U9uCCTpZd??@w9y{9Hj~dltaC5l_CJPpzcyXQNVElNC|(?%B-t%gMRL)-e5Tc zve!ozT{}S)zJD2sV6MH|O^Wx0wPGH9Z zKI^pf-k0Rr|U4u{x}QBd%`tvlk}nsOqW9Vcvr6j;*FcV+_~wPaB{ z1eR8xR8({r#&uc*1d*{rccvyw!kSaQHa12^)&bqt*9WNs7eG_Hx>{O#D%ja6*co_v zNzRRLCTVM9V(Rg_Ny*Aui>R${{pb)7Y|_%!22w#_2D*WP0Y2x0)sPr-fQp+a_{2c3 z2+T!8R_Jo3|8gdR6pA;#u`!i#jwDNcZcS-J!xaE9cvkHsfxN-+Wjm0o=dqt9dx2{Sv$Y9e|B|rNLfnqdd!O-m zQpSfX-J3~?o=%_{b=P^F5Qx)2@5=ii3>TN5^*`BwAd7*HPR{EN(6p%n`l4PRE;=@RhF^YIW1+)PMph^6+C19!Ps_yv;s6wGcyk^l`zX8a%U4$*M79Ys(jsi#| zRMU?J6S*7HUcR{o6mBPHTd(;*KqQy1ko4jD=xE&3(0=I#&;dzFo@v8j=77uzQlk!j zxW2>|E{m;IQ%qrZyw=P}N=jDA*9LTVYr|msxuzUU#{A!>xxDf(t${`NkVR*CYD~3u zXD1oJ-P%BCMuJ<#&O$B-^44o~h<2KK5W2P6y+~t!p^pa0FQdqWuh)hdf!IpN8Sdil zzW8%PvAuo`34Y^!AA0Dw@o;}1%1Y4sUNBxx(o93EGZUc0yEa-*WSA%e`%GHECM#0p zZL|l>tEmeu!|}|*?kji!?Q{dO1$y0$vhID#smZZM2ngCnN=aq}jp1^R)dPcaNP}m$ z*kmCr%a7upF7@7TEAPc~M8$dmS*QL!CK#d)+pwRn(MWzf z?hOb74ZueLo$=us6#1=f1<;u-0fHz%2b;Vn7Iv`EsH>~X$S3&b-3L7cdcIL;1+D4( zH}BX)IDz!FIP{z9F26K`@UvL2E0-J_m1^EpAX|_w;2M9TITporv;83S&go-9>5nLq zR~X&NU=8^Fru}NRsMxpi@&jxrsP#5ukcp-mFn9DxXHM8{ZNE8O=R7RsIf&`}%q5|% ze#>kR*0z$hqeN`}LW_$3uW2@?`7ptB7rwx7Pc>CEN;Zmq|77key?UncG z6lrXK3zu>6`dLpnnJ6!4xGjKTzC+mWK^r2f3c%{Bj|cP72}$pK2O7tv(nv^67QZ_h zOX`DN0BX8;&|Q=$H7F>h9#6c${cywfW2Pc5jtWvJ5P$fpQ7Hz7Zd=lrUKZCCGZYIy zo5)H_BzRJx9|bG~LarMmu(0-4uN#^1Pbq*1w1AvdUEa4`|NeHO4?kDiZNwk`U<0M& z?ba~pQd3FCAQd>;=~Ar{VgXdkygnbN_q1*AEKvZA0Bnu9sgonWZtCK(Vwei_kALryHxz(kjaV00fm?Y41FPfP<-8;)H$p^kjHeRa%Vktg70+ z3a@x{ZeS>wTMt8byu}rXG7x+K$JN{10gkF02?a#rhQ4~Zlfv1|2caWCn&?L2LeSF% z+%U7(TZwN9gF&?T0nJ~HZ|wlIH*XY>fkHZGw0rRMTY5Iy@TyX@xl8bS(`=s&5mCQZ zO*`Ux)pT1s6Q?sYdXVBP)^N2ofnhzoy_-#+O7diLx~Fw~YDSP^ntrI#%sH^eOutaQ$e|;#k)48OYwZJ13^k|#nIzG`qdoFw0GDvH{YXD62&HOoQe;XycF^3uH*YCQ>VeNiWB8vD z;{oFVonC8~rv$85fQqn@!1xi6m2}r~9SB5LZ;e43e{*>P`~Ayv978Lq-kyxb2peG& z9OnopV3G;toI;KV`F-}w4s!MnH4HTA`tt7%w1u2nyu9*sUNsc=--^ua)1W@Th&tG= z+ywa*6iEnN^K-|li2AUz(`;uU+oj>?>J5f~5Pt?*#wFWY3yj>nnpIGw9pU6c?;OUu zSR#{V>!cESE;f%MIXEh9cjY84Zrby$Yn?AuXX>y0K6oNltd|9$KeMwrpz|}d#c{B% zNGE)zGz%2Sr%%rU32Gc~*H2HMa{7Tv90!LOq6gCeDF(ils*cV<+eK`i(%470D~r|1 z?kJB>k5U8%E*Fe-YF*9=*gUt%phW^sOT#A{gdLQW7MzJaYs$*X*#aJphliz~MvQKO z?u14m>{?JlUw;LNy+R1sy8A{Zrqd-3(wcB`8Y+RZ{(FGFu|CCqb$q-US}%>Ej(7~c z`a72pN^eC)MbE}%6i@<A0_WeO?H^|OFu@4|Jh1p?<-mAgc*??2 zM8r_@rU=}bt8L=#nQ9^;A~KIxCrZE0>R-{3hB{Hie2$7G6`b>_qxE;A4#UbQDw;d# z3sKc0ZyBEb8up2g_G3|Dt?=V#X-Q)ZV}L((<|7ZcE$zm6;}I5iJhcL3M-kNleMYJE zUrhJEI{_t}^tixumHx!0jRK=it+uu{5PA-euqoeG8i9)q@Xx3onM8iMyugIA`#b`m z&xgq_&z`kUp;uWg zyk%UswgOp2l#bfw_MWMQ!JD0RC1vGjBs_Osp^(tPW+ipyKSt$jtmVa;jdxpRB~ZkP z_4`}w3p->_`uE6`j;pBK={5lY5*d#}HOs9OjFdSO+upuqxL+iTOZor;q#R+iA7yXd12gA;*N7)*1)nTrG9kAi5T z+c{Z;>9rvbc&Q?YczY-JzJZ-+w#V=pzUfq%PcgMcUDU3!lR zdRdvy&Dq7{p)G*yEYu@p?XNCNGe0n4W{SzV&tHrce5X^%RBGU>KPRQ3r^imd+q5aG zNhKg6LX`sfx^V3(V6QqmoVL`eZ3=3{1h5}7%MLSkz1O76aw!=CA}a53hwVO-H}t2? zsIn@tSIDizrAK{Yl}a*}4lf?HpW!z;3WyHw1s|+#*+s$gOG>!x5C5^*Qs6|hv?#Rh z(B^S;9sn5al zP}l-dVwdv6OzU>78vE>y4sMH5Yfsp1$16E-Egx7bV|{CFeQmR)qNH>XzSePvq3Qb| zO#uwWdgFZdQ@8ihG-@G@!rNlHOuua!@}cCDzF6pF<3;m9+|0D<^~Ju(P(PouVm{e! zj{W+siw*uq8_3Ye2m_6?en5>(m{z@~*RcmfQ(PQ3W2^+6@(=J3S!79CQ_oH6qn^JTbEDeV!78m_ak*c4^eOd{@w zMbTNQC-@7S#5NKO8Z>K+_PfCNlTlKz0&t0;=3PIIrkHHo8NS@Ko5I!)3gfMxGO)Rh zeu3TP0b5tRl@<`s@ci1gX4@ffYSIOBeb3VaPzX@OrEU@g zOrW}*9pj$5VuLHkc;|SNcrd!Pxp{i%GWQkLJQPUky)xgS#8A z?Nto7mW-!?-xegz^5aP4t|JOb_-`IwH(j*k4x}3Y2z&y)-O{jm!k7f%JHLWIZ+qNB z@(f#uz2jmpYD?NLtRa@EqYu0BEftqxtSSyms0?NEC2etCcLn;kns4?-zSs&v_-|A1 zFQ7(&Ew;2}bsTuGo9(`MGV}^jR^hQh8i1N^9J+;#!9*mMQ09;~sRjsq0Hl9z=8ozb z?CT>RL=zbvPidG~|EzLP?p4_-{u&>7&IC=eH2y_?91tRxF{yM-J55Y>nSgE+E`25i zjIOuRN=lWh{STLYkC-_*75}cDIGPHUqN@iylNOGkK?)#*SEppO`+>0@ZNl|VCwR$% z0I38fTKVuG;-kwBIo-7nyM%ZR|JnIYe%_v(qdy007HM-uMwxubwkSz!C zfAurV(u2NqEv=JdL(k*LQDLzV=+T+eQn=UkvzMg@zn_~<3(O#a&J!ggszm zq%p|?$OYb#3H?m05>;Aq!)H@A!#KNlD zlZ)e*+ue9QetYY7V#A$)$aD{l#aafnzc-WK{*)6<*1+$g8K+MtmS5Ka{uI+x{SoE^ zc#k)bx7Zis$}TS1+jKb(PqHeqqU>LE%gA>$zN2&9F@|LwMF}f_nM>5U^sX0~+7CQ{ z9VO`e>`!SPy$ZGnyV~+_bv3e@m$2z@XssCv;K`(|ZI6kL?K!pU9t)Niqiy?VFdoD= zbIZvON8xHnNVhDRzRy_}GC`}D1)%h==hi;6#J(F~jL`mJ%n~0Gf-$OcbZ#e=?cNfK z=x|AYZn$hczm9l*aX{wo>Uu8@KT5?3@RjGXYR{DZ^xJ^-kL+2CRq!XAKOcd(=k*3O z)njdc%nrnXW<>3JYc}1zD)osgsMTMuJs#Y$w;AAv*VWX^af$Z8rn5fN(#o`39_E!Q zc<;}CIvJR5l9<7hwpsE6DB@t$d!&57r@_D(6R`tSjspB8U@#|Yb-X`4X`IA+FVs=V z4;WKq;6wNh^-)m)Pq^piwAS*hSoehZ7~1YBt5tgd<^gi+hcwjuk0L0vVREDA6(UeM zWNfaqj~_nNcr)@YEs;x73FkZ-8+7=|n5?d@F5q^K>d6MQ$xsp$z@egf_;Rzq$%9`| zCv14ta8e#V3);@jV-i4>B;cy+P^q1KDSaATL*}W@V|bPH_x99XqKHW+@$Tg6C}-yg zWZ(EF7X_apNq-0+v(k?2$awiW8Y?0xY1kLH{LJMwqlXOz*H0cBitj&+n!LOO)_~!i z=hm>qxBI+lT>K!&}rX8s8 zcPQr`i{T@0@oF2k4q+jXD8zW212H}j&e^nKqJF6zwR}h=%pi#KdOy&;igUaVQu@kZ z>4qn2q@ci@hQjR3{zUovV6t1&RCx}1BiUF(Zk}w(5a^F~cf0&Sm2r3^GS={_TQB2M zx@AZfbkP&PV#>bXuB0xKL)2-jU^v5jC-ciMAmG$-B1oGlwKATom8;?n= zW}eRmGs==Y$E({M+nA*x#BB0%C{B}M-=egBFeUR9Ps)!rCRW#Qy$KAI@Me48t4j+6 z&`~4xHT69C{I4Ws23~OSGm#tI&8m?xXub9@1I|(e(w4T1O=tB{35dnyD17DnhyUvF z8cwgXzq8I(v7~?2$oOCLlx&l^9efd0arfQoKcr{rI>f9y8k0t{0~2|755~+{qTW9z zUyUVGsj01%)oL}q2+X?sdXP;A#Cle4JmVIe*PKce!kenb&0XDY@eA~?+%qRkOg_Fc z+(Fc3h(*bre1AhnK_LtqII5gq^*`>62eM4im!N>M8a#|=;p8-NpyE!+I|mRoE*%9( z08q+dqtyX?TRff`^rGYe-I`X8pG>v?O6SK~M!ZNKkL|28bLC3C?$P1ltF=zt<@JE3 zAQcS>0ou^YXv(!yro4TIpT8&QJfoPu4&tXm8*JuMl|NU(9ngh^^#QC761)(Sc?#a? zpJfsj_L7A))Wr~wX3f)ULQsrB3vY&6TQ#rfx0wx9D+FMOe>q59Km;mgfJk-@J^xq^ zD2tUQF9s-n&BxUc*3|0Qjo6;M4M5_4u3A$ypv=ymY2PiWjo*qsp@z6aOA`|V|4V=O z%V8vetSOW9duZp%?OkWWxkJs{)Rm#F({%(f^d#8tw@}G*dB230{lF!@sLwak4m02| z8vP=LCqei&lz>y!Bn%TQUvT(r4#$^xVsU9hCPFJup2*HqV*_nlbqLAy98*~+m_-4i z_4abZX`>JR04dJJ+EF74#uJY5Xs!EN0^mxCRl8}LyCq5xOfue&$Lg9|$&g#;tw!%S zAlO@8-_E#tnBV;w2udYWdEc(XrqbR)Z36uTKfwBWa1e)1ea!A=qBt%_=GB{LIQg-`mJ9KqWIH7>54SE;Jv~o&tG~!WuLF<~vc&%p74>?23UNCQt2r3_F)|No_J2|@Q}in^>N;Ul zC3}2M&|mg8fkk8HLtMu?V2USkgo3;?Kk1sp3$mu>%eD)Abg7rTW}u3ABsEmebX)*Y zDM{w_uhRm{=whu5;ZeH_9e(2uDqrgS{1+P8H(FtkR}IfElq7oE7aGRggPBfF*viW& zp@VQoq1TCRF?OA%dzG)cKg?cc06*)Bd>&5a1Gv3Nv5P?IiJ>7v7Wcz%!eWTPL&8%4 z{Q}!VsE@@(-MkUJa}+n5J_+gtT9j>otR|=v1;@q5!>{a9x!jB%jS+vvB&AfE7;Px+ zVc7Fr5Yz+J*r##|3r;scn*58kKoHsx%k2+C10|+rX8W^EN3gL?4;0LW#*4JHUq2>B z4S){9?DO*8+E9UUXjt02C9Vq7fP9YS$(gAbJcDj^lO8(SV$lUG^@+1MRT<2HCE*-N zBEareyYBgdl$48u<7{`S+AONLEn~KYoGT!IiVu(& zB_)V+)M(^32iw`yg4zil$#lKfP(bxiL~54j&6LXCzAD5yPElKq+(p-ZNbLI&m$d{2 zD(>Awy?UCD!*-6gFD|xz0EN)U_>Z%FGvLlx78Z#ZOA$eGT;5&ky!eoNePw@f7Vh%n z$DA7`4HH+>^%fV5DX1XlGcB_WjE**EAOU(aNO~{OTf4s4nQ7KpaMZGDzFoo}(vC&! zPIFnGYedPx4%5BV-3zlm>v*0BNO_(2H%#pv$sg0ab?Lj30&>#4hMTQJLxO*Jk?aYT z2w>@k33Lo}d`@>6_mg32Rr)Ttc&W~BF(H;FVJ8fkLA{0DBMVlcsSBVZJs`Lqr2nyS zct-FUo?EcCN~epV=w1H!F4Yfftl{px6~pl?M7(VjHd*GbYfx zQ&!S+yE(!XWgir!^%;71h8gd=Qi88j`zC5HL>-{Q56HXLTQalw{4d_nf7$G^2^n2L zp07uQu`{Jq7I~nAJ|*E0q~?+tCrjaWpt4;&TyHC`V2VgxfAWmH4WF)5Kt)^b=uj?# zm9tXo#T(Nf#OX^wUfbqLr z?ZUs3XW}(q47Fu-4pW0c8g_TfYZs6!i){_Nv8+M>VgNM#1<#ku4V~gJ+5B3~{Zq9Q zs77T%-_l1_qn`6*B;Sy?^z`z6S`sn?N&Ft?zxDKiepne$U~44-0Rf;jn;4JhGMSRB zLdm}X z;ROaLGysTQb{xt9-23s)*hpW;)bDpXCiEX1WEB+3t=eLwG#noxpJHI3p`IRCT3eeN z0F^puXI=xTc5F;cZjL~s3*VCHZr{chA<5#q++5@J^~Q?w%Jd{+rgeW!VAh~-HmW?s zx}DbAd`9AZglP+R-Tzz9_bYs z3I5Ft4vq$Tq~hX`6!0hx$;mMS?JJg+T5>i=_b|6b3?Xng7=`7ZK^Zf~ zQ3=R?H8m!n9uRbnvOhW=gTZLuT94nH?)Yak)n1-(Fko{oDe3eFUK!+SY7_33gT zQ3h>fa{#7;Jxm*w04K0ityBO6cicv!hvZ(5xp^lwRO3LuFKFci8gc=!2tgjFv9M7- zch71F-p}BN5lX9YcaiY8-?Y^C2xeazjpp{mSkIqh9;2js|d5R8w!?*>HQ2q1qtHQmOtO6H!=weGg$Caa3_a6WUv1`9eId^w5GA5wXJa~E2$V77|b;|7=sE4ES>v7b>NZKZ-T2Z z_tuzO$MoI)-{1UWuX{h;{QmJjk96OR`_GWKhV^s+%!DiV{fo`~|2=TcJ^R7`JaFyr zK(YJt_`fzGNJG;5kt{5{e*YpEi`V}Z>pA(~AK&@;0xjg9-`02&ze*XZPvC74{r|K9Anrb~wOc$Z1>^}w_o4VI4 z(;aq0!!oGku>+}sPRBGD%=Wh5iO7Gi98Cf@a^?_?i|fKO#WNKjN;+FmP-H5`H{7*W ze0kHBkYEO*G-aR0U$`~1_zXiV=%ZW!mBjame@F^n;|SF}dsbP=!E|C9K{hYb;1SuT zN0Ir@>QAvsIFp?MDWuMhuBxdRgAf@NHGKv3NhkrAAr<+mUy0ybhPR@=i#4drlnj=Z z;7Os6gF?Nrc=)36x?&l0=Y znb}#H*^f{6Nm+Ee&V$X5Pi$pJ9~hK~`9AjbCDqoVKzTY}YPuI#_|!nc4HCR)kyG>a z7m|By%6M%kL(vo&`-`)FPfaj!$zy+X$9SDSCZ{SSBs;pY+&uPo*cV|6eMFjUN%35@ z^$i~#n^xZiP&tCoN6nli)6209V5o{vU6zg{v=^m7a6H@KwvjU|Bb9gdvkwiIM7b0< z-cWx7i^I7_MTJa(?F23%c(Yb-SmfF?^f@Q}Yr3!Fk0ev=Pw*awoAQ72hCRtV}Zsl{3$6- zExSGkiSZhF@IMQH&Bpp{sK2wgO3w>ia7m(!j8Ipjw+8p%;1C@vHQfq){0vG-E%3^l zfPl#NY%kQ}LD(lLDF>rJ2KIG`v1GtLgd7hU4F0_{uz z{4stLYy$#@@9$IaR;#>Y_G-!d`P2RQk{pB4{xOhTfs?}6vF?k;&`k*M1(S? zXoV9GPA!tOPH4^v+wp#bAj4%MNdI(b8cs~~Bm}#RYRIyUirTscyXcr-7`PLUib%f^%3(2HYCPEMA+ z?G<^y*g{=i^-t=nEU}8D$UN_Y)5C3)3_A`Wj6muZ zwG{^xAB(?G!O~?zmmo^V#cQfdb>`!|3NV?c-AbZbTpsU$(2RC>%>5n=lg?F9j>5;s zr4p#Q*!0YhZKmgu7OQi04M*~I+}rPgY^-jqwTtLTxt7yb9xJ|ju%@T93)duasV&hV zVQ1we_hybSEP-BXiK$$4ulQ+9AVlCeV66`{!{bFWwHlqzd;QzWQj#w_M00K1QLbtlgz*NWFR7a!C>es!*af6;?(Ri=Oo(2)J&CP8z$ML?l zp1w9Z#;c#+og8KB&9j7*7XfcxR*t`Tj2zQF4ye;Q5_~r2b^@UvV1=zeNM}7SjW!jm zNn|#=QDk7)BW=7nm<=#jewbWjxqJCMa}!r9-%s)iZGLve@1j_z7HbF^R-*Gx^lGGL zv!JhJN5Qy{i=EX96h4)fUWG%i0<(GS&V{%znOa`Bp-_V-;&)gu6u}skaNKV?Jw(*Zd9}PeOrNWZ}2$!tcTH{uT($Y1duy5m#|f^)KEiyJ(Jv zXs7f?kGv5>gM)G9U-Ap;QOH-px|?83?&;|U+IDG1t2R-YU*%3oEXGUI5YK*?Gvnox z&`!7T=G|1Gsxq@YF}$>NkQMMa7l+%9H-}AP7dSw)Dk;_X_!;ru4!-WeCjXboO$9N`iW-Hj z0eOfzKi?bv&$FxX-eF`-Iiz}@RAj7|t`RFLS(|kDRvn#D(J`Al#HYuYMBMgSP2ZNj zQ<4>38H(8GePib_)ir4kea!Q+zk{vwU_lCaR(4L7XJ}hE&pA|8badq4Ogf^KMk3fD z36ehVVJpK4QkKC%(A3$w8pm2sc*9@MVj)HO+WXhkE{YS*L*Z7W?`?@F-Z#=&@mm9E z=-U41sL`c-tV&j{|$3w#=%w+`Gsc0WJ5=0mK~8-cT)2z#a%&)>Dz7= z6{e=H{>5KYzM_AO*6{?J8i6iY!;W{Di#e%!Rai?)z)HBS!;bo3t`=Cao|zfmOHxA8 z=h?Z|X@_9(yDl@OALZ_&9oQ4)jL*d@Fzyq>BYrH+Ss+zjEgHm=*PRzIP(%>SkQ0=>C&z>DK6k@D3a0JWngyc)&i>nP7ef=7SC3JO8 z*3J}FI>AK7SE0guYq}j-s03-gXl5$3+@+HA*r`5f#_omnb>D%X5~*8@fS$Ry-vcbT zyWKswgyw7=cWsSaN{Z|0sZRMeb&F-Wv8l|5*sU%6Uso4o$F|ysi0WU9WBYr=!BUbW z$y#1QS4jdcA8f68x1JHQj1P9jVc9w_^v@izd_Qjof!I#RU_j?MJtt;-(tm`j2(DG< zIKWM!r9~QAtv`}b5!HF)-{FIt8%jn?$3VzuT91^*v%`-_kYRU-qKC^ z>dlR^MMc?w=`9Mz3KwH$i6-|{A&Z>6rlP!NR7}JyY-DIKT;IXr43(U(x_Be>XDb9V ziMyestib}Tz-`%PMLWR*hzU0$w1PSm(YM+P{u8Ko#C-Y$g!~UDIsDDen_F8rLRR8O zz3FGyV+rQL8LYoJd^B?`!%9?Xw*p>`#ALRLiauLH939>zkLRv0ueU()>fEk#PL1`A~uc+^O6B64g$&w>iyI(fCR#a5N1(sjf9>5^XQCJbl z@r=`7Jrfdc7PTLOJ&y_s*xRJd%*@VD(O-GLfz&bmc#ORKxp=*~SIPNKB2}(PGn`#a zDx@_nf%R=8kkn38dpev&)rF#cVxwbge1)JSfAfla*MYb?wmBw-v%cwWsgX}ytMbt? zZgjwLnE)Rr7&48cQ2v%}1B5misGDH0C>>BN&^{q= z(R&^M!?CHC%pGZ?$V4SaE;*JVgJd0!JP*vCDsaL=JT6bOdHdxS=F|FJ1>BJ+S3zS| zwUGYe@&%VrNST$AlA%TKm{CEK5b6*Y^X_>#FaD_9&#(YP6ExreuAYn7tN`0aS; zwe);+GNp?1xbLqR4tjB8S`4Q7xTR7X(~J+^34PS=59F&}*3c<_R5Acs0%;wWIGHvq zhYywi_+ZcHp(eX*SniR)8(-|t)rz=mtf;A@CH9Svj@s`m#~_wkz@Dm_*f94ZmGaignQ5zDVZ9v1fN z$9k=Sq2{k00Yt6R>X}dBR%3;>AKT; z_6&{S@DtW@NGj{e;C%8;(-fLoO<#|T21f&~=Y0S!QBzktL3BM=fPpEW;t~PC6@nrr zap7SSk5f7*ce=T(-sa*rz^rWwXs&rDZfERAMu+9Qni3P@PY_s73n*>zx^A65mB%Qs zaYQzF`6!O8^+0)8e@4?qd>K_&Ab6olg$o)s6A^xc+_q>7Vj|ft7mhc-_~>eL?wN;N!My)@S9( z3~w}biA%Wbg7j&w&21_m_2k5MI2F>@FDV0!QI^vlPw<&(NGfPrD#}8qeD&(48o98j z4Y5*G8+aL-n7ANjdRGl9(ZvH$2%pf+fK>HhHmDC8uc4p?#{2!2(d%G>9xe2xwR@h# zG{l+nj}^2b1fSv8jZkn&^-Va`YxhnLS~%V|8$YnzQds$=@v-O(&Lk#UX$x`(b#pYY zhdo(BsM1YBv1C36nHj@{#l_;%u8S)>_yog#P`9(Oo(6oicv@8lbJ`kiP}GSyQb9Eb zeINIGuvE`y&qug+k5sZ(M!8DkBynwLU%Cc^0WTA zcYyY$s`f*FF=w;#14I>i$LtyW;FLjxSS5@|qTFXxJsv^JH#q#VQW@{Dp@o?_>eY@h z=T267kcXmfLiNgLclTS6?Sc^hTnHq0c@|@6C5wN7hX&H&uiXYxi5%7=2}-uj_$|Yu zuN9HLn42|`jx^jY@D^m*B`h|iQ+9Y5f|83N)vlsq^rvT~e?r3cwG+;bmyjEZFBlH# zJu^5+_v)jBL?V`L`Ba|J-ljSQnW2h1A)^ngppo31Qdzn3B5VVk)S;x@(5twD`rPt@`pCdUuShn;*g`FOYzlW7 zWPMu%j%PJvJMX*4(xFZB;K7o4he!#^hx@2LkeVZYf@7}12kr_06!@w?Y^bZx3=-~9 zNJs<(UP4vXW(1|O3DD&ZVLG2|dYr-~?ixodObw-`dS+W;>g4c}GNd_WpZA6?uRjP2 zQ!r;?A`YUcKZ(zYA?L)$9M?1yj&@Cc0Dwh!PvgX}tc95d^jUCFZhwMI<`D2NWV2G6 zTwhG^2a1t=gKC`5v)rGkPff};`Fu9DY_pz?ipHbkkO@H3jy2G5>%_CJ?y=!DJI5i0 z*AfP3bxt7~e!!Ljc2^A^DtqNRhScJU=i&S;yDZfMR8_rqlA$Cd)V zqG_nf*_a$a?C_dOG7I=V_hx};+DJHE>VJu$K!v?fxb%e^QbIIoB&2d!DQm3Z%Wf5XXC{ML=ip$Li|4)HsL8`%$?9q&hv zeDVk8pNOKT4bgC(i6}otRGR8E{{u@!&p{V`7xRjm&Z}n)TgY3GjdpOZI#%dd#}Gx` z#pnI8jhtEvDj~l+JEF}4d-7I>gPhBy?gAY=a_YCsJwdf1FzT6SS~gB8>R~p53OYR0n;h9tsDGX zH!#^`a^hpi$WUORq?IrddApyPj43;jAx4GLt(h++hkox|OrMZ{P*50Yk9vK+ z!+5rCQ#*U@WDN$|_+qshlszi3s`Au3Gfkt-52x7ik)Oifm&U~!p5A~EI;NMFZcVSD z-_T{(`&F}V;UnB)3p7Htg~~N&`CDISv=?e6NSWCXPK8KFIRr1J1Z-+z*~{N2TY};fJcwLtj_iePI={0zQ#>r!=2>jU;Tt!tNz;6VUPSY^04b$-{Uv3 zX1CZ*s<`fg)_r37>a#p56GiwBU9GloQ@HP7&>{J~%o9BHP^T!L3sOZ6+}r<`mTXg%lV2`uYM73qVvq zm1?jn1GHk77+s=Z0<#_+{gQ$R+3$>m#V8}b7TK$XnT2BqVzSxLLBz_D3w)zGVcf!llHuGgI(OLW{0~@^O-{?yH{74C>I}V z>+EtvK$p_6Nkuh2z5gbp3zSXLxd0P=O3Y!ko3*w4I5&m^q2!pBO|GM7a#WM|N+wP+ z=39Dtz28KdUS`wfdF-8+?~qBw&z~@WgTB}{&I|IeXcN!M5*{a-pL0Egz<^nO-aVtc z@#o+etFN*G`P=9OR~(DmgS9>F?g-M^#A*{$=MPce(#exsepOV(GaDKq-V4K>E^wBu z^A^8oHrg}Nu_a?+6LL7uFJtmI)S2#V9^wE{f!7n(TZ)rgxo&TNzAAUewp6{&u*>!3 zM|wC*atm|$ua`WI!=O=X<|ZjqkaSimFTa?|o13>DOGrL45+*LOR&UlNRysixt>g~x zQlVFJKN9l6rRJheMCd(Lal$OI66{McH#}?}ny_9B11GsfOfXFN6kTEmz`4Px{KA8B z*|h+&!E3mdGZ@u1#^+LCv%?GQ_-v}Ku7*j(N&DK2nf%QPe57m`n+H$X&vriHPwvZ3 z#Srvtd8Szsc|Q+7+1bv7OKB25=i6iCJGQkVV&%|yZiZLf^fZOmvZ^{q0}?tj&E_*1 zn1W*?BcVTtUOea6Y(D7<+-*cyz%K)F%_5MZao7B-t*=mgoE=W!8B;En*Et-(wQWE! z)DaWbc7KtzDRBIrNPg@H7l3u1OPL3tqi1PqiMUL~I6(WfE}N=C`hS$-hy^9n#Npz5 zoP9c`@Fa`)BU(Jj=Am|?voH7*rW*dzC%t1OBTFh;mI81V7ueRRf{s7Rda?n;_KYqZ zSgzF{svL!d1c}U{fIu|N-T5JRWo4tQDI77;pybW%eHQ1-P2fghQOBSw_w4jcOeT)i zwKZye1f+M>mX{iN^=T0pV!++H?2&=_cK}D**_!JcsZTUXdwr=9G9m{KeZ3OeuTh~0 zU?H%i+eCw*D@iAp0C@Q4nYo{Pt3aAP01SgjJK)9#q*$w_6vF0liIa%)c+Eqsi?R}_JY=S zC3>o3q&_g0Yfb%FXMKOFRISNpEIp|@=jiPYOZ0(Iegit!!&Z#IwxySojkkX)dmfPM zFTIT}>!EmJ;Cg6fN6O&V8aq#W-hP>)Q+=lm{&TB^S{cmPW z!yyB7S$=)RB_#zkOwjo2*L-voTP=-sb?Qp{`ozkwDM?s)fPad&!!z62{6b9RXr-pZ z#M-`mMu(p?H(L)s1%_tw=Oi~@hO|e1dWslvCr}{+Y5uLtW`|BBm6^9VcH2HvI;2wb zdf}n+{8C;?!A#YWHNZ|0zp;!}xIB<3gq)+-);dIdK85Z>>QX0RBXZJ?>r4wr13XPs zR5=zHd=Mrs#`WpUYyXTswXsyY(ayffof|4Q5f?RaTY2+hqGP$;N>M{x9l>K<30$29 zS-lQ`YBk{E<4jWz!~TpzXxNvG3SZG`oQ(tk>veH;Vq<3qL-akulU;6)eNK%{0VVK4 zYGXPYeM*fG#5ZZiVt~5=`inh5RLWtjXEy1+fmy2Nt#h~3xX)NtQuR9f>suDfJ|Fo{ z#^oUa%71r^@2R9(#h`(GZD~UZB^VhUJ?#*ac!L=UHf9P~+ud$jZ5u!($L~-2{lgv5 ztdH~$zS7#C?1`YdM5p?hVEyy1@ z)!=Xx85eU#^3{ohCVKiVG2eI8t6OuH`x%(1&9msy91mp>dgjk;y2~G3d7}aJbJwRx_TL8h#*%|V@Q&PNmpA>xok-B*bfP4p~ zzf0!=2jI{^G$nsqWolw#e=yY3R$t&1Sn_w(T1fUBzqD&#u14drX@x~HN{h*v@%9h9QM1flxe>hRJ}E^2QvG9(#wxb5yn zS?(6tiKG-HddB<7ZGY>^9PC#)Vz6z{YXWpO+Ol_XDKqmiCbc&^r!9`v9|2G214C^q z0Mk^3RK?dChNgG|(m<-O*SJsTW(ozp_SrLT_kU`lzzzHO^}Qi)8Q__CdF#BxK*?Z3 zOa%7wdiRB(EStlbU)w`V>#DqBk9cCWsS8B#+M4OfsRE-ta*x;WAzeAW7V8BjNEuW` zUECIsPhcEa9T=sv0{5ptxhMaw{i|)V{;rD$ddBz!*wU!o9^tq243t|-0zx0bcLe)R zNWVxcEtMOj9%*eAM+Ob=EF>IO*yLGNIj(Kn(H$blQGs9z|K3z7{1`s+VXNf%y(;Bh z{lrjRkaP-5y_4=o5KEnO7i&IVxHsezE z`;b6OcVesaMxZ7!<~XY~oKAIk0FpN~_@(602*69h;(K_%_$18D&45_JOXylveTI26 zXnDES?*cosMB8HV3k{csj10u~H`albpePj;kaz>w;WEw~Xb;X#_c@)0>iWW|4?+vsxG)~s-6M~bya-F!U8A(O|%D^L*WBjv zn8SF32#`7G1~h$32hZT-MyTv&_-(!QAMMzD4^EHs@1z25=sBu0lfXeZ?CsaopYVTQBYuQ%<*OVEMEtdpv$NnIEq)^Sr7?2T6*T{Ur(QI z2@_($VxLG-ng7{!0-r$3ndIZ1;^RKUcsf;K1mtAdgU9Q5F`&veHnMsfmyubpvAVpz zx;#$JYSy`4ITcS>G({^V)z{6oZhx^i=APk`9qp41b`?wYKv>-K??SMr$k_C- zoa_y~J*I*^{qsk+GEFbk=Lfqc!Lz{p;@6KmjqzJGHM#fk^pV{O^(HBPDiiBVl!)dV z?2e^hI5^8|le%hlDNvdXM)jWsxzv-KPMAy}Z=T$w%kTcQtejOQJV;ep&%sAyZW!(x zWy;C^Wq&qkX9k+4GO@p`{RSuvK(+`(v0z>HCsm8{lJ{ikD+=68ohGfA)e23m`}9lM z>F8hsDg0MAre+RGloAR(gI!&J{uBc;nNg)GoX0oh<;K#~S^Ls0So}rBKUrDWh}kWo zteK#0V!1&2oy_a_3*P$JSM=tO7?Pje(r!0Etbqjr#t2Ec4cOc8b@lsKbO4(Hr2k)S zz;{0g0H=II;|Irb{fbjk2CI8k`@MmCo#f+9<+fb}WI-jzm=Rvg(sMZwJIAXWt(jEI zjK&7~nqg@LxflIzWPlC_@@)~FMrXc#Q8iQlrf=^D=Dz_jZV>QzKn4%-gi8++%8wTf z12Xou-|c220~Gpoo^W?4Wd7bJ|c=GR*dmSNo{C@aqSSfCrKdvJA4{JHkr7Teay>gWLE6P}&kFFum=BS00CI&%$m1(*e2RhU-{dMs9=|wJ ze&IVthYWE!V?7w0hk|tdb>?F}?%GF>{5YV~%+8ktK*a>+-rUw(buKK*&@<6BI&Nud zO9Le`8Mws3pe<))8nQa`v+4Hn@r*FYbwkLespIbG_qwMc!wa{Uc0lQHq%f}zZ<}B> zG#X9Qlk@WRmzME3z66}!<^%~q(p5@sO5rc892}$^9QFfudp8D*`gC@I%%r;`y37!O zD;L0z2}+~+yd&!5r?S0MI?Mwi{x-Ix-ytV>Bu-no_{?^eYxN7IsdaWKFEI#vm$A&6g`~M7r7+ zRh^a(paq7EKnS(FzZa|h%|jW5RQ?7hKdj-7f`a&3pO+dyt3FhXc;%U7x4lW8Ui%W` zdbCvdeyI}US2LpV402XEo`*<3^?mB31WacDs=Kqi{=W9z@}BchaUuv1pwgq--ZnFw zljgBa=@{M};|s$&UOl3CAF2523g+`VTqR|C6)UgCvDy|TyM!K=_w_~rhy26B?_WUp zm7ePDErulo{6s_~sr__=()<%OSCX7R90~wTczSwvKh1A8k2mHnqL`G2TFgRaOv_osf1v`$`j+`;`wMFIU$z>y_=U^mJ zO=UEh53%n-lgqjHUTqW!OxA{$EC2FhgmkB?zZBN~T|dnKt{;0s%37u}02KoHPo0~y z$6cQc+@+RqAl1k)$Cw{VyO3-Ro6rY4xL!g5VfO^&txZ-UxGz=}sFV(AbwZvUVxj?+ ziiyeMY(2$|K;4Fnf_OlnWM40maBDf+h(_uYzD)Ga9A`zf{l)vjq9Fo~ zUqW>s;7Qp1NpfnabBql`jqHfp0u4M3o>Foe8e-$mVkkBcbn%~E^YB&`-egY-|0b)I zYkdfA#`N_7p3?Zf@_yQBw2$pVYIe58&9zhQ$f_R>mwqM~cY3hBuVAbjt!V5Q{n3Ae0y)mTwYAksuq|Y48QX+Xd9@{ZoQB_%9Rf)bg z6MD~o+rV45qB=tj&g>!floMEUSPk zJQaul;I3;uk8D!uuq44gbJ$aAED*Sp>xmnD*g87qd`G7*sXPqe-i8h*&6N)JFXS!u zspm;K&60p5?w#!B|5w{rheg?KZ(|V__#z@DB7%X0w4{QRlt{O9Nq5btqynPS-Q6_< zGr%Yy-8IzE-6=K9d|Q04^Ih+Ce&?Lu`Mz_w_(Nw8&$FMs_p{et_kFLmS{RAW^UXKO z#kYnM(u1?A8w(rWM9chPxK;UyIv)GV># zmx_&TZ-XVrjW2&YWEzl}3B+7GL}#~6&dMr>smP2tJS*-oY?I@tsjXG`R4|Pl^#?%c z^hE;t1O;^!1D0l}g}HINaS7mK54wh(oc6%^n}osD<_FzSjqc(-;QDB5ze4leO2Nfq z^RU&i%a*#r!bJDXn1h)5o~Aj>dId2lE6WDuR^>N~7empo6C|tx$MK-}&n>2R1G#Il zJus*O^tk|C8WFrdyPA_W=I^hEdxxbtlUm|45p$0S9p0jP|~m> z-eyF!V>}P)TdF-`;M+}e(~&WcJ)Z&9&YAC1sp7%Su_S7PuyCJ#ZB5OcQ5lmACNaTZ zV#`NsBtI12yus_1YJ4jAV;4GF>@f$hp4>ud{8d&XP~8Vq#3HVe;%QCIsJMck*>*Ue zM7nX$-&d+wBNl>t#(72RfmA1cAJATpnZl-@nT+0gf1|!`5dHgIk;t)VY|;V8{ehmI zy|p#R9vtd@msO79S|T2V;Xxza>li@U!S@ zNLpD?L<26M*Z4hfpL#wx3Dl1^MUia-xa|bRu4rmz!p&_*%mDDR2kK4q6QN{x1hkU5 zwfF9@q!q#MvSq|EYXS`n?+MS==ErMnL&_kvrcvEv7NoWpn7iyj!^YOj;C#0-kcfb_XIHwIpuF^UDcI?BF~C#u{X8p0sy9DRoVifle3AI75vQhzuqUABfD+F}+$Sf-{dxZ+ zSRg{xN#;OZOE9Td&`%oP;SrB>Xq0gx&{?B%q)`+nxMK)7hY5C!e3+-f|E{8I9m;V#dUCDT>s*X0h2LR!0zrYASpRPqI^Ec*C?d-40VcvInTfV zjapHB*`_d;V;gV{?+{(K5P|2G8Uh#q;8qUwvEZHkMJpxncK|#b>>G<14-rk&A|;Qx z2JlG2%Ru-_!2X6u>``NoJCTd6e&sH?uwEz(Mhg_HUmm1fF$k50FbNP2qJh!ER z`vZi&!SZr|z!n?FCe!NMD@}pk9nf{nwz=aPI#zJ;NV}ZE#Bm@w0s!^CX^WTi@EKK^ zfTuR4H&R+ZZX-$ffIb7TRa?vRjM245eOeHyl|Ma|?TnT=fE|vLUH6Hz?`a-YOZ;q7 zvo78JIQP~ssPc_0h>B4^!CC`)5S%TksHp}925Xu-gKHfaPBf|Kjw#SZI?bK!i_=SU zv(u)p&5d81OQ%_!hC+0>gI5TsFVgX^%DhTBd!Z-mZGmTekS-er#>OBxVMl)+*d)*0 zNt;k8JJxxR6-7W!hDGot&*D;x&echgHp<0I5(8)*>bCJ|Eaux(F<*fuMQ@h=#@pM< zf1^B*@R`&ihn)9AsdeuoL?4k7lk9Kpm6etZ3=SHUtz6Qt0b(IC=uB*P;IhLTRdBd@ zz5kO2%|>)SpsLdOF)t4&ypmf`kW&aej|UJO_a2bU0=%u@i5{rT;apJx4!$Dt-e2vw z)VeiQk|$Mhxk;*HaNr2+yz)&TMzM`YpP=_a}bZ~=_x?)K(7P{gGc z6%}O^)SIHCq9SUW+oe6+L|Nxb7U|B!I3%*)6I?-Wpn`*`$10FTB_AFH)B~WO208=y z7grFJ@?lhng7)lEi;^!OsJ=wS&5Y*3{UR#BUbA?~)?p(#KSF}qAt2@?oZthGZD(2b~T;i>*ZD1fG#1W#{jxyu4&_;QM7WE#4bIz zSNnOf=IyS?K^65G=`-a;t=0dPlRwcF3T+c4dv&%g`Q5S z`Zp3l9SGbb*&v&qbEKf+wWRg=E-j<*S2o2L%*{11Kxx{J2P&cJpIQAR`grl_arPsi zi|cRq!iG};f3Imq_X!l1fY$%9V0|pa0F2UorrYN!dItI~5nr7N{mhnLnQganG_aU> zo}gfVys3>gKK=rp#(QtNt(w;O(x3eu8Csf=0yf0W&6SIb3(d!2TpA5RlMkz&gwhL3 zS5mR;Z~71rq*C+8Pp8(!mGr!V6w=)@jtAqBY!n7U899kgVeVwc`ee@2e-R{vAF!pl znSqxF{3MIllZ*ZS{O_q0p%O3(6u+DQ8I|&nWBL9uPxE(t%->xk`3grvSL*M20ANZu zgcyE@BmUhN{}ws;|8uv0e39gbmrESY{|ttG`|0vOWR(7mj&(x<@f^ana=#;7yHln} z7=BN}**_=aZ`Yzr9C9VzBK+O_wCP_*L;gJ__OFNfA3yxxc(s3hkz}5m(`G%N1%E$C z0_W}LLLgT^_~}kbX}kaX)4zMX|4s<$e`Fy@eL=!w#xp?&xS?S9DfQ;ZJ*)Cfqb#!oaOGWj-cm!q@;M$kjz~ z`!}IW{F?wid-{UBeR{g${->r%w#U}17pN+Logg4cYot1T&;I-(PL8_9INVC|SKGHr zd;iloXk0qAsCe^()9-Ou#{b@Y{^f1{Ne}+xP04J1jrw1ePS+=g;lJ6#N_HL`t=KK` z(*ctV;W{10r?*eHShC-o`T5^_(Yw>(c>SE3&LsTVU&rWwJNSQnbljvI4OB+b`PWQ* z3;c7q|KBe4Z~j%~u^f%JgrxoHoumKtor9%k(ta&gJZ{?#9n!5`9T@q_z_xH-!CBG*GJ1}cvL7ns;a80 z(0;O8$*d~@?;TpCmdDEWK;{La8viY&NWHLy{eHES6&wzimC3~nZ*My!y?r_UYsR6p zlAiv>j#(Nf-1mLmUN7Dj6x6<2^{&06Ls)3c(`jRSdS^%BmSA_5I;myv$4BM1=twCu zk?TXePha>z$sDT2T6#*f(VaygEi@2MY>Z~9=OMM=mKFvIx$9>A%?7lt1O#_EV_FUZ zl006oilc_#6TB-POs}-xBkzn>V&tDK0Erq;mZl|`nRQ-|an3Y-+TPyA&e&#!rOm`r z;CFWRrhc7b$%sSV#fUw2X%F;&HLY>gy-&~G`dt_j6^4W!7k>gN&%ch;R11w>fMtlV z{xLZr8H;mhaZsFit!oW!Talm*uR4T^AK5P`l_J4ld z2Z{O-2NJ>5*#Brk@)gbAoC-bu`M9+PAR)J9V_0nKRuHqp#d7akdW3Cyb zn3{gnC;uAxNVmkMz7Y{K+F;zUNyHpXLq|imv^uR*Fkreco5=6(F}Lj81QF;#uzvA? z*exbkZW$RGrRnO%gG4sHg;^WJo|AoDQL}TDV+L1twl9J5u6deVnG+v}O)s8MRo4g+ zU0D@Ph9(tvlPQwA`iUv2Wy;Caxa9 zTY>8XwKbj!iQKiyZ-POIEFGJ#F2X0Eu1?-yKK`&FM@?Oocxqu~XL_gW^6Es>_;(R5 zE~}=_4NC6=d*zAnF-_|Uh!xJr(R2yko*-Aeur}`58Bl8ahAiaYACB^^~TRQuxehn zzq3mn-%Fja8KJ&*i`RMkJcF+sa~!|HDhj`&e-ZzeURZY?^Z>;U8D`Y}rVWXz(_0Rl( z41E*MnDwv|$|Nt1d#}q$uUgX6a$CR9k$%1aGPJ3ws1jczr>i)OQ|+ZoKZCPQ^e|k{ z{!$MSfTWgqqp~WjF?!tE-_)d~<-VRx0cnTG42RKq3&JOrIXO9GhRflV67&!qW#zQE zXKYcVo_5*SYhZ6Mj~#~2vFgs`v5VqYCu~C2uHT^E-f*4R-TK)}-?O0b&`25&wi1r{ zr;Ce|9Bwb67$+d9fUO}5Gt-yPrjQvL>R_H8tWG56ixL`@<>%+`_9f3wEh#G`iXc5Y z2pN3E3=lR0z0r%!jRG-3_Ff=GmVT0ZNrtu|Q2V(Is3!pjsrn8*6rb{6$zzsi{xKK}Y5gR_|Y(xsp-(Zk!hMn&)I>Ih}C=uLgen3*}NbZSk1 zd|k&NxJTV(^DM!Jv)9|T9C~kdVWn?U*KxlP=2}YGaiiEdu7}~SMl2i1|1D;0VzMz( z<2oBimFAExx?$+xtx$d;!m0 zep-;5TUa{^GadH#c!MprG9d9~NPk;YuQEHjUxlwE{9T?EVn_S9(o9yvN!=Fp)KRwW zqr==@czVO7th`*C<5bx2N2*G8UYD!i4IbMh)<&ugY8AkM)}85r$eLv;1C#XGutfuF8^V&f5; zHPyq<^-oQv{aFy->8(U8Wu%6jFnxdR{x%>U*s}wT)j7#f6Tl8Gmm?3ZjMqeQKXHXBYz@!Y5`Jpy8^X2HsLf= z1QJ5Z9O>lssMKJW-%oZA1xByyvuUz**$Np0{8J3Rr#pO$9siH!4kuf-Y-4 zJX%^>Y&x4Gn1@UElGull8vz0#Eg%uxP7(ex#7@pl&XqJN`P+*Ne+9X%vo$UYuI4JvSVfnZJVvto>f2*p@l$K%e83|Cv(JOS$$ z@xY*SucH2 z93*noiXD}#@3`c(gs(l)vW(|-PUS9;{UDHswjmSyH4rTrXxI3;SI5D_ii^B0Eg01I z6^XXi@X${0hqw7bHAyN^ubS^%LCd!@Ct9vvG^-P$_YJY>0o1GX1aBiVJ4D1A-Hy&j z$7x4LM{8(k9uuA?y~*3tcQ1K8%aYuEgTZJdph;_VBrdu+t`d^f^|^%MS^{kX22}i- zbEqmvFnVb&hc~b{HI)yMS)ZDj*nej~Zhf{O-x{=LM1;g;DMpQp3ss-Qj$aU0Gkd+j z%)Bk)(^S4fW@2G&WOxS-E4lPxvEQ@#W|hu(>PMN!!K4M1s`PTBY z4m5%R(S;{x#qW#~2JF-F_x|W;Q!&VV8SM@yS>>@a&MO){qNAFk5?O>uk)nv>dcT3$y?YD|zyMZP3vqFktyiaa;nrH3H;XMo+Xu~a(;ESB zzTA~oYj3nsOE02@9Zuc9v87^+}l9sL%!huENMAEBXmm zo=Ymip%Dx1KwLqTD{H9i4uy3&t&9xU*VlByPIxP_^D+h5^+;!7CKlm}l9P&3*jleywvJ6~obw5K=bo(1^@|Lv zbn)j#0?=cts0=BXj;058vamY-a*W&{+uc{L{=?60JPy(Ng?HnNvR?{3LAtIBH*|g< z9%bh^8JRm?q3d6y5*t1_>|^6dHhNQTLkZ&iYe!3D(Y0$xy57PNI<7jMl+QPw*loUC zb0yJBYzkeKMLKLv*3#jRv8d3lgt?6c?JTIb=g;-15oP5f-Ky9-HNR$&`MH}0QO?}4 z@bT{PaM`|E9SP}5cQ5M)V&tCFhCEQEt%<(7BESzt0#R zD|UJ6A(XAUzd^!g8duoo7GH~QEH%NcwLF)ilFEAja1Kog>rE!BYiUU-smRyGTPIit zUM3CG(}j7dl53Cl=K7x}k_kEfNgr-HXwEG<4q=%TE?A>mmngfyy?Ma9*cdV$VA?J( zi)3Tn9_Xd0z|(4L$lVlt!TcQENtdx%ZHnOw*_&7;d;`{4e_}!cV}-W1CMKeFaX%?y z;3*!vSx+j8y}6=jgeRvO8lQXv2rM_g;mF-AnKAA`zOV`(l_HT?t{X`OTquAM8y zg=GghjGldkce5Xc%iDhI@g6N?*1KP$lw8oOlB0UzNlX)T2-Ia>TUwh~y}=wWn)0Yh zDQzH^rERB-OMz}UE-q%!$>g$T0z<+|{Nd8Kingf!h&f={%UMXwKCM%Vfe_7#Y{QO1 zHV*!=eieJ%>{R+eUu*BQWr12jZu<+Q$M&WkgKrV^CHe6v%p0Vtj!j7PFy0t^A1@b@ z`zkHBy{m=)aAyBPm1copDd{6g`SoH&oR9LIt}cK&3rtKI2%467S~{XD%cz}sinmGLu)CZ> zZ+5e%5c;542_s|O9mcxGP`bUr_h^w5uNEwnEgzMdoBMEyQzfCg8atWng0RrmreW~K zd0RRAX98ccX0O1fMpqX89JOE_hvrke0*b$@sh1XKn|F-Z8XBdViM$d#zjI)prdE)n ztB!QB2I~dwgg3odMmRb^Ew85Lk|22^{6ewIJasfuP1W_0)5VK6$gGm@EAOB_BQV2L z`)5%x^0l{jc9w+*a$tY>alo0dSQpH|(L(5{umX5L2Mzs6M@>+nFf_JSJ6iO~U zxsoKGc%4t-qVK~BkHPqR;^TPp=E*bHt{H$s>g2WGCX_UoVl{wYIR8j?_g0@_8_9wc?Ffg<>^m$hgslZ zxi~1RSaI$n&Tg|97gKYCP;Adyd%Rl@%-7{5khHV@L3_I|+1#9S07=e$b_%ikHmJEG z9ZgH=q)0X1lYk~o4J|ZO2CqR{~(YjZkAp2|o{SzWiNbZ!13zR*dZTgTgrs9|{A9tEZqG_F><|4tB#*J|G`rsN zaN18z7xFBj-pP3k#j|JcfadK5i~Rm-k7_Igr0aEXuvEnCE)AqPvmnTzCFqVOp>{80 zEpk^|V9`lF$k^CaJTnCKZF(usm|m1f8W&#K$B*{IoS`(R45l`2EjQ8Z^gL4?$hiI|-7MGSjsPguelV#Cn z@RcmcE#veN(eaZ6sm~TnvQ`R(`m+asZkjXZO@BYCITksc+{S8Sadvrq zf-Qd`S;;JvUQXsCYG;6|w<;q;UOc8xE7u>`RS#zb*LuQ9|MhtzTh)L%vRi}c2o?hamiFkS% za;BQ{!+EUK1@kD@MF5wS86NmVIhb6SHcGB^lB`2uJ2f#H@hn_MiDNB@BE+`*w8pe&u za_ypMs}2145sc{e?(R+Q;tBr>ec3LdHx{a{-Y7+Ih&P!||?chOM?*J+R8)W%Pm`4MRQP!Xf*M6%povT8*b4)2k>m<1zB%7reG z!(?200kR{%MCraC89ko{xPXk=q`d9=E^M=(Nlv?BCG*@EpNG{ROcCwKO$Nt>H=!H!wgeg^T23 z_ho}XAV-1q+8x1tg^!{IN_lIv3H64E(J=_QmQhfaUhVape=N(?5}pP2O(>6IA(f2l(Mg#~w5R+m=EYEWaM1FoZywM!UZ z`c5z##RLL>!m>KC%TW4#n>D6b*3i6$B}!W9_P_7V>4jI+n&Hx z=A0M(b8{7dM=$ZE-v}$pb4^TIW6F{aTuxdA%nAYIN-qjY#Xabl$b`A>+s@oNgmmF{ zgXNYUd_stB5c2H}yDL&T%w+Va5E5(>g*yxXVCP8R|6GF5cP#4-UB%q-m9DmXm@Av~ z?X&dKYM5jJ0>aY+w>~zdWPk85P}G|{Rhb=x)!>u0XFjW|TPe~HqgNegX`Fbr-rJ78 zW=B0eQMRT+vjK2uG4$Y7Qb<7!GD<%no6UJ7Y`SagaQX6T^{nJOwY;?<$7G0+0YstK zPq~8YrW!b0sHZ$SKI|@J^QPb2CCSFW{?=a3BERZTRl3_S1$4Gl%kxVs^X{XLS?Nl~ z>p#9Qk>PN=qQkZmCCJp&RGbjyG&>VB6C8C&`(DQ0Xu^BLhf+Tg<-M?e=HysXO2VxY zSyhPux}k;nxg=3~6sS7=%jtbX5Q^4=t}Kve&37hVyLQXeH1mLmVJpvs1zmWo22BJw zumR(}VCt<&aOg`*yAvOuV40g&=IEdpFI3~v;m;^#>)9_C1WQjYwp;bJ0A(VhISk|g z)QgPE`=F!uS^slX6y8d#H>F-`MMyb?fiJq((3)(r>9MLEAOBB~ ztwZ-34`+BqNk>-~NX^!>KaRi8%be@{?j^C3jt-~EQ9i`mQ}H9sXq9q4fV@9^kQv$A zRR%Db9+H8NugF=ILM&du8#eLHfL%ni2#ON z0U>8N_W~A@g^H0}7rN9ptF*b?vDK@=L1v#0&!4BMblc8w{2_4&PA-B~9-w%-N<_rr z6RHneSwWX}wBZR77pekWY%hl_FHf$T=Dq~mN0F{frPtEf=7&(;n#nKT+TQ0zJl)_W zunIoa`yd}p(6%G+DbWeri24DlA@>S3Pvfr0?r0l5h;;{R{=>Gm!mPXZ^!PK7{GFQs zV?nG2TOGp+Ehwqi*5}MjjI@=Nl~W$EusxJklxgj(99)H;BdXP=zkXw8e#ywd1ngHY zY_4bC)dhY@wX4)m9Fz7)U)py{T;iKf)FbDi(NSIb+?tmK)zxEsx5HzH40+U@;spRTCXH*-V$KWDk{Xp_G<&xkXMY5~Q{^dL(c z2z?e778Iu34+YY7<5uZ?4mmdOUGycuRN@ zZVi4KgJn;t-hWCna&HZhPz`_^5)d%{l~Ml-ANfzN@n3FQJ`z1{WaG#}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Comment générer un code‑barres DataMatrix en Python avec Aspose.BarCode + +Si vous devez **générer un code‑barres DataMatrix** en Python tout en **encodant du texte russe**, ce guide vous montre les étapes exactes. Vous verrez un exemple complet et exécutable qui construit un texte de code étendu, configure le code‑barres et enregistre l’image dans un seul script. + +Créer des codes‑barres contenant des caractères non‑ASCII soulève souvent des questions sur les jeux de caractères et l’encodage des données. En utilisant `ExtCodetextBuilder` d’Aspose.BarCode, vous pouvez intégrer en toute sécurité du texte UTF‑8 tel que des caractères cyrilliques dans un symbole DataMatrix. Le résultat fonctionne avec n’importe quel lecteur compatible avec la norme DataMatrix. + +Dans ce tutoriel, vous allez : + +* Installer le package Aspose.BarCode requis. +* Construire un texte de code étendu qui mélange des données simples et du texte russe. +* **Générer un code‑barres DataMatrix** avec la chaîne étendue. +* Ajuster les paramètres du code‑barres comme la taille du module. +* Enregistrer le code‑barres sous forme de fichier PNG. + +Aucun service externe n’est nécessaire ; tout s’exécute localement sur votre machine. + +## Prérequis + +Avant de commencer, assurez‑vous d’avoir : + +* Python 3.8 ou une version plus récente installé. +* Une licence active d’Aspose.BarCode for Python (une version d’essai gratuite suffit pour le développement). +* Une connaissance de base du scripting Python. + +Vous pouvez installer la bibliothèque Aspose.BarCode via pip : + +```bash +pip install aspose-barcode +``` + +## Étape 1 : Construire une chaîne de texte de code étendue + +La première tâche consiste à créer une seule chaîne contenant à la fois l’identifiant produit simple et la phrase russe. `ExtCodetextBuilder` vous permet de concaténer différentes parties de texte de code tout en préservant leurs informations d’encodage. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Pourquoi cette étape est importante** – Les symboles DataMatrix stockent des octets bruts. Lorsque vous devez mélanger des alphabets, vous devez indiquer à l’encodeur quel jeu de caractères s’applique à chaque segment. La méthode `add_eci_codetext` insère un indicateur ECI avant le texte russe, garantissant que les lecteurs interprètent les octets comme UTF‑8. Sans ECI, les caractères cyrilliques apparaîtraient comme des données corrompues. + +## Étape 2 : Créer un générateur de code‑barres DataMatrix + +Une fois le texte de code étendu prêt, créez une instance de `BarcodeGenerator` en spécifiant le type `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Pourquoi DataMatrix ?** – DataMatrix est un code‑barres bidimensionnel qui peut stocker jusqu’à 2 335 caractères alphanumériques ou 1 556 octets. Il est idéal pour les petits objets, les pièces industrielles et les situations où vous devez intégrer du texte multilingue. + +## Étape 3 : (Facultatif) Configurer les paramètres du code‑barres + +Aspose.BarCode expose de nombreux paramètres. Pour la plupart des cas d’usage, les paramètres par défaut produisent un symbole lisible. Cependant, vous pouvez vouloir contrôler la taille de chaque module (le plus petit carré de la matrice) afin de répondre aux exigences d’impression. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +D’autres paramètres utiles incluent le niveau de correction d’erreurs, la marge et la couleur d’arrière‑plan. Ajustez‑les uniquement si votre environnement de lecture cible impose des tolérances spécifiques. + +## Étape 4 : Enregistrer l’image du code‑barres + +Enfin, écrivez le code‑barres dans un fichier. La méthode `save` prend en charge PNG, JPEG, BMP et plusieurs formats vectoriels. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Lorsque vous ouvrirez `extended_codetext.png`, vous verrez un symbole DataMatrix net. Le scanner le décodera en deux parties : + +1. **ABC123** – l’identifiant simple. +2. **Привет** – le salut russe, correctement décodé en UTF‑8. + +## Exemple complet et exécutable + +Voici le script complet que vous pouvez copier‑coller dans un fichier nommé `generate_datamatrix.py`. Remplacez `YOUR_DIRECTORY` par un dossier existant sur votre système. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Exécutez le script depuis la ligne de commande : + +```bash +python generate_datamatrix.py +``` + +Vous devriez voir une sortie console similaire à : + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Vérifier le résultat + +Pour confirmer que le code‑barres encode correctement la phrase russe : + +1. Ouvrez le fichier PNG dans un visualiseur d’images. +2. Utilisez n’importe quelle application de lecture DataMatrix (de nombreuses applications mobiles le supportent) ou un scanner matériel. +3. La chaîne décodée doit afficher `ABC123Привет` (ou les deux parties séparées selon l’interface du scanner). + +Si les caractères russes apparaissent comme du texte illisible, vérifiez que le scanner prend en charge l’ECI UTF‑8. La plupart des lecteurs modernes le font, mais les appareils plus anciens peuvent nécessiter une configuration explicite. + +## Pièges courants et comment les éviter + +| Problème | Cause | Solution | +|----------|-------|----------| +| Texte cyrillique corrompu | Indicateur ECI manquant | Utilisez `add_eci_codetext` avec `eci_encoding=3`. | +| Code‑barres trop petit pour l’imprimante | Taille de module par défaut trop fine pour une faible résolution DPI | Augmentez `x_dimension` (par ex., `3.0` ou `4.0`). | +| Fichier non enregistré | Chemin du répertoire invalide | Assurez‑vous que `YOUR_DIRECTORY` existe et est accessible en écriture. | +| Le scanner ne lit pas | Densité de données excessive | Réduisez la quantité de données encodées ou augmentez le niveau de correction d’erreurs (`generator.parameters.barcode.error_correction_level`). | + +## Étendre l’exemple + +Vous pouvez adapter ce modèle à d’autres langues ou types de données : + +* **Encoder du texte japonais ou arabe** – changez `eci_encoding` à la valeur appropriée (par ex., 5 pour ISO‑8859‑5, 6 pour ISO‑8859‑7). +* **Ajouter plusieurs segments ECI** – appelez `add_eci_codetext` plusieurs fois, chacun avec son propre encodage. +* **Créer un QR code à la place** – remplacez `EncodeTypes.DATA_MATRIX` par `EncodeTypes.QR`. + +Toutes les autres étapes restent identiques car `ExtCodetextBuilder` abstrait la gestion bas‑niveau des octets. + +## Conclusion + +Vous savez maintenant comment **générer un code‑barres DataMatrix** en Python et **encoder du texte russe** en utilisant la fonction de texte de code étendu d’Aspose.BarCode. Le script complet gère la négociation du jeu de caractères, la création du code‑barres et la génération de l’image avec seulement quelques lignes de code. + +Ensuite, explorez d’autres symbologies de code‑barres (PDF417, Aztec) ou intégrez le générateur dans un service web qui renvoie des images PNG à la demande. Les mêmes principes—construction d’un texte de code étendu et sélection du `EncodeTypes` approprié—s’appliquent à l’ensemble de la suite Aspose.BarCode. + +Bon codage, et profitez de la puissance de la génération multilingue de codes‑barres ! + +## Que devez‑vous apprendre ensuite ? + +Les tutoriels suivants couvrent des sujets étroitement liés qui s’appuient sur les techniques démontrées dans ce guide. Chaque ressource comprend des exemples de code complets avec des explications pas à pas pour vous aider à maîtriser d’autres fonctionnalités de l’API et à explorer des approches d’implémentation alternatives dans vos propres projets. + +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) +- [Generate a DataMatrix barcode in ASCII mode with Aspose.BarCode for .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [How to Generate DataMatrix Barcodes (ECC 200) with Aspose.BarCode for .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/german/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/german/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..903fde0a6 --- /dev/null +++ b/barcode/german/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,251 @@ +--- +category: general +date: 2026-08-22 +description: Erfahren Sie, wie Sie DataMatrix‑Barcodes in Python erzeugen und russischen + Text mit Aspose.BarCode codieren – Schritt‑für‑Schritt‑Anleitung. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: de +lastmod: 2026-08-22 +og_description: Erzeugen Sie einen DataMatrix-Barcode in Python und codieren Sie russischen + Text mit Aspose.BarCode. Folgen Sie dem vollständigen Beispiel und führen Sie es + sofort aus. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: DataMatrix-Barcode in Python generieren – vollständiges Aspose.BarCode‑Tutorial +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Wie man DataMatrix‑Barcodes in Python mit Aspose.BarCode generiert +url: /de/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Wie man DataMatrix‑Barcode in Python mit Aspose.BarCode generiert + +Wenn Sie **DataMatrix‑Barcode** in Python erzeugen und dabei **russischen Text kodieren** möchten, zeigt Ihnen diese Anleitung die genauen Schritte. Sie erhalten ein vollständiges, ausführbares Beispiel, das einen erweiterten Codetext erstellt, den Barcode konfiguriert und das Bild in einem einzigen Skript speichert. + +Das Erstellen von Barcodes, die Nicht‑ASCII‑Zeichen enthalten, wirft häufig Fragen zu Zeichensätzen und Datenkodierung auf. Durch die Verwendung von Aspose.BarCode’s `ExtCodetextBuilder` können Sie UTF‑8‑Text wie kyrillische Zeichen sicher in ein DataMatrix‑Symbol einbetten. Das Ergebnis funktioniert mit jedem Scanner, der den DataMatrix‑Standard unterstützt. + +In diesem Tutorial lernen Sie: + +* Das erforderliche Aspose.BarCode‑Paket installieren. +* Einen erweiterten Codetext erstellen, der Klartext‑Daten und russischen Text kombiniert. +* **DataMatrix‑Barcode** mit dem erweiterten String **generieren**. +* Barcode‑Parameter wie Modulgröße anpassen. +* Den Barcode als PNG‑Datei speichern. + +Es werden keine externen Dienste benötigt; alles läuft lokal auf Ihrem Rechner. + +## Voraussetzungen + +Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben: + +* Python 3.8 oder neuer installiert. +* Eine aktive Aspose.BarCode‑Lizenz für Python (eine kostenlose Testversion reicht für die Entwicklung). +* Grundlegende Erfahrung mit Python‑Skripting. + +Sie können die Aspose.BarCode‑Bibliothek über pip installieren: + +```bash +pip install aspose-barcode +``` + +## Schritt 1: Einen erweiterten Codetext‑String erstellen + +Die erste Aufgabe besteht darin, einen einzelnen String zu erzeugen, der sowohl die reine Produkt‑Kennung als auch die russische Phrase enthält. `ExtCodetextBuilder` ermöglicht das Verketten verschiedener Codetext‑Teile, wobei die jeweiligen Kodierungsinformationen erhalten bleiben. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Warum dieser Schritt wichtig ist** – DataMatrix‑Symbole speichern rohe Bytes. Wenn Sie verschiedene Alphabete mischen, müssen Sie dem Encoder mitteilen, welcher Zeichensatz auf jedes Segment angewendet wird. Die Methode `add_eci_codetext` fügt vor dem russischen Text einen ECI‑Indikator ein, sodass Scanner die Bytes als UTF‑8 interpretieren. Ohne ECI würden die kyrillischen Zeichen als fehlerhafte Daten erscheinen. + +## Schritt 2: Einen DataMatrix‑Barcode‑Generator erstellen + +Nachdem der erweiterte Codetext bereitsteht, instanziieren Sie einen `BarcodeGenerator` und geben den Typ `EncodeTypes.DATA_MATRIX` an. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Warum DataMatrix?** – DataMatrix ist ein zweidimensionaler Barcode, der bis zu 2 335 alphanumerische Zeichen oder 1 556 Bytes speichern kann. Er eignet sich ideal für kleine Objekte, Industrieteile und Situationen, in denen mehrsprachiger Text eingebettet werden muss. + +## Schritt 3: (Optional) Barcode‑Parameter konfigurieren + +Aspose.BarCode stellt zahlreiche Parameter zur Verfügung. Für die meisten Anwendungsfälle erzeugen die Standardeinstellungen ein gut lesbares Symbol. Sie können jedoch die Größe jedes Moduls (das kleinste Quadrat in der Matrix) anpassen, um den Druckanforderungen zu entsprechen. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Weitere nützliche Parameter sind Fehlkorrektur‑Level, Rand und Hintergrundfarbe. Passen Sie sie nur an, wenn Ihre Ziel‑Scanning‑Umgebung spezifische Toleranzen erfordert. + +## Schritt 4: Das Barcode‑Bild speichern + +Zum Schluss schreiben Sie den Barcode in eine Datei. Die Methode `save` unterstützt PNG, JPEG, BMP und mehrere Vektorformate. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Wenn Sie `extended_codetext.png` öffnen, sehen Sie ein gestochen scharfes DataMatrix‑Symbol. Das Scannen mit einem Standard‑DataMatrix‑Reader liefert die beiden Teile: + +1. **ABC123** – die reine Kennung. +2. **Привет** – die russische Begrüßung, korrekt als UTF‑8 dekodiert. + +## Vollständiges, ausführbares Beispiel + +Unten finden Sie das komplette Skript, das Sie in eine Datei namens `generate_datamatrix.py` kopieren können. Ersetzen Sie `YOUR_DIRECTORY` durch einen existierenden Ordner auf Ihrem System. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Führen Sie das Skript über die Befehlszeile aus: + +```bash +python generate_datamatrix.py +``` + +Sie sollten eine Konsolenausgabe ähnlich der folgenden sehen: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Ergebnis verifizieren + +Um zu bestätigen, dass der Barcode die russische Phrase korrekt kodiert: + +1. Öffnen Sie die PNG‑Datei in einem Bildbetrachter. +2. Verwenden Sie eine DataMatrix‑Scanning‑App (viele Mobil‑Apps unterstützen sie) oder einen Hardware‑Scanner. +3. Der dekodierte String sollte `ABC123Привет` anzeigen (oder die beiden Teile getrennt, je nach Scanner‑UI). + +Wenn die russischen Zeichen als Kauderwelsch erscheinen, prüfen Sie, ob der Scanner ECI UTF‑8 unterstützt. Die meisten modernen Leser tun dies, aber ältere Geräte benötigen möglicherweise eine explizite Konfiguration. + +## Häufige Fallstricke und wie man sie vermeidet + +| Problem | Ursache | Lösung | +|-------|-------|-----| +| Verzerrte kyrillische Ausgabe | Fehlender ECI‑Indikator | Verwenden Sie `add_eci_codetext` mit `eci_encoding=3`. | +| Barcode zu klein für den Drucker | Standard‑Modulgröße zu fein für niedrige DPI | Erhöhen Sie `x_dimension` (z. B. `3.0` oder `4.0`). | +| Datei nicht gespeichert | Ungültiger Verzeichnispfad | Stellen Sie sicher, dass `YOUR_DIRECTORY` existiert und beschreibbar ist. | +| Scanner kann nicht lesen | Zu hohe Datendichte | Reduzieren Sie die zu kodierenden Daten oder erhöhen Sie das Fehlkorrektur‑Level (`generator.parameters.barcode.error_correction_level`). | + +## Beispiel erweitern + +Sie können dieses Muster für andere Sprachen oder Datentypen anpassen: + +* **Japanischen oder Arabischen Text kodieren** – ändern Sie `eci_encoding` auf den passenden Wert (z. B. 5 für ISO‑8859‑5, 6 für ISO‑8859‑7). +* **Mehrere ECI‑Segmente hinzufügen** – rufen Sie `add_eci_codetext` mehrfach auf, jeweils mit einer eigenen Kodierung. +* **Stattdessen einen QR‑Code erstellen** – ersetzen Sie `EncodeTypes.DATA_MATRIX` durch `EncodeTypes.QR`. + +Alle anderen Schritte bleiben identisch, da `ExtCodetextBuilder` die low‑level Byte‑Verarbeitung abstrahiert. + +## Fazit + +Sie wissen jetzt, wie man **DataMatrix‑Barcode** in Python **generiert** und **russischen Text** mit Aspose.BarCode’s erweiterter Codetext‑Funktion kodiert. Das vollständige Skript übernimmt die Zeichensatz‑Aushandlung, die Barcode‑Erstellung und die Bildausgabe mit nur wenigen Code‑Zeilen. + +Als Nächstes können Sie weitere Barcode‑Symbologien (PDF417, Aztec) erkunden oder den Generator in einen Web‑Service integrieren, der PNG‑Bilder auf Abruf liefert. Die gleichen Prinzipien – Aufbau eines erweiterten Codetexts und Auswahl des passenden `EncodeTypes` – gelten für die gesamte Aspose.BarCode‑Suite. + +Viel Spaß beim Coden und genießen Sie die Möglichkeiten der mehrsprachigen Barcode‑Erstellung! + + +## Was sollten Sie als Nächstes lernen? + + +Die folgenden Tutorials behandeln eng verwandte Themen, die auf den in diesem Leitfaden gezeigten Techniken aufbauen. Jede Ressource enthält vollständige, funktionierende Code‑Beispiele mit Schritt‑für‑Schritt‑Erklärungen, um Ihnen zu helfen, weitere API‑Funktionen zu meistern und alternative Implementierungsansätze in Ihren eigenen Projekten zu erkunden. + +- [Wie man DataMatrix‑Barcodes mit Aspose.BarCode für .NET generiert – Schritt‑für‑Schritt‑Anleitung](/barcode/english/net/datamatrix-barcode-configuration/) +- [DataMatrix‑Barcode im ASCII‑Modus mit Aspose.BarCode für .NET (C#) generieren](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [Wie man DataMatrix‑Barcodes (ECC 200) mit Aspose.BarCode für .NET generiert](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/greek/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/greek/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..032016eda --- /dev/null +++ b/barcode/greek/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-08-22 +description: Μάθετε πώς να δημιουργείτε κώδικα DataMatrix σε Python και να κωδικοποιείτε + ρωσικό κείμενο χρησιμοποιώντας το Aspose.BarCode – οδηγός βήμα‑προς‑βήμα. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: el +lastmod: 2026-08-22 +og_description: Δημιουργήστε κωδικό DataMatrix σε Python και κωδικοποιήστε ρωσικό + κείμενο με το Aspose.BarCode. Ακολουθήστε το πλήρες παράδειγμα και εκτελέστε το + αμέσως. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Δημιουργία κωδικού DataMatrix σε Python – πλήρης οδηγός Aspose.BarCode +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Πώς να δημιουργήσετε κωδικό DataMatrix σε Python με το Aspose.BarCode +url: /el/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Πώς να δημιουργήσετε DataMatrix barcode σε Python με Aspose.BarCode + +Αν χρειάζεστε **να δημιουργήσετε DataMatrix barcode** σε Python ενώ **κωδικοποιείτε ρωσικό κείμενο**, αυτός ο οδηγός σας δείχνει τα ακριβή βήματα. Θα δείτε ένα πλήρες, εκτελέσιμο παράδειγμα που δημιουργεί ένα επεκταμένο codetext, διαμορφώνει τον γραμμωτό κώδικα και αποθηκεύει την εικόνα σε ένα μόνο script. + +Η δημιουργία γραμμωτών κωδίκων που περιέχουν μη‑ASCII χαρακτήρες συχνά εγείρει ερωτήματα σχετικά με τα σύνολα χαρακτήρων και την κωδικοποίηση δεδομένων. Χρησιμοποιώντας το `ExtCodetextBuilder` του Aspose.BarCode, μπορείτε με ασφάλεια να ενσωματώσετε κείμενο UTF‑8 όπως κυριλλικούς χαρακτήρες μέσα σε ένα σύμβολο DataMatrix. Το αποτέλεσμα λειτουργεί με οποιονδήποτε σαρωτή που υποστηρίζει το πρότυπο DataMatrix. + +Σε αυτό το tutorial θα: + +* Εγκαταστήσετε το απαιτούμενο πακέτο Aspose.BarCode. +* Δημιουργήσετε ένα επεκταμένο codetext που συνδυάζει απλά δεδομένα και ρωσικό κείμενο. +* **Δημιουργήσετε DataMatrix barcode** με το επεκταμένο κείμενο. +* Προσαρμόσετε τις παραμέτρους του γραμμωτού κώδικα όπως το μέγεθος του μονάδας. +* Αποθηκεύσετε τον γραμμωτό κώδικα ως αρχείο PNG. + +Δεν απαιτούνται εξωτερικές υπηρεσίες· όλα εκτελούνται τοπικά στον υπολογιστή σας. + +## Προαπαιτούμενα + +Πριν ξεκινήσετε, βεβαιωθείτε ότι έχετε: + +* Εγκατεστημένη έκδοση Python 3.8 ή νεότερη. +* Ένα ενεργό άδεια Aspose.BarCode για Python (μια δωρεάν δοκιμή λειτουργεί για ανάπτυξη). +* Βασική εξοικείωση με scripting σε Python. + +Μπορείτε να εγκαταστήσετε τη βιβλιοθήκη Aspose.BarCode μέσω pip: + +```bash +pip install aspose-barcode +``` + +## Βήμα 1: Δημιουργία επεκταμένου κειμένου codetext + +Η πρώτη εργασία είναι να δημιουργήσετε μια ενιαία συμβολοσειρά που περιέχει τόσο το απλό αναγνωριστικό προϊόντος όσο και τη ρωσική φράση. Το `ExtCodetextBuilder` σας επιτρέπει να συνενώσετε διαφορετικά τμήματα codetext διατηρώντας τις πληροφορίες κωδικοποίησής τους. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Γιατί αυτό το βήμα είναι σημαντικό** – Τα σύμβολα DataMatrix αποθηκεύουν ακατέργαστα bytes. Όταν χρειάζεται να συνδυάσετε αλφάβητα, πρέπει να ενημερώσετε τον κωδικοποιητή ποιο σύνολο χαρακτήρων ισχύει για κάθε τμήμα. Η μέθοδος `add_eci_codetext` εισάγει έναν δείκτη ECI πριν από το ρωσικό κείμενο, εξασφαλίζοντας ότι οι σαρωτές ερμηνεύουν τα bytes ως UTF‑8. Χωρίς το ECI, οι κυριλλικοί χαρακτήρες θα εμφανίζονταν ως ακατάστατο κείμενο. + +## Βήμα 2: Δημιουργία γεννήτριας γραμμωτού κώδικα DataMatrix + +Με το επεκταμένο codetext έτοιμο, δημιουργήστε ένα αντικείμενο `BarcodeGenerator` καθορίζοντας τον τύπο `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Γιατί DataMatrix;** – Το DataMatrix είναι ένας δισδιάστατος γραμμωτός κώδικας που μπορεί να αποθηκεύσει έως 2.335 αλφαριθμητικούς χαρακτήρες ή 1.556 bytes. Είναι ιδανικό για μικρά αντικείμενα, βιομηχανικά εξαρτήματα και καταστάσεις όπου χρειάζεται να ενσωματώσετε πολυγλωσσικό κείμενο. + +## Βήμα 3: (Προαιρετικό) Διαμόρφωση παραμέτρων γραμμωτού κώδικα + +Το Aspose.BarCode εκθέτει πολλές παραμέτρους. Για τις περισσότερες περιπτώσεις χρήσης, οι προεπιλεγμένες ρυθμίσεις παράγουν ένα αναγνώσιμο σύμβολο. Ωστόσο, μπορεί να θέλετε να ελέγξετε το μέγεθος κάθε μονάδας (το μικρότερο τετράγωνο στο πλέγμα) ώστε να ταιριάζει με τις απαιτήσεις εκτύπωσης. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Άλλες χρήσιμες παράμετροι περιλαμβάνουν το επίπεδο διόρθωσης σφαλμάτων, το περιθώριο και το χρώμα φόντου. Προσαρμόστε τις μόνο εάν το περιβάλλον σάρωσης που στοχεύετε απαιτεί συγκεκριμένες ανοχές. + +## Βήμα 4: Αποθήκευση εικόνας γραμμωτού κώδικα + +Τέλος, γράψτε τον γραμμωτό κώδικα σε αρχείο. Η μέθοδος `save` υποστηρίζει PNG, JPEG, BMP και αρκετές διανυσματικές μορφές. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Όταν ανοίξετε το `extended_codetext.png`, θα δείτε ένα καθαρό σύμβολο DataMatrix. Η σάρωση του με έναν τυπικό αναγνώστη DataMatrix επιστρέφει τα δύο τμήματα: + +1. **ABC123** – το απλό αναγνωριστικό. +2. **Привет** – η ρωσική χαιρετιστική φράση, σωστά αποκωδικοποιημένη ως UTF‑8. + +## Πλήρες, εκτελέσιμο παράδειγμα + +Παρακάτω βρίσκεται το πλήρες script που μπορείτε να αντιγράψετε‑επικολλήσετε σε ένα αρχείο με όνομα `generate_datamatrix.py`. Αντικαταστήστε το `YOUR_DIRECTORY` με έναν υπάρχον φάκελο στο σύστημά σας. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Εκτελέστε το script από τη γραμμή εντολών: + +```bash +python generate_datamatrix.py +``` + +Θα πρέπει να δείτε έξοδο στην κονσόλα παρόμοια με: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Επαλήθευση του αποτελέσματος + +Για να επιβεβαιώσετε ότι ο γραμμωτός κώδικας κωδικοποιεί σωστά τη ρωσική φράση: + +1. Ανοίξτε το αρχείο PNG σε προβολέα εικόνων. +2. Χρησιμοποιήστε οποιαδήποτε εφαρμογή σάρωσης DataMatrix (πολλές κινητές εφαρμογές το υποστηρίζουν) ή έναν υλικό σαρωτή. +3. Η αποκωδικοποιημένη συμβολοσειρά θα πρέπει να εμφανίζει `ABC123Привет` (ή τα δύο τμήματα χωριστά ανάλογα με το UI του σαρωτή). + +Αν οι ρωσικοί χαρακτήρες εμφανίζονται ως ακατάστατο κείμενο, ελέγξτε ξανά ότι ο σαρωτής υποστηρίζει ECI UTF‑8. Οι περισσότεροι σύγχρονοι αναγνώστες το κάνουν, αλλά οι παλαιότερες συσκευές μπορεί να χρειάζονται ρητή διαμόρφωση. + +## Συνηθισμένα προβλήματα και πώς να τα αποφύγετε + +| Πρόβλημα | Αιτία | Διόρθωση | +|----------|-------|----------| +| Ακατάστατη έξοδος κυριλλικών | Έλλειψη δείκτη ECI | Χρησιμοποιήστε `add_eci_codetext` με `eci_encoding=3`. | +| Ο γραμμωτός κώδικας είναι πολύ μικρός για τον εκτυπωτή | Το προεπιλεγμένο μέγεθος μονάδας είναι πολύ μικρό για χαμηλό DPI | Αυξήστε το `x_dimension` (π.χ., `3.0` ή `4.0`). | +| Το αρχείο δεν αποθηκεύεται | Μη έγκυρη διαδρομή φακέλου | Βεβαιωθείτε ότι το `YOUR_DIRECTORY` υπάρχει και είναι εγγράψιμο. | +| Ο σαρωτής δεν μπορεί να διαβάσει | Υπερβολική πυκνότητα δεδομένων | Μειώστε την ποσότητα των κωδικοποιημένων δεδομένων ή αυξήστε το επίπεδο διόρθωσης σφαλμάτων (`generator.parameters.barcode.error_correction_level`). | + +## Επέκταση του παραδείγματος + +Μπορείτε να προσαρμόσετε αυτό το μοτίβο για άλλες γλώσσες ή τύπους δεδομένων: + +* **Κωδικοποίηση ιαπωνικού ή αραβικού κειμένου** – αλλάξτε το `eci_encoding` στην κατάλληλη τιμή (π.χ., 5 για ISO‑8859‑5, 6 για ISO‑8859‑7). +* **Προσθήκη πολλαπλών τμημάτων ECI** – καλέστε το `add_eci_codetext` πολλές φορές, το καθένα με τη δική του κωδικοποίηση. +* **Δημιουργία κώδικα QR αντί αυτού** – αντικαταστήστε το `EncodeTypes.DATA_MATRIX` με `EncodeTypes.QR`. + +Όλα τα άλλα βήματα παραμένουν ίδια επειδή το `ExtCodetextBuilder` αφαιρεί την ανάγκη χειρισμού χαμηλού επιπέδου bytes. + +## Συμπέρασμα + +Τώρα ξέρετε πώς να **δημιουργήσετε DataMatrix barcode** σε Python και **να κωδικοποιήσετε ρωσικό κείμενο** χρησιμοποιώντας τη λειτουργία επεκταμένου codetext του Aspose.BarCode. Το πλήρες script διαχειρίζεται τη διαπραγμάτευση συνόλων χαρακτήρων, τη δημιουργία του γραμμωτού κώδικα και την έξοδο εικόνας με λίγες μόνο γραμμές κώδικα. + +Στη συνέχεια, εξερευνήστε άλλες συμβολές γραμμωτών κωδίκων (PDF417, Aztec) ή ενσωματώστε τη γεννήτρια σε μια web υπηρεσία που επιστρέφει εικόνες PNG κατόπιν αιτήματος. Οι ίδιες αρχές—δημιουργία επεκταμένου codetext και επιλογή του κατάλληλου `EncodeTypes`—εφαρμόζονται σε όλη τη σουίτα Aspose.BarCode. + +Καλή προγραμματιστική εργασία και απολαύστε τη δύναμη της πολυγλωσσικής δημιουργίας γραμμωτών κωδίκων! + +## Τι πρέπει να μάθετε στη συνέχεια; + +Τα παρακάτω tutorials καλύπτουν στενά συναφή θέματα που βασίζονται στις τεχνικές που παρουσιάστηκαν σε αυτόν τον οδηγό. Κάθε πόρος περιλαμβάνει πλήρη λειτουργικά παραδείγματα κώδικα με βήμα‑βήμα εξηγήσεις για να σας βοηθήσουν να κυριαρχήσετε επιπλέον δυνατότητες του API και να εξερευνήσετε εναλλακτικές προσεγγίσεις υλοποίησης στα δικά σας έργα. + +- [Πώς να δημιουργήσετε γραμμωτούς κώδικες DataMatrix χρησιμοποιώντας το Aspose.BarCode για .NET – Οδηγός βήμα‑βήμα](/barcode/english/net/datamatrix-barcode-configuration/) +- [Δημιουργία γραμμωτού κώδικα DataMatrix σε λειτουργία ASCII με το Aspose.BarCode για .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [Πώς να δημιουργήσετε γραμμωτούς κώδικες DataMatrix (ECC 200) με το Aspose.BarCode για .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hindi/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/hindi/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..c7e9af0a7 --- /dev/null +++ b/barcode/hindi/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Python में DataMatrix बारकोड बनाना सीखें और Aspose.BarCode का उपयोग करके + रूसी पाठ को एन्कोड करें – चरण‑दर‑चरण गाइड। +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: hi +lastmod: 2026-08-22 +og_description: Python में DataMatrix बारकोड जेनरेट करें और Aspose.BarCode के साथ + रूसी टेक्स्ट एन्कोड करें। पूर्ण उदाहरण का पालन करें और तुरंत चलाएँ। +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Python में DataMatrix बारकोड जेनरेट करें – पूर्ण Aspose.BarCode ट्यूटोरियल +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Python में Aspose.BarCode के साथ DataMatrix बारकोड कैसे बनाएं +url: /hi/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Python में Aspose.BarCode के साथ DataMatrix बारकोड कैसे जेनरेट करें + +यदि आपको **Python में DataMatrix बारकोड** जेनरेट करना है और **रूसी टेक्स्ट** एन्कोड करना है, तो यह गाइड आपको सटीक चरण दिखाता है। आप एक पूर्ण, चलाने योग्य उदाहरण देखेंगे जो विस्तारित कोडटेक्स्ट बनाता है, बारकोड को कॉन्फ़िगर करता है, और एक ही स्क्रिप्ट में इमेज को सेव करता है। + +गैर‑ASCII अक्षरों वाले बारकोड बनाते समय अक्सर कैरेक्टर सेट और डेटा एन्कोडिंग के बारे में सवाल उठते हैं। Aspose.BarCode के `ExtCodetextBuilder` का उपयोग करके आप UTF‑8 टेक्स्ट (जैसे सायरिलिक अक्षर) को सुरक्षित रूप से DataMatrix सिम्बल में एम्बेड कर सकते हैं। परिणाम किसी भी स्कैनर के साथ काम करता है जो DataMatrix मानक को सपोर्ट करता है। + +इस ट्यूटोरियल में आप करेंगे: + +* आवश्यक Aspose.BarCode पैकेज इंस्टॉल करेंगे। +* साधारण डेटा और रूसी टेक्स्ट को मिलाकर एक विस्तारित कोडटेक्स्ट बनाएँगे। +* विस्तारित स्ट्रिंग के साथ **DataMatrix बारकोड** जेनरेट करेंगे। +* मॉड्यूल साइज जैसी बारकोड पैरामीटर्स को समायोजित करेंगे। +* बारकोड को PNG फ़ाइल के रूप में सेव करेंगे। + +कोई बाहरी सर्विस आवश्यक नहीं है; सब कुछ आपके स्थानीय मशीन पर चलता है। + +## Prerequisites + +शुरू करने से पहले सुनिश्चित करें कि आपके पास है: + +* Python 3.8 या उससे नया संस्करण। +* Aspose.BarCode for Python का सक्रिय लाइसेंस (डेवलपमेंट के लिए फ्री ट्रायल चल सकता है)। +* Python स्क्रिप्टिंग की बुनियादी जानकारी। + +आप pip के माध्यम से Aspose.BarCode लाइब्रेरी इंस्टॉल कर सकते हैं: + +```bash +pip install aspose-barcode +``` + +## Step 1: Build an extended codetext string + +पहला कार्य यह है कि एक ही स्ट्रिंग बनाएं जिसमें साधारण प्रोडक्ट आइडेंटिफायर और रूसी वाक्य दोनों हों। `ExtCodetextBuilder` आपको विभिन्न कोडटेक्स्ट भागों को जोड़ने की सुविधा देता है, जबकि उनकी एन्कोडिंग जानकारी को बरकरार रखता है। + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**यह चरण क्यों महत्वपूर्ण है** – DataMatrix सिम्बल रॉ बाइट्स स्टोर करता है। जब आप विभिन्न अल्फाबेट्स को मिलाते हैं, तो आपको एन्कोडर को बताना पड़ता है कि प्रत्येक सेगमेंट पर कौन सा कैरेक्टर सेट लागू होता है। `add_eci_codetext` मेथड रूसी टेक्स्ट से पहले एक ECI इंडिकेटर डालता है, जिससे स्कैनर बाइट्स को UTF‑8 के रूप में पढ़ता है। बिना ECI के सायरिलिक अक्षर गड़बड़ डेटा की तरह दिखेंगे। + +## Step 2: Create a DataMatrix barcode generator + +विस्तारित कोडटेक्स्ट तैयार होने पर, `BarcodeGenerator` को `EncodeTypes.DATA_MATRIX` टाइप के साथ इंस्टैंशिएट करें। + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**DataMatrix क्यों?** – DataMatrix एक दो‑आयामी बारकोड है जो अधिकतम 2,335 अल्फ़ान्यूमेरिक कैरेक्टर्स या 1,556 बाइट्स स्टोर कर सकता है। यह छोटे आइटम, औद्योगिक पार्ट्स, और उन स्थितियों के लिए आदर्श है जहाँ आपको बहुभाषी टेक्स्ट एम्बेड करना होता है। + +## Step 3: (Optional) Configure barcode parameters + +Aspose.BarCode कई पैरामीटर्स प्रदान करता है। अधिकांश उपयोग मामलों में डिफ़ॉल्ट सेटिंग्स एक पठनीय सिम्बल बनाती हैं। फिर भी, आप प्रिंटिंग आवश्यकताओं के अनुसार प्रत्येक मॉड्यूल (मैट्रिक्स में सबसे छोटा वर्ग) का आकार नियंत्रित करना चाह सकते हैं। + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +अन्य उपयोगी पैरामीटर्स में एरर करेक्शन लेवल, मार्जिन, और बैकग्राउंड कलर शामिल हैं। इन्हें केवल तभी बदलें जब आपके लक्ष्य स्कैनिंग वातावरण को विशेष टॉलरेंस की आवश्यकता हो। + +## Step 4: Save the barcode image + +अंत में, बारकोड को फ़ाइल में लिखें। `save` मेथड PNG, JPEG, BMP, और कई वेक्टर फ़ॉर्मेट्स को सपोर्ट करता है। + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +जब आप `extended_codetext.png` खोलेंगे, तो आपको एक स्पष्ट DataMatrix सिम्बल दिखाई देगा। इसे एक मानक DataMatrix रीडर से स्कैन करने पर दो भाग मिलेंगे: + +1. **ABC123** – साधारण आइडेंटिफायर। +2. **Привет** – रूसी अभिवादन, सही ढंग से UTF‑8 में डिकोड हुआ। + +## Full, runnable example + +नीचे पूरा स्क्रिप्ट दिया गया है जिसे आप `generate_datamatrix.py` नाम की फ़ाइल में कॉपी‑पेस्ट कर सकते हैं। `YOUR_DIRECTORY` को अपने सिस्टम में मौजूद किसी फ़ोल्डर से बदलें। + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +कमांड लाइन से स्क्रिप्ट चलाएँ: + +```bash +python generate_datamatrix.py +``` + +आपको कंसोल आउटपुट कुछ इस तरह दिखना चाहिए: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Verifying the result + +रूसी वाक्य सही तरीके से एन्कोड हुआ है, यह पुष्टि करने के लिए: + +1. PNG फ़ाइल को इमेज व्यूअर में खोलें। +2. कोई भी DataMatrix स्कैनिंग ऐप (कई मोबाइल ऐप्स सपोर्ट करते हैं) या हार्डवेयर स्कैनर का उपयोग करें। +3. डिकोडेड स्ट्रिंग `ABC123Привет` (या स्कैनर UI के अनुसार दो भाग अलग-अलग) दिखनी चाहिए। + +यदि रूसी अक्षर गड़बड़ दिखें, तो जांचें कि स्कैनर ECI UTF‑8 को सपोर्ट करता है या नहीं। अधिकांश आधुनिक रीडर सपोर्ट करते हैं, लेकिन पुराने डिवाइस को स्पष्ट कॉन्फ़िगरेशन की आवश्यकता हो सकती है। + +## Common pitfalls and how to avoid them + +| Issue | Cause | Fix | +|-------|-------|-----| +| गड़बड़ सायरिलिक आउटपुट | ECI संकेतक गायब | `add_eci_codetext` को `eci_encoding=3` के साथ उपयोग करें। | +| प्रिंटर के लिए बारकोड बहुत छोटा | डिफ़ॉल्ट मॉड्यूल साइज कम DPI पर बहुत फाइन है | `x_dimension` बढ़ाएँ (उदा., `3.0` या `4.0`)। | +| फ़ाइल सेव नहीं हुई | अमान्य डायरेक्टरी पाथ | सुनिश्चित करें कि `YOUR_DIRECTORY` मौजूद है और लिखने योग्य है। | +| स्कैनर पढ़ नहीं पा रहा | डेटा डेंसिटी अधिक | एन्कोडेड डेटा की मात्रा घटाएँ या एरर करेक्शन लेवल बढ़ाएँ (`generator.parameters.barcode.error_correction_level`)। | + +## Extending the example + +आप इस पैटर्न को अन्य भाषाओं या डेटा टाइप्स के लिए भी अनुकूलित कर सकते हैं: + +* **जापानी या अरबी टेक्स्ट एन्कोड करें** – `eci_encoding` को उपयुक्त वैल्यू (जैसे ISO‑8859‑5 के लिए 5, ISO‑8859‑7 के लिए 6) में बदलें। +* **एकाधिक ECI सेगमेंट जोड़ें** – `add_eci_codetext` को कई बार कॉल करें, प्रत्येक का अपना एन्कोडिंग हो। +* **QR कोड बनाएं** – `EncodeTypes.DATA_MATRIX` को `EncodeTypes.QR` से बदलें। + +अन्य सभी चरण समान रहते हैं क्योंकि `ExtCodetextBuilder` लो‑लेवल बाइट हैंडलिंग को एब्स्ट्रैक्ट करता है। + +## Conclusion + +अब आप जानते हैं कि Python में **DataMatrix बारकोड** कैसे जेनरेट करें और Aspose.BarCode की विस्तारित कोडटेक्स्ट सुविधा का उपयोग करके **रूसी टेक्स्ट** कैसे एन्कोड करें। पूरा स्क्रिप्ट कैरेक्टर‑सेट नेगोशिएशन, बारकोड निर्माण, और इमेज आउटपुट को कुछ ही लाइनों में संभालता है। + +अब आप अन्य बारकोड सिम्बोलॉजी (PDF417, Aztec) का अन्वेषण कर सकते हैं या जेनरेटर को वेब सर्विस में इंटीग्रेट कर सकते हैं जो ऑन‑डिमांड PNG इमेज रिटर्न करता है। वही सिद्धांत—विस्तारित कोडटेक्स्ट बनाना और उपयुक्त `EncodeTypes` चुनना—पूरे Aspose.BarCode सूट में लागू होते हैं। + +Happy coding, and enjoy the power of multilingual barcode generation! + +## What Should You Learn Next? + +नीचे दिए गए ट्यूटोरियल्स उन विषयों को कवर करते हैं जो इस गाइड में दिखाए गए तकनीकों पर आधारित हैं। प्रत्येक संसाधन में पूर्ण कार्यशील कोड उदाहरण और चरण‑दर‑चरण व्याख्याएँ शामिल हैं, जिससे आप अतिरिक्त API फीचर्स को मास्टर कर सकें और अपने प्रोजेक्ट्स में वैकल्पिक इम्प्लीमेंटेशन अप्रोचेज़ की खोज कर सकें। + +- [Aspose.BarCode for .NET के साथ DataMatrix बारकोड कैसे जेनरेट करें – चरण‑दर‑चरण गाइड](/barcode/english/net/datamatrix-barcode-configuration/) +- [Aspose.BarCode for .NET (C#) में ASCII मोड के साथ DataMatrix बारकोड जेनरेट करें](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [Aspose.BarCode for .NET में DataMatrix बारकोड (ECC 200) कैसे जेनरेट करें](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hongkong/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/hongkong/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..6b4d7d540 --- /dev/null +++ b/barcode/hongkong/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,246 @@ +--- +category: general +date: 2026-08-22 +description: 學習在 Python 中產生 DataMatrix 條碼，並使用 Aspose.BarCode 編碼俄文文字 – 步驟教學指南。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: zh-hant +lastmod: 2026-08-22 +og_description: 在 Python 中生成 DataMatrix 條碼，並使用 Aspose.BarCode 編碼俄文文字。遵循完整範例，即可立即執行。 +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: 在 Python 中生成 DataMatrix 條碼 – 完整的 Aspose.BarCode 教學 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: 如何在 Python 中使用 Aspose.BarCode 生成 DataMatrix 條碼 +url: /zh-hant/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 Python 中使用 Aspose.BarCode 產生 DataMatrix 條碼 + +如果您需要在 Python 中 **產生 DataMatrix 條碼** 並 **編碼俄文文字**，本指南會向您展示完整步驟。您將看到一個完整、可執行的範例，該範例會建立擴充的 codetext、設定條碼，並在單一腳本中儲存圖像。 + +建立包含非 ASCII 字元的條碼時，常會遇到字元集與資料編碼的問題。透過使用 Aspose.BarCode 的 `ExtCodetextBuilder`，您可以安全地在 DataMatrix 符號中嵌入 UTF‑8 文字，例如西里爾字元。此結果可於任何支援 DataMatrix 標準的掃描器上使用。 + +在本教學中您將： + +* 安裝所需的 Aspose.BarCode 套件。 +* 建立混合純資料與俄文文字的擴充 codetext。 +* **產生 DataMatrix 條碼** 使用擴充字串。 +* 調整條碼參數，例如模組大小。 +* 將條碼儲存為 PNG 檔案。 + +不需要任何外部服務；所有操作皆在本機本地執行。 + +## 前置條件 + +在開始之前，請確保您已具備： + +* 已安裝 Python 3.8 或更新版本。 +* 擁有有效的 Aspose.BarCode for Python 授權（免費試用版可用於開發）。 +* 具備 Python 腳本的基本知識。 + +您可以透過 pip 安裝 Aspose.BarCode 函式庫： + +```bash +pip install aspose-barcode +``` + +## 步驟 1：建立擴充 codetext 字串 + +第一個任務是建立一個同時包含純產品識別碼與俄文片語的單一字串。`ExtCodetextBuilder` 允許您串接不同的 codetext 部分，同時保留其編碼資訊。 + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**此步驟的重要性** – DataMatrix 符號儲存原始位元組。當您需要混合不同字母表時，必須告訴編碼器每個段落使用的字元集。`add_eci_codetext` 方法會在俄文文字前插入 ECI 指示符，確保掃描器將位元組解讀為 UTF‑8。若未使用 ECI，西里爾字元將顯示為亂碼。 + +## 步驟 2：建立 DataMatrix 條碼產生器 + +擁有擴充 codetext 後，建立 `BarcodeGenerator` 並指定 `EncodeTypes.DATA_MATRIX` 類型。 + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**為什麼選擇 DataMatrix？** – DataMatrix 是一種二維條碼，可儲存最多 2,335 個字母數字字元或 1,556 位元組。它非常適合小型物件、工業零件，以及需要嵌入多語言文字的情境。 + +## 步驟 3：（可選）設定條碼參數 + +Aspose.BarCode 提供許多參數。對於大多數使用情境，預設設定即可產生可讀的符號。然而，您可能需要控制每個模組（矩陣中最小的方格）的大小，以符合列印需求。 + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +其他有用的參數包括錯誤更正等級、邊距與背景顏色。僅在目標掃描環境需要特定容差時才調整它們。 + +## 步驟 4：儲存條碼影像 + +最後，將條碼寫入檔案。`save` 方法支援 PNG、JPEG、BMP 以及多種向量格式。 + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +當您開啟 `extended_codetext.png` 時，會看到清晰的 DataMatrix 符號。使用標準 DataMatrix 讀取器掃描它會返回兩個部分： + +1. **ABC123** – 純文字識別碼。 +2. **Привет** – 俄文問候語，正確以 UTF‑8 解碼。 + +## 完整、可執行範例 + +以下是完整腳本，您可以複製貼上至名為 `generate_datamatrix.py` 的檔案。將 `YOUR_DIRECTORY` 替換為系統中已存在的資料夾路徑。 + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +從命令列執行腳本： + +```bash +python generate_datamatrix.py +``` + +您應該會看到類似以下的主控台輸出： + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## 驗證結果 + +為了確認條碼正確編碼俄文片語，請執行以下步驟： + +1. 在圖像檢視器中開啟 PNG 檔案。 +2. 使用任何 DataMatrix 掃描應用程式（許多手機應用程式支援）或硬體掃描器。 +3. 解碼後的字串應顯示 `ABC123Привет`（或根據掃描器介面分開顯示兩個部分）。 + +若俄文字符顯示為亂碼，請再次確認掃描器支援 ECI UTF‑8。大多數現代讀取器皆支援，但舊版設備可能需要明確設定。 + +## 常見陷阱與避免方法 + +| Issue | Cause | Fix | +|-------|-------|-----| +| 西里爾字元顯示為亂碼 | 缺少 ECI 指示符 | 使用 `add_eci_codetext` 並設定 `eci_encoding=3`。 | +| 條碼對印表機太小 | 預設模組大小對低 DPI 太細 | 增加 `x_dimension`（例如 `3.0` 或 `4.0`）。 | +| 檔案未儲存 | 目錄路徑無效 | 確保 `YOUR_DIRECTORY` 已存在且可寫入。 | +| 掃描器無法讀取 | 資料密度過高 | 減少編碼資料量或提升錯誤更正等級（`generator.parameters.barcode.error_correction_level`）。 | + +## 擴充範例 + +您可以將此模式套用於其他語言或資料類型： + +* **編碼日文或阿拉伯文** – 將 `eci_encoding` 改為相應的值（例如 ISO‑8859‑5 為 5，ISO‑8859‑7 為 6）。 +* **加入多個 ECI 段落** – 多次呼叫 `add_eci_codetext`，每次使用不同的編碼。 +* **改為產生 QR code** – 將 `EncodeTypes.DATA_MATRIX` 替換為 `EncodeTypes.QR`。 + +其他步驟保持相同，因為 `ExtCodetextBuilder` 抽象化了低階位元組處理。 + +## 結論 + +您現在已了解如何在 Python 中 **產生 DataMatrix 條碼** 並使用 Aspose.BarCode 的擴充 codetext 功能 **編碼俄文文字**。完整腳本僅以少量程式碼即可處理字元集協商、條碼建立與影像輸出。 + +接下來，您可以探索其他條碼符號（PDF417、Aztec）或將產生器整合至即時回傳 PNG 圖像的 Web 服務中。相同的原則——建立擴充 codetext 並選擇適當的 `EncodeTypes`——適用於整個 Aspose.BarCode 系列。 + +祝程式開發順利，盡情體驗多語言條碼產生的強大功能！ + +## 接下來該學什麼？ + +以下教學涵蓋與本指南技術密切相關的主題，並在此基礎上延伸。每個資源皆提供完整可執行的程式碼範例與逐步說明，協助您掌握更多 API 功能，並在專案中探索其他實作方式。 + +- [如何使用 Aspose.BarCode for .NET 產生 DataMatrix 條碼 – 步驟指南](/barcode/english/net/datamatrix-barcode-configuration/) +- [在 Aspose.BarCode for .NET (C#) 中以 ASCII 模式產生 DataMatrix 條碼](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [如何使用 Aspose.BarCode for .NET 產生 DataMatrix 條碼 (ECC 200)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/hungarian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/hungarian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..f0dcd3ce5 --- /dev/null +++ b/barcode/hungarian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Tanulja meg, hogyan generáljon DataMatrix vonalkódot Pythonban, és kódolja + az orosz szöveget az Aspose.BarCode használatával – lépésről lépésre útmutató. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: hu +lastmod: 2026-08-22 +og_description: Generáljon DataMatrix vonalkódot Pythonban, és kódolja az orosz szöveget + az Aspose.BarCode segítségével. Kövesse a teljes példát, és futtassa azonnal. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: DataMatrix vonalkód generálása Pythonban – teljes Aspose.BarCode útmutató +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Hogyan generáljunk DataMatrix vonalkódot Pythonban az Aspose.BarCode segítségével +url: /hu/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hogyan generáljunk DataMatrix vonalkódot Pythonban az Aspose.BarCode segítségével + +Ha **DataMatrix vonalkódot** szeretnél **generálni Pythonban**, miközben **orosz szöveget** kódolsz, ez az útmutató pontos lépéseket mutat. Megmutatjuk a teljes, futtatható példát, amely egy kiterjesztett kódszöveget épít, beállítja a vonalkódot, és egyetlen szkriptben elmenti a képet. + +A nem‑ASCII karaktereket tartalmazó vonalkódok létrehozása gyakran felveti a karakterkészletek és az adatkódolás kérdését. Az Aspose.BarCode `ExtCodetextBuilder`‑jével biztonságosan ágyazhatod be az UTF‑8 szöveget, például cirill betűket, egy DataMatrix szimbólumba. Az eredmény minden, a DataMatrix szabványt támogató szkennerrel működik. + +Ebben a tutorialban: + +* Telepíted a szükséges Aspose.BarCode csomagot. +* Létrehozod a kiterjesztett kódszöveget, amely keveri az egyszerű adatot és az orosz szöveget. +* **DataMatrix vonalkódot generálsz** a kiterjesztett karakterlánccal. +* Beállítod a vonalkód paramétereit, például a modulméretet. +* Elmented a vonalkódot PNG fájlként. + +Nincs szükség külső szolgáltatásokra; minden helyben fut a gépeden. + +## Előfeltételek + +Mielőtt elkezdenéd, győződj meg róla, hogy: + +* Python 3.8 vagy újabb telepítve van. +* Aktív Aspose.BarCode for Python licenc (egy ingyenes próba is elegendő fejlesztéshez). +* Alapvető ismeretekkel rendelkezel a Python szkriptelésről. + +Az Aspose.BarCode könyvtárat a pip segítségével telepítheted: + +```bash +pip install aspose-barcode +``` + +## 1. lépés: Kiterjesztett kódszöveg létrehozása + +Az első feladat egyetlen karakterlánc létrehozása, amely tartalmazza a egyszerű termékazonosítót és az orosz kifejezést is. Az `ExtCodetextBuilder` lehetővé teszi, hogy különböző kódszöveg‑részeket összefűzz, miközben megőrzi azok kódolási információját. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Miért fontos ez a lépés** – A DataMatrix szimbólumok nyers bájtokat tárolnak. Amikor betűkészleteket keversz, meg kell mondanod a kódolónak, melyik karakterkészlet melyik szegmensre vonatkozik. Az `add_eci_codetext` metódus egy ECI indikátort helyez el az orosz szöveg előtt, biztosítva, hogy a szkennerek a bájtokat UTF‑8‑ként értelmezzék. ECI nélkül a cirill karakterek összezavart adatként jelennek meg. + +## 2. lépés: DataMatrix vonalkód generátor létrehozása + +Miután a kiterjesztett kódszöveg készen van, példányosíts egy `BarcodeGenerator`‑t, amelynek a típusa `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Miért DataMatrix?** – A DataMatrix egy kétdimenziós vonalkód, amely akár 2 335 alfanumerikus karaktert vagy 1 556 bájtot is tárolhat. Ideális kis tárgyakhoz, ipari alkatrészekhez, és olyan helyzetekben, ahol többnyelvű szöveget kell beágyazni. + +## 3. lépés: (Opcionális) Vonalkód paraméterek konfigurálása + +Az Aspose.BarCode számos paramétert kínál. A legtöbb esetben az alapbeállítások olvasható szimbólumot eredményeznek. Azonban előfordulhat, hogy a modul (a mátrix legkisebb négyzete) méretét szeretnéd a nyomtatási követelményekhez igazítani. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Egyéb hasznos paraméterek közé tartozik a hibajavítási szint, a margó és a háttérszín. Ezeket csak akkor módosítsd, ha a célkörnyezeted speciális toleranciákat igényel. + +## 4. lépés: A vonalkód kép mentése + +Végül írd a vonalkódot egy fájlba. A `save` metódus PNG, JPEG, BMP és több vektoros formátumot is támogat. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Amikor megnyitod a `extended_codetext.png` fájlt, egy tiszta DataMatrix szimbólumot látsz. Egy szabványos DataMatrix olvasóval beolvasva a két részt kapod: + +1. **ABC123** – az egyszerű azonosító. +2. **Привет** – az orosz üdvözlet, helyesen UTF‑8‑ként dekódolva. + +## Teljes, futtatható példa + +Az alábbi teljes szkriptet bemásolhatod egy `generate_datamatrix.py` nevű fájlba. Cseréld ki a `YOUR_DIRECTORY`‑t egy létező mappára a rendszereden. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Futtasd a szkriptet a parancssorból: + +```bash +python generate_datamatrix.py +``` + +A konzolon a következőhöz hasonló kimenetet kell látnod: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Az eredmény ellenőrzése + +Annak megerősítésére, hogy a vonalkód helyesen kódolja az orosz kifejezést: + +1. Nyisd meg a PNG fájlt egy képmegjelenítőben. +2. Használj bármilyen DataMatrix olvasó alkalmazást (számos mobilapp támogatja) vagy egy hardveres szkennert. +3. A dekódolt karakterláncnak `ABC123Привет`‑nek kell megjelenítenie (vagy a két rész külön, a szkenner UI‑jától függően). + +Ha az orosz karakterek értelmetlenül jelennek meg, ellenőrizd, hogy a szkenner támogatja‑e az ECI UTF‑8‑at. A legtöbb modern olvasó igen, de a régebbi eszközöknek explicit beállításra lehet szükségük. + +## Gyakori hibák és megoldások + +| Probléma | Ok | Megoldás | +|----------|----|----------| +| Görbe cirill kimenet | Hiányzó ECI indikátor | Használd az `add_eci_codetext`‑t `eci_encoding=3`‑val. | +| A vonalkód túl kicsi a nyomtatóhoz | Alapértelmezett modulméret túl finom alacsony DPI‑nél | Növeld a `x_dimension`‑t (pl. `3.0` vagy `4.0`). | +| Fájl nem mentődik | Érvénytelen könyvtárútvonal | Győződj meg róla, hogy a `YOUR_DIRECTORY` létezik és írható. | +| A szkenner nem olvas | Túl nagy adat sűrűség | Csökkentsd a kódolt adat mennyiségét vagy növeld a hibajavítási szintet (`generator.parameters.barcode.error_correction_level`). | + +## A példa kiterjesztése + +A mintát más nyelvek vagy adat típusok esetén is alkalmazhatod: + +* **Japán vagy arab szöveg kódolása** – módosítsd az `eci_encoding`‑t a megfelelő értékre (pl. 5 az ISO‑8859‑5‑höz, 6 az ISO‑8859‑7‑hez). +* **Több ECI szegmens hozzáadása** – hívd meg az `add_eci_codetext`‑t többször, mindegyikhez saját kódolással. +* **QR kód létrehozása** – cseréld le a `EncodeTypes.DATA_MATRIX`‑t `EncodeTypes.QR`‑ra. + +Minden egyéb lépés változatlan marad, mivel az `ExtCodetextBuilder` elrejti az alacsony szintű bájtkezelést. + +## Összegzés + +Most már tudod, hogyan **generálj DataMatrix vonalkódot** Pythonban, és hogyan **kódolj orosz szöveget** az Aspose.BarCode kiterjesztett kódszöveg funkciójával. A teljes szkript kezeletlenül végzi a karakterkészlet‑egyeztetést, a vonalkód létrehozását és a kép kimenetet néhány sor kóddal. + +Ezután fedezd fel a többi vonalkód szimbólumot (PDF417, Aztec), vagy integráld a generátort egy webszolgáltatásba, amely igény szerint PNG képeket ad vissza. Ugyanazok a elvek – kiterjesztett kódszöveg építése és a megfelelő `EncodeTypes` kiválasztása – érvényesek az egész Aspose.BarCode csomagra. + +Jó kódolást, és élvezd a többnyelvű vonalkód generálás erejét! + +## Mit tanulj meg legközelebb? + +A következő tutorialok szorosan kapcsolódó témákat fednek le, amelyek a jelen útmutató technikáira épülnek. Minden forrás teljes, működő kódrészleteket és lépésről‑lépésre magyarázatokat tartalmaz, hogy a további API funkciókat is elsajátíthasd, és alternatív megvalósítási megközelítéseket fedezhess fel saját projektjeidben. + +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) +- [Generate a DataMatrix barcode in ASCII mode with Aspose.BarCode for .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [How to Generate DataMatrix Barcodes (ECC 200) with Aspose.BarCode for .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/indonesian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/indonesian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..65efb1bbb --- /dev/null +++ b/barcode/indonesian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Pelajari cara menghasilkan kode batang DataMatrix di Python dan mengkodekan + teks Rusia menggunakan Aspose.BarCode – panduan langkah demi langkah. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: id +lastmod: 2026-08-22 +og_description: Buat kode batang DataMatrix di Python dan enkode teks Rusia dengan + Aspose.BarCode. Ikuti contoh lengkapnya dan jalankan secara langsung. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Menghasilkan barcode DataMatrix di Python – tutorial lengkap Aspose.BarCode +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Cara menghasilkan barcode DataMatrix di Python dengan Aspose.BarCode +url: /id/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cara menghasilkan DataMatrix barcode di Python dengan Aspose.BarCode + +Jika Anda perlu **menghasilkan DataMatrix barcode** di Python sambil **mengodekan teks Rusia**, panduan ini menunjukkan langkah‑langkah tepatnya. Anda akan melihat contoh lengkap yang dapat dijalankan yang membangun extended codetext, mengkonfigurasi barcode, dan menyimpan gambar dalam satu skrip. + +Membuat barcode yang berisi karakter non‑ASCII sering menimbulkan pertanyaan tentang set karakter dan enkoding data. Dengan menggunakan `ExtCodetextBuilder` dari Aspose.BarCode, Anda dapat dengan aman menyematkan teks UTF‑8 seperti karakter Cyrillic di dalam simbol DataMatrix. Hasilnya dapat bekerja dengan pemindai apa pun yang mendukung standar DataMatrix. + +Dalam tutorial ini Anda akan: + +* Menginstal paket Aspose.BarCode yang diperlukan. +* Membuat extended codetext yang mencampur data biasa dan teks Rusia. +* **Menghasilkan DataMatrix barcode** dengan string yang diperluas. +* Menyesuaikan parameter barcode seperti ukuran modul. +* Menyimpan barcode sebagai file PNG. + +Tidak diperlukan layanan eksternal; semuanya berjalan secara lokal di mesin Anda. + +## Prasyarat + +Sebelum Anda memulai, pastikan Anda memiliki: + +* Python 3.8 atau yang lebih baru terinstal. +* Lisensi aktif Aspose.BarCode untuk Python (versi percobaan gratis dapat digunakan untuk pengembangan). +* Familiaritas dasar dengan scripting Python. + +Anda dapat menginstal library Aspose.BarCode melalui pip: + +```bash +pip install aspose-barcode +``` + +## Langkah 1: Membuat string extended codetext + +Tugas pertama adalah membuat satu string yang berisi baik pengidentifikasi produk biasa maupun frasa Rusia. `ExtCodetextBuilder` memungkinkan Anda menggabungkan bagian‑bagian codetext yang berbeda sambil mempertahankan informasi enkodingnya. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Mengapa langkah ini penting** – Simbol DataMatrix menyimpan byte mentah. Ketika Anda perlu mencampur alfabet, Anda harus memberi tahu encoder set karakter mana yang berlaku untuk setiap segmen. Metode `add_eci_codetext` menyisipkan indikator ECI sebelum teks Rusia, memastikan pemindai menginterpretasikan byte sebagai UTF‑8. Tanpa ECI, karakter Cyrillic akan muncul sebagai data yang rusak. + +## Langkah 2: Membuat generator barcode DataMatrix + +Dengan extended codetext siap, buat instance `BarcodeGenerator` dengan menentukan tipe `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Mengapa DataMatrix?** – DataMatrix adalah barcode dua dimensi yang dapat menyimpan hingga 2.335 karakter alfanumerik atau 1.556 byte. Ini ideal untuk barang kecil, komponen industri, dan situasi di mana Anda perlu menyematkan teks multibahasa. + +## Langkah 3: (Opsional) Mengonfigurasi parameter barcode + +Aspose.BarCode menyediakan banyak parameter. Untuk sebagian besar kasus penggunaan, pengaturan default menghasilkan simbol yang dapat dibaca. Namun, Anda mungkin ingin mengontrol ukuran setiap modul (kotak terkecil dalam matriks) agar sesuai dengan kebutuhan pencetakan. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Parameter berguna lainnya termasuk tingkat koreksi kesalahan, margin, dan warna latar belakang. Sesuaikan hanya jika lingkungan pemindaian target Anda memerlukan toleransi tertentu. + +## Langkah 4: Menyimpan gambar barcode + +Akhirnya, tulis barcode ke sebuah file. Metode `save` mendukung PNG, JPEG, BMP, dan beberapa format vektor. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Saat Anda membuka `extended_codetext.png`, Anda akan melihat simbol DataMatrix yang tajam. Memindainya dengan pembaca DataMatrix standar mengembalikan dua bagian: + +1. **ABC123** – pengidentifikasi biasa. +2. **Привет** – salam Rusia, terdekripsi dengan benar sebagai UTF‑8. + +## Contoh lengkap yang dapat dijalankan + +Berikut adalah skrip lengkap yang dapat Anda salin‑tempel ke dalam file bernama `generate_datamatrix.py`. Ganti `YOUR_DIRECTORY` dengan folder yang ada di sistem Anda. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Jalankan skrip dari baris perintah: + +```bash +python generate_datamatrix.py +``` + +Anda harus melihat output konsol yang mirip dengan: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Memverifikasi hasil + +Untuk memastikan bahwa barcode mengodekan frasa Rusia dengan benar: + +1. Buka file PNG dengan penampil gambar. +2. Gunakan aplikasi pemindai DataMatrix apa pun (banyak aplikasi seluler mendukungnya) atau pemindai perangkat keras. +3. String yang terdekripsi harus menampilkan `ABC123Привет` (atau dua bagian terpisah tergantung pada UI pemindai). + +Jika karakter Rusia muncul sebagai teks tidak terbaca, periksa kembali bahwa pemindai mendukung ECI UTF‑8. Sebagian besar pembaca modern melakukannya, tetapi perangkat lama mungkin memerlukan konfigurasi eksplisit. + +## Kesalahan umum dan cara menghindarinya + +| Issue | Cause | Fix | +|-------|-------|-----| +| Output Cyrillic yang terdistorsi | Indikator ECI tidak ada | Gunakan `add_eci_codetext` dengan `eci_encoding=3`. | +| Barcode terlalu kecil untuk printer | Ukuran modul default terlalu kecil untuk DPI rendah | Tingkatkan `x_dimension` (misalnya `3.0` atau `4.0`). | +| File tidak tersimpan | Path direktori tidak valid | Pastikan `YOUR_DIRECTORY` ada dan dapat ditulisi. | +| Pemindai tidak dapat membaca | Kepadatan data berlebih | Kurangi jumlah data yang dienkode atau tingkatkan level koreksi kesalahan (`generator.parameters.barcode.error_correction_level`). | + +## Memperluas contoh + +Anda dapat mengadaptasi pola ini untuk bahasa atau tipe data lain: + +* **Menyandikan teks Jepang atau Arab** – ubah `eci_encoding` ke nilai yang sesuai (misalnya 5 untuk ISO‑8859‑5, 6 untuk ISO‑8859‑7). +* **Menambahkan beberapa segmen ECI** – panggil `add_eci_codetext` beberapa kali, masing‑masing dengan enkodingnya sendiri. +* **Membuat kode QR sebagai gantinya** – ganti `EncodeTypes.DATA_MATRIX` dengan `EncodeTypes.QR`. + +Semua langkah lain tetap sama karena `ExtCodetextBuilder` mengabstraksi penanganan byte tingkat rendah. + +## Kesimpulan + +Anda sekarang tahu cara **menghasilkan barcode DataMatrix** di Python dan **mengodekan teks Rusia** menggunakan fitur extended codetext dari Aspose.BarCode. Skrip lengkap menangani negosiasi set karakter, pembuatan barcode, dan output gambar dengan hanya beberapa baris kode. + +Selanjutnya, jelajahi simbol barcode lain (PDF417, Aztec) atau integrasikan generator ke dalam layanan web yang mengembalikan gambar PNG sesuai permintaan. Prinsip yang sama—membangun extended codetext dan memilih `EncodeTypes` yang tepat—berlaku di seluruh rangkaian Aspose.BarCode. + +Selamat coding, dan nikmati kekuatan pembuatan barcode multibahasa! + +## Apa yang Harus Anda Pelajari Selanjutnya? + +Tutorial berikut mencakup topik yang sangat terkait yang membangun teknik yang ditunjukkan dalam panduan ini. Setiap sumber mencakup contoh kode lengkap yang berfungsi dengan penjelasan langkah demi langkah untuk membantu Anda menguasai fitur API tambahan dan mengeksplorasi pendekatan implementasi alternatif dalam proyek Anda. + +- [Cara Menghasilkan Barcode DataMatrix Menggunakan Aspose.BarCode untuk .NET – Panduan Langkah‑per‑Langkah](/barcode/english/net/datamatrix-barcode-configuration/) +- [Menghasilkan barcode DataMatrix dalam mode ASCII dengan Aspose.BarCode untuk .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [Cara Menghasilkan Barcode DataMatrix (ECC 200) dengan Aspose.BarCode untuk .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/italian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/italian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..461d205b1 --- /dev/null +++ b/barcode/italian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Impara a generare codici a barre DataMatrix in Python e a codificare + testo russo usando Aspose.BarCode – guida passo passo. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: it +lastmod: 2026-08-22 +og_description: Genera un codice a barre DataMatrix in Python e codifica testo russo + con Aspose.BarCode. Segui l'esempio completo ed eseguilo subito. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Genera codice a barre DataMatrix in Python – tutorial completo di Aspose.BarCode +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Come generare il codice a barre DataMatrix in Python con Aspose.BarCode +url: /it/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Come generare un codice a barre DataMatrix in Python con Aspose.BarCode + +Se hai bisogno di **generare un codice a barre DataMatrix** in Python mentre **codifichi testo russo**, questa guida ti mostra i passaggi esatti. Vedrai un esempio completo, eseguibile, che costruisce un codetext esteso, configura il codice a barre e salva l’immagine in un unico script. + +Creare codici a barre che contengono caratteri non‑ASCII solleva spesso domande su set di caratteri e codifica dei dati. Utilizzando `ExtCodetextBuilder` di Aspose.BarCode, puoi incorporare in modo sicuro testo UTF‑8, come i caratteri cirillici, all’interno di un simbolo DataMatrix. Il risultato funziona con qualsiasi scanner che supporti lo standard DataMatrix. + +In questo tutorial imparerai a: + +* Installare il pacchetto Aspose.BarCode necessario. +* Costruire un codetext esteso che mescoli dati semplici e testo russo. +* **Generare un codice a barre DataMatrix** con la stringa estesa. +* Regolare parametri del codice a barre come la dimensione del modulo. +* Salvare il codice a barre come file PNG. + +Non sono richiesti servizi esterni; tutto viene eseguito localmente sulla tua macchina. + +## Prerequisiti + +Prima di iniziare, assicurati di avere: + +* Python 3.8 o versioni successive installate. +* Una licenza attiva di Aspose.BarCode per Python (una versione di prova gratuita è sufficiente per lo sviluppo). +* Familiarità di base con la programmazione in Python. + +Puoi installare la libreria Aspose.BarCode tramite pip: + +```bash +pip install aspose-barcode +``` + +## Passo 1: Costruire una stringa di codetext esteso + +Il primo compito è creare una singola stringa che contenga sia l’identificatore di prodotto semplice sia la frase in russo. `ExtCodetextBuilder` ti consente di concatenare diverse parti di codetext preservando le informazioni di codifica. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Perché questo passaggio è importante** – I simboli DataMatrix memorizzano byte grezzi. Quando devi mescolare alfabeti, devi indicare all’encoder quale set di caratteri si applica a ciascun segmento. Il metodo `add_eci_codetext` inserisce un indicatore ECI prima del testo russo, garantendo che gli scanner interpretino i byte come UTF‑8. Senza ECI, i caratteri cirillici apparirebbero come dati corrotti. + +## Passo 2: Creare un generatore di codice a barre DataMatrix + +Con il codetext esteso pronto, istanzia un `BarcodeGenerator` specificando il tipo `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Perché DataMatrix?** – DataMatrix è un codice a barre bidimensionale che può contenere fino a 2.335 caratteri alfanumerici o 1.556 byte. È ideale per piccoli oggetti, parti industriali e situazioni in cui è necessario incorporare testo multilingue. + +## Passo 3: (Opzionale) Configurare i parametri del codice a barre + +Aspose.BarCode espone molti parametri. Per la maggior parte dei casi d’uso, le impostazioni predefinite producono un simbolo leggibile. Tuttavia, potresti voler controllare la dimensione di ogni modulo (il quadrato più piccolo nella matrice) per adattarla ai requisiti di stampa. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Altri parametri utili includono il livello di correzione errori, il margine e il colore di sfondo. Modificali solo se l’ambiente di scansione di destinazione richiede tolleranze specifiche. + +## Passo 4: Salvare l’immagine del codice a barre + +Infine, scrivi il codice a barre su un file. Il metodo `save` supporta PNG, JPEG, BMP e diversi formati vettoriali. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Quando apri `extended_codetext.png`, vedrai un simbolo DataMatrix nitido. Scansionandolo con un lettore DataMatrix standard otterrai le due parti: + +1. **ABC123** – l’identificatore semplice. +2. **Привет** – il saluto russo, correttamente decodificato come UTF‑8. + +## Esempio completo, eseguibile + +Di seguito trovi lo script completo che puoi copiare‑incollare in un file chiamato `generate_datamatrix.py`. Sostituisci `YOUR_DIRECTORY` con una cartella esistente sul tuo sistema. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Esegui lo script dalla riga di comando: + +```bash +python generate_datamatrix.py +``` + +Dovresti vedere un output sulla console simile a: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Verifica del risultato + +Per confermare che il codice a barre codifichi correttamente la frase russa: + +1. Apri il file PNG in un visualizzatore di immagini. +2. Usa qualsiasi app di scansione DataMatrix (molte app mobili lo supportano) o uno scanner hardware. +3. La stringa decodificata dovrebbe mostrare `ABC123Привет` (o le due parti separate a seconda dell’interfaccia dello scanner). + +Se i caratteri russi appaiono come spazzatura, ricontrolla che lo scanner supporti ECI UTF‑8. La maggior parte dei lettori moderni lo fa, ma i dispositivi legacy potrebbero richiedere una configurazione esplicita. + +## Problemi comuni e come evitarli + +| Problema | Causa | Soluzione | +|----------|-------|-----------| +| Output cirillico corrotto | Indicatore ECI mancante | Usa `add_eci_codetext` con `eci_encoding=3`. | +| Codice a barre troppo piccolo per la stampante | Dimensione modulo predefinita troppo fine per bassa DPI | Aumenta `x_dimension` (es. `3.0` o `4.0`). | +| File non salvato | Percorso della directory non valido | Verifica che `YOUR_DIRECTORY` esista e sia scrivibile. | +| Lo scanner non legge | Densità dati eccessiva | Riduci la quantità di dati codificati o aumenta il livello di correzione errori (`generator.parameters.barcode.error_correction_level`). | + +## Estendere l’esempio + +Puoi adattare questo schema ad altre lingue o tipi di dati: + +* **Codificare testo giapponese o arabo** – cambia `eci_encoding` al valore appropriato (es. 5 per ISO‑8859‑5, 6 per ISO‑8859‑7). +* **Aggiungere più segmenti ECI** – chiama `add_eci_codetext` più volte, ciascuna con la propria codifica. +* **Creare un QR code invece** – sostituisci `EncodeTypes.DATA_MATRIX` con `EncodeTypes.QR`. + +Tutti gli altri passaggi rimangono identici perché `ExtCodetextBuilder` astrae la gestione a basso livello dei byte. + +## Conclusione + +Ora sai come **generare un codice a barre DataMatrix** in Python e **codificare testo russo** usando la funzionalità di codetext esteso di Aspose.BarCode. Lo script completo gestisce la negoziazione del set di caratteri, la creazione del codice a barre e l’output dell’immagine con poche righe di codice. + +Successivamente, esplora altre simbologie di codici a barre (PDF417, Aztec) o integra il generatore in un servizio web che restituisce immagini PNG su richiesta. Gli stessi principi—costruire un codetext esteso e selezionare il `EncodeTypes` appropriato—si applicano all’intera suite Aspose.BarCode. + +Buon coding e goditi la potenza della generazione multilingue di codici a barre! + +## Cosa dovresti imparare dopo? + +I tutorial seguenti trattano argomenti strettamente correlati che si basano sulle tecniche dimostrate in questa guida. Ogni risorsa include esempi di codice completi e funzionanti con spiegazioni passo‑passo per aiutarti a padroneggiare ulteriori funzionalità dell’API e a esplorare approcci di implementazione alternativi nei tuoi progetti. + +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) +- [Generate a DataMatrix barcode in ASCII mode with Aspose.BarCode for .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [How to Generate DataMatrix Barcodes (ECC 200) with Aspose.BarCode for .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/japanese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/japanese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..3ff84d6f0 --- /dev/null +++ b/barcode/japanese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,246 @@ +--- +category: general +date: 2026-08-22 +description: PythonでDataMatrixバーコードを生成し、Aspose.BarCodeを使用してロシア語テキストをエンコードする方法 – ステップバイステップガイド +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: ja +lastmod: 2026-08-22 +og_description: PythonでDataMatrixバーコードを生成し、Aspose.BarCodeでロシア語テキストをエンコードします。完全なサンプルに従ってすぐに実行できます。 +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: PythonでDataMatrixバーコードを生成する – 完全なAspose.BarCodeチュートリアル +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Aspose.BarCode を使用して Python で DataMatrix バーコードを生成する方法 +url: /ja/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Python と Aspose.BarCode で DataMatrix バーコードを生成する方法 + +Python で **DataMatrix バーコードを生成** しながら **ロシア語テキストをエンコード** したい場合、このガイドでは正確な手順を示します。拡張コーデテキストを構築し、バーコードを設定し、画像を単一のスクリプトで保存する、完全で実行可能な例をご覧いただけます。 + +非 ASCII 文字を含むバーコードを作成すると、文字セットやデータエンコーディングに関する疑問が生じがちです。Aspose.BarCode の `ExtCodetextBuilder` を使用すれば、キリル文字などの UTF‑8 テキストを DataMatrix シンボル内に安全に埋め込むことができます。結果は DataMatrix 標準に対応した任意のスキャナーで読み取れます。 + +このチュートリアルで学べること: + +* 必要な Aspose.BarCode パッケージをインストールする。 +* プレーンデータとロシア語テキストを混在させた拡張コーデテキストを構築する。 +* 拡張文字列で **DataMatrix バーコードを生成** する。 +* モジュールサイズなどのバーコードパラメータを調整する。 +* バーコードを PNG ファイルとして保存する。 + +外部サービスは不要です。すべてローカル環境で実行できます。 + +## 前提条件 + +開始する前に、以下が揃っていることを確認してください: + +* Python 3.8 以上がインストールされていること。 +* 有効な Aspose.BarCode for Python ライセンス（開発用の無料トライアルでも可）。 +* Python スクリプトの基本的な知識。 + +Aspose.BarCode ライブラリは pip でインストールできます: + +```bash +pip install aspose-barcode +``` + +## ステップ 1: 拡張コーデテキスト文字列を構築する + +最初のタスクは、プレーンな製品識別子とロシア語フレーズの両方を含む単一の文字列を作成することです。`ExtCodetextBuilder` を使うと、エンコーディング情報を保持したまま複数のコーデテキスト部分を連結できます。 + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**このステップが重要な理由** – DataMatrix シンボルは生バイトを格納します。複数の文字体系を混在させる場合、各セグメントに適用すべき文字セットをエンコーダに指示する必要があります。`add_eci_codetext` メソッドはロシア語テキストの前に ECI インジケータを挿入し、スキャナーがバイト列を UTF‑8 として解釈できるようにします。ECI が無いと、キリル文字は文字化けしてしまいます。 + +## ステップ 2: DataMatrix バーコードジェネレータを作成する + +拡張コーデテキストが準備できたら、`EncodeTypes.DATA_MATRIX` タイプを指定して `BarcodeGenerator` をインスタンス化します。 + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**なぜ DataMatrix か？** – DataMatrix は 2 次元バーコードで、最大 2,335 文字の英数字または 1,556 バイトを格納できます。小型部品や工業部品、マルチリンガルテキストを埋め込む必要があるシーンに最適です。 + +## ステップ 3: (オプション) バーコードパラメータを設定する + +Aspose.BarCode には多数のパラメータが公開されています。ほとんどのユースケースではデフォルト設定で読み取り可能なシンボルが生成されますが、印刷要件に合わせて各モジュール（マトリックス内の最小正方形）のサイズを調整したくなることがあります。 + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +その他の便利なパラメータとして、誤り訂正レベル、余白、背景色などがあります。これらはスキャン環境が特定の許容範囲を要求する場合にのみ調整してください。 + +## ステップ 4: バーコード画像を保存する + +最後に、バーコードをファイルに書き出します。`save` メソッドは PNG、JPEG、BMP、そしていくつかのベクターフォーマットをサポートしています。 + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +`extended_codetext.png` を開くと、鮮明な DataMatrix シンボルが表示されます。標準的な DataMatrix リーダーでスキャンすると、次の 2 部分が取得できます: + +1. **ABC123** – プレーンな識別子。 +2. **Привет** – 正しく UTF‑8 としてデコードされたロシア語の挨拶。 + +## 完全な実行可能サンプル + +以下は `generate_datamatrix.py` というファイル名でコピー＆ペーストできる完全なスクリプトです。`YOUR_DIRECTORY` をシステム上の既存フォルダーに置き換えてください。 + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +コマンドラインからスクリプトを実行します: + +```bash +python generate_datamatrix.py +``` + +コンソールに次のような出力が表示されるはずです: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## 結果の検証 + +バーコードがロシア語フレーズを正しくエンコードしていることを確認する手順: + +1. PNG ファイルを画像ビューアで開く。 +2. 任意の DataMatrix スキャンアプリ（多くのモバイルアプリが対応）またはハードウェアスキャナーを使用する。 +3. デコードされた文字列が `ABC123Привет`（またはスキャナー UI によっては 2 部分に分かれて）と表示されることを確認する。 + +ロシア語文字が文字化けしている場合は、スキャナーが ECI UTF‑8 に対応しているか再確認してください。最新のリーダーはほとんど対応していますが、レガシーデバイスは明示的な設定が必要な場合があります。 + +## よくある落とし穴と回避策 + +| 問題 | 原因 | 対策 | +|------|------|------| +| キリル文字が文字化けする | ECI インジケータが欠如 | `add_eci_codetext` を `eci_encoding=3` で使用する | +| プリンタでバーコードが小さすぎる | デフォルトのモジュールサイズが低 DPI に対して細かすぎる | `x_dimension` を増やす（例: `3.0` または `4.0`） | +| ファイルが保存されない | ディレクトリパスが無効 | `YOUR_DIRECTORY` が存在し書き込み可能であることを確認 | +| スキャナーが読み取れない | データ密度が高すぎる | エンコードデータ量を減らすか、誤り訂正レベルを上げる（`generator.parameters.barcode.error_correction_level`） | + +## サンプルの拡張 + +このパターンは他の言語やデータタイプにも応用できます: + +* **日本語やアラビア語テキストをエンコード** – `eci_encoding` を適切な値に変更（例: ISO‑8859‑5 は 5、ISO‑8859‑7 は 6） +* **複数の ECI セグメントを追加** – `add_eci_codetext` を複数回呼び出し、各セグメントごとにエンコーディングを指定 +* **QR コードに変更** – `EncodeTypes.DATA_MATRIX` を `EncodeTypes.QR` に置き換える + +`ExtCodetextBuilder` が低レベルのバイト処理を抽象化しているため、他の手順は同じままです。 + +## 結論 + +これで Python で **DataMatrix バーコードを生成**し、Aspose.BarCode の拡張コーデテキスト機能を使って **ロシア語テキストをエンコード**する方法が分かりました。短いコード数行で文字セット交渉、バーコード生成、画像出力を実現する完全なスクリプトが完成しました。 + +次は他のバーコードシンボル（PDF417、Aztec）を試すか、PNG 画像をオンデマンドで返す Web サービスにジェネレータを組み込んでみてください。拡張コーデテキストの構築と適切な `EncodeTypes` の選択という原則は、Aspose.BarCode スイート全体に共通です。 + +コーディングを楽しみながら、多言語バーコード生成の力を活用してください！ + +## 次に学ぶべきことは？ + +以下のチュートリアルは、本ガイドで示した手法を基にした、密接に関連するトピックを扱っています。各リソースには、完全な動作コード例とステップバイステップの解説が含まれており、API の追加機能を習得したり、独自プロジェクトで代替実装アプローチを探求したりするのに役立ちます。 + +- [Aspose.BarCode for .NET で DataMatrix バーコードを生成する方法 – ステップバイステップガイド](/barcode/english/net/datamatrix-barcode-configuration/) +- [Aspose.BarCode for .NET (C#) で ASCII モードの DataMatrix バーコードを生成する](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [Aspose.BarCode for .NET で DataMatrix バーコード (ECC 200) を生成する方法](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/korean/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/korean/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..818b258ba --- /dev/null +++ b/barcode/korean/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Python에서 DataMatrix 바코드를 생성하고 Aspose.BarCode를 사용하여 러시아어 텍스트를 인코딩하는 방법을 + 배우세요 – 단계별 가이드. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: ko +lastmod: 2026-08-22 +og_description: Python에서 DataMatrix 바코드를 생성하고 Aspose.BarCode로 러시아어 텍스트를 인코딩합니다. 전체 + 예제를 따라 즉시 실행해 보세요. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Python으로 DataMatrix 바코드 생성 – 완전한 Aspose.BarCode 튜토리얼 +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Python에서 Aspose.BarCode를 사용하여 DataMatrix 바코드 생성하는 방법 +url: /ko/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Python과 Aspose.BarCode로 DataMatrix 바코드 생성 방법 + +Python에서 **DataMatrix 바코드**를 **러시아어 텍스트**와 함께 인코딩해야 할 경우, 이 가이드는 정확한 단계들을 보여줍니다. 확장된 codetext를 구성하고, 바코드를 설정하며, 이미지를 단일 스크립트로 저장하는 완전하고 실행 가능한 예제를 확인할 수 있습니다. + +비‑ASCII 문자를 포함하는 바코드를 만들면 문자 집합 및 데이터 인코딩에 대한 질문이 자주 발생합니다. Aspose.BarCode의 `ExtCodetextBuilder`를 사용하면 Cyrillic 문자와 같은 UTF‑8 텍스트를 DataMatrix 심볼 안에 안전하게 삽입할 수 있습니다. 결과는 DataMatrix 표준을 지원하는 모든 스캐너에서 작동합니다. + +이 튜토리얼에서 배울 내용: + +* 필요한 Aspose.BarCode 패키지를 설치합니다. +* 일반 데이터와 러시아어 텍스트를 혼합한 확장 codetext를 만듭니다. +* 확장 문자열을 사용해 **DataMatrix 바코드**를 생성합니다. +* 모듈 크기와 같은 바코드 매개변수를 조정합니다. +* 바코드를 PNG 파일로 저장합니다. + +외부 서비스는 필요하지 않으며, 모든 작업이 로컬 머신에서 실행됩니다. + +## Prerequisites + +시작하기 전에 다음이 준비되어 있는지 확인하세요: + +* Python 3.8 이상이 설치되어 있어야 합니다. +* Aspose.BarCode for Python 라이선스가 활성화되어 있어야 합니다(무료 체험판도 개발에 사용 가능). +* Python 스크립팅에 대한 기본적인 이해가 필요합니다. + +Aspose.BarCode 라이브러리는 pip를 통해 설치할 수 있습니다: + +```bash +pip install aspose-barcode +``` + +## Step 1: Build an extended codetext string + +첫 번째 작업은 일반 제품 식별자와 러시아어 구문을 모두 포함하는 하나의 문자열을 만드는 것입니다. `ExtCodetextBuilder`를 사용하면 서로 다른 codetext 부분을 연결하면서 각 부분의 인코딩 정보를 유지할 수 있습니다. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**이 단계가 중요한 이유** – DataMatrix 심볼은 원시 바이트를 저장합니다. 서로 다른 알파벳을 혼합해야 할 때는 인코더에게 각 구간에 적용되는 문자 집합을 알려줘야 합니다. `add_eci_codetext` 메서드는 러시아어 텍스트 앞에 ECI 표시자를 삽입해 스캐너가 바이트를 UTF‑8로 해석하도록 합니다. ECI가 없으면 Cyrillic 문자가 깨진 데이터로 표시됩니다. + +## Step 2: Create a DataMatrix barcode generator + +확장 codetext가 준비되면 `EncodeTypes.DATA_MATRIX` 유형을 지정하여 `BarcodeGenerator`를 인스턴스화합니다. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**왜 DataMatrix인가?** – DataMatrix는 2,335개의 영숫자 문자 또는 1,556바이트까지 저장할 수 있는 2차원 바코드입니다. 작은 부품, 산업용 부품 및 다국어 텍스트를 삽입해야 하는 상황에 이상적입니다. + +## Step 3: (Optional) Configure barcode parameters + +Aspose.BarCode는 다양한 매개변수를 제공합니다. 대부분의 경우 기본 설정만으로도 읽기 쉬운 심볼을 만들 수 있지만, 인쇄 요구사항에 맞게 각 모듈(매트릭스에서 가장 작은 정사각형)의 크기를 조정하고 싶을 수 있습니다. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +그 외에도 오류 정정 수준, 여백, 배경색 등의 매개변수가 유용합니다. 대상 스캔 환경이 특정 허용 오차를 요구할 때만 조정하세요. + +## Step 4: Save the barcode image + +마지막으로 바코드를 파일에 저장합니다. `save` 메서드는 PNG, JPEG, BMP 및 여러 벡터 형식을 지원합니다. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +`extended_codetext.png` 파일을 열면 선명한 DataMatrix 심볼이 표시됩니다. 표준 DataMatrix 리더기로 스캔하면 두 부분이 반환됩니다: + +1. **ABC123** – 일반 식별자. +2. **Привет** – 러시아어 인사말, UTF‑8로 올바르게 디코딩됨. + +## Full, runnable example + +아래는 `generate_datamatrix.py`라는 파일에 복사‑붙여넣기 할 수 있는 전체 스크립트입니다. `YOUR_DIRECTORY`를 시스템에 존재하는 폴더 경로로 바꾸세요. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +명령줄에서 스크립트를 실행합니다: + +```bash +python generate_datamatrix.py +``` + +콘솔에 다음과 유사한 출력이 표시됩니다: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Verifying the result + +바코드가 러시아어 구문을 올바르게 인코딩했는지 확인하려면: + +1. PNG 파일을 이미지 뷰어에서 엽니다. +2. DataMatrix 스캔 앱(많은 모바일 앱이 지원)이나 하드웨어 스캐너를 사용합니다. +3. 디코딩된 문자열이 `ABC123Привет`(또는 스캐너 UI에 따라 두 부분으로 구분)으로 표시되어야 합니다. + +러시아어 문자가 깨져 보이면 스캐너가 ECI UTF‑8을 지원하는지 다시 확인하세요. 최신 리더기는 대부분 지원하지만, 레거시 장치는 명시적 설정이 필요할 수 있습니다. + +## Common pitfalls and how to avoid them + +| Issue | Cause | Fix | +|-------|-------|-----| +| Garbled Cyrillic output | Missing ECI indicator | Use `add_eci_codetext` with `eci_encoding=3`. | +| Barcode too small for printer | Default module size too fine for low DPI | Increase `x_dimension` (e.g., `3.0` or `4.0`). | +| File not saved | Invalid directory path | Ensure `YOUR_DIRECTORY` exists and is writable. | +| Scanner cannot read | Excessive data density | Reduce the amount of encoded data or increase error correction level (`generator.parameters.barcode.error_correction_level`). | + +## Extending the example + +다른 언어나 데이터 유형에도 이 패턴을 적용할 수 있습니다: + +* **Encode Japanese or Arabic text** – `eci_encoding`을 해당 값(예: ISO‑8859‑5는 5, ISO‑8859‑7은 6)으로 변경합니다. +* **Add multiple ECI segments** – `add_eci_codetext`를 여러 번 호출하고 각 구간마다 다른 인코딩을 지정합니다. +* **Create a QR code instead** – `EncodeTypes.DATA_MATRIX`를 `EncodeTypes.QR`로 교체합니다. + +`ExtCodetextBuilder`가 저수준 바이트 처리를 추상화하므로 다른 단계는 동일하게 유지됩니다. + +## Conclusion + +이제 Python에서 **DataMatrix 바코드**를 생성하고 Aspose.BarCode의 확장 codetext 기능을 사용해 **러시아어 텍스트**를 인코딩하는 방법을 알게 되었습니다. 전체 스크립트는 문자 집합 협상, 바코드 생성 및 이미지 출력까지 몇 줄의 코드만으로 처리합니다. + +다음으로 다른 바코드 심볼(PDF417, Aztec)을 탐색하거나, PNG 이미지를 실시간으로 반환하는 웹 서비스에 생성기를 통합해 보세요. 확장 codetext를 구축하고 적절한 `EncodeTypes`를 선택하는 동일한 원칙이 Aspose.BarCode 전체 제품군에 적용됩니다. + +즐거운 코딩 되시고, 다국어 바코드 생성의 강력함을 경험해 보세요! + +## What Should You Learn Next? + +다음 튜토리얼은 이 가이드에서 시연한 기술을 기반으로 하는 밀접한 관련 주제를 다룹니다. 각 리소스는 완전한 코드 예제와 단계별 설명을 포함하여 추가 API 기능을 마스터하고 프로젝트에 다양한 구현 방식을 적용할 수 있도록 돕습니다. + +- [Aspose.BarCode for .NET을 사용하여 DataMatrix 바코드 생성하기 – 단계별 가이드](/barcode/english/net/datamatrix-barcode-configuration/) +- [Aspose.BarCode for .NET (C#)으로 ASCII 모드에서 DataMatrix 바코드 생성](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [Aspose.BarCode for .NET으로 DataMatrix 바코드 (ECC 200) 생성하기](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/polish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/polish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..1b4f0d326 --- /dev/null +++ b/barcode/polish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Naucz się generować kod DataMatrix w Pythonie i kodować rosyjski tekst + przy użyciu Aspose.BarCode – przewodnik krok po kroku. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: pl +lastmod: 2026-08-22 +og_description: Generuj kod DataMatrix w Pythonie i koduj rosyjski tekst przy użyciu + Aspose.BarCode. Postępuj zgodnie z pełnym przykładem i uruchom go od razu. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Generowanie kodu DataMatrix w Pythonie – kompletny samouczek Aspose.BarCode +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Jak wygenerować kod DataMatrix w Pythonie przy użyciu Aspose.BarCode +url: /pl/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak generować kod DataMatrix w Pythonie przy użyciu Aspose.BarCode + +Jeśli potrzebujesz **generować kod DataMatrix** w Pythonie przy **kodowaniu rosyjskiego tekstu**, ten przewodnik pokaże Ci dokładne kroki. Zobaczysz kompletny, gotowy do uruchomienia przykład, który tworzy rozszerzony kod tekstowy, konfiguruje kod kreskowy i zapisuje obraz w jednym skrypcie. + +Tworzenie kodów kreskowych zawierających znaki nie‑ASCII często rodzi pytania o zestawy znaków i kodowanie danych. Korzystając z `ExtCodetextBuilder` Aspose.BarCode, możesz bezpiecznie osadzić tekst UTF‑8, taki jak znaki cyrylicy, wewnątrz symbolu DataMatrix. Wynik działa z każdym skanerem obsługującym standard DataMatrix. + +W tym tutorialu: + +* Zainstalujesz wymagany pakiet Aspose.BarCode. +* Zbudujesz rozszerzony kod tekstowy, który miesza zwykłe dane i rosyjski tekst. +* **Wygenerujesz kod DataMatrix** przy użyciu rozszerzonego ciągu. +* Dostosujesz parametry kodu, takie jak rozmiar modułu. +* Zapiszesz kod jako plik PNG. + +Żadne zewnętrzne usługi nie są wymagane; wszystko działa lokalnie na Twoim komputerze. + +## Wymagania wstępne + +Zanim rozpoczniesz, upewnij się, że masz: + +* Python 3.8 lub nowszy zainstalowany. +* Aktywną licencję Aspose.BarCode for Python (bezpłatna wersja próbna wystarczy do rozwoju). +* Podstawową znajomość skryptów w Pythonie. + +Możesz zainstalować bibliotekę Aspose.BarCode za pomocą pip: + +```bash +pip install aspose-barcode +``` + +## Krok 1: Zbuduj rozszerzony ciąg kodu tekstowego + +Pierwszym zadaniem jest stworzenie jednego ciągu, który zawiera zarówno zwykły identyfikator produktu, jak i rosyjską frazę. `ExtCodetextBuilder` pozwala łączyć różne części kodu tekstowego, zachowując informacje o ich kodowaniu. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Dlaczego ten krok jest ważny** – symbole DataMatrix przechowują surowe bajty. Gdy musisz mieszać różne alfabety, musisz poinformować enkoder, jaki zestaw znaków obowiązuje w każdym segmencie. Metoda `add_eci_codetext` wstawia wskaźnik ECI przed rosyjskim tekstem, zapewniając, że skanery interpretują bajty jako UTF‑8. Bez ECI znaki cyrylicy pojawiłyby się jako zniekształcone dane. + +## Krok 2: Utwórz generator kodu DataMatrix + +Po przygotowaniu rozszerzonego kodu tekstowego, utwórz instancję `BarcodeGenerator`, określając typ `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Dlaczego DataMatrix?** – DataMatrix to dwuwymiarowy kod kreskowy, który może przechowywać do 2 335 znaków alfanumerycznych lub 1 556 bajtów. Jest idealny dla małych przedmiotów, części przemysłowych i sytuacji, w których trzeba osadzić tekst wielojęzyczny. + +## Krok 3: (Opcjonalnie) Skonfiguruj parametry kodu kreskowego + +Aspose.BarCode udostępnia wiele parametrów. Dla większości zastosowań domyślne ustawienia generują czytelny symbol. Jednak możesz chcieć kontrolować rozmiar każdego modułu (najmniejszego kwadratu w macierzy), aby dopasować go do wymagań druku. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Inne przydatne parametry to poziom korekcji błędów, margines i kolor tła. Dostosowuj je tylko wtedy, gdy środowisko skanowania wymaga konkretnych tolerancji. + +## Krok 4: Zapisz obraz kodu kreskowego + +Na koniec zapisz kod do pliku. Metoda `save` obsługuje PNG, JPEG, BMP oraz kilka formatów wektorowych. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Gdy otworzysz `extended_codetext.png`, zobaczysz wyraźny symbol DataMatrix. Skanowanie go standardowym czytnikiem DataMatrix zwróci dwie części: + +1. **ABC123** – zwykły identyfikator. +2. **Привет** – rosyjskie powitanie, poprawnie odkodowane jako UTF‑8. + +## Pełny, gotowy do uruchomienia przykład + +Poniżej znajduje się kompletny skrypt, który możesz skopiować i wkleić do pliku o nazwie `generate_datamatrix.py`. Zamień `YOUR_DIRECTORY` na istniejący folder w swoim systemie. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Uruchom skrypt z wiersza poleceń: + +```bash +python generate_datamatrix.py +``` + +Powinieneś zobaczyć wyjście konsoli podobne do: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Weryfikacja wyniku + +Aby potwierdzić, że kod prawidłowo koduje rosyjską frazę: + +1. Otwórz plik PNG w przeglądarce obrazów. +2. Użyj dowolnej aplikacji do skanowania DataMatrix (wiele aplikacji mobilnych to obsługuje) lub skanera sprzętowego. +3. Zdekodowany ciąg powinien wyświetlać `ABC123Привет` (lub dwie części oddzielone, w zależności od interfejsu skanera). + +Jeśli rosyjskie znaki pojawią się jako bełkot, sprawdź ponownie, czy skaner obsługuje ECI UTF‑8. Większość nowoczesnych czytników tak robi, ale starsze urządzenia mogą wymagać dodatkowej konfiguracji. + +## Typowe pułapki i jak ich unikać + +| Problem | Przyczyna | Rozwiązanie | +|---------|-----------|-------------| +| Zniekształcony wynik cyrylicy | Brak wskaźnika ECI | Użyj `add_eci_codetext` z `eci_encoding=3`. | +| Kod kreskowy za mały dla drukarki | Domyślny rozmiar modułu jest zbyt mały przy niskim DPI | Zwiększ `x_dimension` (np. `3.0` lub `4.0`). | +| Plik nie został zapisany | Nieprawidłowa ścieżka katalogu | Upewnij się, że `YOUR_DIRECTORY` istnieje i jest zapisywalny. | +| Skaner nie może odczytać | Zbyt duża gęstość danych | Zredukuj ilość kodowanych danych lub zwiększ poziom korekcji błędów (`generator.parameters.barcode.error_correction_level`). | + +## Rozszerzanie przykładu + +Możesz dostosować ten wzorzec do innych języków lub typów danych: + +* **Koduj tekst japoński lub arabski** – zmień `eci_encoding` na odpowiednią wartość (np. 5 dla ISO‑8859‑5, 6 dla ISO‑8859‑7). +* **Dodaj wiele segmentów ECI** – wywołaj `add_eci_codetext` wielokrotnie, każdy z własnym kodowaniem. +* **Utwórz zamiast tego kod QR** – zamień `EncodeTypes.DATA_MATRIX` na `EncodeTypes.QR`. + +Wszystkie pozostałe kroki pozostają identyczne, ponieważ `ExtCodetextBuilder` abstrahuje niskopoziomowe operacje na bajtach. + +## Zakończenie + +Teraz wiesz, jak **generować kod DataMatrix** w Pythonie i **kodować rosyjski tekst** przy użyciu funkcji rozszerzonego kodu tekstowego Aspose.BarCode. Kompletny skrypt obsługuje negocjację zestawu znaków, tworzenie kodu i zapis obrazu w kilku linijkach kodu. + +Następnie eksploruj inne symbologie kodów kreskowych (PDF417, Aztec) lub zintegrować generator z usługą internetową, która na żądanie zwraca obrazy PNG. Te same zasady – budowanie rozszerzonego kodu tekstowego i wybór odpowiedniego `EncodeTypes` – mają zastosowanie w całym zestawie Aspose.BarCode. + +Miłego kodowania i ciesz się mocą wielojęzycznego generowania kodów kreskowych! + +## Co powinieneś nauczyć się dalej? + +Poniższe tutoriale obejmują tematy ściśle powiązane, które rozwijają techniki przedstawione w tym przewodniku. Każdy zasób zawiera kompletne, działające przykłady kodu z wyjaśnieniami krok po kroku, aby pomóc Ci opanować dodatkowe funkcje API i odkrywać alternatywne podejścia implementacyjne w własnych projektach. + +- [Jak generować kody DataMatrix przy użyciu Aspose.BarCode dla .NET – Przewodnik krok po kroku](/barcode/english/net/datamatrix-barcode-configuration/) +- [Generowanie kodu DataMatrix w trybie ASCII przy użyciu Aspose.BarCode dla .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [Jak generować kody DataMatrix (ECC 200) przy użyciu Aspose.BarCode dla .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/portuguese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/portuguese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..02fbaf16c --- /dev/null +++ b/barcode/portuguese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Aprenda a gerar códigos de barras DataMatrix em Python e codificar texto + em russo usando Aspose.BarCode – guia passo a passo. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: pt +lastmod: 2026-08-22 +og_description: Gere código de barras DataMatrix em Python e codifique texto em russo + com Aspose.BarCode. Siga o exemplo completo e execute‑o instantaneamente. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Gerar código de barras DataMatrix em Python – tutorial completo do Aspose.BarCode +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Como gerar código de barras DataMatrix em Python com Aspose.BarCode +url: /pt/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Como gerar código de barras DataMatrix em Python com Aspose.BarCode + +Se você precisa **gerar código de barras DataMatrix** em Python enquanto **codifica texto em russo**, este guia mostra os passos exatos. Você verá um exemplo completo e executável que cria um codetext estendido, configura o código de barras e salva a imagem em um único script. + +Criar códigos de barras que contêm caracteres não‑ASCII frequentemente levanta questões sobre conjuntos de caracteres e codificação de dados. Usando o `ExtCodetextBuilder` do Aspose.BarCode, você pode incorporar com segurança texto UTF‑8, como caracteres cirílicos, dentro de um símbolo DataMatrix. O resultado funciona com qualquer scanner que suporte o padrão DataMatrix. + +Neste tutorial você irá: + +* Instalar o pacote Aspose.BarCode necessário. +* Construir um codetext estendido que mistura dados simples e texto em russo. +* **Gerar código de barras DataMatrix** com a string estendida. +* Ajustar parâmetros do código de barras, como o tamanho do módulo. +* Salvar o código de barras como um arquivo PNG. + +Nenhum serviço externo é necessário; tudo roda localmente na sua máquina. + +## Pré-requisitos + +Antes de começar, certifique-se de que você tem: + +* Python 3.8 ou mais recente instalado. +* Uma licença ativa do Aspose.BarCode para Python (uma avaliação gratuita funciona para desenvolvimento). +* Familiaridade básica com scripts Python. + +Você pode instalar a biblioteca Aspose.BarCode via pip: + +```bash +pip install aspose-barcode +``` + +## Etapa 1: Construir uma string de codetext estendido + +A primeira tarefa é criar uma única string que contenha tanto o identificador simples do produto quanto a frase em russo. `ExtCodetextBuilder` permite concatenar diferentes partes de codetext preservando suas informações de codificação. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Por que esta etapa é importante** – Os símbolos DataMatrix armazenam bytes brutos. Quando você precisa misturar alfabetos, deve informar ao codificador qual conjunto de caracteres se aplica a cada segmento. O método `add_eci_codetext` insere um indicador ECI antes do texto em russo, garantindo que os scanners interpretem os bytes como UTF‑8. Sem o ECI, os caracteres cirílicos apareceriam como dados corrompidos. + +## Etapa 2: Criar um gerador de código de barras DataMatrix + +Com o codetext estendido pronto, instancie um `BarcodeGenerator` especificando o tipo `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Por que DataMatrix?** – DataMatrix é um código de barras bidimensional que pode armazenar até 2.335 caracteres alfanuméricos ou 1.556 bytes. É ideal para itens pequenos, peças industriais e situações onde você precisa incorporar texto multilíngue. + +## Etapa 3: (Opcional) Configurar parâmetros do código de barras + +Aspose.BarCode expõe muitos parâmetros. Para a maioria dos casos de uso, as configurações padrão produzem um símbolo legível. No entanto, você pode querer controlar o tamanho de cada módulo (o quadrado menor na matriz) para atender aos requisitos de impressão. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Outros parâmetros úteis incluem nível de correção de erro, margem e cor de fundo. Ajuste-os somente se o ambiente de escaneamento alvo exigir tolerâncias específicas. + +## Etapa 4: Salvar a imagem do código de barras + +Finalmente, grave o código de barras em um arquivo. O método `save` suporta PNG, JPEG, BMP e vários formatos vetoriais. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Ao abrir `extended_codetext.png`, você verá um símbolo DataMatrix nítido. Escaneá-lo com um leitor padrão de DataMatrix retorna as duas partes: + +1. **ABC123** – o identificador simples. +2. **Привет** – a saudação em russo, decodificada corretamente como UTF‑8. + +## Exemplo completo e executável + +Abaixo está o script completo que você pode copiar‑colar em um arquivo chamado `generate_datamatrix.py`. Substitua `YOUR_DIRECTORY` por uma pasta existente no seu sistema. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Execute o script a partir da linha de comando: + +```bash +python generate_datamatrix.py +``` + +Você deverá ver uma saída no console semelhante a: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Verificando o resultado + +Para confirmar que o código de barras codifica corretamente a frase em russo: + +1. Abra o arquivo PNG em um visualizador de imagens. +2. Use qualquer aplicativo de escaneamento DataMatrix (muitos apps móveis suportam) ou um scanner de hardware. +3. A string decodificada deve exibir `ABC123Привет` (ou as duas partes separadas, dependendo da interface do scanner). + +Se os caracteres russos aparecerem como lixo, verifique novamente se o scanner suporta ECI UTF‑8. A maioria dos leitores modernos suporta, mas dispositivos legados podem precisar de configuração explícita. + +## Armadilhas comuns e como evitá‑las + +| Problema | Causa | Solução | +|----------|-------|---------| +| Saída cirílica corrompida | Indicador ECI ausente | Use `add_eci_codetext` com `eci_encoding=3`. | +| Código de barras muito pequeno para a impressora | Tamanho de módulo padrão muito pequeno para baixa DPI | Aumente `x_dimension` (ex.: `3.0` ou `4.0`). | +| Arquivo não salvo | Caminho de diretório inválido | Certifique-se de que `YOUR_DIRECTORY` exista e seja gravável. | +| Scanner não consegue ler | Densidade de dados excessiva | Reduza a quantidade de dados codificados ou aumente o nível de correção de erro (`generator.parameters.barcode.error_correction_level`). | + +## Estendendo o exemplo + +Você pode adaptar este padrão para outros idiomas ou tipos de dados: + +* **Codificar texto em japonês ou árabe** – altere `eci_encoding` para o valor apropriado (ex.: 5 para ISO‑8859‑5, 6 para ISO‑8859‑7). +* **Adicionar múltiplos segmentos ECI** – chame `add_eci_codetext` várias vezes, cada um com sua própria codificação. +* **Criar um código QR em vez disso** – substitua `EncodeTypes.DATA_MATRIX` por `EncodeTypes.QR`. + +Todas as demais etapas permanecem idênticas porque o `ExtCodetextBuilder` abstrai o manuseio de bytes de baixo nível. + +## Conclusão + +Agora você sabe como **gerar código de barras DataMatrix** em Python e **codificar texto em russo** usando o recurso de codetext estendido do Aspose.BarCode. O script completo lida com a negociação de conjunto de caracteres, criação do código de barras e geração da imagem com apenas algumas linhas de código. + +Em seguida, explore outras simbologias de códigos de barras (PDF417, Aztec) ou integre o gerador a um serviço web que devolve imagens PNG sob demanda. Os mesmos princípios — construir um codetext estendido e selecionar o `EncodeTypes` apropriado — se aplicam a toda a suíte Aspose.BarCode. + +Boa codificação e aproveite o poder da geração de códigos de barras multilíngues! + +## O que você deve aprender a seguir? + +Os tutoriais a seguir cobrem tópicos intimamente relacionados que se baseiam nas técnicas demonstradas neste guia. Cada recurso inclui exemplos de código completos e funcionais com explicações passo a passo para ajudá‑lo a dominar recursos adicionais da API e explorar abordagens de implementação alternativas em seus próprios projetos. + +- [Como gerar códigos de barras DataMatrix usando Aspose.BarCode para .NET – Guia passo a passo](/barcode/english/net/datamatrix-barcode-configuration/) +- [Gerar um código de barras DataMatrix em modo ASCII com Aspose.BarCode para .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [Como gerar códigos de barras DataMatrix (ECC 200) com Aspose.BarCode para .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/russian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/russian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..93c8bd153 --- /dev/null +++ b/barcode/russian/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Научитесь генерировать штрих‑код DataMatrix в Python и кодировать русский + текст с помощью Aspose.BarCode – пошаговое руководство. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: ru +lastmod: 2026-08-22 +og_description: Создайте штрих‑код DataMatrix на Python и закодируйте русский текст + с помощью Aspose.BarCode. Следуйте полному примеру и запустите его мгновенно. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Создание штрих‑кода DataMatrix в Python — полный учебник Aspose.BarCode +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Как сгенерировать штрих‑код DataMatrix в Python с помощью Aspose.BarCode +url: /ru/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Как генерировать DataMatrix штрих‑код в Python с Aspose.BarCode + +Если вам нужно **генерировать DataMatrix штрих‑код** в Python, одновременно **кодируя русский текст**, это руководство покажет вам точные шаги. Вы увидите полный, исполняемый пример, который создает расширенный codetext, настраивает штрих‑код и сохраняет изображение в одном скрипте. + +Создание штрих‑кодов, содержащих символы не‑ASCII, часто вызывает вопросы о наборах символов и кодировании данных. Используя `ExtCodetextBuilder` из Aspose.BarCode, вы можете безопасно внедрять UTF‑8 текст, например кириллические символы, в символ DataMatrix. Результат работает с любым сканером, поддерживающим стандарт DataMatrix. + +В этом руководстве вы: + +* Установите необходимый пакет Aspose.BarCode. +* Сформируете расширенный codetext, комбинирующий обычные данные и русский текст. +* **Сгенерируете DataMatrix штрих‑код** с расширенной строкой. +* Настроите параметры штрих‑кода, такие как размер модуля. +* Сохраните штрих‑код в файл PNG. + +Внешние сервисы не требуются; всё работает локально на вашем компьютере. + +## Требования + +Прежде чем начать, убедитесь, что у вас есть: + +* Установленный Python 3.8 или новее. +* Действующая лицензия Aspose.BarCode для Python (бесплатная пробная версия подходит для разработки). +* Базовые знания скриптинга на Python. + +Вы можете установить библиотеку Aspose.BarCode через pip: + +```bash +pip install aspose-barcode +``` + +## Шаг 1: Создать строку расширенного codetext + +Первая задача — создать одну строку, содержащую как обычный идентификатор продукта, так и русскую фразу. `ExtCodetextBuilder` позволяет конкатенировать разные части codetext, сохраняя информацию об их кодировке. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Почему этот шаг важен** – символы DataMatrix хранят необработанные байты. Когда необходимо смешивать алфавиты, вы должны указать кодировщику, какой набор символов применяется к каждому сегменту. Метод `add_eci_codetext` вставляет индикатор ECI перед русским текстом, гарантируя, что сканеры интерпретируют байты как UTF‑8. Без ECI кириллические символы будут отображаться как искажённые данные. + +## Шаг 2: Создать генератор DataMatrix штрих‑кода + +Когда расширенный codetext готов, создайте экземпляр `BarcodeGenerator`, указывая тип `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Почему DataMatrix?** – DataMatrix это двумерный штрих‑код, способный хранить до 2 335 буквенно‑цифровых символов или 1 556 байт. Он идеален для небольших предметов, промышленных деталей и ситуаций, когда необходимо внедрять многоязычный текст. + +## Шаг 3: (Опционально) Настроить параметры штрих‑кода + +Aspose.BarCode предоставляет множество параметров. Для большинства сценариев настройки по умолчанию дают читаемый символ. Однако вы можете захотеть контролировать размер каждого модуля (самый маленький квадрат в матрице), чтобы соответствовать требованиям печати. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Другие полезные параметры включают уровень коррекции ошибок, отступ и цвет фона. Регулируйте их только если ваша целевая среда сканирования требует определённых допусков. + +## Шаг 4: Сохранить изображение штрих‑кода + +Наконец, запишите штрих‑код в файл. Метод `save` поддерживает PNG, JPEG, BMP и несколько векторных форматов. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Когда вы откроете `extended_codetext.png`, вы увидите чёткий символ DataMatrix. Сканирование его стандартным считывателем DataMatrix вернёт две части: + +1. **ABC123** – обычный идентификатор. +2. **Привет** – русское приветствие, корректно декодированное как UTF‑8. + +## Полный, исполняемый пример + +Ниже приведён полный скрипт, который вы можете скопировать и вставить в файл с именем `generate_datamatrix.py`. Замените `YOUR_DIRECTORY` на существующую папку в вашей системе. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Запустите скрипт из командной строки: + +```bash +python generate_datamatrix.py +``` + +Вы должны увидеть вывод в консоли, похожий на: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Проверка результата + +Чтобы убедиться, что штрих‑код правильно кодирует русскую фразу: + +1. Откройте PNG‑файл в просмотрщике изображений. +2. Используйте любое приложение для сканирования DataMatrix (многие мобильные приложения поддерживают его) или аппаратный сканер. +3. Декодированная строка должна отображать `ABC123Привет` (или две части, разделённые в зависимости от интерфейса сканера). + +Если русские символы отображаются как нечитаемый набор, проверьте, поддерживает ли сканер ECI UTF‑8. Большинство современных считывателей поддерживают его, но устаревшие устройства могут требовать явной настройки. + +## Распространённые ошибки и как их избежать + +| Проблема | Причина | Решение | +|----------|---------|---------| +| Искажённый вывод кириллицы | Отсутствует индикатор ECI | Используйте `add_eci_codetext` с `eci_encoding=3`. | +| Штрих‑код слишком мал для принтера | Размер модуля по умолчанию слишком мелкий для низкого DPI | Увеличьте `x_dimension` (например, `3.0` или `4.0`). | +| Файл не сохранён | Недействительный путь к директории | Убедитесь, что `YOUR_DIRECTORY` существует и доступен для записи. | +| Сканер не может прочитать | Слишком высокая плотность данных | Уменьшите объём кодируемых данных или увеличьте уровень коррекции ошибок (`generator.parameters.barcode.error_correction_level`). | + +## Расширение примера + +Вы можете адаптировать этот шаблон для других языков или типов данных: + +* **Кодировать японский или арабский текст** – измените `eci_encoding` на соответствующее значение (например, 5 для ISO‑8859‑5, 6 для ISO‑8859‑7). +* **Добавить несколько ECI‑сегментов** – вызовите `add_eci_codetext` несколько раз, каждый раз с собственной кодировкой. +* **Создать QR‑код вместо этого** – замените `EncodeTypes.DATA_MATRIX` на `EncodeTypes.QR`. + +Все остальные шаги остаются одинаковыми, поскольку `ExtCodetextBuilder` абстрагирует работу с байтами низкого уровня. + +## Заключение + +Теперь вы знаете, как **генерировать DataMatrix штрих‑код** в Python и **кодировать русский текст** с помощью функции расширенного codetext в Aspose.BarCode. Полный скрипт обрабатывает согласование наборов символов, создание штрих‑кода и вывод изображения всего несколькими строками кода. + +Далее изучайте другие символьные системы штрих‑кодов (PDF417, Aztec) или интегрируйте генератор в веб‑службу, возвращающую PNG‑изображения по запросу. Те же принципы — построение расширенного codetext и выбор соответствующего `EncodeTypes` — применимы ко всему набору Aspose.BarCode. + +Удачной разработки и наслаждайтесь возможностями многоязычной генерации штрих‑кодов! + +## Что стоит изучить дальше? + +Следующие руководства охватывают тесно связанные темы, основанные на техниках, продемонстрированных в этом руководстве. Каждый ресурс включает полные работающие примеры кода с пошаговыми объяснениями, чтобы помочь вам освоить дополнительные возможности API и исследовать альтернативные подходы к реализации в ваших проектах. + +- [Как генерировать DataMatrix штрих‑коды с помощью Aspose.BarCode для .NET – пошаговое руководство](/barcode/english/net/datamatrix-barcode-configuration/) +- [Генерация DataMatrix штрих‑кода в ASCII‑режиме с Aspose.BarCode для .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [Как генерировать DataMatrix штрих‑коды (ECC 200) с Aspose.BarCode для .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/spanish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/spanish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..9979c10fe --- /dev/null +++ b/barcode/spanish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Aprende a generar códigos de barras DataMatrix en Python y a codificar + texto en ruso usando Aspose.BarCode – guía paso a paso. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: es +lastmod: 2026-08-22 +og_description: Genera un código de barras DataMatrix en Python y codifica texto en + ruso con Aspose.BarCode. Sigue el ejemplo completo y ejecútalo al instante. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Generar código de barras DataMatrix en Python – tutorial completo de Aspose.BarCode +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Cómo generar código de barras DataMatrix en Python con Aspose.BarCode +url: /es/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cómo generar un código de barras DataMatrix en Python con Aspose.BarCode + +Si necesitas **generar un código de barras DataMatrix** en Python mientras **codificas texto en ruso**, esta guía muestra los pasos exactos. Verás un ejemplo completo y ejecutable que construye un codetext extendido, configura el código de barras y guarda la imagen en un solo script. + +Crear códigos de barras que contengan caracteres no ASCII a menudo genera preguntas sobre juegos de caracteres y codificación de datos. Usando `ExtCodetextBuilder` de Aspose.BarCode, puedes incrustar de forma segura texto UTF‑8 como caracteres cirílicos dentro de un símbolo DataMatrix. El resultado funciona con cualquier escáner que soporte el estándar DataMatrix. + +En este tutorial aprenderás a: + +* Instalar el paquete necesario de Aspose.BarCode. +* Construir un codetext extendido que mezcle datos simples y texto en ruso. +* **Generar un código de barras DataMatrix** con la cadena extendida. +* Ajustar parámetros del código de barras como el tamaño del módulo. +* Guardar el código de barras como archivo PNG. + +No se requieren servicios externos; todo se ejecuta localmente en tu máquina. + +## Requisitos previos + +Antes de comenzar, asegúrate de tener: + +* Python 3.8 o superior instalado. +* Una licencia activa de Aspose.BarCode para Python (una prueba gratuita funciona para desarrollo). +* Familiaridad básica con la escritura de scripts en Python. + +Puedes instalar la biblioteca Aspose.BarCode vía pip: + +```bash +pip install aspose-barcode +``` + +## Paso 1: Construir una cadena de codetext extendido + +La primera tarea es crear una única cadena que contenga tanto el identificador de producto simple como la frase en ruso. `ExtCodetextBuilder` te permite concatenar diferentes partes de codetext mientras preserva su información de codificación. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Por qué este paso es importante** – Los símbolos DataMatrix almacenan bytes crudos. Cuando necesitas mezclar alfabetos, debes indicar al codificador qué juego de caracteres se aplica a cada segmento. El método `add_eci_codetext` inserta un indicador ECI antes del texto ruso, asegurando que los escáneres interpreten los bytes como UTF‑8. Sin ECI, los caracteres cirílicos aparecerían como datos corruptos. + +## Paso 2: Crear un generador de código de barras DataMatrix + +Con el codetext extendido listo, instancia un `BarcodeGenerator` especificando el tipo `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**¿Por qué DataMatrix?** – DataMatrix es un código de barras bidimensional que puede almacenar hasta 2 335 caracteres alfanuméricos o 1 556 bytes. Es ideal para artículos pequeños, piezas industriales y situaciones donde necesitas incrustar texto multilingüe. + +## Paso 3: (Opcional) Configurar parámetros del código de barras + +Aspose.BarCode expone muchos parámetros. Para la mayoría de los casos, la configuración predeterminada produce un símbolo legible. Sin embargo, puede que quieras controlar el tamaño de cada módulo (el cuadrado más pequeño de la matriz) para que coincida con los requisitos de impresión. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Otros parámetros útiles incluyen el nivel de corrección de errores, margen y color de fondo. Ajústalos solo si tu entorno de escaneo objetivo requiere tolerancias específicas. + +## Paso 4: Guardar la imagen del código de barras + +Finalmente, escribe el código de barras en un archivo. El método `save` admite PNG, JPEG, BMP y varios formatos vectoriales. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Al abrir `extended_codetext.png`, verás un símbolo DataMatrix nítido. Escanearlo con un lector estándar de DataMatrix devuelve las dos partes: + +1. **ABC123** – el identificador simple. +2. **Привет** – el saludo en ruso, decodificado correctamente como UTF‑8. + +## Ejemplo completo y ejecutable + +A continuación tienes el script completo que puedes copiar‑pegar en un archivo llamado `generate_datamatrix.py`. Sustituye `YOUR_DIRECTORY` por una carpeta existente en tu sistema. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Ejecuta el script desde la línea de comandos: + +```bash +python generate_datamatrix.py +``` + +Deberías ver una salida en consola similar a: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Verificando el resultado + +Para confirmar que el código de barras codifica correctamente la frase en ruso: + +1. Abre el archivo PNG en un visor de imágenes. +2. Usa cualquier aplicación de escaneo DataMatrix (muchas apps móviles lo soportan) o un escáner hardware. +3. La cadena decodificada debería mostrar `ABC123Привет` (o las dos partes separadas según la UI del escáner). + +Si los caracteres rusos aparecen como basura, verifica que el escáner soporte ECI UTF‑8. La mayoría de los lectores modernos lo hacen, pero dispositivos heredados pueden requerir configuración explícita. + +## Problemas comunes y cómo evitarlos + +| Problema | Causa | Solución | +|----------|-------|----------| +| Salida cirílica corrupta | Indicador ECI ausente | Usa `add_eci_codetext` con `eci_encoding=3`. | +| Código de barras demasiado pequeño para la impresora | Tamaño de módulo predeterminado demasiado fino para DPI bajo | Incrementa `x_dimension` (p. ej., `3.0` o `4.0`). | +| Archivo no guardado | Ruta de directorio inválida | Asegúrate de que `YOUR_DIRECTORY` exista y tenga permisos de escritura. | +| El escáner no puede leer | Densidad de datos excesiva | Reduce la cantidad de datos codificados o aumenta el nivel de corrección de errores (`generator.parameters.barcode.error_correction_level`). | + +## Extender el ejemplo + +Puedes adaptar este patrón para otros idiomas o tipos de datos: + +* **Codificar texto japonés o árabe** – cambia `eci_encoding` al valor correspondiente (p. ej., 5 para ISO‑8859‑5, 6 para ISO‑8859‑7). +* **Agregar varios segmentos ECI** – llama a `add_eci_codetext` varias veces, cada una con su propia codificación. +* **Crear un código QR en su lugar** – reemplaza `EncodeTypes.DATA_MATRIX` por `EncodeTypes.QR`. + +Todos los demás pasos permanecen idénticos porque `ExtCodetextBuilder` abstrae el manejo de bytes de bajo nivel. + +## Conclusión + +Ahora sabes cómo **generar un código de barras DataMatrix** en Python y **codificar texto en ruso** usando la función de codetext extendido de Aspose.BarCode. El script completo maneja la negociación del juego de caracteres, la creación del código de barras y la salida de imagen con solo unas pocas líneas de código. + +A continuación, explora otras simbologías de códigos de barras (PDF417, Aztec) o integra el generador en un servicio web que devuelva imágenes PNG bajo demanda. Los mismos principios—construir un codetext extendido y seleccionar el `EncodeTypes` apropiado—se aplican a toda la suite de Aspose.BarCode. + +¡Feliz codificación y disfruta del poder de la generación multilingüe de códigos de barras! + +## ¿Qué deberías aprender a continuación? + +Los siguientes tutoriales cubren temas estrechamente relacionados que amplían las técnicas demostradas en esta guía. Cada recurso incluye ejemplos de código completos y explicaciones paso a paso para ayudarte a dominar funciones adicionales de la API y explorar enfoques de implementación alternativos en tus propios proyectos. + +- [Cómo generar códigos de barras DataMatrix usando Aspose.BarCode para .NET – Guía paso a paso](/barcode/english/net/datamatrix-barcode-configuration/) +- [Generar un código de barras DataMatrix en modo ASCII con Aspose.BarCode para .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [Cómo generar códigos de barras DataMatrix (ECC 200) con Aspose.BarCode para .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/swedish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/swedish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..4fc924eba --- /dev/null +++ b/barcode/swedish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Lär dig att generera DataMatrix‑streckkod i Python och koda rysk text + med Aspose.BarCode – steg‑för‑steg‑guide. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: sv +lastmod: 2026-08-22 +og_description: Generera DataMatrix-streckkod i Python och koda rysk text med Aspose.BarCode. + Följ hela exemplet och kör det omedelbart. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Generera DataMatrix-streckkod i Python – komplett Aspose.BarCode-handledning +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Hur man genererar DataMatrix‑streckkod i Python med Aspose.BarCode +url: /sv/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Så genererar du DataMatrix-streckkod i Python med Aspose.BarCode + +Om du behöver **generera DataMatrix-streckkod** i Python samtidigt som du **kodar rysk text**, visar den här guiden de exakta stegen. Du får se ett komplett, körbart exempel som bygger en utökad kodtext, konfigurerar streckkoden och sparar bilden i ett enda skript. + +Att skapa streckkoder som innehåller icke‑ASCII‑tecken väcker ofta frågor om teckenuppsättningar och data‑kodning. Genom att använda Aspose.BarCode:s `ExtCodetextBuilder` kan du säkert bädda in UTF‑8‑text, såsom kyrilliska tecken, i en DataMatrix‑symbol. Resultatet fungerar med alla skannrar som stöder DataMatrix‑standarden. + +I den här handledningen kommer du att: + +* Installera det erforderliga Aspose.BarCode‑paketet. +* Bygga en utökad kodtext som blandar vanlig data och rysk text. +* **Generera DataMatrix-streckkod** med den utökade strängen. +* Justera streckkodens parametrar som modulstorlek. +* Spara streckkoden som en PNG‑fil. + +Inga externa tjänster krävs; allt körs lokalt på din maskin. + +## Förutsättningar + +Innan du börjar, se till att du har: + +* Python 3.8 eller nyare installerat. +* En aktiv Aspose.BarCode‑licens för Python (en gratis provlicens fungerar för utveckling). +* Grundläggande kunskap om Python‑skriptning. + +Du kan installera Aspose.BarCode‑biblioteket via pip: + +```bash +pip install aspose-barcode +``` + +## Steg 1: Bygg en utökad kodtextsträng + +Den första uppgiften är att skapa en enda sträng som innehåller både den enkla produktidentifieraren och den ryska frasen. `ExtCodetextBuilder` låter dig concatenera olika kodtextdelar samtidigt som deras kodningsinformation bevaras. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Varför detta steg är viktigt** – DataMatrix‑symboler lagrar råa byte. När du behöver blanda alfabet måste du tala om för kodaren vilken teckenuppsättning som gäller för varje segment. Metoden `add_eci_codetext` sätter in en ECI‑indikator före den ryska texten, vilket säkerställer att skannrar tolkar bytena som UTF‑8. Utan ECI skulle de kyrilliska tecknen visas som förvrängd data. + +## Steg 2: Skapa en DataMatrix‑streckkodsgenerator + +När den utökade kodtexten är klar, instansiera en `BarcodeGenerator` och ange typen `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Varför DataMatrix?** – DataMatrix är en tvådimensionell streckkod som kan lagra upp till 2 335 alfanumeriska tecken eller 1 556 byte. Den är idealisk för små föremål, industriella delar och situationer där du behöver bädda in flerspråkig text. + +## Steg 3: (Valfritt) Konfigurera streckkodens parametrar + +Aspose.BarCode exponerar många parametrar. För de flesta användningsfall ger standardinställningarna en läsbar symbol. Du kan dock vilja kontrollera storleken på varje modul (den minsta kvadraten i matrisen) för att matcha utskriftskraven. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Andra användbara parametrar inkluderar felkorrigeringsnivå, marginal och bakgrundsfärg. Justera dem endast om din mål‑scannermiljö kräver specifika toleranser. + +## Steg 4: Spara streckkodsbilden + +Skriv slutligen streckkoden till en fil. Metoden `save` stöder PNG, JPEG, BMP och flera vektorformat. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +När du öppnar `extended_codetext.png` ser du en skarp DataMatrix‑symbol. Att skanna den med en standard‑DataMatrix‑läsare returnerar de två delarna: + +1. **ABC123** – den enkla identifieraren. +2. **Привет** – den ryska hälsningen, korrekt avkodad som UTF‑8. + +## Fullt, körbart exempel + +Nedan är hela skriptet som du kan kopiera‑och‑klistra in i en fil med namnet `generate_datamatrix.py`. Ersätt `YOUR_DIRECTORY` med en befintlig mapp på ditt system. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Kör skriptet från kommandoraden: + +```bash +python generate_datamatrix.py +``` + +Du bör se konsolutdata liknande: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Verifiera resultatet + +För att bekräfta att streckkoden korrekt kodar den ryska frasen: + +1. Öppna PNG‑filen i en bildvisare. +2. Använd någon DataMatrix‑skanningsapp (många mobilappar stödjer det) eller en hårdvaruskanner. +3. Den avkodade strängen bör visa `ABC123Привет` (eller de två delarna separerade beroende på skannarens UI). + +Om de ryska tecknen visas som nonsens, dubbelkolla att skannern stödjer ECI UTF‑8. De flesta moderna läsare gör det, men äldre enheter kan behöva explicit konfiguration. + +## Vanliga fallgropar och hur du undviker dem + +| Problem | Orsak | Lösning | +|---------|-------|---------| +| Förvrängd kyrillisk utskrift | Saknad ECI‑indikator | Använd `add_eci_codetext` med `eci_encoding=3`. | +| Streckkod för liten för skrivare | Standardmodulstorlek för fin för låg DPI | Öka `x_dimension` (t.ex. `3.0` eller `4.0`). | +| Filen sparas inte | Ogiltig sökväg till katalog | Säkerställ att `YOUR_DIRECTORY` finns och är skrivbar. | +| Skannern kan inte läsa | Överdriven datatäthet | Minska mängden kodad data eller öka felkorrigeringsnivån (`generator.parameters.barcode.error_correction_level`). | + +## Utöka exemplet + +Du kan anpassa detta mönster för andra språk eller datatyper: + +* **Koda japansk eller arabisk text** – ändra `eci_encoding` till lämpligt värde (t.ex. 5 för ISO‑8859‑5, 6 för ISO‑8859‑7). +* **Lägg till flera ECI‑segment** – anropa `add_eci_codetext` flera gånger, varje med sin egen kodning. +* **Skapa en QR‑kod istället** – ersätt `EncodeTypes.DATA_MATRIX` med `EncodeTypes.QR`. + +Alla andra steg förblir identiska eftersom `ExtCodetextBuilder` abstraherar den lågnivå‑byte‑hanteringen. + +## Slutsats + +Du vet nu hur du **genererar DataMatrix‑streckkod** i Python och **kodar rysk text** med Aspose.BarCode:s utökade kodtextfunktion. Det kompletta skriptet hanterar teckenuppsättnings‑förhandling, streckkodsskapande och bildutmatning med bara några rader kod. + +Nästa steg är att utforska andra streckkodssymboler (PDF417, Aztec) eller integrera generatorn i en webbtjänst som returnerar PNG‑bilder på begäran. Samma principer – att bygga en utökad kodtext och välja rätt `EncodeTypes` – gäller för hela Aspose.BarCode‑sviten. + +Lycka till med kodningen, och njut av kraften i flerspråkig streckkodsgenerering! + +## Vad bör du lära dig härnäst? + +Följande handledningar täcker närbesläktade ämnen som bygger på teknikerna som demonstreras i den här guiden. Varje resurs innehåller kompletta fungerande kodexempel med steg‑för‑steg‑förklaringar för att hjälpa dig bemästra ytterligare API‑funktioner och utforska alternativa implementationsmetoder i dina egna projekt. + +- [Hur man genererar DataMatrix-streckkoder med Aspose.BarCode för .NET – Steg‑för‑steg‑guide](/barcode/english/net/datamatrix-barcode-configuration/) +- [Generera en DataMatrix-streckkod i ASCII‑läge med Aspose.BarCode för .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [Hur man genererar DataMatrix-streckkoder (ECC 200) med Aspose.BarCode för .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/thai/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/thai/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..5e2adaec7 --- /dev/null +++ b/barcode/thai/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: เรียนรู้วิธีสร้างบาร์โค้ด DataMatrix ด้วย Python และเข้ารหัสข้อความภาษารัสเซียโดยใช้ + Aspose.BarCode – คู่มือแบบทีละขั้นตอน +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: th +lastmod: 2026-08-22 +og_description: สร้างบาร์โค้ด DataMatrix ด้วย Python และเข้ารหัสข้อความรัสเซียด้วย + Aspose.BarCode ทำตามตัวอย่างเต็มและรันได้ทันที +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: สร้างบาร์โค้ด DataMatrix ด้วย Python – บทเรียน Aspose.BarCode อย่างครบถ้วน +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: วิธีสร้างบาร์โค้ด DataMatrix ด้วย Python และ Aspose.BarCode +url: /th/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# วิธีสร้างบาร์โค้ด DataMatrix ด้วย Python และ Aspose.BarCode + +หากคุณต้องการ **สร้างบาร์โค้ด DataMatrix** ด้วย Python พร้อมกับ **การเข้ารหัสข้อความรัสเซีย** คู่มือนี้จะแสดงขั้นตอนที่แน่นอน คุณจะได้เห็นตัวอย่างที่ทำงานได้เต็มรูปแบบซึ่งสร้าง extended codetext, ตั้งค่าบาร์โค้ด, และบันทึกภาพในสคริปต์เดียว + +การสร้างบาร์โค้ดที่มีอักขระที่ไม่ใช่ ASCII มักทำให้เกิดคำถามเกี่ยวกับชุดอักขระและการเข้ารหัสข้อมูล โดยการใช้ `ExtCodetextBuilder` ของ Aspose.BarCode คุณสามารถฝังข้อความ UTF‑8 เช่นอักษร Cyrillic ลงในสัญลักษณ์ DataMatrix ได้อย่างปลอดภัย ผลลัพธ์จะทำงานกับสแกนเนอร์ใด ๆ ที่รองรับมาตรฐาน DataMatrix + +ในบทเรียนนี้คุณจะ: + +* ติดตั้งแพคเกจ Aspose.BarCode ที่จำเป็น +* สร้าง extended codetext ที่ผสมข้อมูลธรรมดาและข้อความรัสเซีย +* **สร้างบาร์โค้ด DataMatrix** ด้วยสตริงที่ขยายแล้ว +* ปรับพารามิเตอร์ของบาร์โค้ดเช่นขนาดโมดูล +* บันทึกบาร์โค้ดเป็นไฟล์ PNG + +ไม่ต้องใช้บริการภายนอก; ทุกอย่างทำงานบนเครื่องของคุณ + +## ข้อกำหนดเบื้องต้น + +ก่อนเริ่มทำงาน ให้ตรวจสอบว่าคุณมี: + +* Python 3.8 หรือใหม่กว่า ติดตั้งอยู่แล้ว +* ใบอนุญาต Aspose.BarCode for Python ที่ใช้งานได้ (ทดลองฟรีก็ใช้ได้สำหรับการพัฒนา) +* ความคุ้นเคยพื้นฐานกับการเขียนสคริปต์ Python + +คุณสามารถติดตั้งไลบรารี Aspose.BarCode ผ่าน pip: + +```bash +pip install aspose-barcode +``` + +## ขั้นตอนที่ 1: สร้างสตริง extended codetext + +งานแรกคือการสร้างสตริงเดียวที่บรรจุทั้งตัวระบุสินค้าแบบธรรมดาและวลีรัสเซีย `ExtCodetextBuilder` ช่วยให้คุณต่อส่วนต่าง ๆ ของ codetext เข้าด้วยกันพร้อมคงข้อมูลการเข้ารหัสไว้ + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**ทำไมขั้นตอนนี้สำคัญ** – สัญลักษณ์ DataMatrix จะเก็บไบต์ดิบ เมื่อคุณต้องผสมอักษรหลายชุด คุณต้องบอกตัวเข้ารหัสว่าชุดอักขระใดใช้กับแต่ละส่วน วิธี `add_eci_codetext` จะใส่ตัวบ่งชี้ ECI ก่อนข้อความรัสเซีย เพื่อให้สแกนเนอร์ตีความไบต์เป็น UTF‑8 หากไม่มี ECI ตัวอักษร Cyrillic จะปรากฏเป็นข้อมูลเสียหาย + +## ขั้นตอนที่ 2: สร้างตัวสร้างบาร์โค้ด DataMatrix + +เมื่อมี extended codetext พร้อมแล้ว ให้สร้างอ็อบเจกต์ `BarcodeGenerator` โดยระบุประเภท `EncodeTypes.DATA_MATRIX` + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**ทำไมต้องเป็น DataMatrix?** – DataMatrix เป็นบาร์โค้ดสองมิติที่สามารถเก็บได้สูงสุด 2,335 ตัวอักษรอัลฟานูเมอริกหรือ 1,556 ไบต์ เหมาะสำหรับรายการขนาดเล็ก, ชิ้นส่วนอุตสาหกรรม, และสถานการณ์ที่ต้องฝังข้อความหลายภาษา + +## ขั้นตอนที่ 3: (ทางเลือก) ตั้งค่าพารามิเตอร์ของบาร์โค้ด + +Aspose.BarCode เปิดเผยพารามิเตอร์หลายอย่าง สำหรับกรณีใช้งานส่วนใหญ่ การตั้งค่าเริ่มต้นจะให้สัญลักษณ์ที่อ่านได้ อย่างไรก็ตาม คุณอาจต้องการควบคุมขนาดของแต่ละโมดูล (สี่เหลี่ยมที่เล็กที่สุดในเมทริกซ์) เพื่อให้ตรงกับความต้องการการพิมพ์ + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +พารามิเตอร์ที่เป็นประโยชน์อื่น ๆ ได้แก่ ระดับการแก้ไขข้อผิดพลาด, ระยะขอบ, และสีพื้นหลัง ปรับเฉพาะเมื่อสภาพแวดล้อมการสแกนของคุณต้องการความทนทานเฉพาะ + +## ขั้นตอนที่ 4: บันทึกภาพบาร์โค้ด + +สุดท้าย ให้เขียนบาร์โค้ดลงไฟล์ วิธี `save` รองรับ PNG, JPEG, BMP, และหลายรูปแบบเวกเตอร์ + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +เมื่อคุณเปิด `extended_codetext.png` คุณจะเห็นสัญลักษณ์ DataMatrix ที่คมชัด การสแกนด้วยเครื่องอ่าน DataMatrix มาตรฐานจะคืนค่าทั้งสองส่วน: + +1. **ABC123** – ตัวระบุแบบธรรมดา +2. **Привет** – คำทักทายภาษารัสเซีย ที่ถอดรหัสเป็น UTF‑8 อย่างถูกต้อง + +## ตัวอย่างเต็มที่ทำงานได้ + +ด้านล่างเป็นสคริปต์สมบูรณ์ที่คุณสามารถคัดลอก‑วางลงไฟล์ชื่อ `generate_datamatrix.py` แทนที่ `YOUR_DIRECTORY` ด้วยโฟลเดอร์ที่มีอยู่บนระบบของคุณ + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +เรียกใช้สคริปต์จากบรรทัดคำสั่ง: + +```bash +python generate_datamatrix.py +``` + +คุณควรเห็นผลลัพธ์บนคอนโซลคล้ายกับ: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## การตรวจสอบผลลัพธ์ + +เพื่อยืนยันว่าบาร์โค้ดเข้ารหัสวลีรัสเซียอย่างถูกต้อง: + +1. เปิดไฟล์ PNG ด้วยโปรแกรมดูภาพ +2. ใช้แอปสแกน DataMatrix ใดก็ได้ (แอปมือถือหลายตัวรองรับ) หรือสแกนเนอร์ฮาร์ดแวร์ +3. สตริงที่ถอดรหัสควรแสดง `ABC123Привет` (หรือสองส่วนแยกกันขึ้นอยู่กับ UI ของสแกนเนอร์) + +หากตัวอักษรรัสเซียปรากฏเป็นอักขระผสม ให้ตรวจสอบว่าสตากนเนอร์รองรับ ECI UTF‑8 หรือไม่ เครื่องอ่านสมัยใหม่ส่วนใหญ่ทำได้ แต่บางอุปกรณ์เก่าอาจต้องตั้งค่าเพิ่มเติม + +## ข้อผิดพลาดทั่วไปและวิธีหลีกเลี่ยง + +| ปัญหา | สาเหตุ | วิธีแก้ | +|-------|-------|-----| +| ผลลัพธ์ Cyrillic เป็นอักขระผสม | ไม่มีตัวบ่งชี้ ECI | ใช้ `add_eci_codetext` พร้อม `eci_encoding=3`. | +| บาร์โค้ดเล็กเกินไปสำหรับเครื่องพิมพ์ | ขนาดโมดูลเริ่มต้นละเอียดเกินไปสำหรับ DPI ต่ำ | เพิ่ม `x_dimension` (เช่น `3.0` หรือ `4.0`). | +| ไฟล์ไม่ถูกบันทึก | เส้นทางไดเรกทอรีไม่ถูกต้อง | ตรวจสอบให้แน่ใจว่า `YOUR_DIRECTORY` มีอยู่และสามารถเขียนได้. | +| สแกนเนอร์อ่านไม่ออก | ความหนาแน่นข้อมูลมากเกินไป | ลดปริมาณข้อมูลที่เข้ารหัสหรือเพิ่มระดับการแก้ไขข้อผิดพลาด (`generator.parameters.barcode.error_correction_level`). | + +## การขยายตัวอย่าง + +คุณสามารถปรับใช้รูปแบบนี้กับภาษาอื่นหรือประเภทข้อมูลอื่นได้: + +* **Encode Japanese or Arabic text** – เปลี่ยน `eci_encoding` เป็นค่าที่เหมาะสม (เช่น 5 สำหรับ ISO‑8859‑5, 6 สำหรับ ISO‑8859‑7). +* **Add multiple ECI segments** – เรียก `add_eci_codetext` หลายครั้ง, แต่ละครั้งใช้การเข้ารหัสของตนเอง. +* **Create a QR code instead** – แทนที่ `EncodeTypes.DATA_MATRIX` ด้วย `EncodeTypes.QR`. + +ขั้นตอนอื่น ๆ เหลือเหมือนเดิม เพราะ `ExtCodetextBuilder` จัดการการแปลงไบต์ระดับต่ำให้คุณ + +## สรุป + +คุณตอนนี้รู้วิธี **สร้างบาร์โค้ด DataMatrix** ด้วย Python และ **เข้ารหัสข้อความรัสเซีย** ด้วยคุณสมบัติ extended codetext ของ Aspose.BarCode สคริปต์เต็มจะจัดการการเจรจาชุดอักขระ, การสร้างบาร์โค้ด, และการส่งออกภาพด้วยเพียงไม่กี่บรรทัดโค้ด + +ต่อไป ให้สำรวจสัญลักษณ์บาร์โค้ดอื่น ๆ (PDF417, Aztec) หรือผสานตัวสร้างเข้ากับเว็บเซอร์วิสที่ส่งคืนภาพ PNG ตามคำขอ หลักการเดียวกัน—การสร้าง extended codetext และการเลือก `EncodeTypes` ที่เหมาะสม—ใช้ได้กับชุด Aspose.BarCode ทั้งหมด + +ขอให้เขียนโค้ดสนุกและเพลิดเพลินกับพลังของการสร้างบาร์โค้ดหลายภาษา! + +## สิ่งที่คุณควรเรียนต่อไป? + +บทเรียนต่อไปนี้ครอบคลุมหัวข้อที่เกี่ยวข้องอย่างใกล้ชิดและต่อยอดจากเทคนิคในคู่มือนี้ แต่ละแหล่งรวมตัวอย่างโค้ดทำงานเต็มรูปแบบพร้อมคำอธิบายขั้นตอนเพื่อช่วยคุณเชี่ยวชาญฟีเจอร์ API เพิ่มเติมและสำรวจแนวทางการนำไปใช้ในโครงการของคุณ + +- [วิธีสร้างบาร์โค้ด DataMatrix ด้วย Aspose.BarCode สำหรับ .NET – คู่มือขั้นตอนโดยละเอียด](/barcode/english/net/datamatrix-barcode-configuration/) +- [สร้างบาร์โค้ด DataMatrix ในโหมด ASCII ด้วย Aspose.BarCode สำหรับ .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [วิธีสร้างบาร์โค้ด DataMatrix (ECC 200) ด้วย Aspose.BarCode สำหรับ .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/turkish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/turkish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..c886ff140 --- /dev/null +++ b/barcode/turkish/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Python'da DataMatrix barkod oluşturmayı ve Aspose.BarCode kullanarak + Rusça metni kodlamayı öğrenin – adım adım rehber. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: tr +lastmod: 2026-08-22 +og_description: Python'da DataMatrix barkod oluşturun ve Aspose.BarCode ile Rusça + metni kodlayın. Tam örneği izleyin ve hemen çalıştırın. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Python'da DataMatrix barkod oluşturma – eksiksiz Aspose.BarCode öğreticisi +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Python'da Aspose.BarCode ile DataMatrix barkodu nasıl oluşturulur +url: /tr/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Python ile Aspose.BarCode kullanarak DataMatrix barkodu nasıl oluşturulur + +Python'da **DataMatrix barkodu oluşturmak** ve **Rusça metin kodlamak** istiyorsanız, bu kılavuz size tam adımları gösterir. Tek bir betikte genişletilmiş kod metni oluşturduğunuz, barkodu yapılandırdığınız ve görüntüyü kaydettiğiniz eksiksiz, çalıştırılabilir bir örnek göreceksiniz. + +ASCII olmayan karakterler içeren barkodlar oluşturmak genellikle karakter setleri ve veri kodlamasıyla ilgili sorular ortaya çıkarır. Aspose.BarCode’un `ExtCodetextBuilder` sınıfını kullanarak, Cyrillic karakterler gibi UTF‑8 metinleri bir DataMatrix sembolünün içine güvenle gömebilirsiniz. Sonuç, DataMatrix standardını destekleyen herhangi bir tarayıcıyla çalışır. + +Bu öğreticide şunları yapacaksınız: + +* Gerekli Aspose.BarCode paketini kurun. +* Düz veri ve Rusça metni karıştıran genişletilmiş bir kod metni oluşturun. +* **DataMatrix barkodu** oluşturun ve genişletilmiş dizeyi kullanın. +* Modül boyutu gibi barkod parametrelerini ayarlayın. +* Barkodu PNG dosyası olarak kaydedin. + +Harici hizmetlere ihtiyaç yoktur; her şey makinenizde yerel olarak çalışır. + +## Önkoşullar + +Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun: + +* Python 3.8 veya daha yeni bir sürüm yüklü. +* Aktif bir Aspose.BarCode for Python lisansı (geliştirme için ücretsiz deneme sürümü yeterli). +* Python betikleme konusunda temel bilgi. + +Aspose.BarCode kütüphanesini pip aracılığıyla kurabilirsiniz: + +```bash +pip install aspose-barcode +``` + +## Adım 1: Genişletilmiş bir kod metni dizesi oluşturun + +İlk görev, hem düz ürün tanımlayıcısını hem de Rusça ifadeyi içeren tek bir dize oluşturmaktır. `ExtCodetextBuilder`, farklı kod metni bölümlerini birleştirmenize ve kodlama bilgilerini korumanıza olanak tanır. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Bu adımın önemi** – DataMatrix sembolleri ham baytları depolar. Alfabeleri karıştırmanız gerektiğinde, kodlayıcıya her segment için hangi karakter setinin geçerli olduğunu söylemeniz gerekir. `add_eci_codetext` yöntemi, Rusça metinden önce bir ECI göstergesi ekleyerek tarayıcıların baytları UTF‑8 olarak yorumlamasını sağlar. ECI olmadan, Cyrillic karakterler bozuk veri olarak görünür. + +## Adım 2: Bir DataMatrix barkod üreticisi oluşturun + +Genişletilmiş kod metni hazır olduğunda, `EncodeTypes.DATA_MATRIX` tipini belirterek bir `BarcodeGenerator` örneği oluşturun. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Neden DataMatrix?** – DataMatrix, 2.335 alfanümerik karaktere veya 1.556 bayta kadar veri depolayabilen iki boyutlu bir barkoddur. Küçük öğeler, endüstriyel parçalar ve çok dilli metin gömmeniz gereken durumlar için idealdir. + +## Adım 3: (İsteğe Bağlı) Barkod parametrelerini yapılandırın + +Aspose.BarCode birçok parametre sunar. Çoğu kullanım senaryosu için varsayılan ayarlar okunabilir bir sembol üretir. Ancak, baskı gereksinimlerinize uyacak şekilde her modülün (matristeki en küçük kare) boyutunu kontrol etmek isteyebilirsiniz. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Diğer faydalı parametreler arasında hata düzeltme seviyesi, kenar boşluğu ve arka plan rengi bulunur. Bunları yalnızca hedef tarama ortamınız belirli toleranslar talep ediyorsa ayarlayın. + +## Adım 4: Barkod görüntüsünü kaydedin + +Son olarak barkodu bir dosyaya yazın. `save` yöntemi PNG, JPEG, BMP ve birkaç vektör formatını destekler. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +`extended_codetext.png` dosyasını açtığınızda net bir DataMatrix sembolü göreceksiniz. Standart bir DataMatrix okuyucu ile taradığınızda iki bölüm geri döner: + +1. **ABC123** – düz tanımlayıcı. +2. **Привет** – Rusça selam, UTF‑8 olarak doğru şekilde çözümlenmiş. + +## Tam, çalıştırılabilir örnek + +Aşağıda `generate_datamatrix.py` adlı bir dosyaya kopyalayıp yapıştırabileceğiniz tam betik yer alıyor. `YOUR_DIRECTORY` ifadesini sisteminizde mevcut bir klasörle değiştirin. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Betik dosyasını komut satırından çalıştırın: + +```bash +python generate_datamatrix.py +``` + +Aşağıdaki gibi bir konsol çıktısı görmelisiniz: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Sonucu doğrulama + +Barkodun Rusça ifadeyi doğru kodladığını onaylamak için: + +1. PNG dosyasını bir görüntü görüntüleyicide açın. +2. Herhangi bir DataMatrix tarama uygulaması (birçok mobil uygulama destekler) veya bir donanım tarayıcı kullanın. +3. Çözümlenen dize `ABC123Привет` (veya tarayıcı arayüzüne bağlı olarak iki bölüm ayrı ayrı) şeklinde gösterilmelidir. + +Rusça karakterler bozuk görünüyorsa, tarayıcının ECI UTF‑8'i desteklediğini tekrar kontrol edin. Çoğu modern okuyucu bunu yapar, ancak eski cihazlar açık bir yapılandırma gerektirebilir. + +## Yaygın hatalar ve nasıl önlenir + +| Sorun | Neden | Çözüm | +|-------|-------|------| +| Bozuk Cyrillic çıktısı | ECI göstergesi eksik | `add_eci_codetext` ile `eci_encoding=3` kullanın. | +| Barkod yazıcı için çok küçük | Varsayılan modül boyutu düşük DPI için çok ince | `x_dimension` değerini artırın (ör. `3.0` veya `4.0`). | +| Dosya kaydedilmedi | Geçersiz klasör yolu | `YOUR_DIRECTORY` var ve yazılabilir olduğundan emin olun. | +| Tarayıcı okuyamıyor | Aşırı veri yoğunluğu | Kodlanan veri miktarını azaltın veya hata düzeltme seviyesini artırın (`generator.parameters.barcode.error_correction_level`). | + +## Örneği genişletme + +Bu deseni diğer diller veya veri türleri için uyarlayabilirsiniz: + +* **Japonca veya Arapça metin kodlayın** – `eci_encoding` değerini uygun değere değiştirin (ör. ISO‑8859‑5 için 5, ISO‑8859‑7 için 6). +* **Birden fazla ECI segmenti ekleyin** – `add_eci_codetext` metodunu birden çok kez, her seferinde farklı bir kodlama ile çağırın. +* **Bunun yerine bir QR kod oluşturun** – `EncodeTypes.DATA_MATRIX` yerine `EncodeTypes.QR` kullanın. + +Diğer tüm adımlar aynı kalır çünkü `ExtCodetextBuilder` düşük seviyeli bayt işleme detaylarını soyutlar. + +## Sonuç + +Artık Python’da **DataMatrix barkodu oluşturmayı** ve Aspose.BarCode’un genişletilmiş kod metni özelliğiyle **Rusça metin kodlamayı** biliyorsunuz. Tam betik, karakter seti anlaşmasını, barkod oluşturmayı ve görüntü çıktısını sadece birkaç satır kodla halleder. + +Sonraki adımda diğer barkod simgelerini (PDF417, Aztec) keşfedebilir veya jeneratörü, talep üzerine PNG görüntüleri dönen bir web hizmetine entegre edebilirsiniz. Aynı prensipler—genişletilmiş bir kod metni oluşturmak ve uygun `EncodeTypes` seçmek—tüm Aspose.BarCode paketinde geçerlidir. + +İyi kodlamalar ve çok dilli barkod oluşturmanın gücünün tadını çıkarın! + +## Sonraki Öğrenmeniz Gerekenler + +Aşağıdaki öğreticiler, bu kılavuzda gösterilen tekniklere dayanarak yakından ilgili konuları kapsar. Her kaynak, ek API özelliklerini ustalaşmanıza ve kendi projelerinizde alternatif uygulama yaklaşımlarını keşfetmenize yardımcı olacak tam çalışan kod örnekleri ve adım adım açıklamalar içerir. + +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) +- [Generate a DataMatrix barcode in ASCII mode with Aspose.BarCode for .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [How to Generate DataMatrix Barcodes (ECC 200) with Aspose.BarCode for .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/barcode/vietnamese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md b/barcode/vietnamese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md new file mode 100644 index 000000000..2151bf89f --- /dev/null +++ b/barcode/vietnamese/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-08-22 +description: Học cách tạo mã vạch DataMatrix bằng Python và mã hoá văn bản tiếng Nga + bằng Aspose.BarCode – hướng dẫn từng bước. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- generate DataMatrix barcode +- encode Russian text +language: vi +lastmod: 2026-08-22 +og_description: Tạo mã vạch DataMatrix trong Python và mã hoá văn bản tiếng Nga bằng + Aspose.BarCode. Thực hiện ví dụ đầy đủ và chạy ngay lập tức. +og_image_alt: Python script that generate DataMatrix barcode with encoded Russian + text +og_title: Tạo mã vạch DataMatrix trong Python – hướng dẫn đầy đủ Aspose.BarCode +schemas: +- author: Aspose + dateModified: '2026-08-22' + description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + headline: How to generate DataMatrix barcode in Python with Aspose.BarCode + type: TechArticle +- description: Learn to generate DataMatrix barcode in Python and encode Russian text + using Aspose.BarCode – step‑by‑step guide. + name: How to generate DataMatrix barcode in Python with Aspose.BarCode + steps: + - name: '**ABC123** – the plain identifier.' + text: '**ABC123** – the plain identifier.' + - name: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + text: '**Привет** – the Russian greeting, correctly decoded as UTF‑8.' + - name: Open the PNG file in an image viewer. + text: Open the PNG file in an image viewer. + - name: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + text: Use any DataMatrix scanning app (many mobile apps support it) or a hardware + scanner. + - name: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + text: The decoded string should display `ABC123Привет` (or the two parts separated + depending on the scanner UI). + type: HowTo +tags: +- Aspose.BarCode +- Python +- barcode generation +title: Cách tạo mã vạch DataMatrix trong Python với Aspose.BarCode +url: /vi/python/general/how-to-generate-datamatrix-barcode-in-python-with-aspose-bar/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cách tạo DataMatrix barcode trong Python với Aspose.BarCode + +Nếu bạn cần **tạo DataMatrix barcode** trong Python đồng thời **mã hoá văn bản tiếng Nga**, hướng dẫn này sẽ chỉ cho bạn các bước chính xác. Bạn sẽ thấy một ví dụ hoàn chỉnh, có thể chạy được, xây dựng một chuỗi mã mở rộng, cấu hình mã vạch và lưu hình ảnh trong một script duy nhất. + +Việc tạo mã vạch chứa các ký tự không phải ASCII thường đặt ra các câu hỏi về bộ ký tự và mã hoá dữ liệu. Bằng cách sử dụng `ExtCodetextBuilder` của Aspose.BarCode, bạn có thể an toàn nhúng văn bản UTF‑8 như các ký tự Cyrillic vào trong một ký hiệu DataMatrix. Kết quả sẽ hoạt động với bất kỳ máy quét nào hỗ trợ tiêu chuẩn DataMatrix. + +Trong tutorial này bạn sẽ: + +* Cài đặt gói Aspose.BarCode cần thiết. +* Xây dựng một chuỗi mã mở rộng kết hợp dữ liệu thuần và văn bản tiếng Nga. +* **Tạo DataMatrix barcode** với chuỗi mở rộng. +* Điều chỉnh các tham số mã vạch như kích thước module. +* Lưu mã vạch dưới dạng file PNG. + +Không cần dịch vụ bên ngoài; mọi thứ chạy cục bộ trên máy của bạn. + +## Yêu cầu trước + +Trước khi bắt đầu, hãy chắc chắn rằng bạn có: + +* Python 3.8 trở lên đã được cài đặt. +* Giấy phép Aspose.BarCode for Python đang hoạt động (bản dùng thử miễn phí cũng đủ cho phát triển). +* Kiến thức cơ bản về lập trình Python. + +Bạn có thể cài đặt thư viện Aspose.BarCode qua pip: + +```bash +pip install aspose-barcode +``` + +## Bước 1: Xây dựng chuỗi mã mở rộng + +Nhiệm vụ đầu tiên là tạo một chuỗi duy nhất chứa cả định danh sản phẩm thuần và cụm từ tiếng Nga. `ExtCodetextBuilder` cho phép bạn nối các phần mã khác nhau trong khi vẫn giữ thông tin mã hoá của chúng. + +```python +# Import required Aspose.BarCode classes +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +# Initialize the extended codetext builder +builder = ExtCodetextBuilder() + +# Add a plain ASCII identifier – this could be a SKU, part number, etc. +builder.add_plain_codetext("ABC123") + +# Add Russian text using ECI (Extended Channel Interpretation) encoding. +# The eci_encoding value 3 corresponds to UTF‑8. +builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + +# Retrieve the combined string that Aspose.BarCode will use. +extended_text = builder.get_extended_codetext() +print("Generated extended codetext:", extended_text) +``` + +**Tại sao bước này quan trọng** – Các ký hiệu DataMatrix lưu trữ byte thô. Khi bạn cần trộn các bảng chữ cái, bạn phải cho bộ mã hoá biết phần nào áp dụng cho mỗi đoạn. Phương thức `add_eci_codetext` chèn chỉ báo ECI trước văn bản tiếng Nga, đảm bảo máy quét diễn giải các byte dưới dạng UTF‑8. Nếu không có ECI, các ký tự Cyrillic sẽ xuất hiện dưới dạng dữ liệu rối. + +## Bước 2: Tạo trình tạo DataMatrix barcode + +Khi chuỗi mã mở rộng đã sẵn sàng, khởi tạo một `BarcodeGenerator` với kiểu `EncodeTypes.DATA_MATRIX`. + +```python +# Create a DataMatrix barcode generator using the extended codetext +generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) +``` + +**Tại sao lại chọn DataMatrix?** – DataMatrix là mã vạch hai chiều có thể lưu trữ tới 2.335 ký tự alphanumeric hoặc 1.556 byte. Nó lý tưởng cho các vật phẩm nhỏ, bộ phận công nghiệp và các trường hợp cần nhúng văn bản đa ngôn ngữ. + +## Bước 3: (Tùy chọn) Cấu hình các tham số mã vạch + +Aspose.BarCode cung cấp nhiều tham số. Đối với hầu hết các trường hợp, cài đặt mặc định đã tạo ra một ký hiệu dễ đọc. Tuy nhiên, bạn có thể muốn kiểm soát kích thước của mỗi module (ô vuông nhỏ nhất trong ma trận) để phù hợp với yêu cầu in ấn. + +```python +# Set the module (pixel) size to 2.5 points – adjust as needed for your printer DPI +generator.parameters.barcode.x_dimension = 2.5 +``` + +Các tham số hữu ích khác bao gồm mức độ sửa lỗi, lề và màu nền. Chỉ điều chỉnh chúng nếu môi trường quét mục tiêu yêu cầu các dung sai cụ thể. + +## Bước 4: Lưu ảnh mã vạch + +Cuối cùng, ghi mã vạch ra file. Phương thức `save` hỗ trợ PNG, JPEG, BMP và một số định dạng vector. + +```python +# Save the barcode image to the desired folder +output_path = "YOUR_DIRECTORY/extended_codetext.png" +generator.save(output_path) +print(f"Barcode saved as {output_path}") +``` + +Khi bạn mở `extended_codetext.png`, sẽ thấy một ký hiệu DataMatrix sắc nét. Quét nó bằng một trình đọc DataMatrix tiêu chuẩn sẽ trả về hai phần: + +1. **ABC123** – định danh thuần. +2. **Привет** – lời chào tiếng Nga, được giải mã đúng là UTF‑8. + +## Ví dụ đầy đủ, có thể chạy + +Dưới đây là script hoàn chỉnh bạn có thể sao chép‑dán vào một file tên `generate_datamatrix.py`. Thay `YOUR_DIRECTORY` bằng thư mục tồn tại trên hệ thống của bạn. + +```python +# generate_datamatrix.py +# ------------------------------------------------- +# Complete example: generate DataMatrix barcode and encode Russian text +# ------------------------------------------------- + +import aspose.barcode as barcode +from aspose.barcode.generation import ExtCodetextBuilder, BarcodeGenerator, EncodeTypes + +def main(): + # Step 1: Build extended codetext + builder = ExtCodetextBuilder() + builder.add_plain_codetext("ABC123") + builder.add_eci_codetext(eci_encoding=3, codetext="Привет") + extended_text = builder.get_extended_codetext() + print("Generated extended codetext:", extended_text) + + # Step 2: Create DataMatrix generator + generator = BarcodeGenerator(EncodeTypes.DATA_MATRIX, extended_text) + + # Step 3: Optional parameters (adjust module size if needed) + generator.parameters.barcode.x_dimension = 2.5 + + # Step 4: Save the image + output_path = "YOUR_DIRECTORY/extended_codetext.png" + generator.save(output_path) + print(f"Barcode saved as {output_path}") + +if __name__ == "__main__": + main() +``` + +Chạy script từ dòng lệnh: + +```bash +python generate_datamatrix.py +``` + +Bạn sẽ thấy đầu ra console tương tự như: + +``` +Generated extended codetext: (ECI:3)ПриветABC123 +Barcode saved as YOUR_DIRECTORY/extended_codetext.png +``` + +## Xác minh kết quả + +Để xác nhận rằng mã vạch đã mã hoá đúng cụm từ tiếng Nga: + +1. Mở file PNG trong trình xem ảnh. +2. Sử dụng bất kỳ ứng dụng quét DataMatrix nào (nhiều app di động hỗ trợ) hoặc máy quét phần cứng. +3. Chuỗi giải mã sẽ hiển thị `ABC123Привет` (hoặc hai phần tách riêng tùy giao diện máy quét). + +Nếu các ký tự tiếng Nga xuất hiện dưới dạng ký tự rối, hãy kiểm tra lại rằng máy quét hỗ trợ ECI UTF‑8. Hầu hết các trình đọc hiện đại đều hỗ trợ, nhưng các thiết bị cũ có thể cần cấu hình bổ sung. + +## Những lỗi thường gặp và cách tránh + +| Vấn đề | Nguyên nhân | Giải pháp | +|-------|-------------|----------| +| Ký tự Cyrillic bị rối | Thiếu chỉ báo ECI | Sử dụng `add_eci_codetext` với `eci_encoding=3`. | +| Mã vạch quá nhỏ cho máy in | Kích thước module mặc định quá mỏng cho DPI thấp | Tăng `x_dimension` (ví dụ: `3.0` hoặc `4.0`). | +| File không được lưu | Đường dẫn thư mục không hợp lệ | Đảm bảo `YOUR_DIRECTORY` tồn tại và có quyền ghi. | +| Máy quét không đọc được | Độ mật dữ liệu quá cao | Giảm lượng dữ liệu mã hoá hoặc tăng mức sửa lỗi (`generator.parameters.barcode.error_correction_level`). | + +## Mở rộng ví dụ + +Bạn có thể áp dụng mẫu này cho các ngôn ngữ hoặc loại dữ liệu khác: + +* **Mã hoá văn bản Nhật hoặc Ả Rập** – thay đổi `eci_encoding` thành giá trị phù hợp (ví dụ: 5 cho ISO‑8859‑5, 6 cho ISO‑8859‑7). +* **Thêm nhiều đoạn ECI** – gọi `add_eci_codetext` nhiều lần, mỗi lần với mã hoá riêng. +* **Tạo QR code thay vì** – thay `EncodeTypes.DATA_MATRIX` bằng `EncodeTypes.QR`. + +Tất cả các bước còn lại vẫn giống nhau vì `ExtCodetextBuilder` trừu tượng hoá việc xử lý byte ở mức thấp. + +## Kết luận + +Bây giờ bạn đã biết cách **tạo DataMatrix barcode** trong Python và **mã hoá văn bản tiếng Nga** bằng tính năng mã mở rộng của Aspose.BarCode. Script hoàn chỉnh xử lý việc đàm phán bộ ký tự, tạo mã vạch và xuất ảnh chỉ với vài dòng code. + +Tiếp theo, khám phá các symbology mã vạch khác (PDF417, Aztec) hoặc tích hợp trình tạo vào dịch vụ web trả về ảnh PNG theo yêu cầu. Các nguyên tắc tương tự—xây dựng chuỗi mã mở rộng và chọn `EncodeTypes` phù hợp—đều áp dụng trên toàn bộ bộ Aspose.BarCode. + +Chúc lập trình vui vẻ, và tận hưởng sức mạnh của việc tạo mã vạch đa ngôn ngữ! + +## Bạn nên học gì tiếp theo? + +Các tutorial sau đây đề cập đến các chủ đề liên quan chặt chẽ, xây dựng trên các kỹ thuật được trình bày trong hướng dẫn này. Mỗi tài nguyên bao gồm mã mẫu đầy đủ với các giải thích từng bước để giúp bạn nắm vững các tính năng API bổ sung và khám phá các cách triển khai thay thế trong dự án của mình. + +- [How to Generate DataMatrix Barcodes Using Aspose.BarCode for .NET – Step‑by‑Step Guide](/barcode/english/net/datamatrix-barcode-configuration/) +- [Generate a DataMatrix barcode in ASCII mode with Aspose.BarCode for .NET (C#)](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-encoding-mode-ascii/) +- [How to Generate DataMatrix Barcodes (ECC 200) with Aspose.BarCode for .NET](/barcode/english/net/datamatrix-barcode-configuration/datamatrix-ecc-200-configuration/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file