Main Content

VideoWriter.getProfiles

Profiles and file formats that VideoWriter supports

Description

example

profiles = VideoWriter.getProfiles() returns an array of audiovideo.writer.ProfileInfo objects that indicate the types of files that VideoWriter can create.

Examples

collapse all

View available profiles and get specific information about the 'Uncompressed AVI' profile.

View profiles that VideoWriter supports.

profiles = VideoWriter.getProfiles()
  Summary of installed VideoWriter profiles:

          Name                                     Description                              
    ---------------- -----------------------------------------------------------------------
    Archival         Video file compression with JPEG 2000 codec with lossless mode enabled.
    Grayscale AVI    An AVI file with Grayscale Video Data
    Indexed AVI      An AVI file with Indexed Video Data
    Motion JPEG 2000 Video file compression with JPEG 2000 codec.
    Motion JPEG AVI  An AVI file with Motion JPEG compression
    Uncompressed AVI An AVI file with uncompressed RGB24 video data

Find the index number for the 'Uncompressed AVI' profile.

uncompAVI = find(ismember({profiles.Name},'Uncompressed AVI'));

View the properties of the 'Uncompressed AVI' profile.

profiles(uncompAVI)
  audiovideo.writer.ProfileInfo

    ProfileInfo Properties:

       Name:                     'Uncompressed AVI'
       Description:              'An AVI file with uncompressed RGB24 video data'
       FileExtensions:           {'.avi'}
       ColorChannels:            3
       FrameRate:                30
       VideoBitsPerPixel:        24
       VideoCompressionMethod:   'None'
       VideoFormat:              'RGB24'

Get the file extensions associated with the profile.

ext = profiles(uncompAVI).FileExtensions
ext = 1x1 cell array
    {'.avi'}

Output Arguments

collapse all

Supported profiles and video file formats, returned as an array of audiovideo.writer.ProfileInfo objects, which have the following read-only properties.

PropertyDescription

Name

Character vector indicating the profile name, such as 'Uncompressed AVI'.

Description

Character vector indicating the description of the profile.

FileExtensions

Cell array of character vectors containing file extensions supported by the file format.

ColorChannels

Number of color channels in each output video frame.

CompressionRatio

Number greater than 1 that specifies the target ratio between the number of bytes in the input image and the number of bytes in the compressed image. Only applies to objects associated with Motion JPEG 2000 files. Default: 10.

FrameRate

Rate of playback for the video in frames per second. Default: 30.

LosslessCompression

Boolean value (logical true or false) that specifies whether to use reversible mode, so that the decompressed data is identical to the input data. When true, VideoWriter ignores values for CompressionRatio. Only applies to objects associated with Motion JPEG 2000 files.

MJ2BitDepth

Number of least-significant bits in the input image data, from 1 to 16. Applied only to objects associated with Motion JPEG 2000 files.

Quality

Number from 0 through 100. Higher values correspond to higher quality video and larger files. Only applies to objects associated with the MPEG-4 or Motion JPEG AVI profile. Default: 75.

VideoBitsPerPixel

Number of bits per pixel in each output video frame.

VideoCompressionMethod

Character vector indicating the type of video compression, such as 'None' or 'Motion JPEG'.

VideoFormat

Character vector indicating the MATLAB® representation of the video format, such as 'RGB24'.

Version History

Introduced in R2010b

See Also