Configure scan engine settings
Last updated October 16th, 2023
Scan engine settings define the core Knox Capture behavior, such as how barcodes are scanned, and what happens with the data after each scan. The following settings are available:
Choose the barcode symbologies the scanner should recognize. For example, Code 39, and QR code. Available barcode types:
|Numeric-only (1D)||Codabar, EAN13, EAN8, Interleaved 2 of 5, UPCA, UPCE|
|Alphanumeric (1D)||Code 128, Code 39, Code 93|
|2D||Data Matrix, PDF417, QR|
Every barcode except Codabar and Code 93 is enabled by default.
Use scan settings to define how barcodes are scanned, selected, and parsed before Knox Capture sends them to a target business application.
Sets the primary capture mode for scanning. Available options:
|Single scan (default)||Scans and parses one barcode at a time.|
|Multi scan||Detects multiple barcodes in the scan area at the same time.|
Single scan preferences
Sets the way a user selects barcodes when interacting with the camera scanning UI in Single scan mode. Available options:
1 Device users will see a Scan button in the camera preview window when they trigger a barcode scan. Device users can simply tap Scan each time they want to capture a new barcode. As each barcode is scanned, a counter in the top-left corner of the preview window gets updated. Once the user is finished scanning, they can click Done to close the camera preview window and return to the business app.
Multi scan preferences
Sets the way a user selects barcodes when interacting with the camera scanning UI in Multi scan mode. Available options:
|Scan session limit||
This defines the number of barcodes a user must scan before the camera preview window closes. A counter in the top-left corner of the preview window gets updated after each scan. Once the user has scanned the set number of barcodes, the camera preview window closes and the user returns to the business app.
Users can exit the camera preview window at any time by tapping Done, regardless of the number of barcodes captured. You can set any integer value. By default, this value is set to 0 to indicate infinite scans.
Beep after scan
Emits a beep sound after each barcode scan. This is toggled On by default.
Vibrate after scan
Vibrates the device after each barcode scan. This is toggled On by default.
Customize camera hardware and scanning UI options using the following settings:
|Zoom factor||Any value from 1.0 (no zoom) to 4.0 (fully zoomed in). Default value is 1.0.|
2 Flashlight Auto is not available in Knox Capture: Scandit Edition.
Refer to the following settings to change the camera UI overlay displaying around recognized barcodes when scanning:
|Fill color||Set the color inside the box highlighting a recognized barcode, represented as ARGB in HEX format. Set to 00000000 (transparent) by default.|
|Stroke color||Set the border color of the box highlighting the recognized barcode, represented as ARGB in HEX format. Set to FF1C7980 by default.|
|Stroke width||Set the border width of the box highlighting the recognized barcode in pixels. Set to 3 pixels by default.|
Extended barcode type settings
Use these settings to configure each barcode type used in a Knox Capture profile. Access these settings by tapping Advanced settings near the bottom of the scan engine settings menu, then tap Extended barcode type settings to display a list of all barcode types. To view the extended settings for a particular barcode type, tap its name. The following table describes the possible barcode type settings that may appear:
|Inverted color recognition||
Use the following settings to conditionally validate barcodes and highlight rejected barcodes:
|Custom validation||Set a regular expression (regex) used to filter scanned barcodes. Only barcodes that match the provided regular expression will be accepted. Refer to this reference for details on crafting an expression. By default, no regex is set.|
|Highlight rejected code||Toggle on to enable an overlay in the camera preview window that appears around rejected codes. A Custom validation value must be set to enable this setting. This is toggled Off by default.|
The visual cue is the viewfinder overlay centered in the camera scanning UI that focuses the user’s attention on a barcode. The size of the visual cue is the same size as of the actual scan area.
|View finder selection||
|Rectangular viewfinder width||Set the width of the rectangular viewfinder, specified in screen width percentage. Only active if View finder selection is set to Rectangular. Available values are 0% to 100%. Default value is 90%.|
|Rectangular viewfinder height||Set the height of the rectangular viewfinder specified in screen height percentage. Only active if View finder selection is set to Rectangular. Available values are 0% to 100%. Default value is 40%.|
Is this page helpful?
Thank you for your feedback!