ایجاد کدهای QR سفارشی یک روش قدرتمند برای ارائه لینک‌ها، شناسه‌ها و لینک‌های عمیق در برنامه‌ها است، در حالی که همزمان تصویر برند را حفظ می‌کند. С Aspose.BarCode for .NET, می‌توانید تصحیح خطاها، اندازه‌های واحدها، رنگ‌ها و فرمت‌های خروجی را به‌صورت دقیق تنظیم کنید، به‌طوری که هم نیازهای عملکردی و هم نیازهای زیبایی‌شناختی را پوشش دهند. این مقاله ترکیبی از دستورالعمل‌های گام به گام با the لطفاً متن را به زبان انگلیسی ارائه دهید. در نهایت، نکات عملی، خلاقیت و سایر بهبودها را اضافه کنید.

نمای کلی الزامات

  • .NET 8 (یا .NET 6+) SDK
  • دسترسی به NuGet (Aspose.BarCode)
  • معرفی پایه‌ای به System.Drawing
  • (اختیاری) هدف خروجی با وضوح بالا برای چاپ

یک پروژه ایجاد کنید & یک بسته اضافه کنید

dotnet new console -n CustomizableQRCodeExample -f net8.0
cd CustomizableQRCodeExample
dotnet add package Aspose.BarCode

مثال کامل

using System;
using System.Drawing;
using Aspose.BarCode.Generation;

namespace CustomizableQRCodeExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Step 1: Create a QR code generator with specific settings
            var qrGenerator = new BarcodeGenerator(EncodeTypes.QR, "https://www.aspose.com");

            // Step 2: Configure QR code properties
            qrGenerator.Parameters.Barcode.QR.CodeText = "https://www.aspose.com";
            qrGenerator.Parameters.Barcode.QR.ErrorLevel = QRErrorLevelLevel.High;
            qrGenerator.Parameters.Barcode.QR.ModuleSize = 5;
            qrGenerator.Parameters.Barcode.XDimension.Pixels = 2;

            // Step 3: Customize colors
            qrGenerator.Parameters.Barcode.ForegroundColor = Color.Black;
            qrGenerator.Parameters.Barcode.BackgroundColor = Color.White;

            // Step 4: Generate and save the QR code as an image
            using (var image = qrGenerator.GenerateBarCodeImage())
            {
                image.Save("CustomQRCode.png");
                Console.WriteLine("QR Code generated successfully!");
            }
        }
    }
}

گام به گام (مثال Matcher)

مرحله 1: مقداردهی اولیهٔ تولیدکننده QR

یک ژنراتور ایجاد کنید با EncodeTypes.QR و بارگذاری غیرمستقیم مفید (URL، ID و دیگران).

var qrGenerator = new BarcodeGenerator(EncodeTypes.QR, "https://www.aspose.com");

می‌توانید محتوا را یا با استفاده از سازنده، یا. Parameters.Barcode.QR.CodeText. مثال هر دو را برای وضوح بیشتر تعیین می‌کند.

مرحله ۲: پیکربندی ویژگی‌های Core QR

  • متن کد: داده‌های واقعی کدگذاری‌شده در QR.
  • تصحیح خطا: مقاومت را بررسی کنید (مثلاً، دی‌اسمبل، ثبت‌ها در کد).
  • اندازه واحد/سلول: اندازه هر مربع «واحد».
qrGenerator.Parameters.Barcode.QR.CodeText = "https://www.aspose.com";
qrGenerator.Parameters.Barcode.QR.ErrorLevel = QRErrorLevelLevel.High; // robust against damage
qrGenerator.Parameters.Barcode.QR.ModuleSize = 5;                       // pixels per module (visual density)
qrGenerator.Parameters.Barcode.XDimension.Pixels = 2;                   // base module thickness (kept to match gist)

یادداشت: پیکربندی QR QR.ModuleSize معمولاً کافی است. مثال نیز نشان می‌دهد. XDimension.Pixels برای جلوگیری از ماده؛ اگر فقط یک را تنظیم کنید، ترجیح می‌دهد QR.ModuleSize برای مقیاس‌بندی بصری پیش‌بینی‌پذیر.

