Debug Your Application

In This Topic

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:

Run a command prompt with Administrator rights.
This can be done by pressing ⊞Win+R on your keyboard and typing "cmd" in the run command dialog.
Navigate to
C:\Windows\SysWOW64 on 64-bit systems or
C:\Windows\system32 on 32-bit systems,
where "C:" is your system disk.
Run the following command in the command prompt:
regtlib msdatsrc.tlb

Error Codes

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

Error Codes	Error	Description
9000	OUTOFMEMORY	There is not enough memory to continue the operation.
9001	INVALIDPARAMETER	Invalid parameter.
9002	PARAMETEROUTOFRANGE	Parameter out of range.
9003	INVALIDBITMAP	Invalid bitmap.
9004	UNABLEREADBITMAP	Unable to read bitmap.
9005	UNSUPPORTEDBCTYPE	Unsupported barcode type.
9006	INVALIDINDEX	Invalid index.
9007	INVALIDBARCODEVALUE	Invalid barcode value set.
9008	INSUFFICIENTWIDTH	Insufficient barcode width.
9009	INSUFFICIENTHEIGHT	Insufficient barcode height.
9010	UNABLECREATEUPCE	Unable to create UPC-E Barcode.
9011	INVALIDLICENSE	Invalid license.
9012	TIMEOUT	Timeout Error.
9013	IMAGENOTAVAILABLE	Image not available.
9014	INTERNALERROR	Internal error.
9015	INVALIDAREA	Area is outside required range.
9016	UNABLEREADCBBITMAP	A bitmap could not be retrieved from the clipboard.
9017	INVALIDDBDIMENSION	The clipboard image has invalid dimensions.
9018	UNABLEOPENCLIPBOARD	The clipboard could not be opened.
9019	HDIBNOTSET	The hDIB property was not set. Please set it or adjust the ImageSource property.
9020	PICTURENOTSET	The Picture property was not set. Please set it or adjust the ImageSource property.
9100	StatusPDF417EncodingError	PDF417 encoding error.
9101	StatusRowCountError	Invalid row count for the barcode type.
9102	StatusColumnCountError	Invalid column count for the barcode type.
9104	StatusLargeDataError	Barcode data too large for the barcode symbol size.
9105	StatusInvalidErrorCorrection	Error correction level is invalid.
9106	StatusErrorCorrectTooHigh	Error correction level is too high, will not fit in barcode symbol with the data.
9200	StreamParseException	An error was encountered while parsing the stream data in the ReadFromStream method.