User`s guide

videoinput
Purpose Create video input object
Syntax obj = videoinput(ada ptorname)
obj = videoinput(ada ptorname,deviceID)
obj = videoinput(ada ptorname,deviceID,f ormat)
obj = videoinput(adaptorname,deviceID,format,P1,V1,...)
Description obj = videoinput(ada ptorname) constructs the video input object
obj. A video input object represents the connection between MATLAB
and a particular image acquisition device.
adaptorname is a text string
that specifies the name of the adaptor used to communicate with
thedevice. Usethe
imaqhwinfo function to determine the adaptors
available on your system.
obj = videoinput(ada ptorname,deviceID) constructs a video input
object
obj,wheredeviceI D is a numeric scalar v alue that identifies a
particular device available through the specified adaptor,
adaptorname.
Use the
imaqhwinfo(adaptorname) syntax to determine the devices
available through the specified adaptor. If
deviceID is not specified,
the first available device ID is used. As a convenience, a device’s name
canbeusedinplaceofthe
deviceID. If multiple d evices have the same
name, the first available device is used.
obj = videoinput(ada ptorname,deviceID,f ormat) constructs a
video input object, where
format isatextstringthatspecifiesa
particular video format supported by the device or the full path of a
device configuration file (also known a s a camera file).
To get a list of the form ats supporte d b y a particular device, view the
DeviceInfo structure for the device that is returned by the imaqhwinfo
function. Each Dev ice Info structure contains a SupportedFormats
field. If format is not specified, the device’s default format is used.
When the video input object is created, its
VideoFormat field contains
the format name or device configuration file that you specify.
obj = videoinput(adaptorname,deviceID,format,P1,V1,...) creates
a video input object
obj with the specified property values. If an invalid
property name or property value is specified, the obje ct is not created.
12-62