@hexpro/qr-code-studio 0.0.0-stage → 0.1.0

package/dist/decode/finder.js

@@ -0,0 +1,441 @@
+/**
+ * Locating finder patterns.
+ *
+ * A finder pattern is a 7 by 7 bullseye, and every line through its centre
+ * crosses dark, light, dark, light, dark in a 1:1:3:1:1 ratio. That ratio is
+ * scale and rotation invariant, which is why the format chose it, and it is
+ * the whole basis of finding a code in a photograph. QR has three, Micro QR
+ * and rMQR one each.
+ *
+ * Lifted from the authenticator package's reader
+ * (google-auth-secret-retriever, `src/qr/decode/finder.ts`), with the ratio
+ * tolerance made a parameter: half a module for the scanner, as there, and
+ * 0.35 of a module along the rows and columns for the strict profile, which
+ * must refuse a pattern before a phone does.
+ */
+import { hypot } from '../core/math.js';
+/** Half a module of slack per run: tighter loses real patterns on a soft photograph, looser starts matching text. */
+export const LENIENT_FINDER_TOLERANCE = Object.freeze({
+    runs: 0.5,
+    diagonals: 0.5,
+});
+/**
+ * The strict profile's slack: a third tighter than the scanner's, and than
+ * zxing's half module, along the rows and columns.
+ *
+ * Half a module on the diagonals, as the scanner has it and still tighter
+ * than zxing's three quarters (jsQR does not check them at all). A diagonal
+ * is walked a pixel step at a time, each step root two pixels long, from a
+ * centre known only to the nearest pixel, so its runs carry a quantisation
+ * error the axes do not: at 6 pixels a module one step is a quarter of a
+ * module. Held to 0.35 there, the check refused the round, octagonal and
+ * squircle finders the design layer draws, on some sub-pixel phases and not
+ * others, with every reader that matters reading them; measured over the
+ * styled corpus, 0.5 refuses none of them and the conservativeness property
+ * holds. 0.6 also finds octagonal finders at 4 pixels a module, but as the
+ * first look it let a patch of data through as a fourth finder on a version
+ * 30 symbol tilted 20 degrees, and the strict reader, which commits to one
+ * triple, chose the triple with it in: so 0.6 is the second look's alone
+ * (`STRICT_WIDE_FINDER_TOLERANCE`).
+ */
+export const STRICT_FINDER_TOLERANCE = Object.freeze({
+    runs: 0.35,
+    diagonals: 0.5,
+});
+/**
+ * The strict profile's second look, taken only when the first finds fewer
+ * than three finders: 0.6 of a module on the diagonals, still short of the
+ * three quarters and half a pixel zxing-cpp allows on each run. It finds the
+ * octagonal finders at 4 pixels a module and the rounded ring round a round
+ * centre with its ink starved by a twentieth of a module that the first look
+ * misses and zxing-cpp and jsQR read every time; taken only then, it cannot
+ * add a decoy finder to a picture the first look already found three in.
+ */
+export const STRICT_WIDE_FINDER_TOLERANCE = Object.freeze({
+    runs: 0.35,
+    diagonals: 0.6,
+});
+function isDark(image, x, y) {
+    return image.bits[y * image.width + x] === 1;
+}
+/** Do five run lengths sit close enough to 1:1:3:1:1, within `tolerance` modules per run? */
+function matchesRatio(runs, tolerance) {
+    const r0 = runs[0];
+    const r1 = runs[1];
+    const r2 = runs[2];
+    const r3 = runs[3];
+    const r4 = runs[4];
+    const total = r0 + r1 + r2 + r3 + r4;
+    if (total < 7)
+        return false;
+    const module = total / 7;
+    const slack = module * tolerance;
+    return (Math.abs(module - r0) < slack &&
+        Math.abs(module - r1) < slack &&
+        Math.abs(3 * module - r2) < 3 * slack &&
+        Math.abs(module - r3) < slack &&
+        Math.abs(module - r4) < slack);
+}
+/** Centre of the middle run, in the scan direction, for runs that ended just before `end`. */
+function centreOfRuns(end, runs) {
+    return end - runs[4] - runs[3] - runs[2] / 2;
+}
+/**
+ * Candidate finder centres, strongest first.
+ *
+ * Scans rows for the ratio, cross-checks each hit vertically and along both
+ * diagonals, then clusters agreeing hits. `count` is how many rows agreed,
+ * which is a decent proxy for confidence, and a centre seen on one row only
+ * is dropped.
+ */
+export function findFinderPatterns(image, tolerance, limit = 32) {
+    const candidates = [];
+    // A finder is at least seven modules tall, so skipping rows on a large
+    // picture still crosses it several times.
+    const step = Math.max(1, Math.floor(image.height / 512));
+    const runs = [0, 0, 0, 0, 0];
+    for (let y = 0; y < image.height; y += step) {
+        // The five runs are dark, light, dark, light, dark, so even indices are
+        // dark. `state` is the run being counted, and its parity says whether a
+        // colour change opens a new run. Written as a state machine because the
+        // phase matters: run 0 has to be dark, and a loop that starts counting at
+        // the first pixel puts the leading light margin there and never matches.
+        runs.fill(0);
+        let state = 0;
+        const consider = (end) => {
+            if (!matchesRatio(runs, tolerance.runs))
+                return false;
+            const cx = centreOfRuns(end, runs);
+            const moduleSize = runs.reduce((sum, run) => sum + run, 0) / 7;
+            const cy = verticalCentre(image, Math.floor(cx), y, Math.round(moduleSize * 7), tolerance.runs);
+            if (cy === null || !diagonalCheck(image, cx, cy, tolerance.diagonals)) {
+                return false;
+            }
+            addCandidate(candidates, cx, cy, moduleSize);
+            return true;
+        };
+        for (let x = 0; x < image.width; x += 1) {
+            if (isDark(image, x, y)) {
+                // Dark after light opens the next run.
+                if (state % 2 === 1)
+                    state += 1;
+                runs[state] = runs[state] + 1;
+                continue;
+            }
+            if (state % 2 === 1) {
+                runs[state] = runs[state] + 1;
+                continue;
+            }
+            if (state !== 4) {
+                // Light after the first dark of the row, or after a dark run in the middle.
+                if (state === 0 && runs[0] === 0)
+                    continue;
+                state += 1;
+                runs[state] = runs[state] + 1;
+                continue;
+            }
+            // A complete dark, light, dark, light, dark sequence has just ended.
+            if (consider(x)) {
+                runs.fill(0);
+                state = 0;
+            }
+            else {
+                // Slide along by two runs, so two finders sharing a row do not hide each
+                // other and a near miss can still become a hit one run later.
+                runs[0] = runs[2];
+                runs[1] = runs[3];
+                runs[2] = runs[4];
+                runs[3] = 1;
+                runs[4] = 0;
+                state = 3;
+            }
+        }
+        if (state === 4)
+            consider(image.width);
+    }
+    return candidates
+        .filter((candidate) => candidate.count >= 2)
+        .sort((a, b) => b.count - a.count)
+        .slice(0, limit)
+        .map(({ x, y, moduleSize, count }) => ({ x, y, moduleSize, count }));
+}
+/**
+ * Refine the vertical centre of a candidate by walking its runs up and down.
+ * `cx` is the column through the middle of the row's centre run, so it is on
+ * the picture and dark at `cy`.
+ */
+function verticalCentre(image, cx, cy, maxCount, tolerance) {
+    const runs = [0, 0, 0, 0, 0];
+    let y = cy;
+    while (y >= 0 && isDark(image, cx, y)) {
+        runs[2] = runs[2] + 1;
+        y -= 1;
+    }
+    while (y >= 0 && !isDark(image, cx, y) && runs[1] < maxCount) {
+        runs[1] = runs[1] + 1;
+        y -= 1;
+    }
+    while (y >= 0 && isDark(image, cx, y) && runs[0] < maxCount) {
+        runs[0] = runs[0] + 1;
+        y -= 1;
+    }
+    y = cy + 1;
+    while (y < image.height && isDark(image, cx, y)) {
+        runs[2] = runs[2] + 1;
+        y += 1;
+    }
+    while (y < image.height && !isDark(image, cx, y) && runs[3] < maxCount) {
+        runs[3] = runs[3] + 1;
+        y += 1;
+    }
+    while (y < image.height && isDark(image, cx, y) && runs[4] < maxCount) {
+        runs[4] = runs[4] + 1;
+        y += 1;
+    }
+    return matchesRatio(runs, tolerance) ? centreOfRuns(y, runs) : null;
+}
+/**
+ * The five runs through (cx, cy) along (dx, dy): the dark core walked both
+ * ways, then light, then dark on each side.
+ */
+function runsThrough(image, cx, cy, dx, dy) {
+    const runs = [0, 0, 0, 0, 0];
+    const inside = (x, y) => x >= 0 && y >= 0 && x < image.width && y < image.height;
+    for (const sign of [-1, 1]) {
+        let x = sign < 0 ? cx : cx + dx;
+        let y = sign < 0 ? cy : cy + dy;
+        for (const [index, dark] of sign < 0
+            ? [
+                [2, true],
+                [1, false],
+                [0, true],
+            ]
+            : [
+                [2, true],
+                [3, false],
+                [4, true],
+            ]) {
+            while (inside(x, y) && isDark(image, x, y) === dark) {
+                runs[index] = runs[index] + 1;
+                x += sign * dx;
+                y += sign * dy;
+            }
+        }
+    }
+    return runs;
+}
+/**
+ * A real bullseye shows the ratio along both diagonals too, which text and
+ * noise rarely do.
+ *
+ * Walked from each of the four pixels nearest the centre, and passed when
+ * both diagonals hold from any one of them. The centre is known to a fraction
+ * of a pixel and a diagonal is walked from a whole one, and through a round
+ * or octagonal pattern the runs a pixel off the centre are not the runs
+ * through it: from one pixel a light ring reads two steps where from the next
+ * it reads three, which at 6 pixels a module is a whole quarter of a module.
+ */
+function diagonalCheck(image, cx, cy, tolerance) {
+    const left = Math.floor(cx - 0.5);
+    const top = Math.floor(cy - 0.5);
+    for (let y = top; y <= top + 1; y += 1) {
+        for (let x = left; x <= left + 1; x += 1) {
+            if (x < 0 || y < 0 || x >= image.width || y >= image.height || !isDark(image, x, y))
+                continue;
+            if (matchesRatio(runsThrough(image, x, y, 1, 1), tolerance) &&
+                matchesRatio(runsThrough(image, x, y, 1, -1), tolerance)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function addCandidate(candidates, x, y, moduleSize) {
+    for (const candidate of candidates) {
+        if (hypot(candidate.x - x, candidate.y - y) < candidate.moduleSize * 2 &&
+            Math.abs(candidate.moduleSize - moduleSize) < moduleSize * 0.5) {
+            // A running mean, so repeated sightings pull the centre to sub-pixel
+            // accuracy rather than the first one winning.
+            const total = candidate.count + 1;
+            candidate.x = (candidate.x * candidate.count + x) / total;
+            candidate.y = (candidate.y * candidate.count + y) / total;
+            candidate.moduleSize = (candidate.moduleSize * candidate.count + moduleSize) / total;
+            candidate.count = total;
+            return;
+        }
+    }
+    candidates.push({ x, y, moduleSize, count: 1 });
+}
+/** The walk's step, in pixels. */
+const RUN_STEP = 0.5;
+function distance(a, b) {
+    return hypot(a.x - b.x, a.y - b.y);
+}
+/**
+ * Distance from `from` to the far edge of the dark, light, dark run heading
+ * towards `to`, or null if the run does not complete inside the picture.
+ *
+ * From a finder centre that run is half the core, one light module and one
+ * dark: three and a half modules.
+ */
+function runTowards(image, from, to) {
+    const dx = to.x - from.x;
+    const dy = to.y - from.y;
+    const length = hypot(dx, dy);
+    if (length === 0)
+        return null;
+    const stepX = dx / length;
+    const stepY = dy / length;
+    // 0: still in the core. 1: in the light ring. 2: in the outer dark ring.
+    let state = 0;
+    for (let travelled = 0; travelled <= length; travelled += RUN_STEP) {
+        const x = Math.floor(from.x + stepX * travelled);
+        const y = Math.floor(from.y + stepY * travelled);
+        if (x < 0 || y < 0 || x >= image.width || y >= image.height)
+            return null;
+        const dark = isDark(image, x, y);
+        if (state === 0 && !dark)
+            state = 1;
+        else if (state === 1 && dark)
+            state = 2;
+        // The edge lies somewhere in the last step, so its middle is the estimate.
+        // Taking the step that found light instead overshoots, and by more going
+        // left or up than right or down, because a pixel is entered at its lower
+        // edge from one side and its upper edge from the other: at two pixels a
+        // module that bias alone put a 53-module symbol at 51.
+        else if (state === 2 && !dark)
+            return travelled - RUN_STEP / 2;
+    }
+    return null;
+}
+function moduleSizeBetween(image, a, b) {
+    const forward = runTowards(image, a, b);
+    if (forward === null)
+        return null;
+    // The same run the other way, so the estimate straddles all seven modules.
+    const backward = runTowards(image, a, { x: 2 * a.x - b.x, y: 2 * a.y - b.y });
+    // One side ran out of picture: half the pattern is still an estimate.
+    return backward === null ? forward / 3.5 : (forward + backward) / 7;
+}
+/**
+ * Module size measured along the axis joining two finder centres.
+ *
+ * The row scan's estimate is not rotation invariant: a horizontal scan across
+ * a finder rotated by 33 degrees stretches every run by 1/cos, so an 8 pixel
+ * module reads as 9.5, the symbol comes out several versions too small, and
+ * the decode collapses although every pattern was found. Measured along the
+ * axis the modules are actually counted on, the angle drops out. Both ends,
+ * because under a keystone view the far finder really is a different size: 3.7
+ * per cent apart on a 12 per cent keystone, a whole version step on a large
+ * symbol.
+ */
+export function moduleSizeAcross(image, a, b) {
+    const here = moduleSizeBetween(image, a, b);
+    const there = moduleSizeBetween(image, b, a);
+    if (here === null)
+        return there;
+    // The geometric mean of the two ends, not the arithmetic: along a line seen
+    // in perspective, the modules between two points number exactly their
+    // distance over the geometric mean of the module sizes at the ends. The
+    // arithmetic mean put a version 30 symbol tilted 20 degrees two modules
+    // short, at a size no symbol has.
+    return there === null ? here : Math.sqrt(here * there);
+}
+/**
+ * Assign three centres to corners.
+ *
+ * Purely geometric, which makes rotation free rather than a special case: the
+ * corner not touching the longest side is the right angle, so it is the top
+ * left, and the sign of a cross product puts the other two in the order that
+ * makes the frame right-handed in image coordinates.
+ *
+ * That sign is not a mirror test. A reflected symbol has its three finders in
+ * exactly the same L, so mirroring cannot be seen here; it is caught after
+ * sampling, where a mirrored square symbol is the transpose of a readable one.
+ */
+export function orderFinders(a, b, c) {
+    const ab = distance(a, b);
+    const bc = distance(b, c);
+    const ca = distance(c, a);
+    let corner;
+    let first;
+    let second;
+    if (bc >= ab && bc >= ca) {
+        corner = a;
+        first = b;
+        second = c;
+    }
+    else if (ca >= ab && ca >= bc) {
+        corner = b;
+        first = a;
+        second = c;
+    }
+    else {
+        corner = c;
+        first = a;
+        second = b;
+    }
+    const cross = (first.x - corner.x) * (second.y - corner.y) - (first.y - corner.y) * (second.x - corner.x);
+    return cross > 0
+        ? { topLeft: corner, topRight: first, bottomLeft: second }
+        : { topLeft: corner, topRight: second, bottomLeft: first };
+}
+/**
+ * Every ordered triple worth trying, best first.
+ *
+ * A busy picture, or one with several codes in it, leaves more than three
+ * candidates, so rather than guess, the reader tries the plausible
+ * combinations. Three parts of one symbol are the same size and stand in a
+ * rough right-angled L, and three unrelated blobs generally do not, so a
+ * triple is dropped when its sizes or its shape are far off and ranked by how
+ * well the sizes agree.
+ */
+export function candidateTriples(patterns, limit = 8) {
+    const out = [];
+    for (let i = 0; i < patterns.length; i += 1) {
+        for (let j = i + 1; j < patterns.length; j += 1) {
+            for (let k = j + 1; k < patterns.length; k += 1) {
+                const trio = [patterns[i], patterns[j], patterns[k]];
+                const sizes = trio.map((p) => p.moduleSize);
+                const mean = (sizes[0] + sizes[1] + sizes[2]) / 3;
+                const spread = Math.max(...sizes) - Math.min(...sizes);
+                if (spread > mean * 0.7)
+                    continue;
+                const triple = orderFinders(...trio);
+                if (!plausibleShape(triple, mean))
+                    continue;
+                const sightings = trio[0].count + trio[1].count + trio[2].count;
+                out.push({ triple, score: spread / mean - sightings / 100 });
+            }
+        }
+    }
+    return out
+        .sort((a, b) => a.score - b.score)
+        .slice(0, limit)
+        .map(({ triple }) => triple);
+}
+/**
+ * Whether an ordered triple could be one symbol's finders: legs no more than
+ * twice each other's length, a corner between 60 and 120 degrees, and a span
+ * between the smallest and the largest symbol. Generous, because perspective
+ * stretches all three, and exact checks come later.
+ */
+function plausibleShape(triple, moduleSize) {
+    const { topLeft, topRight, bottomLeft } = triple;
+    const ux = topRight.x - topLeft.x;
+    const uy = topRight.y - topLeft.y;
+    const vx = bottomLeft.x - topLeft.x;
+    const vy = bottomLeft.y - topLeft.y;
+    const across = hypot(ux, uy);
+    const down = hypot(vx, vy);
+    if (across === 0 || down === 0)
+        return false;
+    if (across > down * 2 || down > across * 2)
+        return false;
+    if (Math.abs((ux * vx + uy * vy) / (across * down)) > 0.5)
+        return false;
+    const span = (across + down) / 2 / moduleSize;
+    // 21 - 7 modules for version 1, 177 - 7 for version 40, with room for a bad estimate.
+    return span >= 10 && span <= 220;
+}
+//# sourceMappingURL=finder.js.map

package/dist/decode/finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finder.js","sourceRoot":"","sources":["../../src/decode/finder.ts"],"names":[],"mappings":"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"}

package/dist/decode/frame.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The orientation and module size of one finder pattern on its own.
+ *
+ * QR gets its frame from three finders, and a triangle has an orientation.
+ * Micro QR and rMQR have one finder each, and a square bullseye says only
+ * which way its sides run, modulo a quarter turn. That is enough: the four
+ * quarter turns are then tried, and the timing pattern or the far sub-pattern
+ * says which is right.
+ *
+ * The sides are found by casting rays from the centre to the outer edge of
+ * the pattern. A square of half-side h at angle t is h / max(|cos|, |sin|) of
+ * the angle away from t along each ray, so the angle whose model best fits
+ * the measured distances is the pattern's. Fitted rather than read off the
+ * corners, because a corner is exactly where blur and thresholding eat the
+ * pattern first.
+ *
+ * Clean images only, like the locators that use it: screenshots, scans, this
+ * package's own renders and mild rotation. Perspective would bend the square
+ * the model assumes, and is not in scope for Micro QR and rMQR in this version.
+ */
+import type { Binarised } from './binarise.js';
+import type { FinderPattern } from './finder.js';
+import type { Homography } from './transform.js';
+import type { Point } from './types.js';
+export interface FinderFrame {
+    readonly centre: Point;
+    /** The angle of one side, in radians, in [0, pi / 2). */
+    readonly angle: number;
+    /** Pixels per module, from the pattern's measured side. */
+    readonly module: number;
+}
+/** The frame of one finder, or null when the pattern does not fit a square bullseye. */
+export declare function finderFrame(image: Binarised, pattern: FinderPattern): FinderFrame | null;
+/** Solve a 4 by 4 system by elimination with partial pivoting; null when it is singular. */
+export declare function solve4(matrix: Float64Array, vector: Float64Array): number[] | null;
+/** A unit vector along the frame's side `turns` quarter turns round from its angle. */
+export declare function axis(frame: FinderFrame, turns: number): Point;
+/**
+ * The affine map from module coordinates to pixels with the finder's centre at
+ * module (3.5, 3.5), x along `ex` and y along `ey`, each one `module` long.
+ */
+export declare function frameTransform(centre: Point, ex: Point, ey: Point): Homography;
+/**
+ * The y axis for an x axis: a quarter turn clockwise on screen for a
+ * right-handed frame, the way a symbol is drawn, or anticlockwise for the
+ * mirror image of one.
+ */
+export declare function perpendicular(ex: Point, mirrored: boolean): Point;
+//# sourceMappingURL=frame.d.ts.map

package/dist/decode/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/decode/frame.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AA4CD,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,WAAW,GAAG,IAAI,CA8CxF;AAuDD,4FAA4F;AAC5F,wBAAgB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,GAAG,IAAI,CAsBlF;AAED,uFAAuF;AACvF,wBAAgB,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAG7D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,GAAG,UAAU,CAY9E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAG,KAAK,CAEjE"}