Decode Methods

DecodeFile

Decode barcodes from a specified image file.

int dynamsoft::dbr::CBarcodeReader::DecodeFile (const char* pFileName, const char* pTemplateName = "")	

Parameters
[in] pFileName A string defining the file name. It supports BMP, JPEG, PNG, TIFF and PDF files.
[in] pTemplateName_Optional The template name.

Return Value
Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString to get detailed error message.

Code Snippet

CBarcodeReader* reader = new CBarcodeReader();
reader->InitLicense("t0260NwAAAHV***************");
int errorCode = reader->DecodeFile("C:\\Program Files (x86)\\Dynamsoft\\{Version number}\\Images\\AllSupportedBarcodeTypes.tif", "");
delete reader;

Remarks
If no template name is specified, current runtime settings will be used.

DecodeFileInMemory

Decode barcodes from an image file in memory.

int dynamsoft::dbr::CBarcodeReader::DecodeFileInMemory (const unsigned char* pFileBytes, int fileSize, const char* pTemplateName = "")	

Parameters
[in] pFileBytes The image file bytes in memory.
[in] fileSize The length of the file bytes in memory.
[in] pTemplateName_Optional The template name.

Return Value
Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString() to get detailed error message.

Code Snippet

CBarcodeReader* reader = new CBarcodeReader();
reader->InitLicense("t0260NwAAAHV***************");
unsigned char* pFileBytes;
int nFileSize = 0;
GetFileStream("C:\\Program Files (x86)\\Dynamsoft\\{Version number}\\Images\\AllSupportedBarcodeTypes.tif", &pFileBytes, &nFileSize);
int errorCode = reader->DecodeFileInMemory(pFileBytes, nFileSize, "");
delete reader;

Remarks
If no template name is specified, current runtime settings will be used.

DecodeBuffer

Decode barcodes from the memory buffer containing image pixels in defined format.

int dynamsoft::dbr::CBarcodeReader::DecodeBuffer (const unsigned char* pBufferBytes, const int iWidth, const int iHeight, const int iStride, const ImagePixelFormat format, const char* pszTemplateName = "")		

Parameters
[in] pBufferBytes The array of bytes which contain the image data.
[in] iWidth The width of the image in pixels.
[in] iHeight The height of the image in pixels.
[in] iStride The stride (or scan width) of the image.
[in] format The image pixel format used in the image byte array.
[in] pTemplateName_Optional The template name.

Return Value
Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString to get detailed error message.

Code Snippet

CBarcodeReader* reader = new CBarcodeReader();
reader->InitLicense("t0260NwAAAHV***************");
unsigned char* pBufferBytes;
int iWidth = 0;
int iHeight = 0;
int iStride = 0;
ImagePixelFormat format;
GetBufferFromFile("C:\\Program Files (x86)\\Dynamsoft\\{Version number}\\Images\\AllSupportedBarcodeTypes.tif", &pBufferBytes, &iWidth, &iHeight, &iStride, &format);
int errorCode = reader->DecodeBuffer(pBufferBytes, iWidth, iHeight, iStride, format, "");
delete reader;

Remarks
If no template name is specified, current runtime settings will be used.

DecodeBase64String

Decode barcode from an image file encoded as a base64 string.

int dynamsoft::dbr::CBarcodeReader::DecodeBase64String (const char* pBase64String, const char* pTemplateName = "")	

Parameters
[in] pBase64String A base64 encoded string that represents an image.
[in] pTemplateName_Optional The template name.

Return Value
Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString to get detailed error message.

Code Snippet

CBarcodeReader* reader = new CBarcodeReader();
reader->InitLicense("t0260NwAAAHV***************");
unsigned char* pFileBytes;
int nFileSize = 0;
GetFileStream("C:\\Program Files (x86)\\Dynamsoft\\{Version number}\\Images\\AllSupportedBarcodeTypes.tif", &pFileBytes, &nFileSize);
char* strBase64String;
GetFileBase64String(pBufferBytes, &strBase64String);
int errorCode = reader->DecodeBase64String(strBase64String, "");
delete reader;

Remarks
If no template name is specified, current runtime settings will be used.

DecodeDIB

Decode barcode from a handle of device-independent bitmap (DIB).

int dynamsoft::dbr::CBarcodeReader::DecodeDIB (const HANDLE hDIB, const char* pszTemplateName = "")	

Parameters
[in] hDIB Handle of the device-independent bitmap.
[in] pTemplateName_Optional The template name.

Return Value
Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString to get detailed error message.

Code Snippet

CBarcodeReader* reader = new CBarcodeReader();
reader->InitLicense("t0260NwAAAHV***************");
HANDLE pDIB;
GetDIBFromImage("C:\\Program Files (x86)\\Dynamsoft\\{Version number}\\Images\\AllSupportedBarcodeTypes.tif", &pDIB);
int errorCode = reader->DecodeDIB(pDIB "");
delete reader;

Remarks
If no template name is specified, current runtime settings will be used.

InitIntermediateResult

Inits an intermediateResult struct with default values.

int dynamsoft::dbr::CBarcodeReader::InitIntermediateResult(IntermediateResultType intermediateResultType, IntermediateResult* pIntermediateResult)	

Parameters
[in] intermediateResultType The type of the intermediate result to init.
[in, out] pIntermediateResult The intermediate result struct.

Return Value
Returns error code (returns 0 if the function operates successfully).
You can call DBR_GetErrorString to get detailed error message.

Code Snippet

IntermediateResult imResult;
dynamsoft::dbr::CBarcodeReader::InitIntermediateResult(IRT_ORIGINAL_IMAGE, &imResult);

DecodeIntermediateResults

Decodes barcode from intermediate results.

int dynamsoft::dbr::CBarcodeReader::DecodeIntermediateResults(const IntermediateResultArray *pIntermediateResultArray, const char* pTemplateName = "")	

Parameters
[in] pIntermediateResultArray The intermediate result array for decoding.
[in] pTemplateName_Optional The template name.

Return Value
Returns error code (returns 0 if the function operates successfully).
You can call DBR_GetErrorString to get detailed error message.

Code Snippet

CBarcodeReader * reader = new CBarcodeReader();
char fileName[] = "Your barcode file";

PublicRuntimeSettings settings;
reader->GetRuntimeSettings(&settings);
settings.intermediateResultTypes = IRT_ORIGINAL_IMAGE;
reader->UpdateRuntimeSettings(&settings);
reader->DecodeFile(fileName, "");
IntermediateResultArray * imResults = NULL;
reader->GetIntermediateResults(&imResults);
reader->DecodeIntermediateResults(imResults, "");
TextArray * results = NULL;
reader->GetAllTextResults(&results);