Release Notes Open eVision 1 - Euresysdownloads.euresys.com/PackageFiles/OPENEVISION/1.0... ·...

Release Notes Open eVision 1.0

Copyright EURESYS s.a. 2007 /28

Release Notes Open eVision 1.0

July 20, 2007

DISCLAIMER

EURESYS s.a. shall retain all property rights, title and interest of the documentation of the hardware and the software, and of the trademarks of EURESYS s.a.

All the names of companies and products mentioned in the documentation may be the trademarks of their respective owners.

The licensing, use, leasing, loaning, translation, reproduction, copying or modification of the hardware or the software, brands or documentation of EURESYS s.a. contained in this book, is not allowed without prior notice.

EURESYS s.a. may modify the product specification or change the information given in this documentation at any time, at its discretion, and without prior notice.

EURESYS s.a. shall not be liable for any loss of or damage to revenues, profits, goodwill, data, information systems or other special, incidental, indirect, consequential or punitive damages of any kind arising in connection with the use of the hardware or the software of EURESYS s.a. or resulting of omissions or errors in this book.

Release Notes Contents Open eVision 1.0


Contents

1. Open eVision ............................................................................................................................. 3 1.1. Open eVision Introduction .................................................................................................... 3

Introduction .............................................................................................................................. 3 Distributions ............................................................................................................................. 3 Libraries ................................................................................................................................... 4 Supported OS .......................................................................................................................... 4 Supported IDE ......................................................................................................................... 4

1.2. Open eVision Licensing ........................................................................................................ 5 New licensing scheme ............................................................................................................. 5 eVision 6.x licenses ................................................................................................................. 5 Open eVision licenses ............................................................................................................. 5

1.3. EasyMultiCam ...................................................................................................................... 6 EasyMultiCam distribution........................................................................................................ 6 C++ and .NET acquisition functions ......................................................................................... 6 Translation functions between Open eVision and MultiCam ..................................................... 6 Versions compatibility .............................................................................................................. 7

1.4. Open eVision 1.0 Key Points ................................................................................................ 8 EJpegHandler class distribution ............................................................................................... 8 VideoStorage distribution ......................................................................................................... 8 Demonstration tool ................................................................................................................... 8 Open eVision Basic Types ....................................................................................................... 8 New Open eVision .NET documentation .................................................................................. 8 Open eVision sample programs ............................................................................................... 8 EasyAVI distribution ................................................................................................................. 8 EasyMeasure obsolescence .................................................................................................... 9 EasyBGA obsolescence .......................................................................................................... 9

2. Fixes Since eVision 6.7.1 ........................................................................................................ 10 2.1. Open eVision 1.0 ................................................................................................................ 10 2.2. Fixes and Improvements of this Release ............................................................................ 11 2.3. Fixes and Improvements Released in Intermediary Patches .............................................. 14

General Purpose .................................................................................................................... 14 Open eVision Basic Types ..................................................................................................... 14 EasyImage ............................................................................................................................. 15 EasyFind ................................................................................................................................ 16 EasyGauge ............................................................................................................................ 17 EasyBarCode......................................................................................................................... 19 EasyMatrixCode .................................................................................................................... 20 EasyObject ............................................................................................................................ 21 EasyOCR ............................................................................................................................... 22 EasyOCV ............................................................................................................................... 23 C++ ........................................................................................................................................ 24 .NET ...................................................................................................................................... 25 ActiveX .................................................................................................................................. 26

Release Notes Open eVision Open eVision 1.0


1. Open eVision

1.1. Open eVision Introduction

Introduction

From now on, the eVision libraries and tools are distributed under the name Open eVision.

This first release is numbered Open eVision 1.0.

Distributions

Open eVision is distributed as 2 installation files:

The Open eVision SDK for installation on development computers.

The Open eVision Runtime for installation on deployment computers.

Open eVision SDK

The Open eVision SDK will be installed on the development computers. It contains all Open eVision components including sample images and documentation.

Running the Open eVision SDK installation file will install on the computer some or all of the following components, according to your selection:

C/C++ headers and libraries,

.NET assemblies,

ActiveX controls,

Open eVision Studio,

