---

Editing Movies

This chapter describes the functions of the movie toolbox that your application will use to edit movies and tracks. You will need to read this chapter if your application provides editing functions beyond those that are built into the movie controller.

The Movie Toolbox provides a set of high-level functions that allow you to edit movies. This chapter describes these high-level editing functions. These functions work with a movie’s current selection. The current selection is defined by a starting time and a duration.

The Movie Toolbox also provides functions that allow you to edit movie segments. Those functions are described in “Low-Level Movie-Editing Functions.”

The movies created by these functions contain references to the data in the source movie. Because the new movies contain references and not data, they are small and easily moved to and from the scrap. If you delete the movie that contains the data, the data references in the new movies are no longer valid and the new movies cannot be played. Therefore, before you delete the original movie, you should call the FlattenMovie function for each of the new movies. This function copies the data into each of the new movies, eliminating the data references.

Note that the Movie Toolbox does not always copy empty tracks from the source movie to the movies that are created by these functions. Specifically, the Movie Toolbox preserves the empty tracks until you paste or add the selection into the destination movie. At that time, the Movie Toolbox removes the empty tracks from the selection. In addition, if a track in the source movie has trailing empty space, the Movie Toolbox removes that empty space from the track when it is copied into the new movie. Therefore, if you want to add a segment beyond the end of a movie, you insert the space when you insert the new segment using the InsertMovieSegment function.

The Movie Toolbox allows you to paste different data types into a movie. For example, QuickDraw pictures and standard sound data can be pasted directly into a movie. If you are using the movie controller component, you do not need to use these functions to paste different data types into a movie. If you are calling the Movie Toolbox directly to do editing, you should use the functions described in this section.

Contents:

Handling Media Sample References
Manipulating Media Input Maps
Undo for Movies
Functions That Modify Movie Properties
Editing Tracks
Undo for Tracks
Selection and Scrap Functions
Low-Level Movie-Editing Functions
Summary of Editing Functions

---