Main Content


Property characteristics for image acquisition objects


out = propinfo(obj)
out = propinfo(obj,PropertyName)


out = propinfo(obj) returns the structure out whose field names are the names of all the properties supported by obj. obj must be a 1-by-1 image acquisition object. The value of each field is a structure containing the fields shown below.

Field Name



Data type of the property. Possible values are 'any', 'callback', 'double', 'character vector', and 'struct'.


Type of constraint on the property value. Possible values are 'bounded', 'callback', 'enum', and 'none'.


List of valid character vector values or a range of valid values.


Default value for the property.


Condition under which a property is read only:

  • 'always' — Property cannot be configured.

  • 'whileRunning' — Property cannot be configured while Running is set to on.

  • 'never' — Property can be configured at any time.


1 if the property is device specific; otherwise, 0 (zero).

out = propinfo(obj,PropertyName) returns the structure out for the property specified by PropertyName. If PropertyName is a cell array of character vectors, propinfo returns a structure for each property, stored in a cell array.


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.


Create the video input object vid.

vid = videoinput('winvideo',1);

Capture all property information for all properties.

out = propinfo(vid);

Access property information for a particular property.

out1 = propinfo(vid,'LoggingMode');

Version History

Introduced before R2006a

See Also