Open eVision Documentation,

Sample Images,

Open eVision License Manager.

Open eVision Runtime

The Open eVision Runtime will be installed on the deployment computers that run your applications. It only includes the components mandatory to use Open eVision libraries.

Running the Open eVision Runtime installation file will install on the computer some or all of the following components, according to your selection:

C/C++ libraries,

.NET assemblies,

ActiveX controls,

Open eVision License Manager,



Libraries

Open eVision 1.0 includes the following libraries:

EasyImage

EasyColor

EasyObject

EasyMatch

EasyFind

EasyGauge

EasyOCR

EasyOCV

EasyBarCode

EasyMatrixCode

Supported OS

The following table summarizes all currently supported OS.

OS Version Additional Information

Windows Server 2003 32-bit Service Pack 1

Windows XP 32-bit Service Pack 2

Windows 2000 — Service Pack 4

Supported IDE

The following table summarizes all currently supported IDE.

Using Open eVision with C++

Microsoft Visual C++ 2005

Microsoft Visual C++ .NET 2003

Microsoft Visual C++ 6.0

Borland C++ Builder 2006

Borland C++ Builder 6.0

Using Open eVision with .NET

Microsoft Visual C# 2005

Microsoft Visual C# .NET 2003

Using Open eVision with ActiveX

Microsoft Visual Basic 6.0

Borland Delphi 2006

Borland Delphi 6.0



1.2. Open eVision Licensing

New licensing scheme

Open eVision 1.0 introduces a new libraries licensing scheme. This licensing uses a software-only node-locking scheme and supports Internet-based activation rather than the previous hardware-based key storage.

eVision 6.x licenses

The licenses stored on Euresys frame grabbers, in dongles or with a host-pc key are no longer supported and cannot be used with Open eVision.

Open eVision licenses

Activation

Since Open eVision, there is only one license mean available. After a license order, the user will receive one or several activation ID. He must then activate his license through the Open eVision License Manager application installed with Open eVision.

Refer to the “Getting Started” document or the “Open eVision User Guide” chapter in the documentation for more information about license activation procedures.

Application

Once a licence is activated on a computer, no more processing is required. Applications running Open eVision code do not need any modification in regards with the licensing.



1.3. EasyMultiCam

EasyMultiCam distribution

The EasyMultiCam library has been removed from Open eVision. The MultiCam C++ and .NET functions are distributed with MultiCam while the translation functions used to transfer data to and from Open eVision, are available with the sample programs.

C++ and .NET acquisition functions

The C++ and .NET functions that were part of EasyMultiCam are distributed with MultiCam. They are presented in the MultiCam 6.0 documentation, in the MultiCam C++/.NET Reference book.

The changes with EasyMultiCam are the distribution and include files and the translation functions that are distributed separately. Apart from this, applications using EasyMultiCam do not require code modification.

C++ Requirements

Header: MultiCamCpp.h

Namespace: Euresys::MultiCam

Platforms: Windows 2000, Windows XP, Windows Server 2003, Linux Suse 10.0

C# Requirements

Assembly: Multicam.clr.dll

Namespace: Euresys.MultiCam

Platforms: Windows 2000, Windows XP, Windows Server 2003

Translation functions between Open eVision and MultiCam

EasyMultiCam also exposed the translation functions used to transfer data in applications between MultiCam image acquisition functions and Open eVision image processing functions.

From now on, these functions are distributed and documented as source code in specific sample programs besides Open eVision and MultiCam.

These functions are:

CreateImageBW8

CreateImageBW16

CreateImageC15

CreateImageC16

CreateImageC24

CreateImageC24A

CreateSurface

UpdateImageConfig



Versions compatibility

C++ and .NET applications acquiring images with MultiCam 6.0 functions will be able to transfer data to and from Open eVision with the translation functions provided with MultiCam 6.0 sample programs.

Transfer of images between C++ and .NET applications acquiring images with MultiCam 5.x functions and Open eVision are not supported.



1.4. Open eVision 1.0 Key Points

EJpegHandler class distribution

In C++ and .NET environments, the EJpegHandler class has been removed from Open eVision.

