File Exchange

image thumbnail


version 1.0 (187 KB) by

replacement for the movie command and play movies read by mmread



View License

function mmplay(...options...)

mmplay is a replacement for the movie command as well as plays movies read by mmread. It can play both audio and video simultaneously. This
uses the Windows DirectX infrastructure to generate the movie, so other OSs are out of luck. The video will appear in the current figure (or pop one up if it doesn't exist) unless 'fullscreen' is specified. The video
will cover the entire window, including the toolbar and menubar. If this bothers you turn off the menubar with:

video structure: The video structure matches the output of mmread. At a minimum it must have 4 fields "frames", "times", "height" and "width". The "frames" field must be a struct array with a field "cdata" that contains the raw frame data encoded as height by width by color(3) as UINT8s. The "times" field contains the time stamps of the data stored in frames. "times" and "frames.cdata" must be the same length.

audio structure: The audio structure matches the output of mmread. At a minimum it must have 3 fields "data", "rate" and "times". The "data" field is a matrix nrSamples by nrChannels (the same format was wavread/wavplay). The field "rate" is the sampling rate of the data in Hz, eg. 44100. The field "frames" is used to specify the time that audio should start, the rest of the time is extrapolated based upon the "rate" and the nrSamples.

'fullscreen': play in fullscreen mode.

[video,audio] = mmread('myfile');

%play fullscreen

% play just a subsample (the time range 10 to 20s) of a movie using mmread
[video, audio] = mmread('your file',[],[10 20]);

subtract 10 seconds off the time stamps so that the audio and video will start at the beginning of the movie.
video.times = video.times - 10;
audio.times = audio.times - 10;

mmplay(audio,video); % play the movie...

% make a movie ourselves...
x = -pi:.1:pi;
set(gca,'xlim',[-length(x) length(x)],'ylim',[-length(x) length(x)]);
for i=1:length(x)
patch(sin(x)*i,cos(x)*i,[abs(cos(x(i))) 0 0]);
v.frames(i) = getframe(gca);
v.times(i) = i/30; % display at 30fps

%as a replacement for the 'movie' command
change: movie(M)
v.frames = M;
v.times = (1:length(M))/12; %movie defaults to 12fps
v.width = size(M(1).cdata,2);
v.height = size(M(1).cdata,1);

Comments and Ratings (5)


Has anyone a solution for Cemils problem?
i tried axes(handles.axes) to set them, doesn't work.
and set(0, 'CurrentFigure',...) doesn't work either.


Zira (view profile)

what is M? how to change it?

Cemil Kirbas

Thank you Micah. Nice program.
Is there any way to play the movie in a specific axes in a GUI?



Harry (view profile)

Stefan Bleeck

Stefan Bleeck (view profile)

works only erratic for me (windows xp, matlab 7) The commands sometimes works, sometimes plays just rubbish in a random window (sometimes the sidebar, sometimes fullscreen, sometimes only sound) without apparent logic. Can't get it to work reliable.


Updated the help and description.

Added more comments and included source.

MATLAB Release
MATLAB 6.5 (R13)

Inspired by: mmread

Download apps, toolboxes, and other File Exchange content using Add-On Explorer in MATLAB.

» Watch video