Retired Document

Important: This sample code may not represent best practices for current development. The project may use deprecated symbols and illustrate technologies and techniques that are no longer recommended.

QTKitMovieFrameImage

Last Revision:	Version 1.0, 2007-08-31 Using the QTMovie frameImageAtTime: withAttributes: method to get an image for the frame at a given time in a QTMovie.
Build Requirements:	Xcode 3.0
Runtime Requirements:	Mac OS X Leopard, QuickTime 7.2.1 or better

This sample shows how to use the QTMovie frameImageAtTime: method to get an NSImage for the frame at a given time in a QTMovie.

Mac OS X Leopard contains a new version of this method that gives the ability to pass a dictionary of attributes describing exactly the kind of image you want:

- (NSImage *)frameImageAtTime:(QTTime)time withAttributes:(NSDictionary *)attributes error: (NSError **)errorPtr;

Previously, you always got back an NSImage of the current movie size from this method, even if this was not what was desired. This required a lot of post-processing of the returned image.

Now, you can specify the following attributes when calling this method:

QTMovieFrameImageSize

QTMovieFrameImageType

QTMovieFrameImageRepresentationsType

QTMovieFrameImageOpenGLContext

QTMovieFrameImagePixelFormat

QTMovieFrameImageInterlaced

QTMovieFrameImageHighQuality

QTMovieFrameImageSingleField

(See QTMovie.h for more details)

These give the developer much more control over the type of image that is returned.