Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Editing Movies

PutMovieIntoTypedHandle

The PutMovieIntoTypedHandle function takes a movie (or a single track from within that movie) and converts it into a handle of a specified type.

pascal OSErr PutMovieIntoTypedHandle (Movie theMovie, 
                                    Track targetTrack, 
                                    OSType handleType, 
                                    Handle publicMovie, 
                                    TimeValue start, 
                                    TimeValue dur, 
                                    long flags, 
                                    ComponentInstance userComp);

theMovie

Specifies the movie to convert.

targetTrack

Specifies the track to convert.

handleType

Indicates the type of the new data.

publicMovie

Contains the actual handle in which to place the new data.

start

Specifies the start time of the segment of the movie or track
to be converted.

dur

Specifies the duration of the segment of the movie or track
to be converted.

flags

Indicates condition of the conversion. Set this parameter to 0.

userComp

Indicates a component or component instance of the movie export component you want to perform the conversion. Otherwise, set this parameter to 0 for the Movie Toolbox to choose the appropriate component. If you pass in a component instance, it will be used by PutMovieIntoTypedHandle. This allows you to communicate directly with the component before using this function to establish any conversion parameters. If you pass in a component ID, an instance is created and closed within this function. For details on movie export components, see Inside Macintosh: QuickTime Components.