Skip to content

Configuring the Applet (microDisplay X)#

To configure you applet and to test the configuration, proceed the following steps:

  1. Start microDisplay X on your computer.
  2. Select the frame grabber you want to work with from the list in the left upper corner.
    A tool tip provides you with more information about the frame grabber:

    Select Frame Grabber

    When selecting a frame grabber, a list of applets should appear in the pane below:

    List of Applets


    If there are no applets displayed, install the applet set for your frame grabber model on the host computer as described in the User Manual of your frame grabber. After installation, select File -> Rescan Applets in microDisplay X.

  3. Select an applet out of the applets list.
    A tool tip provides you with more information about each applet:

    Select Applet

    The applet you select must correspond to the connected cameras (number of connected cameras per frame grabber, area or line scan, etc.).

    The applet name displayed in bold is the applet that is currently active on the frame grabber.

    The applets displayed in black are the applets currently available for the selected frame grabber.

    When is an applet available?

    • On imaWorx frame grabbers, an applet is available as soon as it is available in the file system of your computer (Framegrabber SDK installation directory, sub-directories DLL or Hardware Applets). If the applet isn't there, run the applet installer that contains the applet you want to use, or, if you need an applet created with VisualApplets, copy the applet file (*.hap) into the Hardware Applets folder of your Framegrabber SDK installation (e.g., ...\Basler\FramegrabberSDK5.x.x\Hardware Applets\*.hap).
    • On marathon frame grabbers, an applet is available as soon as it is flashed onto the frame grabber. If the applet you want to use isn't flashed on the frame grabber yet, flash it according to the instructions in Managing Applets (microDiagnostics).
  4. Double-click the applet name to load the applet.

    Load Applet

    The applet is loaded. The acquisition processes of the applet (together with the respective camera and DMA ports) are displayed in the left-hand pane, and the DMA outputs are visible in the viewing pane (tab Acquisition Channel):

    Acquisition Processes

    For each process defined in the applet, an according acquisition process with camera IN ports (Cam 0, Cam 1, …) and DMA OUT ports (DMA 0, DMA 1, …) is displayed.

    Acquisition Process

    The tooltip of a DMA line (left-hand panel) informs you about the most important applet features and settings:

    DMA Line Tooltip

    To connect another camera to a given applet process, click the Edit button in the Cam line and select the camera you want to connect. After this, the camera will show in the Cam line of the process and disappear from the Cam line of the process it was connected to before.

  5. Make sure your cameras are connected and detected. A detected camera (image source) is marked green:

    DMA Line Tooltip

  6. If no camera is detected, deactivate the Windows Fast Startup option as described by


    Instead of a camera, you can use the Camera Simulator as image source if you have no camera at hand. To do so:

    1. Click the DMA line to configure the input source for a process (acquisition channel).
    2. Below, in the Parameter Selection pane, open the options for parameter Camera Simulator. Go to Image Source and from the value list, select Generator.
    3. The Cam line of the process should display a green disk now and display the information that an image generator is connected to the input of the acquisition channel.
  7. Click the DMA line to configure the applet for a process.

  8. Set the applet parameters in the pane below:

    Configuring Applet Parameters

    Double-click or right-click a parameter/value to get the list of available values or an input field.

  9. Define the time-out and the number of buffers to be allocated per acquisition channel: Keep the DMA line of the process active. Click the Edit button. In the dialog that opens, you can set the parameters:

    • Timeout: Acquisition timeout. If no image has been received in the time span you define here, acquisition is aborted.
    • Buffers: Number of buffers to be allocated per acquisition channel.
  10. Repeat steps 7 to 9 for all active DMA channels.

  11. If necessary, adapt the camera settings as described in the Configuring the Camera topic.
    To avoid random data at the margins of the acquired images (displayed in red in the DMA output display panes), make sure the applet settings for frame width and height match the camera settings for frame width and height.
  12. Acquire several images:

    1. Click the DMA line of the process you want to start. The corresponding DMA output display pane (tab Acquisition Channel) becomes active:

      DMA Output Display Pane

    2. Click the Grab button to start acquisition.
      If your system is correctly installed, the grabbed images are displayed in the corresponding DMA output display pane:

      Image Display

    3. Use the Stop button to stop acquisition.

  13. Examine the acquired images. They are displayed in the DMA output display pane.

  14. If necessary, adjust the applet parameter settings so the acquired images fulfill your requirements.
  15. If you want to reuse your applet configuration, save your applet configuration to an MCF file:

    Save Configuration

    The MCF file contains the applet configuration for one frame grabber, including the configurations for all processes (acquisition channels) of the applet. For more information, see Saving Applet Configuration.