Main Content

imaqfind

Find image acquisition objects

Syntax

imaqfind
out = imaqfind
out = imaqfind(PropertyName, Value, PropertyName2, Value2,...)
out = imaqfind(S)
out = imaqfind(obj, PropertyName, Value, PropertyName2, Value2,...)

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(PropertyName, Value, PropertyName2, Value2,...) returns a cell array, out, of image acquisition objects whose property names and property values match those passed as arguments. You can specify the property name/property value pairs in a cell array. You can use a mixture of character vectors, structures, and cell arrays. Use the get function to determine the list of properties supported by an image acquisition object.

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, PropertyName, Value, PropertyName2, Value2,...) 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

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'. 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'. Use the get function to determine the exact spelling of a property value.

Note

To get a list of options you can use on a function, press the Tab key after entering a function on the MATLAB® command line. The list expands, and you can scroll to choose a property or value. For information about using this advanced tab completion feature, see Using Tab Completion for Functions.

Examples

To illustrate various imaqfind syntaxes, first create two video input objects.

obj1 = videoinput('matrox',1,'M_RS170','Tag','FrameGrabber');
obj2 = videoinput('winvideo',1,'RGB24_320x240','Tag','Webcam');

Now use imaqfind to find these objects by type and tag.

out1 = imaqfind('Type', 'videoinput')
out2 = imaqfind('Tag', 'FrameGrabber')
out3 = imaqfind({'Type', 'Tag'}, {'videoinput', 'Webcam'})

Version History

Introduced before R2006a

See Also