Mac OS X Reference Library Apple Developer
Search

QTMovieLayer Class Reference

Inherits from
Conforms to
Framework
/System/Library/Frameworks/QTKit.framework
Availability
Available in QuickTime 7.2.1 and later.
Declared in
QTMovieLayer.h
Related sample code

Overview

This class provides a layer into which the frames of a QTMovie can be drawn, and is intended to provide support for Core Animation, that is, drawing the contents of a movie into a layer. QTMovieLayer renders a QTMovie within a layer hierarchy. Note that this class requires rendering using visual contexts. Do not attempt to directly modify the contents property of an QTMovieLayer object. Doing so will effectively turn it into a regular CALayer.

Tasks

Creating Movie Layers

Class Methods

layerWithMovie:

Creates an autoreleased QTMovieLayer associated with the specified QTMovie object.

+ (id)layerWithMovie:(QTMovie *)movie

Parameters
movie

The QuickTime movie with which to create an autoreleased QuickTime layer object.

Discussion

By default, the movie starts playing immediately at rate 1.0 from the beginning of the movie. These default characteristics can be modified by setting layer properties or movie properties.

Availability
  • Mac OS X v10.5 and later.
Declared In
QTMovieLayer.h

Instance Methods

initWithMovie:

Creates a QTMovieLayer associated with the specified QTMovie object.

- (id)initWithMovie:(QTMovie *)movie

Parameters
movie

The QuickTime movie with which to initialize the QuickTime layer object.

Discussion

This is the designated initializer. By default, the movie starts playing immediately at rate 1.0 from the beginning of the movie. These default characteristics can be modified by setting layer properties or movie properties.

Availability
  • Mac OS X v10.5 and later.
Declared In
QTMovieLayer.h

movie

Returns the movie associated with a QTMovieLayer object.

- (QTMovie *)movie

Availability
  • Mac OS X v10.5 and later.
Declared In
QTMovieLayer.h

setMovie:

Sets the QTMovie object in a QTMovieLayer to movie.

- (void)setMovie:(QTMovie *)movie

Discussion

The currently set QuickTime movie is disposed of using DisposeMovie, unless the QTMovie was created with a call to initWithQuickTimeMovie and the disposeWhenDone flag was NO.

Availability
  • Available in Mac OS X v10.5 and later.
Declared In
QTMovieLayer.h



Last updated: 2009-05-20

Did this document help you? Yes It's good, but... Not helpful...