Skip to main content
Kofax

Trap images sent to the EBC engine

19192

QAID # 19192 Published

Question / Problem:

How to trap the true images that are being submitted to the Enhanced Bar Code engine

Answer / Solution:

When troubleshooting issues where bar codes are not being recognized successfully, it can be helpful to analyze the actual image that is being sent to the Enhanced Bar Code engine. Due to image processing, particularly in the case where a Kofax Capture Recognition Profile applies additional temporary image processing, the image that is submitted to the Bar Code engine may differ from the image that appears in the scanning application.

To trap the true images that are being submitted to the Enhanced Bar Code engine:

  1. Stop all applications and services that use Kofax VRS / ImageControls.
     
  2. Create the following folder and grant the user Read/Write/Modify (Full Control) permissions to it:
    C:\EBCInput
     
  3. Navigate to C:\ProgramData\Kofax\Vrs
     
  4. Create a new text file named KBarMode.ini (if it does not already exist).
     
  5. Open KBarMode.ini in a text editor and add the following:
    [Barcode]
    
    ; IniActive - All following settings will ignored unless this is non-zero
    IniActive=1
    
    ; Outputs images where a bar code was found
    ; Will impact performance and disk space if left enabled
    SaveInputImage=1
    
    ; Outputs images where no bar codes were found
    ; Will impact performance and disk space if left enabled
    SaveNoCodeImage=1
    
    ; Set the value to the path where the images will be stored.  Path-only, despite the parameter name.
    ; The Barcode engine will complete the output file name, including the .BMP extension.
    ; Must create folder and grant user Read/Write/Modify (Full Control) permissions to it
    SaveImage_FileName=c:\EBCInput
  6. Save the changes to KBarMode.ini.

The trapped images will be saved to the location defined in the SaveImage_FileName field.

 

To stop trapping the true images that are being submitted to the Enhanced Bar Code engine:

  1. Open KBarMode.ini in a text editor and change the SaveInputImage value to 0
    SaveInputImage=0
     
  2. Change the SaveNoCodeImage value to 0
    SaveNoCodeImage=0
    ​​​​​​​
  3. Save the changes to KBarMode.ini.

Applies to:

Product Version
CAPTURE 10.0
  10.1
  10.2
  11.0
  11.1
VRS 4.5
  5.1
  5.1.1
  5.1.2
  5.2
  • Was this article helpful?