IDLgrMPEG

An IDLgrMPEG object creates an MPEG movie file from an array of image frames.

Superclasses

This class has no superclasses.

Subclasses

This class has no subclasses.

Creation

See IDLgrMPEG::Init

Methods

Intrinsic Methods

This class has the following methods:


IDLgrMPEG::Cleanup

The IDLgrMPEG:: Cleanup procedure method performs all cleanup on the object. IDLgrMPEG is described above.

Calling Sequence

OBJ_DESTROY, Obj

or

Obj -> [IDLgrMPEG::] Cleanup                               ( In a subclass' Cleanup method only .)

Arguments

There are no arguments for this method.

Keywords

There are no keywords for this method.


IDLgrMPEG::GetProperty

The IDLgrMPEG:: GetProperty procedure method retrieves the value of a property or group of properties for the MPEG object. IDLgrMPEG is described above.

Calling Sequence

Obj -> [IDLgrMPEG::] GetProperty

Arguments

There are no arguments for this method.

Keywords

Any keyword to IDLgrMPEG::Init

ALL

Set this keyword to a named variable that will contain an anonymous structure containing the values of all of the retrievable properties associated with this object.


IDLgrMPEG::Init

The IDLgrMPEG:: Init function method initializes the MPEG object. IDLgrMPEG is described above.

Calling Sequence

Obj = OBJ_NEW('IDLgrMPEG')

or

Result = Obj -> [IDLgrMPEG::] Init()         ( In a subclass' Init method only .)

Arguments

There are no arguments for this method.

Keywords

Properties retrievable via IDLgrMPEG::GetProperty

DIMENSIONS (Get, Set)

Set this keyword to a 2-element array specifying the dimensions (in pixels) of each of the images to be used as frames for the movie. If this property is not specified, the dimensions of the first image loaded will be used. Once IDLgrMPEG::Put has been called, this keyword can no longer be set.

FILENAME (Get, Set)

Set this keyword to a string representing the name of the file in which the encoded MPEG sequence is to be stored. The default is 'idl.mpg' .

FORMAT (Get, Set)

Set this keyword to one of the following values to specify the type of MPEG encoding to use:

FRAME_RATE (Get, Set)

Set this keyword to one of the following integer values to specify the frame rate used in creating the MPEG file:

INTERLACED (Get, Set)

Set this keyword to indicate that frames in the encoded MPEG file should be interlaced. The default is non-interlaced.

QUALITY (Get, Set)

Set this keyword to a value in the range from 0 (low quality) to 100 (high quality) indicating the quality at which the MPEG stream is to be stored. Higher quality factors result in lower rates of compression. The default is 100.

SCALE (Get, Set)

Set this keyword to a two-element vector, [ xscale , yscale ], indicating the scale factors to be stored with the MPEG file as hints for playback. The default is [1.0, 1.0], indicating that the movie should be played back at the dimensions of the stored image frames.

STATISTICS (Get, Set)

Set this keyword to save statistical information about MPEG encoding for the supplied image frames in a file when the IDLgrMPEG::Save method is called. The information will be saved in a file with a name that matches that specified by the FILENAME keyword, with the extension " .stat ". By default, statistics are not saved.

TEMP_DIRECTORY

Set the keyword to a string value which specifies a directory in which to place temporary files while creating the MPEG movie file. The default value is platform specific.

 

 


IDLgrMPEG::Put

The IDLgrMPEG:: Put procedure method puts a given image into the MPEG sequence at the specified frame. Note that all images in a given MPEG movie must have matching dimensions. If no dimensions were explicitly specified when the MPEG object was initialized, the dimensions will be set according to the dimensions of the first image. IDLgrMPEG is described above.

Calling Sequence

Obj -> [IDLgrMPEG::] Put, Image [, Frame]

Arguments

Image

An instance of an IDLgrImage object or a m x n or 3 x m x n array representing the image to be loaded at the given frame.

Frame

An integer specifying the index of the frame at which the image is to be added. Frame indices start at zero. If Frame is not supplied, the frame number used will be one more than the last frame that was put. Frame number need not be consecutive; in case of a gap in frame numbers, the frame before the gap is repeated to fill the space.

Keywords

There are no keywords for this method.


IDLgrMPEG::Save

The IDLgrMPEG:: Save procedure method encodes and saves the MPEG sequence to the specified filename. IDLgrMPEG is described above.

Calling Sequence

Obj -> [IDLgrMPEG::] Save

Arguments

There are no arguments for this method.

Keywords

CREATOR_TYPE

Set this keyword to a four character string representing the creator string to be used when writing this file on a Macintosh. This property is ignored if the current platform is not a Macintosh. The default is TVOD (Apple Movie Player application).

FILENAME

Set this keyword to a string representing the name of the file in which the encoded MPEG sequence is to be stored. The default is idl.mpg .


IDLgrMPEG::SetProperty

The IDLgrMPEG:: SetProperty procedure method sets the value of a property or group of properties for the legend. IDLgrMPEG is described above.

Calling Sequence

Obj -> [IDLgrMPEG::] SetProperty

Arguments

There are no arguments for this method.

Keywords

Any keyword to IDLgrMPEG::Init