Main Content

Get Started with Image Acquisition Explorer

The basic workflow of using the Image Acquisition Explorer is to preview, configure, acquire, and save image data. For information on opening the app or the parts of the app, see Image Acquisition Explorer Overview.

  1. After opening the Image Acquisition Explorer app, decide which device you want to work with. The image acquisition devices currently connected to your computer are shown. If you do not see your device, make sure you have the appropriate Image Acquisition Toolbox™ support package installed. If your device is not connected yet, plug it in to your computer and refresh the list of hardware in the app.

    Device card in Image Acquisition Explorer app

  2. Choose the format to work with by selecting an option from Video Format in the Configure Format section of the app toolstrip. The formats might correspond to the different resolutions and color spaces that your device supports, or to different video standards or camera configurations. This information comes from your device adaptor.

    If your device supports camera files, the Select Camera File button is available instead of Video Format.

  3. Look at the preview in the app to check that the device is working and the image is what you expect. If Preview is Off, you can toggle the switch to On.

  4. If necessary, you can physically adjust the device to achieve the desired image area. Optionally, you can specify a region of interest by using the settings in the Region of Interest tab next to the preview to define the acquisition region.

  5. Set any general or device-specific parameters from the Device Properties tab or use the default settings. You can preview the property changes as you update them.

  6. Choose your logging mode, which determines whether you save the acquisition data as a file or as a workspace variable. Select either the File or Workspace Variable option in the Logging section of the app toolstrip.

    Logging section with Workspace Variable selected in Image Acquisition Explorer

    If you select File, you can click the configuration icon next to the file name for additional settings, including file location to save to and file format to save as.

    Image file settings configuration in Image Acquisition Explorer

    Specify the file name or workspace variable name.

  7. Decide whether you want to capture a snapshot of a single frame or record a video of multiple frames.

    • If you want to immediately capture a single frame, click the Capture button in the Snapshot section of the app toolstrip. The image data is saved as an image file or workspace variable, depending on your prior selection.

      Capture button in Image Acquisition Explorer

    • If you want to record a video or acquire a sequence of multiple frames, you can select a recording mode of Finite or Continuous in the Record section of the app toolstrip. If your device supports hardware triggered acquisition, you also have the Hardware Trigger option available. For finite recording, specify the number of frames or seconds to record for and click the Record button. For continuous recording, you can start by clicking the Record button. It becomes a Stop button, which you can click to end recording. The recorded data is saved as a video file or workspace variable, depending on your prior selection.

      Record section in Image Acquisition Explorer

  8. You can generate a MATLAB® live script that includes the device and acquisition configurations that you have in the app. Click the Export button in the app toolstrip to select Generate Snapshot Script or Generate Record Script. Both these options create and open a live script that contains code for the current device configuration, as specified in the Configure Format section, and code for saving data as a file or workspace variable, as specified in the Logging section.

See Also

Related Topics