It is now available on the Euresys Internet server along with a dedicated sample program for MultiCam 6.0.

The ActiveX control is still included with Open eVision, without any modification since the previous release.

VideoStorage distribution

In C++ and .NET environments, VideoStorage has been removed from Open eVision. It is replaced by a MultiCam sample program that shows how to create video files from MultiCam surfaces.

The ActiveX control, is still included with Open eVision without modification since previous release.

Demonstration tool

The Open eVision libraries demonstration tool, previously known as EasyAccess, has been renamed Open eVision Studio.

Open eVision Basic Types

“Open eVision Basic Types” is the new name for common features that do not require license and that were previously grouped under the name “Easy library”.

New Open eVision .NET documentation

Open eVision .NET interface is distributed with a new documentation, the “Open eVision .NET Reference”, a new book that is part of the Open eVision documentation.

Open eVision sample programs

The Open eVision sample programs are now distributed as a package, independently of the libraries. The sample program topic in the documentation links directly to the relevant page on Euresys website.

EasyAVI distribution

Included in the program samples are programs using EasyAVI and the EImageSequence class. This class and its functions were previously documented in eVision. They are now documented in a dedicated file available with the sample programs.



EasyMeasure obsolescence

The EasyMeasure library is superseded by the EasyGauge library. It has been removed from Open eVision.

EasyBGA obsolescence

The EasyBGA library is obsolete and has been removed from Open eVision.

License Mediator obsolescence

The License Mediator library is obsolete and has been removed from Open eVision.

Release Notes Fixes Since eVision 6.7.1 Open eVision 1.0


2. Fixes Since eVision 6.7.1

2.1. Open eVision 1.0

Open eVision and eVision

From now on, the eVision libraries and tools are distributed under the name Open eVision. This first release is numbered Open eVision 1.0.

As Open eVision 1.0 is the successor of eVision 6.7.1, this chapter lists the issues solved since eVision 6.7.1, the last major release.

EasyBGA Obsolescence

EasyBGA is obsolete and has been removed from Open eVision distribution. So, the corrections made to this library have been removed from this document.

EasyMultiCam

EasyMultiCam is not distributed as part of Open eVision anymore. So the corrections made to it have been removed from this document.



2.2. Fixes and Improvements of this Release

Open eVision images storage format

Images were stored in buffers with a pitch padded to the nearest multiple of 24 bytes. This pitch is now padded to become a multiple of 4 bytes to improve image buffer compatibility with other libraries.

EasyAccess did not generate code for some features of EasyOCV

EasyAccess, now called Open eVision Studio, did not generate the code when the Location Score parameter value was changed in EasyOCV.

The EasyObject SelectObjectByPosition function did not work properly

In EasyObject, the SelectObjectByPosition function did not work properly and did not always return the right object.

Misspelling in an EasyObject enum in the .NET API

In EasyObject, some of Euresys.eVision.EasyObject.SelectOption enum values in the .NET API were misspelled. The correct values are InsertGreaterOrEqual and RemoveGreaterOrEqual.

Missing methods in the .NET API

The EasyMatch CreateBW8PatternCopy and CreateC24PatternCopy methods were missing in the .NET API.

The basic Distance (Euresys.eVision.Rectangle rect) and the Distance (Euresys.eVision.Rectangle rect, bool edge) methods were missing in .NET API.

In EasyMatch, the ScaleX property had incorrect settings

In EasyMatch, the ScaleX property was read-only. It can now by written and read as other similar properties.

Removal of old classes

In EasyFind, the old C++ EFind class, superseded by the PatternFinder and FoundPattern classes, has been removed.

In EasyMatrixCode, the old EMatrixCode class, superseded by the MatrixCode and the MatrixCodeReader classes, has been removed.

Removal of old ActiveX controls

In EasyFind, the old EasyFind ActiveX superseded by the PatternFinder and the FoundPatternArray controls, has been removed.

In EasyMatrixCode, the old EasyMatrixCode ActiveX superseded by the MatrixCode and the MatrixCodeReader controls, has been removed.



Removal of .NET indexed properties

The few indexed properties that were available in the eVision .NET interface have been converted to regular getters and setters so:

