Because debugging and writing debug information to a log file is time consuming and expensive, Barcode Xpress provides the ability to control the level of information written to the debug log as well as the ability to turn off writing to a file completely.

Use the objects below to adjust the settings of your debugging, event handling, memory and IDispose for optimal performance.

Control Debugging Information

• Debug - Turns on or off the ability to write to the debug log file.
• DebugLogFile - A filename which stores the debug log information.
• DebugErrorLevel - Controls the amount of information that is written to the debug log file.
  
  When DebugErrorLevel is set to Detailed, Barcode Xpress will log most of your calls to the component including the occurrence of exceptions, the result of most major operations and the operation of each event it raises.

Troubleshooting

• Color or Grayscale Images - Barcode Xpress works with 1, 8, or 24-bit images. To convert other formats, use the ColorDepth or other methods with the included ImagXpress component.
• Linker Tools Error LNK1123, failure during conversion to COFF: file invalid or corrupt - Barcode Xpress needs to have service pack 1 installed when using VS2010 IDE.        
• Due to poor image quality, not able to read Barcodes when you know they exist - There is no set process for cleanup of images. Since literally a single pixel may make a difference for recognition results, what may work on one image for cleanup, may not work on another. The ScanFix component, which is sold separately, can perform various clean-up operations including SmoothandZoom, Dilation, and Erosion which all assist in recognition of the barcodes, but there is no set order in which to perform these operations that will ensure each image barcode will be detected. All ScanFix Xpress (sold separately) cleanup operations are very fast, so an option to consider is performing multiple operations and then retrying recognition. Some image clean-up operations can also be found in ImagXpress.
• Issues with barcode recognition - Some reasons why your barcode may not be detected could be due to poor resolution, resolutions of horizontal and vertical are not the same (such as a faxed image), the barcode wasn't made correctly according to the standard, bad scanning quality, bad image quality (see bullet two above), or the barcode is a type that Barcode Xpress doesn't read. Attempt to solve any image quality, resolution, and scanning properties using the included ImagXpress component. ImagXpress can be used to set both horizontal and vertical resolutions the same.
• Confidence values - Confidence values are programmed into the component. Barcode Xpress is conservative on confidence values compared to other competitive components so the developer understands when a barcode may not be 100% accurate. This ensures the barcode recognized is producing accurate data.
• "Object library not registered" error - You may encounter the error "Object library not registered" when loading Visual Basic 6 samples that use common ActiveX controls. This may occur after installing Windows or Visual Studio updates. In the event this occurs, a potential solution is:

Error Codes

Listed below is a cross reference of error codes and their corresponding descriptions.