This is machine translation

Translated by Microsoft
Mouse over text to see original. Click the button below to return to the English verison of the page.


Create object to write video files


  • v = VideoWriter(filename)
  • v = VideoWriter(filename,profile)



v = VideoWriter(filename) creates a VideoWriter object to write video data to an AVI file with Motion JPEG compression.


v = VideoWriter(filename,profile) creates a VideoWriter object and applies a set of properties tailored to a specific file format (such as 'MPEG-4' or 'Uncompressed AVI').


collapse all

Create VideoWriter Object and Write Video

Create a VideoWriter object to write a Motion JPEG AVI file named newfile.avi.

v = VideoWriter('newfile.avi');

Open the file for writing and write a 300-by-300 matrix of data to the file.


Close the file.


Specify Profile for Uncompressed AVI and Write Video

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

A = imread('peppers.png');

Create a VideoWriter object for a new uncompressed AVI file for RGB24 video.

v = VideoWriter('newfile.avi','Uncompressed AVI');

Open the file for writing.


Write the image in A to the video file.


Close the file.


Input Arguments

collapse all

filename — File namestring

File name, specified as a string. VideoWriter creates the file.

VideoWriter supports these file extensions.


AVI file


Motion JPEG 2000 file

.mp4 or .m4v

MPEG-4 file (systems with Windows® 7 or later, or Mac OS X 10.7 and later)

If you do not specify a valid file extension, VideoWriter appends the extension .avi, .mj2 or .mp4, depending on the value of the profile argument. If you do not specify a value for profile, then VideoWriter creates a Motion JPEG compressed AVI file with the extension .avi.

Example: 'myFile.avi'

Example: '../dir/videos/myFile.mj2'

Data Types: char

profile — File type'Motion JPEG AVI' (default) | 'Archival' | 'Motion JPEG 2000' | ...

File type, specified as one of the following strings.

Value of profileDescription


Motion JPEG 2000 file with lossless compression

'Motion JPEG AVI'

AVI file using Motion JPEG encoding

'Motion JPEG 2000'

Motion JPEG 2000 file


MPEG-4 file with H.264 encoding (systems with Windows 7 or later, or Mac OS X 10.7 and later)

'Uncompressed AVI'

Uncompressed AVI file with RGB24 video

'Indexed AVI'

Uncompressed AVI file with indexed video

'Grayscale AVI'

Uncompressed AVI file with grayscale video

profile sets default values for video properties such as VideoCompressionMethod.

Output Arguments

collapse all

v — Output VideoWriter objectVideoWriter

Output VideoWriter object. After you create a VideoWriter object, you can write video files using object functions. See Using VideoWriter Objects for details.

Introduced in R2010b

Was this topic helpful?