Skip to content

Accuracy and speed ​

How the scanner works ​

The camera plugin delivers frames to Dart. The scanner copies only the scan window of each frame and decodes it on a background isolate, one frame at a time: while a frame is decoded, newer frames replace each other, so nothing piles up. A frame takes 1–9 ms on an iPhone 17 Pro Max and 2–18 ms on a 2020 Pixel 4a, of the 33–40 ms between frames, so every frame the camera delivers is decoded, and the frame rate of the camera is the limit.

Load and battery ​

Most of the scanner's work is not decoding. The camera plugin copies every frame into Dart, which costs more than reading it: about a quarter of a CPU core on an iPhone 17 Pro Max and most of a core on a Pixel 4a. The scanner keeps the rest small:

  • A paused scanner, such as under a result sheet, takes no frames and keeps only the preview.
  • The scan window and the brackets on a code redraw the screen only when something moves, not at the display's full rate.
  • The blur turns itself off on a phone without room for it (see below).

stop() releases the camera entirely: use it when the scanner is not on screen for long.

Small or dense codes ​

Only the scan window of each frame is read. The default camera resolution, CameraResolution.hd (about 1280×720), is plenty for QR codes on screens and labels. For a dense Data Matrix or a long GS1 DataBar, give the decoder more pixels:

dart
final controller = ScannerController(
  resolution: CameraResolution.fullHd,
  scanWindow: const ScanWindow.centered(width: 0.9),
);

For small codes on parts and boards, start zoomed in: ScannerController(initialZoom: 2), or the ScannerTemplate.small() template. On iPhones, automatic zoom moves to the ultra-wide camera for codes too close for the main camera to focus.

Faster frames ​

  • Fewer formats. Each format is another search; formats with only the ones the app needs decodes faster and never mistakes one symbology for another.
  • One code per frame. maxBarcodes: 1, the default, stops at the first code: several times faster on a frame with a code.
  • The camera preset. ReaderOptions.camera() leaves out light-on-dark codes. Turn tryInvert on only if the app reads them.
  • Slow phones. The dimmed camera around the window is blurred again for every frame. Left unset, the scanner turns its blur off by itself when the device does not draw its frames in time; ScannerTheme(scrimBlur: false, blur: false) turns it off from the start, true keeps it on.

Photos and files ​

Image files are read at full resolution, with every search strategy of ReaderOptions() on, including a smaller copy of large images (tryDownscale). A 12-megapixel photo with a small, dense QR code is found in about 100 ms on a MacBook and 220 ms on a 2020 Pixel 4a, without blocking the UI.

Measured ​

Release builds. The phone was held on a QR code until 1000 frames with the code were decoded. Scan window 60% × 80% of the frame, 1280×720 frames. Scan latency is from the frame arriving in Dart to its barcodes being back on the UI isolate.

DeviceDecoded per secondFrames skippedScan latency avg / p95UI frames over 16 ms
iPhone 17 Pro Max3002.6 / 3.6 ms0 of 1073
Pixel 4a (2020)24.903.0 / 9.5 ms0 of 1246
Safari, MacBook camera30—9.6 / 12 ms0 of 1140
Safari, iPhone 17 Pro Max30—9.0 / 12 ms0 of 1129
Images3.1.14.0
32 images, MacBook4.8 ms0.6 ms
32 images, Pixel 4a15.8 ms1.6 ms
12 MP photo, MacBooknot found; UI frozen 374 msfound in 103 ms, UI not blocked
12 MP photo, Pixel 4anot found; UI frozen 1.0 sfound in 219 ms, UI not blocked
12 MP photo, Chrome (WebAssembly)not supportedfound in 204 ms

The raw data and how to repeat a run are in benchmark/BENCHMARKS.md.

Limits ​

  • MaxiCode is read from clean images only (a code without background, not skewed), not from the camera: a limit of zxing-cpp.
  • zxing-cpp is a classic decoder. Machine-learning decoders such as ML Kit tend to read damaged, blurred and curved codes that it misses: see Coming from mobile_scanner.