Створення персоналізованих QR-кодів є потужним способом надання посилань, ідентифікаторів та глибоких додатків під час перебування на бренді. з Aspose.BarCode для .NET, ви можете виправити помилки, розмір модулів, кольори та формати виходу, щоб задовольнити як функціональні, так і естетичні потреби.
Передумови
- Створення .NET 8 (або .Net 6+)
- Доступний доступ (
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!");
}
}
}
}
Крок за кроком (на карті до прикладу)
Крок 1: Ініціалізація генератора QR
Створення генератора з EncodeTypes.QR
і стандартний платіжний заряд (URL, ID і т.д.).
var qrGenerator = new BarcodeGenerator(EncodeTypes.QR, "https://www.aspose.com");
Ви можете встановити контент або через конструктора або Parameters.Barcode.QR.CodeText
Приклад дає обидві сторони чіткості.
Крок 2: Налаштування Core QR Properties
- Кодний текст: фактичні дані, зашифровані в 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
для передбачуваного візуального масштабування.
Крок 3: Використовуйте кольори бренду (Першочерговий / Задні)
qrGenerator.Parameters.Barcode.ForegroundColor = Color.Black;
qrGenerator.Parameters.Barcode.BackgroundColor = Color.White;
Для максимальної надійності сканування, забезпечити адекватний контраст. Якщо ви обертаєте кольори або розміщуєте на зайнятих фонах, додайте щедру зону спокою (маргіна).
Четвертий етап: відправлення та збереження
Створення A System.Drawing.Image
Зберегти як PNG (шарп, без втрат).
using (var image = qrGenerator.GenerateBarCodeImage())
{
image.Save("CustomQRCode.png");
}
Опціональні поліпшення
а) експорт у декілька форматів
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)
б) збільшення типового читання
- • Підвищення рівня: підняття
QR.ModuleSize
(наприклад, 6-10) для фізичних друку. - Quiet zone: забезпечити достатній білий простір навколо коду; якщо інструмент розташування занадто близький, додайте падіння до зображення.
- Висока корекція помилок: зберігати
High
Якщо розміщувати дрібні логотипи або друкувати на текстурованих поверхнях.
В) Вбудовані варіанти оплати
- Посилання на додаток *:
myapp://open?id=12345
- Посилання на додаток *:
- • Конфігурація Wi-Fi:
WIFI:T:WPA;S:MySSID;P:MyPassword;H:false;
- Завантажити VCard:
BEGIN:VCARD\nVERSION:3.0\nN:…\nEND:VCARD
- Завантажити VCard:
Troubleshooting
- ** Скенер не читає**: збільшується контраст (темний фронт, світлий фон), зростає
ModuleSize
Забезпечити чисту та спокійну зону. - Blurry в невеликих розмірах: Уникайте JPEG для дрібних кодів; віддайте перевагу PNG і більшим модулям.
- Logo overlay: Зберігайте його маленьким і централізованим; покладайтеся на
High
Виправлення помилок для компенсації.
Найкращі практики
- Валідація контенту: валідуйте URL-адреси / ідентифікатори, перш ніж вставляти, щоб уникнути твердих QR-кодів у друку.
- Контроль версії: Зберігайте налаштування генератора в коді (або конфігуруйте) і прив’язуйте їх — репродуктивні вихідні речовини в бренді.
- Парітність навколишнього середовища: Якщо ви віддаєте на CI, використовуйте той самий DPI/font stack, щоб уникнути тонких розбіжностей.
Заключення
За допомогою Aspose.BarCode для .NET ви можете створювати QR-коди, які є не тільки robust (через виправлення помилок), але і *on-brand (чрез розмір і контроль кольорів). ModuleSize
, виправлення помилок, і кольори, щоб підходити до вашого середовища доставки — екран, етикетка, або таблиця.