Scan engine settings

Configure scan engine settings for each Knox Capture profile to set values such as recognizable barcode type, camera zoom, and the visual scanning interface.

Basic settings

Barcode types

Choose the barcode symbologies the scanner should recognize. For example, Code 39, and QR code.

Setting Description Options Default
Barcode types Currently supported 1D and 2D barcode types.
  • Numeric-only (1D)—Codabar, Code 11, Code 25, Code 32, DataBar 14, DataBar Limited, EAN13, EAN8, Interleaved 2 of 5, MSI-Plessey, UPCA, UPCE
  • Alpha-numeric (1D)—Code 128, Code 39, Code 93, DataBar Expanded, KIX, RM4SCC
  • 2D—Aztec, Data Matrix, DotCode, MaxiCode, MicroPDF417, Micro QR, PDF417, QR
Code 128, Code 39, DataMatrix, EAN8, Interleaved 2 Of 5, QR, UPCA, UPCE

Scan settings

Use scan settings to define how barcodes are scanned, selected, and parsed before Knox Capture sends them to a target business application.

Setting Description Options Default
Scan mode

Sets the primary capture mode for scanning.

  • Single scan—Scans and parses one barcode at a time.
  • Multi scan—Detects multiple barcodes in the scan area at the same time.
Single scan
Single scan preferences See Single scan preferences.
Multi scan preferences See Multi scan preferences.
Beep after scan Beep emitted after scanning barcode data. ON/OFF ON
Remove checksum Global setting to remove checksums for barcode data for all barcode types. ON/OFF OFF
Parse GS1

If enabled, parses scanned barcode data based on the GS1 data format before sending it to the target business app.

For more information on the GS1 standard, refer to GS1 General Specifications.


Single scan preferences

Setting Description Options Default
Barcode selection Sets the way a user selects barcodes when interacting with the camera scanning UI in Single scan mode.
  • Automatic—Captures the first-detected barcode without additional user input.
  • Aim and scan—Requires the user to aim the camera at a barcode and tap the Scan button to capture barcode data.
Continuous scanning Allows the device user to scan consecutive barcodes in the same single scan session. ON/OFF OFF

Multi scan preferences

Use the Session scan limit to configure the number of barcodes a user should scan in an activity in the target business app. When set, the user must scan the specified number of barcodes (or exit the session) before the camera scanning overlay closes, and the captured barcode data appears as output in the business app. However, the user can continue to scan if the session limit is not set, and scan as many as barcodes as they want, then click Done to pass on the result to the business app.

Setting Description Options Default
Barcode selection

Sets the way a user selects barcodes when interacting with the camera scanning UI in Multi scan mode.

  • Automatic—Allows the user to scan multiple barcodes without having to press a Scan button.
  • Batch—The user can scan multiple barcodes in a single camera frame using the scan button.
  • Aim and scan—Requires the user to aim the camera at a set of barcodes and tap the Scan button to capture the barcodes, one at a time.
  • Tap to select—Lets a user aim the camera at multiple barcodes, freeze the scanning overlay, tap to select barcodes, and tap the Scan button to capture data from the selected barcodes.
Scan session limit Number of barcodes to capture and process during a single scanning session. Any integer value. 0 (indicates infinite scans)

Camera settings

Customize camera hardware and scanning UI options using the following settings:

Setting Description Options Default
Default camera Default device camera used for scanning. Back/Front Back
Flashlight button UI button in the camera scanning overlay used to turn the device flashlight on and off. Use this setting to access the device flashlight while scanning in dark conditions. ON/OFF ON
Zoom factor Factor by which the camera focus zooms in when scanning, starting at 1 (no zoom). 1.0 - 4.0 1.0

Highlight barcode

Refer to the following settings to change the camera UI overlay displaying around recognized barcodes when scanning:

Setting Description Default
Fill color Color inside the box highlighting a recognized barcode, represented as ARGB in HEX format. For example, F33E91FF. 00000000 (transparent)
Stroke color Border color of the box highlighting the recognized barcode, represented as ARGB in HEX format. FF1C7980
Stroke width Border width of the box highlighting the recognized barcode in pixels. 3 pixels

Advanced settings

Barcode filtering

Use the following settings to conditionally validate barcodes and highlight rejected barcodes:

Setting Description Options Default
Custom validation 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 a regex expression. Not set
Highlight rejected codes Overlay in camera scanning UI that appears around rejected codes. A Custom validation value must be set to enable this setting. ON/OFF OFF

Visual cue

The visual cue is the view finder 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.

Setting Description Options Default
View finder selection Shape of the visual cue that appears on or around an in-focus barcode.
  • Rectangular - Draws a rectangle around detected barcodes.
  • Laser - Overlays a horizontal "laser" line over detected barcodes.
Rectangular view finder width Width of the rectangular viewfinder specified in screen width percentage. Only active if View finder selection is set to Rectangular. [0%, 100%] 90%
Rectangular view finder height Height of the rectangular viewfinder specified in screen height percentage. Only active if View finder selection is set to Rectangular. [0%, 100%] 40%

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 settings menu for a particular barcode type, tap its name.

The following table describes the possible barcode type settings that may appear after selecting a <barcode name> detail config option. Available settings and their default values vary by barcode type.

Setting Description Options Default
Min. length

Determines the minimum supported barcode length (active symbol count) to decode.

Change this property to include lengths not enabled by default, or to optimize decoding performance for a certain number of symbols.

Character-to-symbol mapping depends on barcode type. For example, some barcodes include additional checksum characters in their symbol counts.

For more information on active symbol count, refer to Configure the Active Symbol Count.

Depends on barcode type.
Max. length Determines the maximum supported barcode length (active symbol count) to decode. Depends on barcode type.
Inverted color recognition Enables recognition of inverted barcodes that have been printed using bright ink on a dark background. ON/OFF OFF
Reduced quiet zone-size Enables scanning codes with smaller than normal quiet zones (white space before and after the code) than allowed by the barcode type specification. Use this if you experience issues when scanning codes that violate quiet zone specifications. Please note that turning on this feature may lead to false positive scans in some cases. ON/OFF OFF
Strip leading FNC1 Removes the leading FNC1 character that indicates a GS1 code. ON/OFF OFF
Direct part marking mode Improves scan performance when reading direct part marked (DPM) Data Matrix codes. Please note that this setting increases frame processing times. Samsung recommends restricting the scanning area to a smaller portion of the screen for better performance when using direct part marking mode. ON/OFF OFF
Checksum mod n

Barcode checksums use a piece of barcode data and a checksum algorithm to ensure data transmission integrity.

Some barcode types include a mandatory checksum, while others only have optional checksums. Enforcing an optional checksum helps reduce false positives and provides an extra layer of error prevention. When enabling a checksum, ensure your barcode data includes the calculated checksum, otherwise the checksum will not match and the barcode data is discarded.

Uses and enforces a modulo n checksum algorithm.

Full ASCII support Interprets Code39 data using two symbols per output character to encode all ASCII characters. ON/OFF OFF
Double checksum mod n Uses and enforces a double checksum modulo n. ON/OFF OFF
Remove leading zero Removes the leading zero digit from EAN13/UCPA scanned barcode data. ON/OFF ON
Return as UPCA Transforms UPCE scanned barcode data into its UPCA representation. ON/OFF OFF
Remove leading UPCA zero Removes the leading zero digit from scanned barcode data if Return as UPCA is enabled. ON/OFF OFF