Mencipta kode QR yang dapat disesuaikan adalah cara yang kuat untuk memberikan link, ID, dan app-deep link saat tinggal di merek. Dengan Aspose.BarCode untuk .NET, Anda dapat memperbaiki kesalahan yang halus, ukuran modul, warna dan format output untuk memenuhi kebutuhan fungsional dan estetik. Artikel ini menyelaraskan petunjuk langkah demi langkah dengan gist di akhir dan menambahkan tips praktis, gotchas, serta peningkatan pilihan.

Persyaratan

  • Menggunakan .NET 8 (atau SDK)
  • Pengaturan Akses (Aspose.BarCode)
  • Kenalan dasar dengan System.Drawing
  • (Optional) Tujuan output resolusi tinggi untuk kasus penggunaan cetak

Buat proyek & tambahkan paket

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

Contoh lengkap

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!");
            }
        }
    }
}

Langkah demi langkah (Mapped to the Example)

Langkah 1: Memulai QR Generator

Membuat generator dengan EncodeTypes.QR dan beban default (URL, ID, dll)

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

Anda dapat mengatur konten melalui pembuat atau Parameters.Barcode.QR.CodeTextContohnya adalah keduanya untuk ketelusan.

Langkah 2: Mengkonfigurasi Properti QR Core

  • Teks kode: data yang sebenarnya dikodkan dalam QR.
  • Koreksi kesalahan: mengontrol resiliensi (misalnya, smudges, logo di atas kode).
    • Modul / ukuran sel**: ukuran setiap “modul” persegi.
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)

Nota: Untuk QR, pengaturan QR.ModuleSize Contohnya sudah cukup, contohnya juga sudah XDimension.Pixels untuk melihat cermin; jika Anda menyentuh hanya satu, lebih baik QR.ModuleSize untuk skala visual yang dapat diramalkan.

Langkah 3: Gunakan warna merek (Foreground/Background)

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

Untuk kebolehpercayaan pemindaian maksimum, pastikan kontras yang mencukupi.Jika Anda mengubah warna atau menempatkan latar belakang yang sibuk, tambahkan zona tenang yang murah hati (margin).

Langkah 4: Render & Save

Generasi A System.Drawing.Image dan menyimpan sebagai PNG (sharp, tanpa kerugian).

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

Opsi Peningkatan

a) Ekspor ke berbagai format

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)

2) Meningkatkan Print-Readiness

    • Meningkatkan nilai : naik QR.ModuleSize (misalnya, 6-10) untuk cetakan fisik.
  • Quiet zone: memastikan ruang putih yang cukup di sekitar kode; jika alat layout Anda terlalu dekat, tambahkan padding ke gambar.
  • High Error Correction*: Tetap High Jika Anda menempatkan logo kecil atau mencetak di permukaan tekstur.

c) Variasi Payload yang dimasukkan

    • Hubungan Aplikasi * : myapp://open?id=12345
  • • Konfigurasi Wi-Fi : WIFI:T:WPA;S:MySSID;P:MyPassword;H:false;
    • Kartu dengan VCard : BEGIN:VCARD\nVERSION:3.0\nN:…\nEND:VCARD

Troubleshooting

  • Scanner tidak akan membaca: Meningkatkan kontras (tembok depan gelap, latar belakang terang), tumbuh ModuleSize, dan memastikan zona yang bersih dan tenang.
  • Blurry pada ukuran kecil: Hindari JPEG untuk kode kecil; lebih baik PNG dan modul yang lebih besar.
  • Logo overlay: Tetap kecil dan berpusat; bergantung pada High Kesalahan yang diperbaiki untuk dikompensasi.

Praktik Terbaik

  • Validasi konten: Validasikan URL/ID sebelum dimasukkan untuk menghindari kode QR yang tidak menentu dalam cetak.
  • Kontrol Versi: Tetap seting generator dalam kode (atau konfig) dan komitmen mereka—bahan output yang dapat diproduksi dalam branding.
  • Paritas Lingkungan: Jika Anda memberikan pada CI, gunakan stok DPI/font yang sama untuk menghindari perbedaan raster halus.

Kesimpulan

Dengan Aspose.BarCode untuk .NET, Anda dapat membuat kode QR yang tidak hanya robust (melalui pembetulan kesalahan) tetapi juga *on-brand (telalui pengukuran dan kontrol warna). ModuleSize, pembetulan kesalahan, dan warna untuk menyesuaikan media pengiriman Anda – layar, label, atau papan.

More in this category