Thanks for downloading Dynamsoft Label Recognizer Package!

Your download will start shortly. If your download does not begin, click here to retry.

User Guide - C

User Guide - C

Requirements

Windows
- Windows 7, 8, 10, 2003, 2008, 2008 R2, 2012.
- Visual Studio 2008 or above
Linux
- Linux x64: Ubuntu 14.04.4+ LTS, Debian 8+, etc
- GCC 4.2+

Installation

If you don’t have SDK yet, please go to Dynamsoft website to get it. Once the folder is decompressed, the root directory of the DLR installation package is DynamsoftLabelRecognizer, which we will refer to as [INSTALLATION FOLDER] throughout this guide.

Build Your First Application

Let’s start by creating a console application which demonstrates how to use the minimum code to recognize text from an image file.

You can download the complete source code referenced in this guide from here.

Create A New Project

For Windows

Open Visual Studio. Go to File > New > Project, select Empty App and enter HelloWorld in the name text box.
Add a new source file named HelloWorld.c into the project.

For Linux

Create a new source file named HelloWorld.c and place it into the folder [INSTALLATION FOLDER]\Samples\C\HelloWorld.

Create a file named Makefile and put it in the same directory as the file HelloWorld.c. The content of Makefile is as follows:

 CC=gcc
 CCFLAGS=-c

 DLRMODEL_PATH=../../../CharacterModel
 DLRLIB_PATH=../../../Lib/Linux/x64
 LDFLAGS=-L $(DLRLIB_PATH) -Wl,-rpath=$(DLRLIB_PATH) -Wl,-rpath=./
 DLRLIB=-lDynamsoftLabelRecognizer -lDynamsoftCore

 TARGET=HelloWorld
 OBJECT=HelloWorld.o
 SOURCE=HelloWorld.c

 # build rule for target.
 $(TARGET): $(OBJECT)
     $(CC) -o $(TARGET) $(OBJECT) $(DLRLIB) $(LDFLAGS)
     cp -r $(DLRMODEL_PATH) $(DLRLIB_PATH)

 # target to build an object file
 $(OBJECT): $(SOURCE)
     $(CC) $(CCFLAGS) $(SOURCE)

 # the clean target
 .PHONY : clean
 clean: 
     rm -f $(OBJECT) $(TARGET) -r $(DLRLIB_PATH)/CharacterModel

Note: The DLRLIB_PATH variable should be set to the correct directory where the DLR library files are located. The files and character models directory can be found in [INSTALLATION FOLDER]/Lib/Linux/x64.

Include the Label Recognizer Library

Add headers and libs in HelloWorld.c.

 #include <stdio.h>
 #include "<relative path>/Include/DynamsoftLabelRecognizer.h"

 // The following code only applies to Windows.
 #if defined(_WIN64) || defined(_WIN32)
     #ifdef _WIN64
         #pragma comment(lib, "<relative path>/Lib/Windows/x64/DynamsoftLabelRecognizerx64.lib")
         #pragma comment(lib, "<relative path>/Lib/Windows/x64/DynamsoftCorex64.lib")
     #else
         #pragma comment(lib, "<relative path>/Lib/Windows/x86/DynamsoftLabelRecognizerx86.lib")
         #pragma comment(lib, "<relative path>/Lib/Windows/x86/DynamsoftCorex86.lib")
     #endif
 #endif

Please replace <relative path> in the above code with the relative path to the HelloWorld.c file. The DynamsoftLabelRecognizer.h file can be found in [INSTALLATION FOLDER]/Include/ folder. The import lib files (only for Windows) can be found in [INSTALLATION FOLDER]/Lib/Windows/[platforms].

Initialize the Label Recognizer

Initialize the license key
```
 char error[512];
    
 // 1.Initialize license.
 DC_InitLicense("DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9", error, 512);
```
Note:
- Network connection is required for the license to work.
- “DLS2***” is a default free public trial license used in the sample.
- If the license has expired, please request a trial license through the customer portal.

Create an instance of Dynamsoft Label Recognizer

 // 2.Create an instance of Label Recognizer.
 void* dlr = DLR_CreateInstance();

Recognition Process and How to Use the Results

Recognizing text in an image
```
 // 3.Recognize text from an image file.
 errorcode = DLR_RecognizeFile(dlr, "../../../Images/dlr-sample-vin.png", "");
    
 if(errorcode != DM_OK)
     printf("%s\n", DLR_GetErrorString(errorcode));
```
You can download the image dlr-sample-vin.png for testing. In addition, you can replace it with the full path of the image you want to recognize. For the error handling mechanism, the SDK returns Error Code for each function and provides a function DLR_GetErrorString to get the readable message. You should add codes for error handling based on your needs. Check out Error Code for full supported error codes.

Get and output the recognition results

 DLR_ResultArray *pDLRResults = NULL;
 DLR_Result* result = NULL;
 DLR_LineResult *lineResult = NULL;
 int lCount, rCount, li, ri;

 // 4. Get all recognized results.
 DLR_GetAllResults(dlr, &pDLRResults);

 if (pDLRResults != NULL && pDLRResults->resultsCount > 0)
 {
     rCount = pDLRResults->resultsCount;
     for (ri = 0; ri < rCount; ++ri)
     {
         printf("Result %d:\n", ri);

         // Get result of each text area (also called label).
         result = pDLRResults->results[ri];
         lCount = result->lineResultsCount;
         for (li = 0; li < lCount; ++li)
         {
             // Get the result of each text line in the label.
             lineResult = result->lineResults[li];
             printf("Line result %d: %s\n", li, lineResult->text);
         }
     }
 }
 else
 {
     printf("No data detected.\n");
 }

The recognition results of SDK are organized into a four-tier structure:

DLR_ResultArray corresponds to the results of an image
DLR_Result corresponds to the result of a TextArea (also called Label)
DLR_LineResult corresponds to the result of each TextLine in the Label
DLR_CharacterResult corresponds to the result of each Character in the TextLine

The structure is shown in the figure below:

Figure 1 – DLR Result Structure

Release Allocated Memory

Release the allocated memory for the recognition results and instance

 if(pDLRResults != NULL)           
     DLR_FreeResults(&pDLRResults);
    
 DLR_DestroyInstance(dlr);

You can download the similar complete source code from Here.

Build and Run the Project

On windows

Build the application through Visual Studio.
Copy the related DLL files to the same folder as the EXE file. The DLL files can be found in [INSTALLATION FOLDER]\Lib\Windows\[platforms]

Note: Select the corresponding folder (x86 or x64) based on your project’s platform setting.
Copy the [INSTALLATION FOLDER]\CharacterModel directory to the same folder as the EXE file.
Run the program HelloWorld.exe.

On Linux

Open a terminal and change to the target directory where Makefile located in. Build the sample:
```
 >make
```
Run the program HelloWorld.
```
 >./HelloWorld
```