Oscore.QrCodes.Maui 1.0.6

Prefix Reserved
dotnet add package Oscore.QrCodes.Maui --version 1.0.6                
NuGet\Install-Package Oscore.QrCodes.Maui -Version 1.0.6                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Oscore.QrCodes.Maui" Version="1.0.6" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Oscore.QrCodes.Maui --version 1.0.6                
#r "nuget: Oscore.QrCodes.Maui, 1.0.6"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Oscore.QrCodes.Maui as a Cake Addin
#addin nuget:?package=Oscore.QrCodes.Maui&version=1.0.6

// Install Oscore.QrCodes.Maui as a Cake Tool
#tool nuget:?package=Oscore.QrCodes.Maui&version=1.0.6                

QrCodes

Nuget package CI/CD License: MIT

Modern and efficient cross-platform QR code generation, rendering and serialization.
qr

🔥 Features 🔥

  • Use SkiaSharp/ImageSharp instead of System.Drawing to be cross-platform.
  • Support latest dotnet versions.
  • Supports trimming/NativeAOT.
  • Generate QR code with logo image.
  • Allows many different styles.
  • Supports many predefined payloads:
    • BezahlCode
    • Bitcoin like address
    • Bookmark
    • CalendarEvent
    • ContactData
    • Geolocation
    • Girocode
    • Mail
    • MMS
    • MoneroTransaction
    • OneTimePassword
    • PhoneNumber
    • ShadowSocksConfig
    • SkypeCall
    • SloveniaUpnQR
    • SMS
    • SwissQRCode
    • Url
    • WhatsAppMessage
    • Telegram
    • Wi-Fi
  • Supports next renderers
    • Ascii
    • Base64
    • SVG
    • PostScript
    • PDF
    • FastPngRenderer - fast but not support all features
    • Bitmap(.bmp) - fast but not support all features
    • ImageSharp - powerful, allows many features and export formats
    • SkiaSharp - powerful, allows many features and export formats
    • System.Drawing - legacy, only windows, not support all features
  • Supports helpers for MAUI
    • QrCodeSource - ImageSource to produce QR code
    • QrCodeExtension markup extension - Simplifies usage of QrCodeSource

Usage

// Base library with all payloads and some renderers(Ascii, Base64, Pdf, FastBitmap, FastPng, SVG, PostScript)
dotnet add package Oscore.QrCodes

// SkiaSharpRenderer(Gif, Jpeg, Png, WebP, Bmp, Ico, Wbmp, Pkm, Ktx, Astc, Dng, Heif, Avif)
dotnet add package Oscore.QrCodes.SkiaSharp
// ImageSharpRenderer(Gif, Jpeg, Png, WebP, Bmp, Pbm, Tga, Tiff)
dotnet add package Oscore.QrCodes.ImageSharp
// SystemDrawingRenderer(Gif, Jpeg, Png, Bmp, Tiff)
dotnet add package Oscore.QrCodes.System.Drawing

// MAUI helpers(QrCodeSource and QrCodeExtension markup extension). Uses SkiaSharpRenderer.
dotnet add package Oscore.QrCodes.Maui
Generate QR code
var qrCode = QrCodeGenerator.Generate(
    plainText: new Mail(email: "hello@oscore.io").ToString(),
    eccLevel: ErrorCorrectionLevel.High);
using var pngBytes = SkiaSharpRenderer.RenderToBytes(
    data,
    settings: new RendererSettings
    {
        DarkColor = Color.Red,
    });
Generate ImageSource for MAUI

You can test all variants using QrCodes.SampleApp MAUI app

xmlns:qr="clr-namespace:QrCodes.Maui;assembly=QrCodes.Maui"
<Image Source="{qr:QrCode 'https://oscore.io/'}" />

Benchmarks

You can view the reports for each version here


BenchmarkDotNet v0.13.12, macOS Sonoma 14.2.1 (23C71) [Darwin 23.2.0]
Apple M1 Pro, 1 CPU, 10 logical and 10 physical cores
.NET SDK 8.0.100
  [Host]     : .NET 8.0.0 (8.0.23.53103), Arm64 RyuJIT AdvSIMD
  DefaultJob : .NET 8.0.0 (8.0.23.53103), Arm64 RyuJIT AdvSIMD

Categories=Renderers  

Method Mean Ratio Gen0 Gen1 Gen2 Allocated Alloc Ratio
SkiaSharpRenderer_Png 1,065.14 μs 1.00 - - - 1.52 KB 1.00
SkiaSharpRenderer_Jpeg 331.18 μs 0.31 1.9531 - - 13.23 KB 8.72
SkiaSharpRenderer_Bmp NA ? NA NA NA NA ?
ImageSharpRenderer_Png 417.70 μs 0.40 1.9531 0.4883 - 48.1 KB 31.71
ImageSharpRenderer_Jpeg 297.34 μs 0.28 9.7656 1.4648 0.4883 57.02 KB 37.60
ImageSharpRenderer_Bmp 67.90 μs 0.06 79.2236 44.5557 43.3350 363.08 KB 239.40
FastPngRenderer_ 43.58 μs 0.04 0.8545 - - 5.39 KB 3.56
BitmapRenderer_ 519.42 μs 0.49 219.7266 219.7266 36.1328 368.75 KB 243.15
SvgRenderer_ 41.03 μs 0.04 8.9111 - - 54.95 KB 36.23

Benchmarks with issues: Benchmarks.SkiaSharpRenderer_Bmp: DefaultJob

It was forked from the QRCoder-ImageSharp project.
QRCoder is a project by Raffael Herrmann and was first released in 10/2013.
QRCoder-ImageSharp is a project by Joerg Plenert.
It's licensed under the MIT license.

Disclaimer

Although the library includes many things, we only use and support QrCodes/SkiaSharp/Maui functionality.
But we will be happy to accept your PR regarding ImageSharp/SystemDrawing/WPF/other renderers.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-android34.0 is compatible.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-ios17.5 is compatible.  net8.0-maccatalyst was computed.  net8.0-maccatalyst17.5 is compatible.  net8.0-macos was computed.  net8.0-tizen8.0 is compatible.  net8.0-tvos was computed.  net8.0-windows was computed.  net8.0-windows10.0.19041 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.6 126 9/1/2024
1.0.5 92 9/1/2024
1.0.4 602 3/18/2024
1.0.3 122 1/31/2024
1.0.2 807 1/29/2024
1.0.0 147 1/25/2024
0.9.3 138 1/25/2024
0.9.2 151 1/18/2024
0.9.1 111 1/17/2024
0.9.0 101 1/17/2024
0.0.0-dev 83 9/1/2024