- a = someObject.PropName[index] becomes a = GetPropName(index)

- someObject.PropName[index] = a becomes someObject.SetPropName(index,a)

- EOCV::m_Texts has been suppressed. It is now accessed through the EOCV::GetText and EOCV::SetText methods.

Some properties and enumerations have been changed

In EasyFind, the PatternFinder.CoarseStage and PatternFinder.FineStage properties have been removed. Instead of these properties, use ReductionMode and ReductionStrength. See the documentation for more information.

In EasyOCV, the EOCV::m_Objects static member variable, that used undocumented types, has been removed.

In EasyMatrixCode, The LearnParams property has been renamed LearnParam.

In the EChecker C++object, the m_Low, m_High and m_Registered variables have been transformed in methods (GetLow, GetHigh and GetRegistered).

In C++, the ESerializer::FileWriterMode enum has been moved out of the class (and brought into global namespace). Its name has been changed to E_SERIALIZER_FILEWRITER_MODE and its values have been changed to : enum E_SERIALIZER_FILEWRITER_MODE { E_SERIALIZER_CREATE, E_SERIALIZER_OVERWRITE, E_SERIALIZER_APPEND };

In C++, the ESerializer::ObjectType enum has been moved out of the class (and brought into global namespace). Its name has been changed to E_SERIALIZER_OBJECT_TYPE and its values have been changed to: enum E_SERIALIZER_OBJECT_TYPE

{

E_SERIALIZER_EndOfArchive,

E_SERIALIZER_NotSerializable,

E_SERIALIZER_EMatch = 0x20,

E_SERIALIZER_EImageBW1,




E_SERIALIZER_EImageC15,





E_SERIALIZER_EImageYUY2,

E_SERIALIZER_EImageC24A,

E_SERIALIZER_EImageSubPixel64,

E_SERIALIZER_EImageComplex64,

E_SERIALIZER_EImageRaw32,

E_SERIALIZER_EImageRaw96,

E_SERIALIZER_EROIBW1,




E_SERIALIZER_EROIC15,



E_SERIALIZER_EROIYUY2,

E_SERIALIZER_EROIC24A,

E_SERIALIZER_EROISubPixel64,

E_SERIALIZER_EROIComplex64,

E_SERIALIZER_EROIRaw32,

E_SERIALIZER_EROIRaw96,

E_SERIALIZER_EJpegHandler,

E_SERIALIZER_Unknown = 0xffffffff

};

In EasyMatch, parallel processing slower

In EasyMatch, running 2 matching processes in parallel in 2 different threads could be slower than serial processing in a single thread.

LoaderLock warning message

When developing with our .NET components, under Visual Studio 2005, an abnormal (but benign) condition called LoaderLock is detected by the debugger (only in debug mode) at program start time and causes a warning message to be displayed. That warning message can easily (and selectively) be disabled.

See the Using the Open eVision Libraries with .NET topic in Open eVision .NET Reference for more information.



2.3. Fixes and Improvements Released in Intermediary Patches

General Purpose

Fixes

Under some specific circumstances, calling eVision methods from different threads in the same process, on a multi-core or multi-processor machine, could lead to a significant processing time increase

This malfunction is solved since eVision 6.7.1 Patch ZD.

(note : this is a separate problem from the one described below that has been fixed since eVision 6.7.1 Patch ZC).

The processing time had increased when multithreading on dual CPU computers since last release. The execution time when using multiple threads with eVision 6.7.1 was longer than with eVision 6.7.

This malfunction is solved since eVision 6.7.1 Patch C.

Open eVision Basic Types

Fixes

The relative position of the mouse pointer was not accurate when quickly dragging thin ROIs.

This malfunction is solved since eVision 6.7.1 Patch L.



EasyImage

Fixes

In EasyImage, using the ImgDistance function with ActiveX, either returned an access violation or an incorrect distance measurement, depending on the image size.

This malfunction is solved since eVision 6.7.1 Patch Z.



EasyFind

Features

New methods and properties used to enable or disable drawing options have been added to the FoundPattern class:

In C++ :

The FoundPattern structure owns three new properties:

