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.

For a walkthrough of the Image Acquisition Explorer app, play the following video.

  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. For a list of supported hardware and their respective support packages, see Image Acquisition Toolbox Supported Hardware. 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.

    Configure Format section in Image Acquisition Explorer

    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.

    Preview switch in Image Acquisition Explorer

  4. If necessary, you can physically adjust the device to achieve the desired image area. Optionally, you can define the acquisition region by using the settings in the ROI Position panel next to the preview.

    ROI Position panel in Image Acquisition Explorer

  5. Set any general or device-specific parameters from the Device Properties panel or use the default settings. The specific list of properties that appear depends on your selected device. You can preview the property changes as you update them.

    Device Properties panel in Image Acquisition Explorer

  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. Specify the file name or workspace variable name.

    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

  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 currently 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.

    • The Generate Snapshot Script option creates and opens a live script that contains code for connecting to your device, configuring its properties, capturing a single frame, and viewing a snapshot of the captured image.

    • The Generate Record Script option creates and opens a live script that contains code for connecting to your device, configuring its properties, recording a specified number of frames, and viewing the recorded video.

    Export section and its options in Image Acquisition Explorer

See Also

Related Topics