Result Methods
Method | Description |
---|---|
GetAllTextResults |
Get all recognized barcode results. |
FreeTextResults |
Free memory allocated for text results. |
GetIntermediateResults |
Get intermediate results. |
FreeIntermediateResults |
Free memory allocated for the intermediate results. |
GetAllTextResults
Get all recognized barcode results.
int dynamsoft::dbr::CBarcodeReader::GetAllTextResults (TextResultArray** pResults)
Parameters
[out] pResults
TextResultArray
returned by the last called function DecodeFile
/ DecodeFileInMemory
/ DecodeBuffer
/ DecodeBase64String
/ DecodeDIB
. The pResults
is allocated by the SDK and should be freed by calling the function FreeTextResults
.
Return Value
Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString
to get detailed error message.
Code Snippet
char errorBuf[512];
dynamsoft::dbr::CBarcodeReader::InitLicense("YOUR-LICENSE-KEY", errorBuf, 512);
CBarcodeReader* reader = CBarcodeReader::GetInstance();
if(reader != NULL)
{
TextResultArray* pResults;
int errorCode = reader->DecodeFile("C:\\Program Files (x86)\\Dynamsoft\\{Version number}\\Images\\AllSupportedBarcodeTypes.tif", "");
reader->GetAllTextResults(&pResults);
dynamsoft::dbr::CBarcodeReader::FreeTextResults(&pResults);
// add further process
reader->Recycle();
}
FreeTextResults
Free memory allocated for text results.
static void dynamsoft::dbr::CBarcodeReader::FreeTextResults (TextResultArray** pResults)
Parameters
[in] pResults
Text results.
Code Snippet
char errorBuf[512];
dynamsoft::dbr::CBarcodeReader::InitLicense("YOUR-LICENSE-KEY", errorBuf, 512);
CBarcodeReader* reader = CBarcodeReader::GetInstance();
if(reader != NULL)
{
TextResultArray* pResults;
int errorCode = reader->DecodeFile("C:\\Program Files (x86)\\Dynamsoft\\{Version number}\\Images\\AllSupportedBarcodeTypes.tif", "");
reader->GetAllTextResults(&pResults);
dynamsoft::dbr::CBarcodeReader::FreeTextResults(&pResults);
// add further process
reader->Recycle();
}
GetIntermediateResults
Get intermediate results containing the original image, the colour clustered image, the binarized Image, contours, Lines, TextBlocks, etc.
int dynamsoft::dbr::CBarcodeReader::GetIntermediateResults (IntermediateResultArray** pResults)
Parameters
[out] pResults
The intermediate results returned by the SDK.
Return Value
Returns error code (returns 0 if the function operates successfully).
You can call GetErrorString
to get detailed error message.
Code Snippet
char errorBuf[512];
dynamsoft::dbr::CBarcodeReader::InitLicense("YOUR-LICENSE-KEY", errorBuf, 512);
CBarcodeReader* reader = CBarcodeReader::GetInstance();
if(reader != NULL)
{
PublicRuntimeSettings* pSettings = new PublicRuntimeSettings;
reader->GetRuntimeSettings(pSettings);
pSettings->intermediateResultTypes = IRT_ORIGINAL_IMAGE | IRT_COLOUR_CLUSTERED_IMAGE | IRT_COLOUR_CONVERTED_GRAYSCALE_IMAGE;
char errorMessage[256];
reader->UpdateRuntimeSettings(pSettings, errorMessage, 256);
reader->DecodeFile("C:\\Program Files (x86)\\Dynamsoft\\{Version number}\\Images\\AllSupportedBarcodeTypes.tif", "");
IntermediateResultArray* pResults = NULL;
reader->GetIntermediateResults(&pResults);
dynamsoft::dbr::CBarcodeReader::FreeIntermediateResults(&pResults);
delete pSettings;
// add further process
reader->Recycle();
}
FreeIntermediateResults
Free memory allocated for the intermediate results.
static void dynamsoft::dbr::CBarcodeReader::FreeIntermediateResults (IntermediateResultArray** pResults)
Parameters
[in] pResults
The intermediate results.
Code Snippet
char errorBuf[512];
dynamsoft::dbr::CBarcodeReader::InitLicense("YOUR-LICENSE-KEY", errorBuf, 512);
CBarcodeReader* reader = CBarcodeReader::GetInstance();
if(reader != NULL)
{
PublicRuntimeSettings* pSettings = new PublicRuntimeSettings;
reader->GetRuntimeSettings(pSettings);
pSettings->intermediateResultTypes = IRT_ORIGINAL_IMAGE | IRT_COLOUR_CLUSTERED_IMAGE | IRT_COLOUR_CONVERTED_GRAYSCALE_IMAGE;
char errorMessage[256];
reader->UpdateRuntimeSettings(pSettings, errorMessage, 256);
reader->DecodeFile("C:\\Program Files (x86)\\Dynamsoft\\{Version number}\\Images\\AllSupportedBarcodeTypes.tif", "");
IntermediateResultArray* pResults = NULL;
reader->GetIntermediateResults(&pResults);
dynamsoft::dbr::CBarcodeReader::FreeIntermediateResults(&pResults);
delete pSettings;
// add further process
reader->Recycle();
}