1.0

SOFTWARE DEVELOPMENT KIT

Getting Started with Open eVisionAfter reading this Getting Started guide, you will know what actually constitutes the Open eVision SDK package, how to install the software, how to activate it, how to find your way in the documentation, how to build the sample programs and, last but not least, how to deploy them on other computers.

Step 1: Identify the CD components

The SDK is delivered on a CD, or downloadable from http://license.euresys.com, under the form of a few files:

• The Getting Started document (.pdf )• The Open eVision SDK -Software Development Kit- installation file (.exe)• The Open eVision Runtime installation file (.exe)

The Getting Started document is an electronic copy of this document. The two executable files are installation files that have to be run to install Open eVision respectively on development and deployment computers. Their use will be explained below.

Step 2: Install the Open eVision SDK on your development computer

Note: It is mandatory to install your IDE (from Microsoft or Borland) before installing the Open eVision SDK.

When inserting the CD in your computer, the Open eVision SDK installation file is automatically launched. If you have disabled the “autorun” Windows option or if you have downloaded the files from the web, you have to run the Open eVision SDK installation file (.exe) manually. Several dialog boxes appear and, after some time, the following window appears:

Click on the “Next” button. Carefully read the license agreement and click the accept button if you accept the terms. Then, click on the “Next” button.

The Open eVision License Manager is then automatically launched, and you can proceed to the next step.

Step 3: Activate the SDK

In order to be used, the Open eVision SDK has to be activated by the Open eVision License Manager (which is normally launched at the end of the previous step). For this purpose, your computer has to be connected to the Internet. However, if your computer is not connected to the Internet, it is possible to activate the Open eVision SDK by using “Offline Activation”, this procedure is explained in the help menu of the Open eVision License Manager. We will now explain the procedure to activate the Open eVision SDK assuming your computer is connected to the Internet. With your Open eVision SDK, you should have received, by e-mail, two activation IDs (alphanumeric strings of about 30 characters, beginning with “act-…”): • An activation ID for the “Open eVision SDK” , and

• An activation ID for the “Open eVision SDK (Auxiliary Computer)” In the following steps, you have to use the first activation ID (“Open eVision SDK”), which allows you to activate the Open eVision debug libraries, the Open eVision release libraries, and Open eVision Studio. Please do not use the other one (“Open eVision SDK (Auxiliary Computer)”) at this time. It is meant for a 2nd development platform where Open eVision Studio 1.0 will not be available.

Keep the typical option and click on the “Next” button.

Keep the default directory and click on the “Next” button.

Select Activate Open eVision License and click on the “Finish” button.

You should now see the Open eVision License Manager main window:

Your Open eVision SDK is now installed and ready to use on your development computer.

Click on the “Activate Licenses” button. Click on the “Online Activation” button.

Enter your activation ID. Be careful to enter the whole string, including the leading “act-…”

Fill the four fields with accurate information and click on the “Next” button.

The activation is successful. Click on the “Finish” button.

You can close this last window which is a summary of the items now activated on your computer.

Step 5: Install sample programs in a directory on your development computer

To install the sample programs, click on the “Sample Programs“ link on the Documentation entry page. The following page then appears.

Click on the blue “online” link in the Open eVision Sample Programs section as depicted in the above picture. Carefully follow the instructions on the displayed page to install, build and execute the sample programs.

Step 4: Find your way in the documentation

Access the documentation by selecting Windows Start Menu > All Programs > Euresys Open eVision SDK > Open eVision Documentation.The home page of the documentation appears and gives you access to the User Guide, the Reference Guides and the Sample Programs. Texts are hyperlinks you can click on to access the different topics.

Documentation home page with hyperlinks

Open eVision Sample Programs page

Step 6: Using Open eVision Studio

You can go further by modifying the sample programs. To ease your job, Open eVision Studio is an application that is installed with the Open eVision SDK and that allows you to generate the vision code you can paste in your own application (only available for the C++ and Visual Basic 6.0 languages).

Start Open eVision Studio by going to in the Windows Start Menu > All Programs > Euresys Open eVision SDK > Open eVision Studio.

When launched, the easiest way to get familiar with Open eVision Studio is to follow the trainings explained in the Training Assistant. The Training Assistant can be activated or deactivated in the Help menu:

Activating the Training Assistant (by default, at the first launch, the training assistant is activated)

To follow the Training Assistant, select a library (“EasyImage (1)” for instance) and then select the tutorial you want to follow (“Thresholding Function” for instance).

Training Assistant

Step 7: Deploy the Open eVision Runtime on other computers

The Open eVision Runtime installation file (.exe) described is step 1 is used to deploy Open eVision on other computers. This file can be copied on your deployment media (USB key or CD).

Run the Open eVision Runtime installation file (.exe) on the deployment computers. The screens that appear are similar to the screens in step 2. You can select between a full or a custom installation according to the IDE you are using for application development.

Activation of the Runtime libraries is similar to the activation of the Open eVision SDK but requires that you purchase a sufficient number of Activation IDs according to the number of computers on which you want to deploy Open eVision.

Note: Keep the second activation ID (“Open eVision SDK (Auxiliary Computer)”) delivered with your SDK for development purposes only.

More details about deployment can be found in the Open eVision Documentation > Open eVision User Guide > Installation > Deployment.

SOFTWARE DEVELOPMENT KIT Open eVision SDKTM 1.0 Including licenses for: • Open eVision 1.0 debug and release libraries, Open eVision Studio 1.0 for a development computer • Open eVision 1.0 debug and release libraries for an auxiliary computer

LIBRARIES EasyImageTM

EasyColorTM

EasyObjectTM

EasyMatchTM

EasyFindTM

EasyGaugeTM

EasyOCVTM

EasyOCRTM

EasyBarCodeTM

EasyMatrixCodeTM

For Microsoft Windows 2000®, XP®, Server 2003®

1.0

© Copyright 2008 Euresys s.a. Belgium. Euresys® is a registred trademark of Euresys s.a. Belgium. Other product and company names listed are trademarks or trade names of their respective manufacturers. Euresys reserves the right to modify product specifications and price without previous notice.

www.euresys.com