Find image acquisition objects
imaqfind
out = imaqfind
out = imaqfind(PropertyName
,
Value, PropertyName2
, Value2,...)
out = imaqfind(S)
out = imaqfind(obj, PropertyName
,
Value, PropertyName2
, Value2,...)
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(
returns
a cell array, PropertyName
,
Value, PropertyName2
, Value2,...)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,
restricts
the search for matching parameter/value pairs to the image acquisition
objects listed in PropertyName
,
Value, PropertyName2
, Value2,...)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.
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'})