User`s guide

7 Working with Acquired Image Data

7-4

main Documentation Center page, or open the file demoimaq_GetSnapshot.m in the

MATLAB Editor.

Moving Multiple Frames into the Workspace

To move multiple frames of data from the memory buffer into the MATLAB workspace,

use the getdata function. By default, getdata retrieves the number of frames specified

in the FramesPerTrigger property but you can specify any number. See the getdata

reference page for complete information about this function.

Note When the getdata function moves frames from the memory buffer into the

workspace, it removes the frames from the memory buffer.

In this figure, getdata is called at T

with a request for 15 frames but only six frames

are available in the memory buffer. getdata blocks until the specified number of frames

becomes available, at T

, at which point getdata moves the frames into the MATLAB

workspace and returns control to the command prompt.

getdata Blocks Until Frames Become Available