View License

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

» Watch video

Highlights from

3.0 | 2 ratings Rate this file 21 Downloads (last 30 days) File Size: 187 KB File ID: #15880 Version: 1.0



Micah Richert (view profile)


09 Aug 2007 (Updated )

replacement for the movie command and play movies read by mmread

| Watch this File

File Information

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);


Mmread inspired this file.

MATLAB release MATLAB 6.5 (R13)
Other requirements DirectX 9 or above. Microsoft Windows platforms only. Other OSs are out of luck.
Tags for This File   Please login to tag files.
Please login to add a comment or rating.
Comments and Ratings (5)
23 Apr 2012 geieraffe

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.

Comment only
02 Apr 2011 Zira

Zira (view profile)

what is M? how to change it?

Comment only
04 Aug 2010 Cemil Kirbas

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


Comment only
23 Oct 2009 Harry

Harry (view profile)

21 Aug 2009 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.

10 Aug 2007

Added more comments and included source.

23 Aug 2007

Updated the help and description.

Contact us