Play recorded movie frames
movie(M) plays the movie in matrix M once, using the current axes as the default target. If you want to play the movie in the figure instead of the axes, specify the figure handle (or gcf) as the first argument: movie(figure_handle,...). M must be an array of movie frames (usually from getframe).
movie(M,n) plays the movie n times. If n is negative, each cycle is shown forward then backward. If n is a vector, the first element is the number of times to play the movie, and the remaining elements make up a list of frames to play in the movie.
For example, if M has four frames then n = [10 4 4 2 1] plays the movie ten times, and the movie consists of frame 4 followed by frame 4 again, followed by frame 2 and finally frame 1.
movie(h,M,n,fps,loc) specifies loc, a four-element location vector, [x y 0 0], where the lower left corner of the movie frame is anchored (only the first two elements in the vector are used). The location is relative to the lower left corner of the figure or axes specified by handle h and in units of pixels, regardless of the object's Units property.
Animate the peaks function as you scale the values of Z:
figure('Renderer','zbuffer') Z = peaks; surf(Z); axis tight set(gca,'NextPlot','replaceChildren'); % Preallocate the struct array for the struct returned by getframe F(20) = struct('cdata',,'colormap',); % Record the movie for j = 1:20 surf(.01+sin(2*pi*j/20)*Z,Z) F(j) = getframe; end
Now play the movie ten times. The twelfth frame looks like the following plot.
With larger frames, first adjust the figure's size to fit the movie:
figure('Position',[100 100 850 600]) Z = peaks; surf(Z); axis tight set(gca,'NextPlot','replacechildren'); % Record the movie for j = 1:20 surf(sin(2*pi*j/20)*Z,Z) F(j) = getframe; end % use 1st frame to get dimensions [h, w, p] = size(F(1).cdata); hf = figure; % resize figure based on frame's w x h, and place at (150, 150) set(hf,'Position', [150 150 w h]); axis off % Place frames at bottom left movie(hf,F,4,30,[0 0 0 0]);
The movie function uses a default figure size of 560-by-420 and does not resize figures to fit movies with larger or smaller frames. To accommodate other frame sizes, you can resize the figure to fit the movie, as shown in the second example below.
movie only accepts 8-bit image frames; it does not accept 16-bit grayscale or 24–bit truecolor image frames.
Buffering the movie places all frames in memory. As a result, on Microsoft® Windows® and perhaps other platforms, a long movie (on the order of several hundred frames) can exhaust memory, depending on system resources. In such cases an error message is issued that says
??? Error using ==> movie Could not create movie frame
You can abort a movie by typing Ctrl-C.
movie is not a built-in function. Therefore, you cannot call movie using the builtin function.
Setting the figure Renderer property to zbuffer or painters works around limitations of using getframe with the OpenGL renderer on some Windows systems.