qrism 0.1.0

A Rust library for generating and reading QR codes with Reed-Solomon error correction. Supports traditional monochromatic QR codes with additional experimental multicolor QR support for enhanced storage capacity.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

use crate::utils::f64_to_i32;

use super::geometry::Point;

// Accumulator trait for flood fill
//------------------------------------------------------------------------------

pub trait Accumulator {
    fn accumulate(&mut self, row: Row);
}

impl<F> Accumulator for F
where
    F: FnMut(Row),
{
    fn accumulate(&mut self, row: Row) {
        self(row)
    }
}

// Region row
//------------------------------------------------------------------------------

#[derive(Debug, Clone, Copy, Eq, PartialEq)]
pub struct Row {
    pub left: u32,
    pub right: u32,
    pub y: u32,
}

// Centre locator for finder
// Uses the centroid formula:
// CX = Sum of X / Total points
// CY = Sum of Y / Total points
//------------------------------------------------------------------------------

pub struct AreaAndCentreLocator {
    sum_x: u64,
    sum_y: u64,
    pub area: u32,
}

impl AreaAndCentreLocator {
    pub fn new() -> Self {
        Self { sum_x: 0, sum_y: 0, area: 0 }
    }

    pub fn get_centre(&self) -> Point {
        let x = self.sum_x as f64 / (2 * self.area) as f64;
        let y = self.sum_y as f64 / self.area as f64;

        let x = x.round();
        let y = y.round();

        let x = f64_to_i32(&x).unwrap();
        let y = f64_to_i32(&y).unwrap();

        Point { x, y }
    }
}

impl Accumulator for AreaAndCentreLocator {
    fn accumulate(&mut self, row: Row) {
        let Row { left, right, y } = row;
        let width = right - left + 1;
        let mid = left + right; // Not divided by 2 to avoid FP arithmetic. This 2 is accounted for
                                // when calculating x and y in get_centre()

        self.sum_x += (mid * width) as u64;
        self.sum_y += (y * width) as u64;
        self.area += width;
    }
}