Tworzenie dostosowywanych kodów QR jest potężnym sposobem dostarczania linków, identyfikatorów i aplikacji-głębokie linki podczas pozostawania na markę. Aspose.BarCode dla .NET, można naprawić błędy, rozmiary modułów, kolory i formaty wyjścia, aby zaspokoić zarówno potrzeby funkcjonalne i estetyczne.

Warunki

  • Źródło: .NET 8 (lub .Net 6+) SDK
  • Użytkownik dostępny (Aspose.BarCode)
  • Podstawowe znajomości z System.Drawing
  • (opcjonalny) Wysokiej rozdzielczości cel wyjścia dla przypadków użycia druku

Tworzenie projektu i dodanie pakietu

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

Pełny przykład

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

Krok po kroku (z mapą do przykładu)

Krok 1: Inicjalizuj generator QR

Tworzenie generatora z EncodeTypes.QR i domyślny ładunek płatniczy (URL, ID itp.).

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

Możesz ustawić treść za pośrednictwem konstruktora lub Parameters.Barcode.QR.CodeTextPrzykładem jest jednoznaczność obojga.

Krok 2: Konfiguruj podstawowe właściwości QR

  • Teks kodowy: faktyczne dane kodowane w QR.
  • ** Korekcja błędu**: kontroluje odporność (np. śmieci, logotypy nad kodem).
  • ** Moduł/rozmiar komórki**: rozmiar każdego kwadratowego „moduła”.
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)

** Uwaga: ** Dla QR, ustawienia QR.ModuleSize Zazwyczaj jest to wystarczające. przykład zawiera również XDimension.Pixels aby odzwierciedlić gąbkę; jeśli tylko jeden tonisz, preferuj QR.ModuleSize dla przewidywalnego skalowania wizualnego.

Krok 3: Stosuj kolory marki (foreground/background)

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

Aby uzyskać maksymalną wiarygodność skanowania, zapewnij odpowiedni kontrast. Jeśli odwracasz kolory lub umieścisz na zajętych tłoch, dodaj wielką cichą strefę (margin).

Krok 4: Render & Save

generuje A System.Drawing.Image i zaoszczędzić jako PNG (czarny, bez strat).

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

Opcjonalne ulepszenia

a) eksportowanie do wielu formatów

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)

b) zwiększenie czytelności drukowanej

    • Wzrost – wzrost QR.ModuleSize (np. 6–10) dla fizycznych odcisków.
  • Zona kwetu: zapewnia wystarczającą ilość białego miejsca wokół kodu; jeśli narzędzie rozmieszczania jest zbyt blisko, dodaj podkład do obrazu.
  • Wysoka poprawka błędu: trzymaj się High w przypadku umieszczania małych logo lub drukowania na teksturowanych powierzchniach.

c) wbudowane warianty płatności

    • Linki do aplikacji *: myapp://open?id=12345
  • • Wi-Fi konfiguracja * WIFI:T:WPA;S:MySSID;P:MyPassword;H:false;
    • wskaźnik karty *: BEGIN:VCARD\nVERSION:3.0\nN:…\nEND:VCARD

Troubleshooting

  • Skaner nie czyta: Zwiększ kontrast (ciemne przedmieści, jasne tło), powiększyć ModuleSizeZapewnij czystą i spokojną strefę.
  • Blurry w małych rozmiarach: Unikaj JPEG dla drobnych kodów; preferuj PNG i większe moduły.
  • Logo overlay: Trzymaj go mały i skoncentrowany; polega na High Naprawa błędu do kompensacji.

Najlepsze praktyki

  • Validacja zawartości: Validuj adresy URL/ID przed wprowadzeniem, aby uniknąć stałych kodów QR w drukowaniu.
  • Kontrola wersji: Utrzymuj ustawienia generatora w kodzie (lub konfiguruj) i zaangażuj je – materia do odtwarzania wyników w brandingu.
  • Parytet środowiskowy: Jeśli zarejestrujesz na CI, użyj tego samego stawu DPI/fontu, aby uniknąć subtelnych różnic rasterowych.

konkluzja

Za pomocą Aspose.BarCode dla .NET można utworzyć kody QR, które są nie tylko robust (przez poprawę błędu), ale także *na znaku towarowego (po rozmiarze i kontrolie koloru). ModuleSize, poprawa błędu i kolory do dostosowania do środka dostawy – ekran, etykieta lub tablicy.

More in this category