BOOL DrawCenter: tells whether the draw method must draw the center of the FoundPattern. The default value is TRUE.

BOOL DrawBoundingBox: tells whether the draw method must draw the bounding box of the FoundPattern instance. The default value is TRUE.

BOOL DrawFeaturePoints: tells whether the draw method must draw the feature points of the FoundPattern. The default value is FALSE.

The current FoundPattern::Draw method becomes obsolete and is superseded by the following new method:

FoundPattern::Draw(HDC hDC, FLOAT32 zoomX = 1.f, FLOAT32 zoomY = 0.f, FLAOT32 panX = 0.f, panY = 0.f)

This method draws different features of the FoundPattern according to the value of the three above properties.

In ActiveX:

The FoundPatternArray control has three new properties similar as the C++ ones. The three properties apply to the current pattern, just like the DrawCurrentPattern method.

The DrawCurrentPatternWithEdges method becomes obsolete and is superseded by the properties described above.

This improvement is available since eVision 6.7.1 Patch W.

Fixes

When the PatternFinder.LocalSearchMode parameter was changed from

the default value, EasyFind did not always interpolate with sub-pixel precision.

This malfunction is solved since eVision 6.7.1 Patch ZD.

There were some rare issues with the backwards compatibility of EasyFind models. These have been fixed.




EasyGauge

Features

In EWorldShape, the robustness of the automatic calibration has been improved.

This improvement is available since eVision 6.7.1 Patch C.

Fixes

Some EasyGauge methods and properties return Euresys.eVision.Shape objects. In .NET environment, It was not possible to cast these objects into other objects such as FrameShape, PointGauge or CircleGauge.

This malfunction is solved since eVision 6.7.1 Patch ZC.

A system exception was sporadically raised and not properly handled by eVision in the EasyGauge library under .NET.

This malfunction is solved since eVision 6.7.1 Patch ZB.

In some cases, the learning process missed some significant edges or erroneously used non-significant edges, which led to subsequent problems in the finding process.

This malfunction is solved since eVision 6.7.1 Patch W.

There were some issues in the way outliers were rejected when using an EWedgeGauge.

This malfunction is solved since eVision 6.7.1 Patch O.

The wedge circle was sometimes incorrectly fit.


The SetAmplitude() method of the CircleGauge object accepted only angle values in Radians.

This malfunction is solved since eVision 6.7.1 Patch I.

The drawing of Wedge and Circle Gauges attached to a FrameShape could be incorrect if the gauges were partial (not forming a full circle).

This malfunction is solved since eVision 6.7.1 Patch G.

The zooming and pan factors are no longer saved with the other parameters in the model files.

This malfunction is solved since eVision 6.7.1 Patch E.



In EWorldShape, when saving an EWorldShape and its attached gauges

calibrated using the bilinear or quadratic empirical modes, the calibration coefficients were not correctly saved.




EasyBarCode

Fixes

After decoding a barcode with the Code93 symbology, EasyBarCode erroneously reported the checksum as incorrect.

This malfunction is solved since eVision 6.7.1 Patch ZC.



EasyMatrixCode

Features

New methods and properties used to retrieve data not coded as ASCII characters

from a matrix code have been added to the MatrixCode object:

In C++: Vector<UINT8> MatrixCode::DecodedData

In ActiveX: MatrixCode.GetDecodedData(index As Long) As Integer

MatrixCode.DecodedDataLength As Long

In .NET: System.Int16 MatrixCode.DecodedDataElement[System.Int32 index]

System.Int32 MatrixCode.DecodedDataLength

For more information, see the “Documentation Update since CD2006-1.pdf” document.

This improvement is available since eVision 6.7.1 Patch A.

Fixes

Some specific MatrixCodes yielded different results before and after a learning operation.

This malfunction is solved since eVision 6.7.1 Patch J.

Some specific MatrixCodes could no longer be read after being learned.


A run-time error occurred with some specific Matrix Codes.




EasyObject

Fixes

The neutral class of the double thresholding in EasyObject required a minimum of 2 gray levels. This minimum is now reduced to one gray level.

This malfunction is solved since eVision 6.7.1 Patch ZB.

