Image Acquisition Toolbox

imaqfind

Find image acquisition objects

Syntax

• imaqfind
  out = imaqfind
  out = imaqfind('P1', V1, 'P2', V2,...)
  out = imaqfind(S)
  out = imaqfind(obj, 'P1', V1, 'P2', V2,...)
  

Description

imaqfind returns an array containing all the video input objects that exist in memory. If only a single video input object exists in memory, imaqfind displays a detailed summary of that object.

out = imaqfind returns an array, out, of all the video input objects that exist in memory.

out = imaqfind('P1', V1, 'P2', V2,...) returns a cell array, out, of image acquisition objects whose property names and property values match those passed as parameter/value pairs P1, V1, P2, V2. Parameter/value pairs can be specified as a cell array.

out = imaqfind(S) returns a cell array, out, of image acquisition objects whose property values match those defined in the structure S. The field names of S are image acquisition object property names and the field values are the requested property values.

out = imaqfind(obj, 'P1', V1, 'P2', V2,...) restricts the search for matching parameter/value pairs to the image acquisition objects listed in obj. obj can be an array of image acquisition objects.

Note    Parameter name/parameter value string pairs, structures, and parameter name/parameter value cell array pairs can be used in the same call to imaqfind.

When searching for properties with specific values, imaqfind performs case-sensitive searches. For example, if the value of an object's Name property is 'MyObject', imaqfind does not find a match if you specify 'myobject'. Use the get function to determine the exact spelling of a property value. Note, however, that searches for properties that have an enumerated list of possible values are not case sensitive. For example, imaqfind will find an object with a Running property value of 'Off' or 'off'.

Example

This example uses imaqfind to find image acquisition objects with the specified property values.

• obj1 = videoinput('matrox', 1, 'Tag', 'FrameGrabber');
  obj2 = videoinput('winvideo', 1, 'Tag', 'Webcam');
  out1 = imaqfind('Type', 'videoinput')
  out2 = imaqfind('Tag', 'FrameGrabber')
  out3 = imaqfind({'Type', 'Tag'}, {'videoinput', 'Webcam'})
  

See Also

get, videoinput

getsnapshot

imaqhelp