Main Content


Return image acquisition object properties


V = get(obj)
V = get(obj,PropertyName)


get(obj) displays all property names and their current values for image acquisition object obj.

V = get(obj) returns a structure, V, in which each field name is the name of a property of obj and each field contains the value of that property.

V = get(obj,PropertyName) returns the value of the property specified by PropertyName for image acquisition object obj. Use the get(obj) syntax to view a list of all the properties supported by a particular image acquisition object.

If PropertyName is a 1-by-N or N-by-1 cell array of character vectors containing property names, V is a 1-by-N cell array of values. If obj is a vector of image acquisition objects, V is an M-by-N cell array of property values where M is equal to the length of obj and N is equal to the number of properties specified.


Create video object, then get values of two frame-related properties, then display all properties of the object:

vid = videoinput('matrox', 1);
get(vid, {'FramesPerTrigger','FramesAcquired'})
out = get(vid, 'LoggingMode')

Instead of using get to query individual property values, you should use dot notation. So for example, instead of this:

get(vid, 'FramesPerTrigger')

You should use this syntax:


Version History

Introduced before R2006a

See Also