Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movie Functions

ConvertMovieToFile

The ConvertMovieToFile function takes a specified movie (or a single track within that movie) and converts it into a specified file and type.

pascal OSErr ConvertMovieToFile(Movie theMovie, Track onlyTrack,
                               const FSSpec *outputFile, 
                               OSType fileType, OSType creator,
                               ScriptCode scriptTag, 
                               short *resID, long flags,
                               ComponentInstance userComp);

theMovie

Specifies the source movie for this conversion operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

onlyTrack

Specifies the track within the source movie for this conversion operation. To specify all tracks, set the value of this parameter to 0.

outputFile

Contains a pointer to the file specification for the destination file.

fileType

Specifies the data type of the destination file for the movie specified in the parameter theMovie.

creator

Specifies the creator value for the output file if it is a new one.

scriptTag

Specifies the script into which the movie should be converted if the output file is a new one. Use the Script Manager constant smSystemScript to use the system script; use the smCurrentScript constant to use the current script. See Inside Macintosh: Text for more information about scripts and script tags.

resID

Contains a pointer to a field that is to receive the resource ID of the open movie. If you don't want to receive this information, set the resID parameter to nil.

flags

Set this parameter to 0.

userComp

If you want a particular movie export component to perform the conversion, you may pass the component or an instance of that component in this parameter. Otherwise, set it to 0 to allow the Movie Toolbox to use the appropriate component. If you pass in a component instance, it is used by ConvertMovieToFile. This allows you to communicate directly with the component before making this call to establish any conversion parameters. If you pass in a component ID, an instance is created and closed within this call.