Capture movie frame
F = getframe
F = getframe(h)
F = getframe(h,rect)
F = getframe(h,rect) specifies a rectangular area from which to copy the pixmap. rect is relative to the lower left corner of the figure or axes h, in pixel units. rect is a four-element vector in the form [left bottom width height], where width and height define the dimensions of the rectangle.
cdata — The image data stored as a matrix of uint8 values. The dimensions of F.cdata are height-by-width-by-3.
colormap — The colormap stored as an n-by-3 matrix of doubles. F.colormap is empty on true color systems.
To capture an image, use this approach:
F = getframe(gcf); image(F.cdata) colormap(F.colormap)
Use the getframe function in a loop to record frames of the peaks function vibrating. Preallocate an array to store the movie frames.
figure Z = peaks; surf(Z) axis tight manual ax = gca; ax.NextPlot = 'replaceChildren'; loops = 40; F(loops) = struct('cdata',,'colormap',); for j = 1:loops X = sin(j*pi/10)*Z; surf(X,Z) drawnow F(j) = getframe; end
To play the movie two times, use movie(F,2).
getframe is usually used in a for loop to assemble an array of movie frames for playback using movie.
If you are capturing frames of a plot that takes a long time to generate or are repeatedly calling getframe in a loop, make sure that your computer's screen saver does not activate and that your monitor does not turn off for the duration of the capture; otherwise one or more of the captured frames can contain graphics from your screen saver or nothing at all.
Note: In situations where MATLAB® software is running on a virtual desktop that is not currently visible on your monitor, calls to getframe will complete, but will capture a region on your monitor that corresponds to the position occupied by the figure or axes on the hidden desktop. Therefore, make sure that the window to be captured by getframe exists on the currently active desktop.
F = getframe returns the contents of the current axes, exclusive of the axis labels, title, or tick labels.
F = getframe(gcf) captures the entire interior of the current figure window.
To capture the figure window menu, use F = getframe(h,rect) with a rectangle sized to include the menu.
The resolution of the framed image depends on the size of the axes in pixels when getframe is called. As the getframe command takes a snapshot of the screen, if the axes is small in size (e.g., because you have restricted the view to a window within the axes), getframe captures fewer screen pixels, and the captured image might have poor resolution if enlarged for display.
To capture uicontrols along with the axes and any annotations displayed on the plot, specify the figure handle:
F = getframe(figure_handle);
To exclude uicontrols outside of the current axes, do not specify the figure handle:
F = getframe;
Setting the figure Renderer property to painters works around limitations of using getframe with the OpenGL renderer on some Windows® systems.