Instructions

U.are.U SDK - Developer Guide 54
ActiveX
THIS CHAPTER PROVIDES AN OVERVIEW OF THE API. FOR DETAILS OF USING THE API ON WINDOWS-BASED
READERS, CONSULT THE U.ARE.U SDK PLATFORM GUIDE FOR WINDOWS.
The ActiveX API and controls are built as a wrapper to the C/C++ APIs, and is available for the Windows platform.
This chapter provides an overview of the API. For details of using the API on Windows-based readers, consult the
U.are.U SDK Platform Guide for Windows.
Note that ActiveX is a Microsoft technology and is not supported on Mozilla Firefox and Google Chrome.
Importing the U.are.U ActiveX package
The U.are.U ActiveX library classes are aggregated into two DLLs:
• DPXUru.dll – ActiveX API library
• DPCtlXUru.dll – ActiveX GUI controls
Getting Detailed Documentation
This chapter provides an overview of the main methods in the ActiveX API. For a complete description of method
parameters, the Doxygen documentation for the ActiveX libraries is provided. Consult the platform guide for details of
where the Doxygen files are located.
Using the Package
Main Access Points
The main access point to the U.are.U ActiveX library is the XReaderCollection class.
• To acquire a reference to XReaderCollection use the GetReaders() method. To destroy
XReaderCollection, (release all system resources associated with readers and make readers available for
other processes) use the Dispose() method.
• To acquire a reference(s) to individual readers, use the XReaderCollection object, which is a collection
of objects of type XReader.
• To work with the FingerJet Engine, instantiate one of the classes: XComparison, XImporter,
XFeatureExtraction or XEnrollment. For example, to start enrolling fingerprints using the FingerJet
engine, call the static method, Enrollment.CreateEnrollmentFmd(). This method takes as input an
enumeration that specifies the format the enrollment template should be in, e.g., ANSI or ISO. This method also
takes an IEnumerable<Fmd> object. See IEnumerables in the .NET Wrapper on page 45 for more information
on IEnumerable<Fmd>.
SDKException
The SDKException class describes exceptions specific to the U.are.U SDK.
Serialization
The ActiveX API provides the ability to convert an FMD or FID into a format that can be read serially. Serialization
allows you to easily transmit and store data as byte strings, streams or XML. This allows you to transmit the data or
save it to standard file systems. The XML format can be used within HTML for building browser-based applications.
To return the data to its original format, deserialization is also provided.