zedbar 0.2.4 → 0.3.0

package/README.md

@@ -101,6 +101,12 @@ Scans grayscale image data for barcodes and QR codes.
 ### `ScanOptions`
 
 - `retryUndecodedRegions` (`boolean`, default: `true`) - Automatically retry undecoded QR finder regions by cropping and upscaling. Disable to skip the retry and reduce processing time for images that are known to have sufficient resolution.
+- `symbologies` (`string[]`, optional) - Restrict scanning to the listed symbologies. When omitted, every supported symbology is enabled. Names match the `symbolType` field on results — see [Supported Formats](#supported-formats).
+
+```javascript
+// Scan QR codes only
+const results = scanImageBytes(imageBytes, { symbologies: ['QR-Code'] });
+```
 
 ### `DecodeResult`
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zedbar",
   "description": "Fast QR code and barcode scanner for Node.js, powered by WebAssembly",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "license": "LGPL-3.0-or-later",
   "repository": {
     "type": "git",

package/zedbar.d.ts

@@ -1,14 +1,5 @@
 /* tslint:disable */
 /* eslint-disable */
-/**
- * Scan grayscale image data for barcodes and QR codes.
- *
- * `data` must be an array of 8-bit grayscale pixel values,
- * row-major, with dimensions `width` x `height`.
- *
- * Returns an array of `DecodeResult` objects.
- */
-export function scanGrayscale(data: Uint8Array, width: number, height: number, options?: ScanOptions | null): DecodeResult[];
 /**
  * Scan an encoded image (PNG, JPEG, BMP, WebP) for barcodes and QR codes.
  *
@@ -21,6 +12,15 @@ export function scanGrayscale(data: Uint8Array, width: number, height: number, o
  * Returns an array of `DecodeResult` objects.
  */
 export function scanImageBytes(bytes: Uint8Array, options?: ScanOptions | null): DecodeResult[];
+/**
+ * Scan grayscale image data for barcodes and QR codes.
+ *
+ * `data` must be an array of 8-bit grayscale pixel values,
+ * row-major, with dimensions `width` x `height`.
+ *
+ * Returns an array of `DecodeResult` objects.
+ */
+export function scanGrayscale(data: Uint8Array, width: number, height: number, options?: ScanOptions | null): DecodeResult[];
 /**
  * A decoded barcode/QR code result.
  */
@@ -54,11 +54,14 @@ export class DecodeResult {
  * All fields are optional and default to sensible values when omitted.
  *
  * ```js
- * // Use defaults (retry enabled):
+ * // Use defaults (every supported symbology, retry enabled):
  * const results = scanGrayscale(data, width, height);
  *
  * // Disable automatic retry of small QR codes:
  * const results = scanGrayscale(data, width, height, { retryUndecodedRegions: false });
+ *
+ * // Restrict to QR codes only:
+ * const results = scanGrayscale(data, width, height, { symbologies: ["QR-Code"] });
  * ```
  */
 export class ScanOptions {
@@ -68,6 +71,17 @@ export class ScanOptions {
    * Create a new options object with defaults.
    */
   constructor();
+  /**
+   * Restrict scanning to the listed symbologies. When omitted, every
+   * supported symbology is enabled.
+   *
+   * Names match the `symbolType` field on decode results: `"QR-Code"`,
+   * `"SQ-Code"`, `"EAN-13"`, `"EAN-8"`, `"EAN-2"`, `"EAN-5"`,
+   * `"UPC-A"`, `"UPC-E"`, `"ISBN-10"`, `"ISBN-13"`, `"I2/5"`,
+   * `"DataBar"`, `"DataBar-Exp"`, `"Codabar"`, `"CODE-39"`,
+   * `"CODE-93"`, `"CODE-128"`.
+   */
+  set symbologies(value: string[]);
   /**
    * Whether to automatically retry undecoded QR finder regions by
    * cropping and upscaling them. Default: `true`.

package/zedbar.js

@@ -2,6 +2,8 @@
 let imports = {};
 imports['__wbindgen_placeholder__'] = module.exports;
 
+let WASM_VECTOR_LEN = 0;
+
 let cachedUint8ArrayMemory0 = null;
 
 function getUint8ArrayMemory0() {
@@ -11,6 +13,71 @@ function getUint8ArrayMemory0() {
     return cachedUint8ArrayMemory0;
 }
 
+const cachedTextEncoder = new TextEncoder();
+
+if (!('encodeInto' in cachedTextEncoder)) {
+    cachedTextEncoder.encodeInto = function (arg, view) {
+        const buf = cachedTextEncoder.encode(arg);
+        view.set(buf);
+        return {
+            read: arg.length,
+            written: buf.length
+        };
+    }
+}
+
+function passStringToWasm0(arg, malloc, realloc) {
+
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8ArrayMemory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
+        const ret = cachedTextEncoder.encodeInto(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
+function isLikeNone(x) {
+    return x === undefined || x === null;
+}
+
+let cachedDataViewMemory0 = null;
+
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
 let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
 
 cachedTextDecoder.decode();
@@ -24,13 +91,27 @@ function getStringFromWasm0(ptr, len) {
     return decodeText(ptr, len);
 }
 
+function addToExternrefTable0(obj) {
+    const idx = wasm.__externref_table_alloc();
+    wasm.__wbindgen_export_2.set(idx, obj);
+    return idx;
+}
+
+function passArrayJsValueToWasm0(array, malloc) {
+    const ptr = malloc(array.length * 4, 4) >>> 0;
+    for (let i = 0; i < array.length; i++) {
+        const add = addToExternrefTable0(array[i]);
+        getDataViewMemory0().setUint32(ptr + 4 * i, add, true);
+    }
+    WASM_VECTOR_LEN = array.length;
+    return ptr;
+}
+
 function getArrayU8FromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
 }
 
-let WASM_VECTOR_LEN = 0;
-
 function passArray8ToWasm0(arg, malloc) {
     const ptr = malloc(arg.length * 1, 1) >>> 0;
     getUint8ArrayMemory0().set(arg, ptr / 1);
@@ -38,10 +119,6 @@ function passArray8ToWasm0(arg, malloc) {
     return ptr;
 }
 
-function isLikeNone(x) {
-    return x === undefined || x === null;
-}
-
 function _assertClass(instance, klass) {
     if (!(instance instanceof klass)) {
         throw new Error(`expected instance of ${klass.name}`);
@@ -49,52 +126,44 @@ function _assertClass(instance, klass) {
 }
 
 function takeFromExternrefTable0(idx) {
-    const value = wasm.__wbindgen_export_0.get(idx);
+    const value = wasm.__wbindgen_export_2.get(idx);
     wasm.__externref_table_dealloc(idx);
     return value;
 }
 
-let cachedDataViewMemory0 = null;
-
-function getDataViewMemory0() {
-    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
-        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
-    }
-    return cachedDataViewMemory0;
-}
-
 function getArrayJsValueFromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     const mem = getDataViewMemory0();
     const result = [];
     for (let i = ptr; i < ptr + 4 * len; i += 4) {
-        result.push(wasm.__wbindgen_export_0.get(mem.getUint32(i, true)));
+        result.push(wasm.__wbindgen_export_2.get(mem.getUint32(i, true)));
     }
     wasm.__externref_drop_slice(ptr, len);
     return result;
 }
 /**
- * Scan grayscale image data for barcodes and QR codes.
+ * Scan an encoded image (PNG, JPEG, BMP, WebP) for barcodes and QR codes.
  *
- * `data` must be an array of 8-bit grayscale pixel values,
- * row-major, with dimensions `width` x `height`.
+ * `bytes` should contain the raw bytes of an image file in one of the
+ * supported formats: PNG, JPEG, BMP, or WebP.
+ *
+ * The image will be automatically decoded and converted to grayscale
+ * before scanning.
  *
  * Returns an array of `DecodeResult` objects.
- * @param {Uint8Array} data
- * @param {number} width
- * @param {number} height
+ * @param {Uint8Array} bytes
  * @param {ScanOptions | null} [options]
  * @returns {DecodeResult[]}
  */
-exports.scanGrayscale = function(data, width, height, options) {
-    const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
+exports.scanImageBytes = function(bytes, options) {
+    const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
     let ptr1 = 0;
     if (!isLikeNone(options)) {
         _assertClass(options, ScanOptions);
         ptr1 = options.__destroy_into_raw();
     }
-    const ret = wasm.scanGrayscale(ptr0, len0, width, height, ptr1);
+    const ret = wasm.scanImageBytes(ptr0, len0, ptr1);
     if (ret[3]) {
         throw takeFromExternrefTable0(ret[2]);
     }
@@ -104,28 +173,27 @@ exports.scanGrayscale = function(data, width, height, options) {
 };
 
 /**
- * Scan an encoded image (PNG, JPEG, BMP, WebP) for barcodes and QR codes.
- *
- * `bytes` should contain the raw bytes of an image file in one of the
- * supported formats: PNG, JPEG, BMP, or WebP.
+ * Scan grayscale image data for barcodes and QR codes.
  *
- * The image will be automatically decoded and converted to grayscale
- * before scanning.
+ * `data` must be an array of 8-bit grayscale pixel values,
+ * row-major, with dimensions `width` x `height`.
  *
  * Returns an array of `DecodeResult` objects.
- * @param {Uint8Array} bytes
+ * @param {Uint8Array} data
+ * @param {number} width
+ * @param {number} height
  * @param {ScanOptions | null} [options]
  * @returns {DecodeResult[]}
  */
-exports.scanImageBytes = function(bytes, options) {
-    const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+exports.scanGrayscale = function(data, width, height, options) {
+    const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
     let ptr1 = 0;
     if (!isLikeNone(options)) {
         _assertClass(options, ScanOptions);
         ptr1 = options.__destroy_into_raw();
     }
-    const ret = wasm.scanImageBytes(ptr0, len0, ptr1);
+    const ret = wasm.scanGrayscale(ptr0, len0, width, height, ptr1);
     if (ret[3]) {
         throw takeFromExternrefTable0(ret[2]);
     }
@@ -221,11 +289,14 @@ const ScanOptionsFinalization = (typeof FinalizationRegistry === 'undefined')
  * All fields are optional and default to sensible values when omitted.
  *
  * ```js
- * // Use defaults (retry enabled):
+ * // Use defaults (every supported symbology, retry enabled):
  * const results = scanGrayscale(data, width, height);
  *
  * // Disable automatic retry of small QR codes:
  * const results = scanGrayscale(data, width, height, { retryUndecodedRegions: false });
+ *
+ * // Restrict to QR codes only:
+ * const results = scanGrayscale(data, width, height, { symbologies: ["QR-Code"] });
  * ```
  */
 class ScanOptions {
@@ -241,6 +312,22 @@ class ScanOptions {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_scanoptions_free(ptr, 0);
     }
+    /**
+     * Restrict scanning to the listed symbologies. When omitted, every
+     * supported symbology is enabled.
+     *
+     * Names match the `symbolType` field on decode results: `"QR-Code"`,
+     * `"SQ-Code"`, `"EAN-13"`, `"EAN-8"`, `"EAN-2"`, `"EAN-5"`,
+     * `"UPC-A"`, `"UPC-E"`, `"ISBN-10"`, `"ISBN-13"`, `"I2/5"`,
+     * `"DataBar"`, `"DataBar-Exp"`, `"Codabar"`, `"CODE-39"`,
+     * `"CODE-93"`, `"CODE-128"`.
+     * @param {string[]} value
+     */
+    set symbologies(value) {
+        const ptr0 = passArrayJsValueToWasm0(value, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.scanoptions_set_symbologies(this.__wbg_ptr, ptr0, len0);
+    }
     /**
      * Whether to automatically retry undecoded QR finder regions by
      * cropping and upscaling them. Default: `true`.
@@ -268,6 +355,15 @@ exports.__wbg_decoderesult_new = function(arg0) {
     return ret;
 };
 
+exports.__wbg_wbindgenstringget_0f16a6ddddef376f = function(arg0, arg1) {
+    const obj = arg1;
+    const ret = typeof(obj) === 'string' ? obj : undefined;
+    var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    var len1 = WASM_VECTOR_LEN;
+    getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+};
+
 exports.__wbg_wbindgenthrow_451ec1a8469d7eb6 = function(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
 };
@@ -279,7 +375,7 @@ exports.__wbindgen_cast_2241b6af4c4b2941 = function(arg0, arg1) {
 };
 
 exports.__wbindgen_init_externref_table = function() {
-    const table = wasm.__wbindgen_export_0;
+    const table = wasm.__wbindgen_export_2;
     const offset = table.grow(4);
     table.set(0, undefined);
     table.set(offset + 0, undefined);