Configuring the Applet

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

  1. Start microDisplay X.
    You find microDisplayX.exe in your Silicon Software runtime installation directory, sub-directory bin (for example: C:\Program Files\SiliconSoftware\Runtime5.7.0\bin\microDisplayX.exe).
  2. Select the frame grabber you want to work with from the list in the left upper corner. A tool tip provides you with additional information on the frame grabber:

    Immediately, a list of applets is displayed in the pane below:
  1. Select an applet out of the available applets (listed in the GUI).
    A tool tip provides you with additional information on each applet:



    - The applet name displayed in bold is the applet that is currently active on the frame grabber (only mE5 marathon, mE5 ironman, and LightBridge 2).
    - The applets displayed in black are the applets currently available for the selected frame grabber.
    - The applets which are displayed in gray are currently not available for the selected frame grabber.

Applet-Camera Match

 

The applet you select needs to correspond to the connected camera/cameras (number of connected cameras per frame grabber board, area or line scan, Gray, RGB, or Bayer, etc.).

   
  1. Double-click on the applet name to load the applet.

    The applet is loaded. For each process defined in the applet, an according acquisition process with camera IN port(s) (Cam 0, Cam 1, ...) and DMA OUT port(s) (DMA 0, DMA 1, ...) is displayed. In the viewing pane (tab Acquisition Channel), one DMA output display pane is visible per DMA output port.

Display per applet process:

  1. Make sure your cameras are connected and detected. A detected camera is marked green:


  2. Click on the DMA line to configure the applet for a process.
  3. Set the applet parameters in the pane below:

Parameter Details and Getter/Setter Code Example

 

You can always get the details of a parameter (description, current value, access rights, data type, etc.) in the bottom part of the Parameter Selection window.

To get additional information and code examples for reading and writing via API:

  1. Click the Details button.

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

  1. Repeat steps 6 to 8 for all active DMA channels.

Configuring the Camera

 

You may also need to adapt the camera settings.

  1. Click on the Cam line.
  2. Set the camera parameters in the pane below, as you did for the applet parameters.

For detailed information on camera configuration, see Configuring the Camera.

   

 

Adjust Image Dimensions in Applet and Camera Settings

 

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.

   
  1. Start the image acquisition:
    1. Click on the DMA line of the process you want to start. The corresponding DMA output display pane becomes active:
    2. Click one of the Grab buttons to start acquisition:
      Starts continuous image acquisition.
      Starts acquisition of an image sequence.
      Starts acquisition of one single frame.
    3. Use the Stop button to stop acquisition.

    Running Acquisition on Camera Port 0 (Acquisition Process 0)

  2. Examine the acquired images. They are displayed in the DMA output display pane.
  1. Adjust the applet parameter settings so the acquired images fulfill your requirements.
  2. Parametrize the applet for each process.
  3. Optional: Save your applet configuration to file (*.mcf) if you want to reuse your applet configuration:

The *.mcf file contains the applet configuration for one frame grabber board (including the configurations for all processes (acquisition channels) of the applet). For details, see section Saving Applet Configuration (MCF/MFS).

Don't forget ...

 

Make sure you configure applet and camera for each process.

Make sure the image dimensions in the applet configuration (ROI width and height) are the same size or smaller than the image dimensions in the camera configuration.