User`s guide

17 Functions — Alphabetical List
17-18
data = getdata(obj,n,type) returns n frames of data associated with the video
input object obj, where type is one of the text strings in the following table that specify
the data type used to store the returned data.
Type String Data Type
'uint8' Unsigned 8-bit integer
'uint16' Unsigned 16-bit integer
'uint32' Unsigned 32-bit integer
'single' Single precision
'double' Double precision
'native' Uses native data type. This is the default.
If type is not specified, 'native' is used as the default. If there is no MATLAB data
type that matches the object's native data type, getdata chooses a MATLAB data type
that preserves numerical accuracy. For example, the components of 12-bit RGB color
data would each be returned as uint8 data.
data = getdata(obj,n,type,format) returns n frames of data associated with the
video input object obj, where format is one of the text strings in the following table that
specify the MATLAB format of data.
Format String Description
'numeric' Returns data as an H-by-W-by-B-by-F array. This is the default
format if none is specified.
'cell' Returns data as an F-by-1 cell array of H-by-W-by-B matrices
[data,time] = getdata(...) returns time, an F-by-1 matrix, where F is the
number of frames returned in data. Each element of time indicates the relative time, in
seconds, of the corresponding frame in data, relative to the first trigger.
time = 0 is defined as the point at which data logging begins. When data logging
begins, the object's Logging property is set to 'On'. time is measured continuously with
respect to 0 until the acquisition stops. When the acquisition stops, the object's Running
property is set to 'Off'.
[data, time, metadata] = getdata(...) returns metadata, an F-by-1 array of
structures, where F is the number of frames returned in data. Each structure contains