Skip to content

Applets for imaFlex 2 Dual 100#

This topic tells you about the acquisition applets available for the imaFlex 2 Dual 100 frame grabber.

Typically, an applet supports a specific camera interface standard and topology, specific image acquisition features, and possibly specific image (pre-)processing features. By loading an applet onto the frame grabber, you define the functionality of the frame grabber and adapt it to the requirements of your specific application.

There are two kinds of applets: acquisition applets (*.dll) always delivered by Basler, and custom applets (*.hap) developed in VisualApplets either by yourself or by Basler. In addition to the acquisition applets that are included in the delivery, imaFlex 2 Dual 100 can be programmed to fulfill highly specific image processing tasks that are required by a specific application. The programming can be done by Basler, a certified partner, or by yourself using the easy-to-use graphical FPGA programming environment VisualApplets.

Basler provides data forwarding examples as a VisualApplets design, along with a C++ SDK control application. In these examples you can see how to use these operators for data forwarding.

To ensure optimum use of system resources, not all image acquisition and processing features designed for imaFlex 2 Dual 100 are loaded onto imaFlex 2 Dual 100 simultaneously. Instead, Basler provides a simple acquisition line-scan applet for baseline tests and calibration for TDI cameras. The acquisition applet for imaFlex 2 Dual 100 is included in the Framegrabber SDK.

Requirements#

  • Host software: Framegrabber SDK version 5.11.50a or later
  • VisualApplets:: VisualApplets version 3.7.50b or later
  • Hardware: An imaFlex 2 Dual 100 frame grabber is connected to your system

Limitation

In all applets, buffers larger than 4GB can't be allocated. Even if the applet allows a larger buffer size, you can't allocate buffers larger than 4GB due to limitations in the driver and firmware.

You can calculate the buffer size as follows:

Buffer size = image height * image width * (pixel width / 8).

For RGB images: buffer size = (image height * image width * (pixel width / 8)) * 3 .

Documentation#

The following sections provide links to the acquisition applets documentation:

Line Acquisition Applets#

GenTL Fglib
Acq_SingleCoF25Line PDF Acq_SingleCoF25Line PDF

Line Scan Acquisition Applet#

The following Line Scan Acquisition Applet is available:

  • Acq_SingleCoF25Line

The denominator "single" in the name of the applet refer to the maximum number of cameras you can connect.

Specifications of the Line Scan Acquisition Applet#
Max. Image Size [px] 32768 x 16777216
Camera Ports 1
Camera Type CoF (CXP-25), link aggregation max. 4
Bit Depth Processing [bit] 16
Bit Depth Output [bit] Mono8-16
RGB8-16
RGBA8
BGR8-16
BGRA8
YCbCr422_8
Mirroring Yes, horizontal and vertical
Tap Geometry Sorting 1X-1Y only
Image Selector Yes
Color Array Filter No
White Balance Yes
LUT Full resolution
Pixel Format Conversion Mono, RGB
Bandwidth: Total DMA [MB/s] c 12800
ROI Step Size [px] x: 32
y: 1
Bandwidth: Mean per Camera [MP/s] 12800

Using Acquisition Applets#

Using Acquisition Applets with the Framegrabber SDK#

Find here general information about using the applets with the Framegrabber SDK: Acquisition Applets.

Installing Applets#

Before you can use a specific applet on your frame grabber, you need to install it on the frame grabber. Instructions for installing the applets are available at Managing Applets (microDiagnostics).

Adding an Applet Manually#

To add an applet you received as *.dll file (and not in form of an installer) to your host file system:

  1. Get the applet file (*.dll) you have received.
  2. Copy this file into the following directory: <Framegrabber SDK installation directory>/Dll/<frame grabber model>

Now you can use the new applet.

Testing Image Acquisition#

Before you start using an applet in your own software (via API), you might want to test the system set-up or an individual applet (and its parametrization options).

For this purpose, you are provided with the tool microDisplay X that has been installed on your host computer as part of the Framegrabber SDK environment. For instructions how to load and test your applet, see Configuring the Applet (microDisplay X).

Saving Applet Configuration#

After you have configured your applet (in microDisplay X or via Framegrabber API), you can save your configuration. For more information, see Other Tasks (microDisplay X).

  1. Framegrabber SDK version 5.11.50 is provided through Basler Customer Support upon request and is not offered via the standard public software download. ↩

  2. All imaFlex 2 Dual 100-specific operators are included in VisualApplets version 3.7.50. This version is provided through Basler Customer Support upon request and is not offered via the standard public software download. ↩

  3. The actual DMA bandwidth depends on the specific mainboard and chip set of the host computer. ↩