[POC] u-22272 — VIN image collector for template optimization

[Tom-Dynamsoft]

Case & Customer

Field	Value
Case ID	u-22272
Company	Internal (PT Lab)
Contact	PT Team
Deal Stage	Active evaluation
Deadline	Not specified
Sales Rep	N/A — internal task

Use Case

Enhance the existing lab/read-vin sample to collect camera frames where VIN barcode decoding fails. These failure images will be used to tune and optimize the read_vin.json DBR template for the customer's specific VIN scanning environment.

The collector should:

• Save the actual image frames passed from DCE (CameraEnhancer) to DCV (CaptureVisionRouter) — not side-captured frames
• Only save frames where decoding failed (no barcode found)
• Throttle saving by time interval (~3s) to avoid near-duplicate frames
• Provide a results log (success/failure counts, timestamps)
• Offer batch ZIP download of all collected failure images + log metadata

SDK Requirements

Field	Value
SDK Product(s)	Barcode Reader JavaScript (dynamsoft-barcode-reader-bundle@11.4.2001)
Specific Types	VIN barcodes (Code 39, Code 128, Code 93, QR, DataMatrix, etc.)
Input Source	Camera (live video)
Volume/Performance	Continuous scanning — high frame rate, throttled image saving

Technical Environment

Field	Value
Platform	Web
Framework	Plain HTML (no framework)
Language	JavaScript
Hosting/Deployment	Local dev server (Five Server / localhost)
Browser/OS Requirements	Modern browsers with camera access (HTTPS or localhost)

Special Requirements

• Use outputOriginalImage = true on simplified settings to capture actual processed frames
• Use onCapturedResultReceived callback (fires every frame) to detect failed decodes
• Use CRIT_ORIGINAL_IMAGE result item type to extract frame as canvas → blob
• Use JSZip (CDN) for batch ZIP download
• Continuous scanning mode (don't stop after first successful decode)
• Time-based throttle (~3s) on failure image saving to avoid flooding

Integration Points

No external integrations. Self-contained sample that collects images locally in browser memory and downloads as ZIP.

UI / Branding

Minimal additions to existing sample UI:

• Floating status badge (top-right): "Failures: X / Frames: Y"
• Floating "Stop & Download" button (bottom)
• Log/download panel after stopping: stats, log entries, "Download ZIP" button

Known Constraints

• Images stored in browser memory — large sessions may consume significant RAM
• Trial license key provided for evaluation

TBD Items

• Intermediate result capture (grayscale, binarized frames) — planned for later phase
• Server-side upload of collected images — not in scope for this phase

Notes from Sales

Internal PT task to support template optimization for customer case u-22272. The customer's VIN barcodes are not decoding reliably with the default template. Collecting real failure frames will allow iterative template tuning.

---

Created via /poc-sample-builder intake on 2026-05-19