Main Content

imaqreset

Disconnect and delete all image acquisition objects

Syntax

Description

imaqreset deletes any image acquisition objects that exist in memory and unloads all adapters loaded by the toolbox. As a result, the image acquisition hardware resets.

imaqreset is the image acquisition command that returns MATLAB® to the known state of having no image acquisition objects and no loaded image acquisition adapters.

You can use imaqreset to force the toolbox to search for new hardware that might have been installed while MATLAB was running.

Note that you must not call imaqreset from any of the callbacks of a videoinput object, such as the start function callback or frames acquired function callback.

example

Examples

collapse all

Create a video input object.

vid = videoinput("winvideo");

Find image acquisition objects.

imaqfind
Summary of Video Input Object Using 'XiaoMi USB 2.0 Webcam'.

   Acquisition Source(s):  input1 is available.

  Acquisition Parameters:  'input1' is the current selected source.
                           10 frames per trigger using the selected source.
                           'RGB24_320x240' video data to be logged upon START.
                           Grabbing first of every 1 frame(s).
                           Log data to 'memory' on trigger.

      Trigger Parameters:  1 'immediate' trigger(s) on START.

                  Status:  Waiting for START.
                           0 frames acquired since starting.
                           0 frames available for GETDATA.

Disconnect and delete all image acquisition objects.

imaqreset

Find image acquisition objects after a reset. Observe that no image acquisition objects are available.

imaqfind
ans =

     []

Version History

Introduced before R2006a

See Also

|