What it does

Validate and score QR codes that standard scanners can't read:

• Artistic QR codes — AI-generated, stylized, custom designs
• Image QR codes — QR embedded in photos, illustrations
• Custom QR codes — Logos, colors, gradients, rounded corners
• Degraded QR codes — Blurred, low contrast, small size

Installation

[dependencies]
qraisc-core = "0.1"

Quick Start

use qraisc_core::{validate, is_valid, score};

fn main() {
    // Simple validation - just check if QR is readable
    if let Some(content) = is_valid("qr.png") {
        println!("QR contains: {}", content);
    }

    // Get scannability score (0-100)
    let s = score("qr.png");
    println!("Scannability: {}/100", s);

    // Full validation with stress tests
    let bytes = std::fs::read("qr.png").unwrap();
    let result = validate(&bytes).unwrap();

    println!("Score: {}", result.score);
    println!("Content: {:?}", result.content);
}

API Reference

Main Functions

Convenience Helpers

Types

pub struct ValidationResult {
    pub score: u8,                    // 0-100
    pub decodable: bool,
    pub content: Option<String>,
    pub metadata: Option<QrMetadata>,
    pub stress_results: StressResults,
}

pub struct QrMetadata {
    pub version: u8,                  // 1-40
    pub error_correction: ErrorCorrectionLevel,
    pub modules: u8,                  // 21-177
    pub decoders_success: Vec<String>,
}

pub struct StressResults {
    pub original: bool,
    pub downscale_50: bool,
    pub downscale_25: bool,
    pub blur_light: bool,
    pub blur_medium: bool,
    pub low_contrast: bool,
}

Score Interpretation

Performance

License

MIT

Part of QR Code AI by Thibaut MÉLEN & SuperNovae Studio