مرحله ۳: استفاده از رنگ‌های شرکت (پس‌زمینه/پیش‌زمینه)

qrGenerator.Parameters.Barcode.ForegroundColor = Color.Black;
qrGenerator.Parameters.Barcode.BackgroundColor = Color.White;

برای حداکثر اطمینان از اسکن، باید اطمینان حاصل کنید که تضاد کافی وجود دارد. اگر رنگ‌ها را معکوس کنید یا آن‌ها را بر روی پس‌زمینه‌ای مزاحم قرار دهید، یک ناحیه آرام و گسترده (فیلد) اضافه کنید.

مرحله ۴: رندرینگ و ذخیره‌سازی

لطفاً متن انگلیسی را که می‌خواهید به فارسی ترجمه شود، برایم بفرستید.?;?. System.Drawing.Image و به‌صورت PNG ذخیره کنید (واضح، بدون تب‌ها).

using Aspose.BarCode;
using System.Drawing;
using Aspose.BarCode.Generation;

var qrGenerator = new BarcodeGenerator(EncodeTypes.QR);
using (var image = qrGenerator.GenerateBarCodeImage())
{
    image.Save("CustomQRCode.png");
}

بهبود اختیاری

A) خروجی به فرمت‌های مختلف

using System.Drawing.Imaging;

// After GenerateBarCodeImage():
image.Save("CustomQRCode.jpg", ImageFormat.Jpeg);  // for photos/CMYK workflows
image.Save("CustomQRCode.bmp", ImageFormat.Bmp);   // uncompressed (big files)

ب) افزایش آمادگی برای چاپ

  • Augmenta: ارتفاع QR.ModuleSize (مثلاً ۶–۱۰) برای چاپ‌های فیزیکی.
  • منطقهٔ ساکت: اطمینان حاصل کنید که فضای سفید کافی در اطراف کد وجود داشته باشد؛ اگر ابزار قالب‌بندی شما آن را بیش از حد نزدیک برش می‌دهد، به تصویر حاشیه اضافه کنید.
  • تصحیح خطاهای بالا: شهر High اگر لوگوهای کوچک یا چاپ‌ها را بر روی سطوح ساختاری قرار دهید.

C) یکپارچه‌سازی تغییرات بار

  • لینک‌ها به پیوست: myapp://open?id=12345
  • پیکربندی Wi‑Fi: WIFI:T:WPA;S:MySSID;P:MyPassword;H:false;
  • vCard: BEGIN:VCARD\nVERSION:3.0\nN:…\nEND:VCARD

حل مشکلات

  • اسکنر نمی‌خواند: کنتراست را افزایش دهید (پس‌زمینه تاریک، پس‌زمینه روشن)، گسترش دهید ModuleSize, و از یک منطقه تمیز و آرام مراقبت کنید.
  • نامشخص و اندازه‌های کوچک:از JPEG برای کدهای کوچک پرهیز کنید· PNG و واحدهای بزرگتر را ترجیح دهید.
  • لوگوی همپوشانی: نگه داشتن آن کوچک و مرکز؟ صبر کنید High تصحیح خطا برای جبران.

بهترین روش

  • اعتبارسنجی محتوا: قبل از جاسازی، URL/ID اصلی را بررسی کنید تا از کدهای QR قدیمی در چاپ جلوگیری شود.
  • کنترل نسخه:پیکربندی ژنراتور را در کد (یا در تنظیمات) ذخیره کنید و یک commit انجام دهید — خروجی قابل تکرار برای برندینگ مهم است.
  • سازگاری محیطی: اگر در CI رندر می‌کنید، از همان DPI-/fontstak استفاده کنید تا از تفاوت‌های کوچک رستر جلوگیری شود.

نتیجه‌گیری

با Aspose.BarCode برای .NET می‌توانید کدهای QR ایجاد کنید، که فقط نیستند. سلام (با دانستن چگونگی رفع خطاها) اما همچنین بر اساس برچسب (با استفاده از کنترل اندازه و رنگ). از مثال کامل قبلی شروع کنید و آن را ویرایش کنید. ModuleSize,، اصلاح خطاها و رنگ‌ها، تا با رسانه‌اش—صفحه نمایش، برچسب یا تابلو—سازگار شود.

More in this category