Terms Of Use

By using this API, the user agrees to the terms and conditions as stated in the document "Resonon API Terms of Use", located on the Resonon website at https://resonon.com/content/files/Resonon_API_Terms_of_Use-2.pdf

Overview

Included here are the library and header files for the Resonon API, as well as a directory of example code. This API allows for control of Resonon hyperspectral Imagers, including the ability to set camera settings, set up spectral calibration, acquire frames, and save data to a datacube format readable with Spectronon (see examples). The API wraps the various camera vendor APIs used by Resonon products and provides a simplified interface that is consistent across all Resonon's hyperspectral imagers.

Installer

The installer installs the Resonon API by default to %PROGRAMFILES%/ResononAPI. If you selected "Append to Path" during installation then the appropriate bin subdirectory (bin64 or bin32, depending on architecture) is added to your path so the Resonon DLLs can be found at runtime.

As of version 3.0 64-bit and 32-bit .lib and .dll files are distributed with both the 64-bit and 32-bit versions of the API. The underlying camera vendor driver packages may be specific to 64-bit or 32-bit architectures however. Where this is the case only vendor packages appropriate for the selected architecture are included in the installer.

Directory Structure

/include

All header files are found in this location.
- resonon_imager_base.h Defines an abstract base class for all imagers. This header is included by other imager headers, but can be explicitly included in your code if you need a pointer to the imager base class.
- resonon_imager_basler.h Defines the interface to all imagers based on the Basler ACE camera. Include this file if your code must control a Pika L or Pika XC2 USB3 imager.
- resonon_imager_allied.h Defines all classes that interface with Resonon imagers based on Allied Vision Techonologies cameras. Include this file if your code must control a Pika NIR GigE imager.
/bin32

This location contains all 32 bit .dll files distributed with the Resonon API.
/bin64

This location contains all 64 bit .dll files distributed with the Resonon API.
/lib32

This location contains all 32 bit .lib files distributed with the Resonon API.
/lib64

This location contains all 64 bit .lib files distributed with the Resonon API.
/examples

This location contains source code for example applications. Each example is contained in a subfolder. Each subfolder contains the example source code and a Visual Studio project file to allow building the example.
/documentation

This documentation is distributed in .chm and .html formats in the documentation folder.

Building Examples

The examples include project files for Microsoft Visual Studio 2015. To build using an alternative compiler use the table below to link against the appropriate libraries.

Dependencies

If your code makes use of classes defined in the following headers, your application will have dependencies as shown below. These dependencies are included in the API installer. Resonon libraries can be found in the bin64 or bin32 folders, while 3rd party dependencies are supplied by vendor installers which, if selected, are run by the Resonon API installer. These installers will install the dependencies in their own locations and automatically update your system PATH variable to include these dependencies. They also install required hardware drivers and in some cases create additional system variables. If you need to distribute applications without the use of the Resonon API installer please contact Resonon for assistance.

Header File	Resonon Libraries	3rd Party .dlls	Required Installer Option
resonon_imager_basler.h	resonon-basler	Basler Pylon 5 runtime	Basler Drivers
resonon_imager_allied.h	resonon-allied	VimbaC	Vimba Drivers

Contact

Please direct questions to: suppo.nosp@m.rt@r.nosp@m.esono.nosp@m.n.co.nosp@m.m