Apple Developer Connection
Member Login Log In | Not a Member? Contact ADC

Next Page > Hide TOC

Movie Manager Reference

Framework
Frameworks/QuickTime.framework
Declared in
Controls.h
HIObject.h
MacTypes.h
Movies.h
TextEdit.h

Overview

QuickTime movies have certain overall timing and other presentation characteristics that an application can manage, including the presentation of special kinds of media such as flash media and sprites.

Functions by Task

Controlling Movie Playback

Creating and Disposing of Time Bases

Determining Movie Creation and Modification Time

Disabling Movies and Tracks

Enhancing Movie Playback Performance

Error Functions

Generating Pictures From Movies

High-Level Movie Editing Functions

Initializing the Movie Toolbox

Managing Movie Sprites

Managing Sprite Images Outside a Movie

Managing the Video Frame Playback Rate

Movie Functions

Movie Posters and Movie Previews

Movie Toolbox Clock Support Functions

Movies and Your Event Loop

Preferred Movie Settings

Saving Movies

Text Media Handler Functions

The Sound Description Structure

Time Base Callback Functions

Using the OpenGL Texture Context

Working With Movie Spatial Characteristics

Working With Movie Time

Working With Progress and Cover Functions

Working With Sound Descriptions

Working With Sound Volume

Working With The Idle Manager

Working With Time Base Values

Working With Times

Working With User Data

Working With Wired Sprites

Supporting Functions

Functions

AbortPrePrerollMovie

Terminates the operation of PrePrerollMovie.

void AbortPrePrerollMovie (
   Movie m,
   OSErr err
);

Parameters
m

The movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle.

err

See Error Codes. Returns noErr if there is no error.

Discussion

You normally call this function only if you have previously called PrePrerollMovie asynchronously and the user quits your application.

Version Notes

Introduced in QuickTime 4.

Availability
Declared In
Movies.h

AddCallBackToTimeBase

Places a callback event into the list of scheduled callback events.

OSErr AddCallBackToTimeBase (
   QTCallBack cb
);

Parameters
cb

Specifies the callback event for the operation. Your clock component obtains this value from the parameters passed to ClockCallMeWhen.

Return Value

You can access Movie Toolbox error returns through GetMoviesError and GetMoviesStickyError, as well as in the function result. See Error Codes.

Discussion

If your component calls this function, the Movie Toolbox notifies it of time, rate, or stop and start changes via ClockRateChanged and ClockTimeChanged.

Version Notes

Introduced in QuickTime 3 or earlier.

Availability
Declared In
Movies.h

AddTime

Adds two times.

void AddTime (
   TimeRecord *dst,
   const TimeRecord *src
);

Parameters
dst

A pointer to a time structure. This time structure contains one of the operands for the addition. AddTime returns the result of the addition into this time structure.

src

A pointer to a time structure. The Movie Toolbox adds this value to the time or duration specified by the dst parameter.

Return Value

You can access this function's error returns through GetMoviesError and GetMoviesStickyError.

Discussion

You must specify the input times in time structures. The result value is formatted as a duration or a time value, the same as the format of the structure pointed to by the dst parameter.

Version Notes

Introduced in QuickTime 3 or earlier.

Availability
Declared In
Movies.h