This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.


Write video data to file




writeVideo(v,img) writes data from an array to the video file associated with v.

You must call open(v) before calling writeVideo.


writeVideo(v,frame) writes one or more movie frames typically returned by the getframe function.


collapse all

Write an RGB image to a Motion JPEG 2000 file with lossless compression.

Create an array containing data from the sample still image, peppers.png.

A = imread('peppers.png');

Create a VideoWriter object for a new video file. Use the 'Archival' profile to specify a Motion JPEG 2000 file with lossless compression.

v = VideoWriter('myFile','Archival');

Verify the type of video compression for the new file.

ans = 
'Motion JPEG 2000'

Open the video file for writing. Then, write the image data in A to the file.


Close the video file.


Read image and colormap data from the sample indexed image file, corn.tif.

[X,map] = imread('corn.tif');

Create a VideoWriter object for a new indexed AVI file.

v = VideoWriter('myIndexed.avi','Indexed AVI');

Assign the colormap data to the Colormap property of v.

v.Colormap = map;

Open the file for writing. After you open the file, you cannot change the properties of v.


Write the image data in X to the video file. Then, close the file.


Convert the example file, xylophone.mp4, to an uncompressed AVI file.

Create objects to read and write the video, and open the AVI file for writing.

reader = VideoReader('xylophone.mp4');
writer = VideoWriter('transcoded_xylophone.avi', ...
                        'Uncompressed AVI');

writer.FrameRate = reader.FrameRate;

Read and write each frame.

while hasFrame(reader)
   img = readFrame(reader);


Write a sequence of frames to a compressed AVI file by generating a sequence of frames, creating a video object for the file to write to, and then writing the frames to the video file.

Setup the axes and figure properties to generate frames for the video.

Z = peaks;
axis tight manual 

Create a video writer object for the output video file and open the object for writing.

v = VideoWriter('peaks.avi');

Generate a set of frames, get the frame from the figure, and then write each frame to the file.

for k = 1:20 
   frame = getframe(gcf);


Input Arguments

collapse all

Input VideoWriter object. Use VideoWriter to create the object.

Values representing grayscale or RGB color images, specified as a 2-D, 3-D, or 4-D array:

  • For a single grayscale, monochrome, or indexed image, img must be two dimensional: height-by-width

  • For a single truecolor (RGB) image, img is three dimensional: height-by-width-by-3.

  • For a sequence of grayscale images, img is four dimensional:. height-by-width-by-1-by-frames. The height and width must be consistent for all frames within a file.

  • For a sequence of RGB images, img is four dimensional: height-by-width-by-3-by-frames. The height and width must be consistent for all frames within a file.

When creating AVI or MPEG-4 files:

  • img is an array of single, double, or uint8 values representing one or more grayscale or RGB color images, which writeVideo writes as one or more RGB video frames.

  • Data of type single or double must be in the range [0,1], except when writing indexed AVI files.

When creating Motion JPEG 2000 files:

  • img is an array of uint8, int8, uint16, or int16 values representing one or more monochrome or RGB color images.

Data Types: single | double | int8 | int16 | uint8 | uint16

Frame data, specified as a 1-by-1 structure array representing a single frame, or a 1-by-F array of structures representing multiple frames. Each frame contains two fields: cdata and colormap. The frame array is typically returned by the getframe function.

If colormap is not empty, then each element of cdata should be a 2-D (height-by-width) array. The height and width must be consistent for all frames within a file.

colormap can contain a maximum of 256 entries. Each element of colormap must be in the range [0,1].

When you create a VideoWriter object. the profile input and the size of cdata determine how writeVideo uses frame.

profile of VideoWriter objectSize of each element of cdata Behavior of writeVideo

'Indexed AVI'

2-D (height-by-width)Use frame as provided.
'Grayscale AVI'2-D (height-by-width)Use frame as provided. colormap should be empty.

All other profiles

2-D (height-by-width)Construct RGB image frames using the colormap field
3-D (height-by-width-by-3)Ignore the colormap field. Construct RGB image frames using the cdata field

Data Types: struct

Introduced in R2010b