Selected

Indicate whether video source object will be used for acquisition

Description

The Selected property indicates if the video source object will be used for acquisition. You select a video source object by specifying its name as the value of the video input object's SelectedSourceName property. The video input object Source property is an array of all the video source objects associated with the video input object.

If Selected is 'on', the video source object is selected. If the value is 'off', the video source object is not selected.

A video source is defined to be a collection of one or more physical data sources that are treated as a single entity. For example, hardware supporting multiple RGB sources, each of which is made up of three physical connections (red, green, and blue), is treated as a single video source object.

Characteristics

Default value is enclosed in braces ({}).

Access

Read only

Data type

String

Values

[ {'off'} | 'on' ]

Examples

Create an image acquisition object.

vid = videoinput('winvideo');

Determine the currently selected video source object.

vid.SelectedSourceName

ans =

input1

Retrieve the currently selected video source object.

src = getselectedsource(vid);

View its Name and Selected properties.

src.SourceName

ans =

input1

src.Selected

ans =

on

See Also

Functions

getselectedsource

Properties

SelectedSourceName

Was this topic helpful?