The ECodedImage::GetObjFirstRunPtr() method could sometimes return an erroneous value.

This malfunction is solved since eVision 6.7.1 Patch Q.

The object count was sometimes incorrectly computed in the continuous mode.


In the continuous mode, there was no sure way to reinitialize the CodedImage

after calls to BuildObjects().

A new function, ResetContinuousMode(), has been added to do this. You

must call this function, not RemoveAllObjects(), to reset your CodedImage

object before doing a new series of BuildObjects().

C++: void ECodedImage.ResetContinuousMode()

.NET: void Euresys.eVision.CodedImage.ResetContinuousMode()

ActiveX: ECodedImageCtl.ResetContinuousMode()


When a single object was removed, the features calculated for it were not correctly cleared. This could lead to an object added later inheriting these.


In the continuous mode of EasyObject, all images used needed to have the same height.

For more information on EasyObject’s continuous mode, see the “Documentation Update since CD2006-1.pdf” document.




EasyOCR

Fixes

The EOCR::AddPatternFromImage now works correctly, regardless of whether the BuildObjects method has been called or not.


The absolute threshold setting was not correctly interpreted.


Characters touching the border of the image could not be read.




EasyOCV

Fixes

In EasyOCV, the constructors for the OCVChar and the OCVText objects were not documented and missing.

This malfunction is solved since eVision 6.7.1 Patch Y.

In EasyOCV, some properties such as NumContourPoints and LocationPoints were erroneously not accessible because in the read only —GetOnly— state.

This malfunction is solved since eVision 6.7.1 Patch Y.



C++

Fixes

The number of warnings during compilation under Borland C++ Builder 6.0 has been significantly reduced.


A single, real memory leak of 1024 bytes was reported when using eVision.

This malfunction is solved since eVision 6.7.1 Patch C.



.NET

Features

The ImageSequence object has been added to the eVision .NET objects. This means that the EasyAVI class is now available under .NET.

This improvement is available since eVision 6.7.1 Patch I.

Fixes

With Open eVision Basic Types, a small memory leak could happen under some specific circumstances when creating and destroying Image objects, or when using drawing functions.


ARGB32 images were not drawn correctly.

This malfunction is solved since eVision 6.7.1 Patch R.



ActiveX

Features

In EasyBarCode, the manual location methods for the Barcode object were missing and have been added:

EBarCodeCtl.SetDragable(Dragable As Boolean, Daughters As Boolean)

Sets if the barcode is to be dragable (movable). If Daughters is set to True, the setting

is passed to all the daughters of the Barcode.

EBarCodeCtl.SetResizable(Resizable As Boolean, Daughters As

Boolean)

Sets if the barcode is to be resizable. If Daughters is set to True, the setting is passed

to all the daughters of the Barcode.

EBarCodeCtl.SetRotatable(Rotatable As Boolean, Daughters As

Boolean)

Sets if the barcode is to be rotatable. If Daughters is set to True, the setting is passed

to all the daughters of the Barcode.

EBarCodeCtl.SetCursor(X As Long, Y As Long)

Sets the current position of the cursor.

EBarCodeCtl.HitTest(Daughters As Boolean) As Boolean

Checks if there’s a handle under the cursor. If Daughters is set to True, the check is

made for all the daughters of the Barcode too.

EBarCodeCtl.Drag(X As Long, Y As Long)

Moves the handle under the cursor (detected by HitTest()) to the given coordinates.

This improvement is available since eVision 6.7.1 Patch I.

Fixes

The new EasyFind interface has been added to the ActiveX in the form of two

new controls, PatterFinder and FoundPatternArray.


In EasyImage, the VerticalMirror() and HorizontalMirror() methods

of the EasyMain control now accept BW16 images.


In EasyObject, the ECodedImage.BuildObjectHoles() function was

inoperative.


Last edition 20-Jul-07

Copyright EURESYS s.a.

2007

Release Notes Open eVision 1 - Euresysdownloads.euresys.com/PackageFiles/OPENEVISION/1.0... ·...

Documents

Transcript of Release Notes Open eVision 1 - Euresysdownloads.euresys.com/PackageFiles/OPENEVISION/1.0... ·...