If filename
does not include an extension, then .avi is used. The file must be in the current
working directory or in a directory on the MATLAB path.
The set of fields in the fileinfo structure are shown below.
Field Name
Description
AudioFormat
A string containing the name of the format used
to store the audio data, if audio data is present
AudioRate
An integer indicating the sample rate in Hertz of
the audio stream, if audio data is present
Filename
A string specifying the name of the file
FileModDate
A string containing the modification date of the
file
FileSize
An integer indicating the size of the file in bytes
FramesPerSecond
An integer indicating the desired frames per
second
Height
An integer indicating the height of the AVI movie
in pixels
ImageType
A string indicating the type of image. Either
'truecolor' for a truecolor (RGB) image, or
'indexed' for an indexed image.
NumAudioChannels
An integer indicating the number of channels in
the audio stream, if audio data is present
NumFrames
An integer indicating the total number of frames
in the movie
2-81
aviinfo
Field Name
Description
NumColormapEntries
An integer specifying the number of colormap
entries
Quality
A number between 0 and 100 indicating the video
quality in the AVI file. Higher quality numbers
indicate higher video quality; lower quality
numbers indicate lower video quality. This value
is not always set in AVI files and therefore may be
inaccurate.
VideoCompression
A string containing the compressor used to
compress the AVI file. If the compressor is not
Microsoft Video 1, Run Length Encoding (RLE),
Cinepak, or Intel Indeo, aviinfo returns a
four-character code.
Width
An integer indicating the width of the AVI movie
in pixels
See also
avifile, aviread
2-82
aviread
2aviread
Purpose
Read an Audio Video Interleaved (AVI) file.
Syntax
mov = aviread(filename)
mov = aviread(filename,index)
Description
mov = aviread(filename) reads the AVI movie filename into the MATLAB
movie structure mov. If filename does not include an extension, then .avi is
used. Use the movie function to view the movie, mov. On UNIX, filename must
be an uncompressed AVI file.
mov has two fields, cdata and colormap. The content of these fields varies
depending on the type of image.
Image Type
mov.cdata Field
mov.colormap Field
Truecolor
height-by-width-by-3
Empty
array
Indexed
height-by-width array
m-by-3 array
mov = aviread(filename,index) reads only the frame(s) specified by index.
index can be a single index or an array of indices into the video stream. In AVI
files, the first frame has the index value 1, the second frame has the index
value 2, and so on.
See also
aviinfo, avifile, movie
2-83
axes
2axes
Purpose
Create axes graphics object
Syntax
axes
axes(' PropertyName',PropertyValue,...)
axes(h)
h = axes(...)
Description
axes is the low-level function for creating axes graphics objects.
axes creates an axes graphics object in the current figure using default
property values.
axes(' PropertyName',PropertyValue,...) creates an axes object having the
specified property values. MATLAB uses default values for any properties that
you do not explicitly define as arguments.
axes(h) makes existing axes h the current axes. It also makes h the first axes
listed in the figure’s Children property and sets the figure’s CurrentAxes
property to h. The current axes is the target for functions that draw image, line,
patch, surface, and text graphics objects.
h = axes(...) returns the handle of the created axes object.
Remarks
MATLAB automatically creates an axes, if one does not already exist, when
you issue a command that draws image, light, line, patch, surface, or text
graphics objects.
The axes function accepts property name/property value pairs, structure
arrays, and cell arrays as input arguments (see the set and get commands for
examples of how to specify these data types). These properties, which control
various aspects of the axes object, are described in the “Axes Properties”
section.