Mac Developer Library

Developer

QTKit Framework Reference QTMovie Class Reference

Options
Deployment Target:

On This Page
Language:

QTMovie

A QTMovie object is an object that represents a playable collection of media data.

A QTMovie object can be initialized from a file, from a resource specified by a URL, from a block of memory, from a pasteboard, or from an existing QuickTime movie. Once a QTMovie object has been initialized, it will typically be used in combination with a QTMovieView for playback. It can also be used for other purposes, such as converting the media data into a different format.

The designated initializer for the QTMovie class is initWithAttributes:error:, whose first parameter is a dictionary of attribute keys and their desired values. One of these attributes must specify the location of the media data (for instance, using the QTMovieURLAttribute key). Other attributes may specify desired movie-opening behaviors, and others still may specify desired initial values of QTMovie properties (for instance, QTMovieVolumeAttribute).

There are two movie-opening behaviors. Specifying QTMovieOpenForPlaybackAttribute with the value YEStrue indicates that the QTMovie object will be used only for playback, in which case QTKit may be able to use more efficient code paths for some media data. Specifying QTMovieOpenAsyncRequiredAttribute with the value YEStrue indicates that all operations necessary to open the movie file (or other container) and to create a valid QTMovie object must occur asynchronously. In other words, initWithAttributes:error: will return almost immediately, performing any lengthy operations on another thread.

An exception, QTDisallowedForInitializationPurposeException, is raised whenever the client attempts to call a method that is not allowed under a requested movie-opening behavior. For example, if a QTMovie object is initialized with QTMovieOpenForPlaybackAttribute set to YEStrue, then QTDisallowedForInitializationPurposeException is raised if the client attempts to call methods that export the media data. An exception, QTMovieUneditableException, is raised whenever the client attempts to directly or indirectly edit a QTMovie object that is not currently set as editable (for instance, by calling appendSelectionFromMovie: on an uneditable movie).

Inheritance


Conforms To


Import Statement


Swift

import QTKit

Objective-C

@import QTKit;

Availability


Available in OS X v10.4 and later.
  • Returns YEStrue if the contents of the specified file can be used to initialize a QTMovie object.

    Declaration

    Objective-C

    + (BOOL)canInitWithFile:(NSString *)fileName

    Parameters

    fileName

    An NSString object that specifies a full pathname to a file.

    Return Value

    YEStrue if a QTMovie object can be initialized from the specified file, NOfalse otherwise.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns YEStrue if the contents of the specified URL can be used to initialize a QTMovie object.

    Declaration

    Objective-C

    + (BOOL)canInitWithURL:(NSURL *)url

    Parameters

    url

    An NSURL object.

    Return Value

    YEStrue if a QTMovie object can be initialized from the specified URL, NOfalse otherwise.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns YEStrue if the contents of the specified pasteboard can be used to initialize a QTMovie object.

    Declaration

    Objective-C

    + (BOOL)canInitWithPasteboard:(NSPasteboard *)pasteboard

    Parameters

    pasteboard

    An NSPasteboard object.

    Return Value

    YEStrue if a QTMovie object can be initialized from the specified pasteboard, NOfalse otherwise.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns YEStrue if the specified data reference can be used to initialize a QTMovie object.

    Declaration

    Objective-C

    + (BOOL)canInitWithDataReference:(QTDataReference *)dataReference

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Initializes a QTMovie object with the contents of the pasteboard specified by pasteboard.

    Declaration

    Objective-C

    - (id)initWithPasteboard:(NSPasteboard *)pasteboard error:(NSError **)errorPtr

    Discussion

    These contents can be a QuickTime movie (of type Movie), a file path, or data of type QTMoviePasteBoardType. If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns an array of file types that can be opened as QuickTime movies.

    Declaration

    Objective-C

    + (NSArray *)movieFileTypes:(QTMovieFileTypeOptions)types

    Discussion

    Passing zero as the options parameter returns an array of all the common file types that QuickTime can open in place on the current system. This array includes the file type .mov and .mqv, and any files types that can be opened using a movie importer that does not need to write data into a new file while performing the import. This array excludes any file types for still images and any file types that require an aggressive movie importer (for instance, the movie importer for text files). For more information, refer to Constants For Use With movieFileTypes: Method.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns an array of UTIs that QuickTime can open.

    Declaration

    Objective-C

    + (NSArray *)movieTypesWithOptions:(QTMovieFileTypeOptions)types

    Discussion

    This method gets an array of NSString objects that specify the uniform type identifiers (UTIs) for types of files that QuickTime can open. The types parameter is interpreted just like the types parameter to + (NSArray *)movieFileTypes:(QTMovieFileTypeOptions)types.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    QuickTime 7.2.1 or later.

    Deprecated in OS X v10.9.

  • Returns an array of file types that can be used to initialize a QTMovie object.

    Declaration

    Objective-C

    + (NSArray *)movieUnfilteredFileTypes

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns an array of pasteboard types that can be used to initialize a QTMovie object.

    Declaration

    Objective-C

    + (NSArray *)movieUnfilteredPasteboardTypes

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • movie + movie (OS X v10.9)

    Creates an empty QTMovie object.

    Declaration

    Objective-C

    + (id)movie

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTMovie object initialized with the data from the QuickTime movie of the specified name in the application’s bundle.

    Declaration

    Objective-C

    + (id)movieNamed:(NSString *)name error:(NSError **)errorPtr

    Discussion

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTMovie object initialized with the data specified by data.

    Declaration

    Objective-C

    + (id)movieWithData:(NSData *)data error:(NSError **)errorPtr

    Discussion

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTMovie object initialized with the data in the URL specified by url.

    Declaration

    Objective-C

    + (id)movieWithURL:(NSURL *)url error:(NSError **)errorPtr

    Discussion

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTMovie object initialized with the contents of the pasteboard specified by pasteboard.

    Declaration

    Objective-C

    + (id)movieWithPasteboard:(NSPasteboard *)pasteboard error:(NSError **)errorPtr

    Discussion

    These contents can be a QuickTime movie (of type Movie), a file path, or data of type QTMoviePasteboardType.

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTMovie object initialized with the data in the file specified by the name fileName.

    Declaration

    Objective-C

    + (id)movieWithFile:(NSString *)fileName error:(NSError **)errorPtr

    Discussion

    The fileName is assumed to be a full path name for a file.

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTMovie object initialized with the data specified by the data reference dataReference.

    Declaration

    Objective-C

    + (id)movieWithDataReference:(QTDataReference *)dataReference error:(NSError **)errorPtr

    Discussion

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a QTMovie object initialized from an existing QuickTime movie movie.

    Declaration

    Objective-C

    + (id)movieWithQuickTimeMovie:(Movie)movie disposeWhenDone:(BOOL)dispose error:(NSError **)errorPtr

    Discussion

    This method cannot be called by 64-bit applications.

    The dispose parameter (a BOOL) indicates whether the QTKit should call DisposeMovie on the specified movie when the QTMovie object is deallocated. Passing YEStrue effectively transfers “ownership” of the Movie to the QTKit. (Note that most applications will probably want to pass YEStrue; passing NOfalse means that the application wants to call DisposeMovie itself, perhaps so that it can operate on a Movie after it has been disassociated with a QTMovie object.)

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Note that command-line tools that pass NOfalse for the disposeWhenDone parameter must make sure to release the active autorelease pool before calling DisposeMovie on the specified QuickTime movie. Failure to do this may result in a crash. Tools that need to call DisposeMovie before releasing the main autorelease pool can create another autorelease pool associated with the movie.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

    Not available to 64-bit applications.

  • Creates a QTMovie object initialized with the attributes specified in attributes.

    Declaration

    Objective-C

    + (id)movieWithAttributes:(NSDictionary *)attributes error:(NSError **)errorPtr

    Parameters

    attributes

    An NSDictionary object whose key-value pairs specify the attributes to use when initializing the movie.

    Discussion

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    A new QTMovie object is created using the specified attributes. There are three types of attributes that can be included in this dictionary:

    • Attributes that specify the location of the movie data, for instance, QTMovieFileNameAttribute.

    • Attributes that specify how the movie is to be instantiated, for instance, QTMovieOpenForPlaybackAttribute.

    • Attributes that specify playback characteristics of the movie or other properties of the QTMovie object, for instance, QTMovieVolumeAttribute.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • autoplay - autoplay (OS X v10.9)

    Sets a movie to start playing when a sufficient amount of media data is available.

    Declaration

    Objective-C

    - (void)autoplay

    Discussion

    The autoplay method configures a QTMovie object to begin playing as soon as enough data is available that the playback can continue uninterrupted to the end of the movie. This is most useful for movies being loaded from a remote URL or from an extremely slow local device. For movies stored on most local devices, this method has the same effect as the -[QTMovie play] method.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    QuickTime 7.2.1 or later.

    Deprecated in OS X v10.9.

  • play - play (OS X v10.9)

    Plays the movie.

    Declaration

    Objective-C

    - (void)play

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • stop - stop (OS X v10.9)

    Stops the movie playing.

    Declaration

    Objective-C

    - (void)stop

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Repositions the play position to the beginning of the movie.

    Declaration

    Objective-C

    - (void)gotoBeginning

    Discussion

    If the movie is playing, the movie continues playing from the new position.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • gotoEnd - gotoEnd (OS X v10.9)

    Repositions the play position to the end of the movie.

    Declaration

    Objective-C

    - (void)gotoEnd

    Discussion

    If the movie is playing in one of the looping modes, the movie continues playing accordingly; otherwise, play stops.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Repositions the movie to the next selection point.

    Declaration

    Objective-C

    - (void)gotoNextSelectionPoint

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Repositions the movie to the previous selection point.

    Declaration

    Objective-C

    - (void)gotoPreviousSelectionPoint

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Repositions the play position to the movie’s poster time.

    Declaration

    Objective-C

    - (void)gotoPosterTime

    Discussion

    If no poster time is defined, the movie jumps to the beginning. If the movie is playing, the movie continues playing from the new position.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Sets the movie’s current time setting to time.

    Declaration

    Objective-C

    - (void)setCurrentTime:(QTTime)time

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • stepForward - stepForward (OS X v10.9)

    Sets the movie forward a single frame.

    Declaration

    Objective-C

    - (void)stepForward

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Sets the movie backward a single frame.

    Declaration

    Objective-C

    - (void)stepBackward

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Performs any QuickTime-specific initialization for the current (non-main) thread; must be paired with a call to exitQTKitOnThread.

    Declaration

    Objective-C

    + (void)enterQTKitOnThread

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Performs any QuickTime-specific initialization for the current (non-main) thread, allowing non-thread-safe components; must be paired with a call to exitQTKitOnThread.

    Declaration

    Objective-C

    + (void)enterQTKitOnThreadDisablingThreadSafetyProtection

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Performs any QuickTime-specific shut-down for the current (non-main) thread; must be paired with a call to enterQTKitOnThread or enterQTKitOnThreadDisablingThreadSafetyProtection.

    Declaration

    Objective-C

    + (void)exitQTKitOnThread

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Attaches the receiver to the current thread; returns YES if successful, NO otherwise.

    Declaration

    Objective-C

    - (BOOL)attachToCurrentThread

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Detaches the receiver from the current thread; returns YES if successful, NO otherwise.

    Declaration

    Objective-C

    - (BOOL)detachFromCurrentThread

    Discussion

    These methods allow applications to manage QTMovie objects on non-main threads. Before any QTKit operations can be performed on a secondary thread, either enterQTKitOnThread or enterQTKitOnThreadDisablingThreadSafetyProtection must be called, and exitQTKitOnThread must be called before exiting the thread. A QTMovie object can be migrated from one thread to another by first calling detachFromCurrentThread on the first thread and then attachToCurrentThread on the second thread.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Initializes a QTMovie object with the data in the file specified by the name fileName.

    Declaration

    Objective-C

    - (id)initWithFile:(NSString *)fileName error:(NSError **)errorPtr

    Discussion

    The fileName is assumed to be a full path name for a file. If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Note that alias files should not be passed into this method; the client application is responsible for resolving aliases before handing them to QTKit methods.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Initializes a QTMovie object with the data in the URL specified by url.

    Declaration

    Objective-C

    - (id)initWithURL:(NSURL *)url error:(NSError **)errorPtr

    Discussion

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Initializes a QTMovie object with the data specified by data.

    Declaration

    Objective-C

    - (id)initWithData:(NSData *)data error:(NSError **)errorPtr

    Discussion

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Initializes a QTMovie object with the data reference setting specified by dataReference.

    Declaration

    Objective-C

    - (id)initWithDataReference:(QTDataReference *)dataReference error:(NSError **)errorPtr

    Discussion

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Initializes a QTMovie object with some or all of the data from an existing QTMovie object movie.

    Declaration

    Objective-C

    - (id)initWithMovie:(QTMovie *)movie timeRange:(QTTimeRange)range error:(NSError **)errorPtr

    Discussion

    The section of data used is delimited by the range range. If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Initializes a QTMovie object with the data from an existing QuickTime movie movie.

    Declaration

    Objective-C

    - (id)initWithQuickTimeMovie:(Movie)movie disposeWhenDone:(BOOL)dispose error:(NSError **)errorPtr

    Parameters

    movie

    A QuickTime movie (of type Movie).

    dispose

    A BOOL value that indicates whether QTKit should call DisposeMovie on the specified QuickTime movie when the QTMovie object is deallocated. Passing YEStrue effectively transfers ownership of the Movie to QTKit.

    Discussion

    This method cannot be called by 64-bit applications.

    This is the designated initializer for the QTMovie class. The dispose parameter (a BOOL) indicates whether the QTKit should call DisposeMovie on the specified movie when the QTMovie object is deallocated. Passing YEStrue effectively transfers “ownership” of the Movie to the QTKit. (Note that most applications will probably want to pass YEStrue; passing NOfalse means that the application wants to call DisposeMovie itself, perhaps so that it can operate on a Movie after it has been disassociated from a QTMovie object.) Command-line tools that pass NO for the dispose parameter must make sure to release the active autorelease pool before calling DisposeMovie on the specified QuickTime movie. Failure to do this may result in a crash. Tools that need to call DisposeMovie before releasing the main autorelease pool can create another autorelease pool associated with the movie.

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

    Not available to 64-bit applications.

  • Initializes a QTMovie object with the attributes specified in attributes.

    Declaration

    Objective-C

    - (id)initWithAttributes:(NSDictionary *)attributes error:(NSError **)errorPtr

    Parameters

    attributes

    An NSDictionary object whose key-value pairs specify the attributes to use when initializing the movie.

    Discussion

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    A new QTMovie object is created using the specified attributes. There are three types of attributes that can be included in this dictionary:

    • Attributes that specify the location of the movie data, for instance, QTMovieFileNameAttribute.

    • Attributes that specify how the movie is to be instantiated, for instance, QTMovieOpenForPlaybackAttribute.

    • Attributes that specify playback characteristics of the movie or other properties of the QTMovie object, for instance, QTMovieVolumeAttribute.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • hasChapters - hasChapters (OS X v10.9)

    Returns YES if the receiver has chapters, NO otherwise.

    Declaration

    Objective-C

    - (BOOL)hasChapters

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Returns the number of chapters in the receiver, or 0 if there are no chapters.

    Declaration

    Objective-C

    - (NSInteger)chapterCount

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • chapters - chapters (OS X v10.9)

    Returns an NSArray containing information about the chapters in the receiver.

    Declaration

    Objective-C

    - (NSArray *)chapters

    Discussion

    Each array element is an NSDictionary containing key-value pairs. Currently two keys are defined for this dictionary, QTMovieChapterName and QTMovieChapterStartTime. The value for the QTMovieChapterName key is an NSString object that is the chapter name. The value for the QTMovieChapterStartTime key is an NSValue object that wraps a QTTime structure that indicates the start time of the chapter.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Adds chapters to the receiver using the information specified in the chapters array. 

    Declaration

    Objective-C

    - (void)addChapters:(NSArray *)chapters withAttributes:(NSDictionary *)attributes error:(NSError **)errorPtr

    Parameters

    chapters

    An NSArray that contains one dictionary per chapter. The dictionary entries are:

    • QTMovieChapterName, an NSString object that is the chapter name.

    • QTMovieChapterStartTime, an NSValue object that wraps a QTTime structure that indicates the start time of the chapter.

    attributes

    An NSDictionary that contains settings for the new chapter track and its text. The following keys are currently recognized:

    • QTMovieChapterTargetTrackAttribute, a QTTrack that is the target of the chapter track; if none is specified, use first video track in movie.

    • QTTrackDisplayNameAttribute, an NSString that is the name of the chapter track; if none is specified, use "Chapter Track".

    • QTTrackTimeScaleAttribute, an NSNumber that wraps a long; this is the time scale of the chapter track. If not present, the time scale of the target track is used.

    • QTTrackBoundsAttribute, an NSValue that wraps an NSRect that specifies the desired position and size of the chapter track. The default width and height are those of the receiver QTMovie object.

    • QTTrackEnabledAttribute, an NSNumber that wraps a BOOL; if YEStrue, the chapter track is enabled, otherwise disabled (which is the default).

    • QTTrackLayerAttribute, an NSNumber that wraps a short; this is the layer of the chapter track (default is -1).

    errorPtr

    A pointer to an NSError instance; if non-NULL, return any error in that location.

    Discussion

    Each array element is an NSDictionary containing key-value pairs. Currently two keys are defined for this dictionary, QTMovieChapterName and QTMovieChapterStartTime. The value for the QTMovieChapterName key is an NSString object that is the chapter name. The value for the QTMovieChapterStartTime key is an NSValue object that wraps a QTTime structure that indicates the start time of the chapter. The receiving QTMovie object must be editable or an exception will be raised.

    The attributes dictionary specifies additional attributes for the chapters. Currently only one key is recognized for this dictionary, QTMovieChapterTargetTrackAttribute, which specifies the QTTrack in the receiver that is the target of the chapters; if none is specified, this method uses first video track in movie. If no video track is in the movie, this method uses the first audio track in the movie. If no audio track is in the movie, this method uses the first track in the movie. If an error occurs and errorPtr is non-NULL, then an NSError object is returned in that location.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    OS X v10.5 and later.

    Deprecated in OS X v10.9.

  •  Removes any existing chapters from the receiver.

    Declaration

    Objective-C

    - (BOOL)removeChapters

    Discussion

    Returns YES if either the receiver had no chapters or the chapters were successfully removed from the receiver. Returns NO if the chapters could not for some reason be removed from the receiver. The receiving QTMovie object must be editable or an exception will be raised.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Returns a QTTime structure that is the start time of the chapter having the specified 0-based index in the list of chapters.

    Declaration

    Objective-C

    - (QTTime)startTimeOfChapter:(NSInteger)chapterIndex

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Returns the 0-based index of the chapter that contains the specified movie time.

    Declaration

    Objective-C

    - (NSInteger)chapterIndexForTime:(QTTime)time

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • duration - duration (OS X v10.9)

    Returns the duration of a QTMovie object as a structure of type QTTime.

    Declaration

    Objective-C

    - (QTTime)duration

    Discussion

    This method can be called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • currentTime - currentTime (OS X v10.9)

    Returns the current time of a QTMovie object as a structure of type QTTime.

    Declaration

    Objective-C

    - (QTTime)currentTime

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • rate - rate (OS X v10.9)

    Returns the current rate of a QTMovie object.

    Declaration

    Objective-C

    - (float)rate

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • volume - volume (OS X v10.9)

    Returns the movie’s volume as a scalar value of type float.

    Declaration

    Objective-C

    - (float)volume

    Discussion

    The valid range is 0.0 to 1.0.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • muted - muted (OS X v10.9)

    Returns the movie’s mute setting.

    Declaration

    Objective-C

    - (BOOL)muted

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns a QTMovie object whose data is the data in the specified time range.

    Declaration

    Objective-C

    - (id)movieWithTimeRange:(QTTimeRange)range error:(NSError **)errorPtr

    Discussion

    If a QTMovie object cannot be created, an NSError object is returned in the location pointed to by errorPtr. Pass NIL if you do not want an NSError object returned.

    Special Considerations

    This method cannot be called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns the current value of the movie attribute attributeKey.

    Declaration

    Objective-C

    - (id)attributeForKey:(NSString *)attributeKey

    Discussion

    A list of supported movie attributes and their acceptable values can be found in the Settable and Gettable Movie Attributes section.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns a dictionary containing the current values of all defined movie attributes.

    Declaration

    Objective-C

    - (NSDictionary *)movieAttributes

    Discussion

    A list of supported movie attributes and their acceptable values can be found in the Settable and Gettable Movie Attributes section.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • setIdling: - setIdling: (OS X v10.9)

    Sets the movie to idle YEStrue or not to idle NOfalse.

    Declaration

    Objective-C

    - (void)setIdling:(BOOL)state

    Parameters

    state

    A Boolean value that indicates whether to idle the movie (YEStrue) or not (NOfalse).

    Discussion

    This method allows you to manage the idling state of a QTMovie object, that is, whether it is being tasked. Note that movies attached to a background thread should not be idled; if they are idled, unexpected behavior can result. This method cannot be called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • isIdling - isIdling (OS X v10.9)

    Returns the current idling state of a QTMovie object.

    Declaration

    Objective-C

    - (BOOL)isIdling

    Return Value

    YEStrue if the movie is idling, NOfalse otherwise.

    Discussion

    This method allows you to manage the idling state of a QTMovie object, that is, whether it is being tasked. Note that movies attached to a background thread should not be idled; if they are idled, unexpected behavior can result. This method cannot be called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • setRate: - setRate: (OS X v10.9)

    Sets the movie’s rate to rate.

    Declaration

    Objective-C

    - (void)setRate:(float)rate

    Discussion

    For instance, 0.0 is stop, 1.0 is playback at normal speed, 2.0 is twice normal speed, and so on.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • setVolume: - setVolume: (OS X v10.9)

    Sets the movie’s volume to volume.

    Declaration

    Objective-C

    - (void)setVolume:(float)volume

    Discussion

    Note that this does not affect the movie’s stored settings.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • setMuted: - setMuted: (OS X v10.9)

    Sets the movie’s mute setting to mute.

    Declaration

    Objective-C

    - (void)setMuted:(BOOL)mute

    Discussion

    Note that this does not affect the volume.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Set the movie attribute attributeKey to the value specified by the value parameter.

    Declaration

    Objective-C

    - (void)setAttribute:(id)value forKey:(NSString *)attributeKey

    Discussion

    A list of supported movie attributes and their acceptable values can be found in the Settable and Gettable Movie Attributes section.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Set the movie attributes using the key-value pairs specified in the dictionary attributes.

    Declaration

    Objective-C

    - (void)setMovieAttributes:(NSDictionary *)attributes

    Discussion

    A list of supported movie attributes and their acceptable values can be found in the Settable and Gettable Movie Attributes section.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Adds information to a QTMovie needed to support aperture modes for tracks created with applications and/or versions of QuickTime that did not support aperture mode dimensions.

    Declaration

    Objective-C

    - (void)generateApertureModeDimensions

    Discussion

    If the image descriptions in video tracks lack tags describing clean aperture and pixel aspect ratio information, the media data is scanned to see if the correct values can be divined and attached. Then the aperture mode dimensions are calculated and set. Afterwards, the QTTrackHasApertureModeDimensionsAttribute property will be set to YEStrue for those tracks. Tracks that do not support aperture modes are not changed.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Removes aperture mode dimension information from a movie's tracks.

    Declaration

    Objective-C

    - (void)removeApertureModeDimensions

    Discussion

    This method does not attempt to modify sample descriptions, so it may not completely reverse the effects of generateApertureModeDimensions. It sets the QTMovieHasApertureModeDimensionsAttribute property to NOfalse.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns the start time of the movie’s current selection as a QTTime structure.

    Declaration

    Objective-C

    - (QTTime)selectionStart

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns the end point of the movie’s current selection as a QTTime structure.

    Declaration

    Objective-C

    - (QTTime)selectionEnd

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns the duration of the movie’s current selection as a QTTime structure.

    Declaration

    Objective-C

    - (QTTime)selectionDuration

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Sets the movie’s selection to selection.

    Declaration

    Objective-C

    - (void)setSelection:(QTTimeRange)selection

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • tracks - tracks (OS X v10.9)

    Returns an array of QTTrack objects associated with the receiver.

    Declaration

    Objective-C

    - (NSArray *)tracks

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns an array of tracks with the specified media type.

    Declaration

    Objective-C

    - (NSArray *)tracksOfMediaType:(NSString *)type

    Discussion

    The type parameter should be one of the media types defined by constants in QTMedia.h beginning with "QTMediaType", for instance, QTMediaTypeVideo.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Creates a new storage container at the location specified by dataReference and returns a QTMovie object that has that container as its default data reference.

    Declaration

    Objective-C

    - (id)initToWritableDataReference:(QTDataReference *)dataReference error:(NSError **)errorPtr

    Special Considerations

    This method cannot be called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    QuickTime 7.2.1 or later.

    Deprecated in OS X v10.9.

  • invalidate - invalidate (OS X v10.9)

    Invalidates a QTMovie object immediately.

    Declaration

    Objective-C

    - (void)invalidate

    Discussion

    By the time this method has returned, the receiver will have detached itself from any resources it is using, disposing of these resources when appropriate. Attempting to make any non-trivial use of the receiver after invalidating it will result in undefined behavior. This method does not release the receiver, so under retain-release memory management, release must still be called on the receiver for it to be fully deallocated. Because this method defeats sharing of QTMovie objects, it should only be called when it is known that the object is no longer needed.

    Clients that pass NOfalse for the dispose parameter must invalidate the QTMovie object (by calling -[QTMovie invalidate]) before calling DisposeMovie on the specified QuickTime movie. Failure to do this may result in a crash.

    Special Considerations

    This method can be called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    QuickTime 7.2.1 or later.

    Deprecated in OS X v10.9.

  • Useful for directly passing filenames and data objects. The QTMovie returned by this method is editable.

    Declaration

    Objective-C

    - (id)initToWritableFile:(NSString *)filename error:(NSError **)errorPtr

    Special Considerations

    This method cannot be called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    QuickTime 7.2.1 or later.

    Deprecated in OS X v10.9.

  • Useful for directly passing filenames and data objects. The QTMovie returned by this method is editable.

    Declaration

    Objective-C

    - (id)initToWritableData:(NSMutableData *)data error:(NSError **)errorPtr

    Discussion

    These methods––initToWritableDataReference:error:, initToWritableFile:error: and initToWritableData:error:––create an empty, writable storage container to which media data can be added (for example, using the QTMovie addImage method). The methods return QTMovie objects associated with those containers.

    Special Considerations

    This method cannot be called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    QuickTime 7.2.1 or later.

    Deprecated in OS X v10.9.

  • Returns the movie’s data in an NSData object.

    Declaration

    Objective-C

    - (NSData *)movieFormatRepresentation

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Returns YEStrue if the movie file was successfully created and NOfalse otherwise.

    Declaration

    Objective-C

    - (BOOL)writeToFile:(NSString *)fileName withAttributes:(NSDictionary *)attributes

    Discussion

    This method returns YEStrue if the movie file was successfully created and NO otherwise. NOfalse will also be returned if the load state of the target is less than QTMovieLoadStateComplete, in which case no attempt is made to write the QTMovie into a file. If the dictionary attributes contains an object whose key is QTMovieFlatten, then the movie is flattened into the specified file. If the dictionary attributes contains an object whose key is QTMovieExport, then the movie is exported into the specified file using a movie exporter whose type is specified by the value of the key QTMovieExportType. The value associated with the QTMovieExportSettings key should be an object of type NSData that contains an atom container of movie export settings.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    QuickTime 7.2.1 or later.

    Deprecated in OS X v10.9.

  • Returns an NSError object if an error occurs and if errorPtr is non-NULL.

    Declaration

    Objective-C

    - (BOOL)writeToFile:(NSString *)fileName withAttributes:(NSDictionary *)attributes error:(NSError **)errorPtr

    Discussion

    The method operates exactly like the existing QTMovie writeToFile:withAttributes method.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Replaces the current selection in a QTMovie with the current selection in movie.

    Declaration

    Objective-C

    - (void)replaceSelectionWithSelectionFromMovie:(id)movie

    Discussion

    If the movie is not editable, this method raises an exception.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Appends to a QTMovie the current selection in movie.

    Declaration

    Objective-C

    - (void)appendSelectionFromMovie:(id)movie

    Discussion

    If the movie is not editable, this method raises an exception.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Inserts into a QTMovie at time time the selection in movie delimited by the time range range.

    Declaration

    Objective-C

    - (void)insertSegmentOfMovie:(QTMovie *)movie timeRange:(QTTimeRange)range atTime:(QTTime)time

    Discussion

    If the movie is not editable, this method raises an exception.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Inserts the specified segment from the movie into the receiver, scaled to the range dstRange.

    Declaration

    Objective-C

    - (void)insertSegmentOfMovie:(QTMovie *)movie fromRange:(QTTimeRange)srcRange scaledToRange:(QTTimeRange)dstRange

    Discussion

    This is essentially an Add Scaled operation on a movie. If the movie is not editable, this method raises an exception.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • inserts into a QTMovie an empty segment delimited by the range range.

    Declaration

    Objective-C

    - (void)insertEmptySegmentAt:(QTTimeRange)range

    Discussion

    If the movie is not editable, this method raises an exception.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Deletes from a QTMovie the segment delimited by segment.

    Declaration

    Objective-C

    - (void)deleteSegment:(QTTimeRange)segment

    Discussion

    If the movie is not editable, this method raises an exception.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Scales the QTMovie segment delimited by the segment segment so that it will have the new duration newDuration.

    Declaration

    Objective-C

    - (void)scaleSegment:(QTTimeRange)segment newDuration:(QTTime)newDuration

    Discussion

    If the movie is not editable, this method raises an exception.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Inserts the specified segment of a QTTrack object into a QTMovie, at the specified time in the target QTMovie.

    Declaration

    Objective-C

    - (QTTrack *)insertSegmentOfTrack:(QTTrack *)track timeRange:(QTTimeRange)range atTime:(QTTime)time

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Inserts the specified segment of a QTTrack object into a QTMovie, scaling it as necessary to fit into the specified target range.

    Declaration

    Objective-C

    - (QTTrack *)insertSegmentOfTrack:(QTTrack *)track fromRange:(QTTimeRange)srcRange scaledToRange:(QTTimeRange)dstRange

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Removes a QTTrack from a movie.

    Declaration

    Objective-C

    - (void)removeTrack:(QTTrack *)track

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Adds an image for the specified duration to the receiver, using attributes specified in the attributes dictionary.

    Declaration

    Objective-C

    - (void)addImage:(NSImage *)image forDuration:(QTTime)duration withAttributes:(NSDictionary *)attributes

    Discussion

    Keys in the dictionary can be QTAddImageCodecType to select a codec type and QTAddImageCodecQuality to select a quality. Qualities are expected to be specified as NSNumbers, using the codec values like codecNormalQuality. (See ImageCompression.h for the complete list.) The attributes dictionary can also contain a value for the QTTrackTimeScaleAttribute key, which is used as the time scale of the new track, should one need to be created. The default time scale for a new track is 600.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Indicates whether a movie file can be updated with changes made to the movie object.

    Declaration

    Objective-C

    - (BOOL)canUpdateMovieFile

    Discussion

    This method returns NOfalse if any of the following conditions are true:

    • The movie is not associated with a file.

    • The movie is not savable (has 'nsav' user data set to 1).

    • The movie file is not writable.

    • The movie file does not contain a movie atom (indicating that the movie was imported from a non-movie format).

    Otherwise, the method returns YEStrue.

    Using this method, an application can check first to see if the movie file can be updated; if not, it can prompt the user for a new name and location of a file in which to save the updated movie.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Updates the movie file of a QTMovie.

    Declaration

    Objective-C

    - (BOOL)updateMovieFile

    Discussion

    Returns YEStrue if the update succeeds and NOfalse otherwise.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • delegate - delegate (OS X v10.9)

    Returns the delegate of a QTMovie object.

    Declaration

    Objective-C

    - (id)delegate

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Sets the movie’s delegate to delegate.

    Declaration

    Objective-C

    - (void)setDelegate:(id)delegate

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • This method is called, if implemented by a QTMovie delegate object, when an external movie needs to be found (usually for a wired action targeted at an external movie).

    Declaration

    Objective-C

    - (QTMovie *)externalMovie:(NSDictionary *)dictionary

    Discussion

    The keys for the dictionary in this delegate method are: QTMovieTargetIDNotificationParameter and QTMovieTargetNameNotificationParameter. The QTMovieTargetIDNotificationParameter key indicates that the delegate should return a QTMovie object that has the specified movie ID. The QTMovieTargetNameNotificationParameter key indicates that the delegate should return a QTMovie object that has the specified movie name.

    This delegate method is not called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • If implemented by a delegate of a QTMovie object, called periodically while the movie is loading its data.

    Declaration

    Objective-C

    - (BOOL)movieShouldLoadData:(id)sender

    Parameters

    sender

    The QTMovie object that is loading its data.

    Return Value

    A BOOL value; this value is ignored by QTKit.

    Special Considerations

    This delegate method is deprecated and should not be used in new code. This delegate method is not called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

  • If a QTMovie object has a delegate and that delegate implements this method, that method will be called before QTKit performs the standard idle processing on a movie.

    Declaration

    Objective-C

    - (BOOL)movieShouldTask:(id)movie

    Discussion

    The delegate can cancel that normal processing by returning YEStrue.

    Special Considerations

    This delegate method is deprecated and should not be used in new code. This delegate method is not called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • If implemented, this method is called periodically during lengthy operations (such as exporting a movie).

    Declaration

    Objective-C

    - (BOOL)movie:(QTMovie *)movie shouldContinueOperation:(NSString *)op withPhase:(QTMovieOperationPhase)phase atPercent:(NSNumber *)percent withAttributes:(NSDictionary *)attributes

    Discussion

    A delegate can implement this method. The op string is a localized string that indicates what the operation is. The phase indicates whether the operation is just beginning, ending, or is at a certain percentage of completion. If the phase is QTMovieOperationUpdatePercentPhase, then the percent parameter indicates the percentage of the operation completed. The attributes dictionary may be NIL; if not NIL, it is the same dictionary passed to a QTMovie method that caused the lengthy operation (for example, the attributes dictionary passed to writeToFile). The constants for this method are defined as follows:

    • typedef enum {
    • QTMovieOperationBeginPhase = movieProgressOpen,
    • QTMovieOperationUpdatePercentPhase = movieProgressUpdatePercent,
    • QTMovieOperationEndPhase = movieProgressClose
    • }

    Special Considerations

    This delegate method is not called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • If implemented by a delegate of a QTMovie object, called to handle the movie controller actionmcActionLinkToURL.

    Declaration

    Objective-C

    - (BOOL)movie:(QTMovie *)movie linkToURL:(NSURL *)url

    Discussion

    QTMovie objects can contain requests to open URLs. An application can implement this delegate method to override the default URL-opening mechanism in QTKit. In general, most applications will not need to install a delegate to handle this. This delegate method is not called when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.3 and later.

    Deprecated in OS X v10.9.

  • Sets the visual context of the QTMovie.

    Declaration

    Objective-C

    - (void)setVisualContext:(QTVisualContextRef)visualContext

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.5 and later.

    Deprecated in OS X v10.9.

    Not available to 64-bit applications.

  • Allows access to the visual context of the QTMovie.

    Declaration

    Objective-C

    - (QTVisualContextRef)visualContext

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.5 and later.

    Deprecated in OS X v10.9.

    Not available to 64-bit applications.

  • The following values can be used to include some or all of the file types that are normally excluded:

    Declaration

    Swift

    struct QTMovieFileTypeOptions { init(_ value: UInt32) var value: UInt32 }

    Objective-C

    typedef enum { QTIncludeStillImageTypes = 1 << 0, QTIncludeTranslatableTypes = 1 << 1, QTIncludeAggressiveTypes = 1 << 2, QTIncludeCommonTypes = 0, QTIncludeAllTypes = 0xffff } QTMovieFileTypeOptions;

    Constants

    • QTIncludeStillImageTypes

      QTIncludeStillImageTypes

      This value adds to the array all file types for still images that can be opened using a graphics importer.

      Available in OS X v10.3 and later.

    • QTIncludeTranslatableTypes

      QTIncludeTranslatableTypes

      This value adds to the array all file types for files that can be opened using a movie importer but for which a new file must be created.

      Available in OS X v10.3 and later.

    • QTIncludeAggressiveTypes

      QTIncludeAggressiveTypes

      This value adds to the array all file types for files that can be opened using a movie importer but that are not commonly used in connection with movies (for instance, text or HTML files).

      Available in OS X v10.3 and later.

    • QTIncludeCommonTypes

      QTIncludeCommonTypes

      This value adds to the array all common file types that QuickTime can open in place on the current system.

      Available in OS X v10.3 and later.

    • QTIncludeAllTypes

      QTIncludeAllTypes

      This value adds to the array all file types that QuickTime can open on the current system, using any available movie or graphics importer.

      Available in OS X v10.3 and later.

    Import Statement

    Objective-C

    @import QTKit;

    Swift

    import QTKit

    Availability

    Available in OS X v10.3 and later.

  • The following constants specify the movie attributes that you can get and set using the movieAttributes and setMovieAttributes methods. To get or set a single attribute, use attributeForKey or setAttribute.

    Declaration

    Objective-C

    NSString * const QTMovieApertureModeAttribute; NSString * const QTMovieActiveSegmentAttribute; NSString * const QTMovieAutoAlternatesAttribute; NSString * const QTMovieCopyrightAttribute; NSString * const QTMovieCreationTimeAttribute; NSString * const QTMovieCurrentSizeAttribute; NSString * const QTMovieCurrentTimeAttribute; NSString * const QTMovieDataSizeAttribute; NSString * const QTMovieDelegateAttribute; NSString * const QTMovieDisplayNameAttribute; NSString * const QTMovieDurationAttribute; NSString * const QTMovieEditableAttribute; NSString * const QTMovieFileNameAttribute; NSString * const QTMovieHasApertureModeDimensionsAttribute; NSString * const QTMovieHasAudioAttribute; NSString * const QTMovieHasDurationAttribute; NSString * const QTMovieHasVideoAttribute; NSString * const QTMovieIsActiveAttribute; NSString * const QTMovieIsInteractiveAttribute; NSString * const QTMovieIsLinearAttribute; NSString * const QTMovieIsSteppableAttribute; NSString * const QTMovieLoadStateAttribute; NSString * const QTMovieLoadStateErrorAttribute; NSString * const QTMovieLoopsAttribute; NSString * const QTMovieLoopsBackAndForthAttribute; NSString * const QTMovieModificationTimeAttribute; NSString * const QTMovieMutedAttribute; NSString * const QTMovieNaturalSizeAttribute; NSString * const QTMoviePlaysAllFramesAttribute; NSString * const QTMoviePlaysSelectionOnlyAttribute; NSString * const QTMoviePosterTimeAttribute; NSString * const QTMoviePreferredMutedAttribute; NSString * const QTMoviePreferredRateAttribute; NSString * const QTMoviePreferredVolumeAttribute; NSString * const QTMoviePreviewModeAttribute; NSString * const QTMoviePreviewRangeAttribute; NSString * const QTMovieRateAttribute; NSString * const QTMovieSelectionAttribute; NSString * const QTMovieTimeScaleAttribute; NSString * const QTMovieURLAttribute; NSString * const QTMovieVolumeAttribute; NSString * const QTMovieRateChangesPreservePitchAttribute;

    Constants

    • QTMovieApertureModeAttribute

      QTMovieApertureModeAttribute

      Sets the aperture mode attribute on a QTMovie object to indicate whether aspect ratio and clean aperture correction should be performed.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieActiveSegmentAttribute

      QTMovieActiveSegmentAttribute

      The active segment of a QTMovie object; the value for this key is of type NSValue, interpreted as a QTTimeRange structure. This constant is available in OS X v10.4 and later, but deprecated in OS X v10.5.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.5.

    • QTMovieAutoAlternatesAttribute

      QTMovieAutoAlternatesAttribute

      The auto-alternate state of a QTMovie object. The value for this key is of type NSNumber, interpreted as a BOOL.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieCopyrightAttribute

      QTMovieCopyrightAttribute

      The copyright string of a QTMovie object; the value for this key is of type NSString.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieCreationTimeAttribute

      QTMovieCreationTimeAttribute

      The creation time of a QTMovie object; the value for this key is of type NSDate.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieCurrentSizeAttribute

      QTMovieCurrentSizeAttribute

      The current size of a QTMovie object; the value for this key is of type NSValue, interpreted as an NSSize structure.

      This attribute can be read and written. This attribute cannot be read or written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue. This attribute is deprecated in QTKit version 7.6 and later.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.6.

    • QTMovieCurrentTimeAttribute

      QTMovieCurrentTimeAttribute

      The current time of a QTMovie object; the value for this key is of type NSValue, interpreted as a QTTime structure.

      This attribute can be read and written. This attribute can be read and written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieDataSizeAttribute

      QTMovieDataSizeAttribute

      The data size of a QTMovie. The value for this key is of type NSNumber, which is interpreted as a longlong.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieDelegateAttribute

      QTMovieDelegateAttribute

      The delegate for a QTMovie object. The value for this key is of type NSObject.

      This attribute can be read and written. This attribute can be read and written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieDisplayNameAttribute

      QTMovieDisplayNameAttribute

      The display name of a QTMovie object. A display name is stored as user data in a movie file and hence may differ from the base name of the movie’s filename or URL. The value for this key is of type NSString.

      This attribute can be read and written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieDontInteractWithUserAttribute

      QTMovieDontInteractWithUserAttribute

      When set in a dictionary passed to movieWithAttributes or initWithAttributes, this prevents QuickTime from interacting with the user during movie initialization. The value for this key is of type NSNumber, interpreted as a BOOL.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieDurationAttribute

      QTMovieDurationAttribute

      The duration of a QTMovie object; the value for this key is of type NSValue, interpreted as a QTTime structure.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieEditableAttribute

      QTMovieEditableAttribute

      The editable setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie can be edited.

      This attribute can be read and written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieFileNameAttribute

      QTMovieFileNameAttribute

      The file name string of a QTMovie object; the value for this key is of type NSString.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieHasApertureModeDimensionsAttribute

      QTMovieHasApertureModeDimensionsAttribute

      The aperture mode dimensions set on any track in this QTMovie object, even if those dimensions are all identical to the classic dimensions (as is the case for content with square pixels and no edge-processing region). The value for this key is of type NSNumber, interpreted as a BOOL.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieHasAudioAttribute

      QTMovieHasAudioAttribute

      The audio data setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie contains audio data.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieHasDurationAttribute

      QTMovieHasDurationAttribute

      The duration setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie has a duration. (Some types of movies, for instance QuickTime VR movies, have no duration.)

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieHasVideoAttribute

      QTMovieHasVideoAttribute

      The video data setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie contains video data.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieIsActiveAttribute

      QTMovieIsActiveAttribute

      The active setting; the value for this key is of type NSNumber, interpreted as a BOOL.

      This attribute can be read and written. This attribute can be read and written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieIsInteractiveAttribute

      QTMovieIsInteractiveAttribute

      The interactive setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie is interactive.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieIsLinearAttribute

      QTMovieIsLinearAttribute

      The linear setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie is linear, as opposed to a non-linear QuickTime VR movie.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieIsSteppableAttribute

      QTMovieIsSteppableAttribute

      The steppable setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie can step from frame to frame.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieLoadStateAttribute

      QTMovieLoadStateAttribute

      The load state value; the value for this key is of type NSNumber, interpreted as a long.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieLoadStateErrorAttribute

      QTMovieLoadStateErrorAttribute

      The load state error of a QTMovie object; the value for this key is of type NSError.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      QuickTime 7.6.3 and later.

      Deprecated in OS X v10.9.

    • QTMovieLoopsAttribute

      QTMovieLoopsAttribute

      The looping setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie is set to loop, NOfalse otherwise.

      This attribute can be read and written. This attribute can be read and written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieLoopsBackAndForthAttribute

      QTMovieLoopsBackAndForthAttribute

      The palindrome looping setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie is set to loop back and forth. Note that QTMovieLoopsAttribute and QTMovieLoopsBackAndForthAttribute are independent and indeed exclusive. QTMovieLoopsAttribute is used to get and set the state of normal looping; QTMovieLoopsBackAndForthAttribute is used to get and set the state of palindrome looping.

      This attribute can be read and written. This attribute can be read and written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieModificationTimeAttribute

      QTMovieModificationTimeAttribute

      The modification time of a QTMovie object; the value for this key is of type NSDate.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieMutedAttribute

      QTMovieMutedAttribute

      The mute setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie volume is muted.

      This attribute can be read and written. This attribute can be read and written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieNaturalSizeAttribute

      QTMovieNaturalSizeAttribute

      The natural size of a QTMovie object; the value for this key is of type NSValue, interpreted as an NSSize structure.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMoviePlaysAllFramesAttribute

      QTMoviePlaysAllFramesAttribute

      The play-all-frames setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie will play all frames.

      This attribute can be read and written. This attribute can be read and written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMoviePlaysSelectionOnlyAttribute

      QTMoviePlaysSelectionOnlyAttribute

      The play-selection setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie will play only the current selection.

      This attribute can be read and written. This attribute can be read and written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMoviePosterTimeAttribute

      QTMoviePosterTimeAttribute

      The movie poster time of a QTMovie object; the value for this key is of type NSValue, interpreted as a QTTime structure.

      This attribute can be read and written. This attribute can be read and written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMoviePreferredMutedAttribute

      QTMoviePreferredMutedAttribute

      The preferred mute setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie preferred mute setting is muted.

      This attribute can be read and written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      The preferred settings refer to settings contained in the movie file (or movie data) itself. The actual settings refer to the actual values of those settings. For instance, a movie can have a preferred rate of 2, and a good movie playing application will respect that setting. But an application or the user can set the actual rate to some other value. The non-preferred settings can change dynamically, but the preferred settings will not.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMoviePreferredRateAttribute

      QTMoviePreferredRateAttribute

      The preferred rate; the value for this key is of type NSNumber, interpreted as a float.

      This attribute can be read and written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      The preferred settings refer to settings contained in the movie file (or movie data) itself. The actual settings refer to the actual values of those settings. For instance, a movie can have a preferred rate of 2, and a good movie playing application will respect that setting. But an application or the user can set the actual rate to some other value. The non-preferred settings can change dynamically, but the preferred settings will not.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMoviePreferredVolumeAttribute

      QTMoviePreferredVolumeAttribute

      The preferred volume; the value for this key is of type NSNumber, interpreted as a float.

      This attribute can be read and written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      The preferred settings refer to settings contained in the movie file (or movie data) itself. The actual settings refer to the actual values of those settings. For instance, a movie can have a preferred rate of 2, and a good movie playing application will respect that setting. But an application or the user can set the actual rate to some other value. The non-preferred settings can change dynamically, but the preferred settings will not.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMoviePreviewModeAttribute

      QTMoviePreviewModeAttribute

      The preview mode setting; the value for this key is of type NSNumber, interpreted as a BOOL. This value is YEStrue if the movie is in preview mode.

      This attribute can be read and written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMoviePreviewRangeAttribute

      QTMoviePreviewRangeAttribute

      The preview range of a QTMovie object; the value for this key is of type NSValue, interpreted as a QTTimeRange structure.

      This attribute can be read and written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieRateAttribute

      QTMovieRateAttribute

      The movie rate; the value for this key is of type NSNumber, interpreted as a float.

      This attribute can be read and written. This attribute can be read and written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieRateChangesPreservePitchAttribute

      QTMovieRateChangesPreservePitchAttribute

      When the playback rate is not unity, audio must be resampled in order to play at the new rate. The default resampling affects the pitch of the audio (for example, playing at 2x speed raises the pitch by an octave, 1/2x lowers an octave). If this property is set on the movie, an alternative algorithm is used, which alters the speed without changing the pitch. Since this is more computationally expensive, this property may be silently ignored on some slow CPUs.

      This attribute can be read but not written; it must be among the initialization attributes to have any effect. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieSelectionAttribute

      QTMovieSelectionAttribute

      The selection range of a QTMovie object; the value for this key is of type NSValue, interpreted as a QTTimeRange structure.

      This attribute can be read and written. This attribute cannot be read or written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieTimeScaleAttribute

      QTMovieTimeScaleAttribute

      The time scale of a QTMovie object; the value for this key is of type NSNumber, interpreted as a long. This attribute can be read and (in OS X v10.5 and later) written; in earlier versions of OS X, this attribute is readable only. In general, you should set this attribute only on newly-created movies or on movies that have not been edited. Also, you should only increase the time scale value, and you should try to use integer multiples of the existing time scale.

      This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieURLAttribute

      QTMovieURLAttribute

      The URL of a QTMovie object; the value for this key is of type NSURL.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieVolumeAttribute

      QTMovieVolumeAttribute

      The movie volume; the value for this key is of type NSNumber, interpreted as a float.

      This attribute can be read and written. This attribute can be read and written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

  • When a movie is in clean, production, or encoded pixels aperture mode, each track's dimensions are overridden by special dimensions for that mode. The original track dimensions are preserved and can be restored by setting the movie into classic aperture mode. Aperture modes are not saved in movies. The associated value is of type NSString and is assumed to be one of the following strings:

    Declaration

    Objective-C

    NSString * const QTMovieApertureModeClassic; NSString * const QTMovieApertureModeClean; NSString * const QTMovieApertureModeProduction; NSString * const QTMovieApertureModeEncodedPixels;

    Constants

    • QTMovieApertureModeClassic

      QTMovieApertureModeClassic

      No aspect ratio or clean aperture correction is performed. This is the default aperture mode and provides compatibility with behavior in QuickTime 7.0.x and earlier. If you call -[QTTrack setDimensions], the movie is automatically switched to classic mode.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieApertureModeClean

      QTMovieApertureModeClean

      An aperture mode for general display. Where possible, video will be displayed at the correct pixel aspect ratio, trimmed to the clean aperture. A movie in clean aperture mode sets each track’s dimensions to match the size returned by -[QTTrack apertureModeDimensionsForMode:QTMovieApertureModeClean].

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieApertureModeProduction

      QTMovieApertureModeProduction

      An aperture mode for modal use in authoring applications. Where possible, video will be displayed at the correct pixel aspect ratio, but without trimming to the clean aperture so that the edge processing region can be viewed. A movie in production aperture mode sets each track's dimensions to match the size returned by -[QTTrack apertureModeDimensionsForMode:QTMovieApertureModeProduction].

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieApertureModeEncodedPixels

      QTMovieApertureModeEncodedPixels

      An aperture mode for technical use. Displays all encoded pixels with no aspect ratio or clean aperture compensation. A movie in encoded pixels aperture mode sets each track's dimensions to match the size returned by -[QTTrack apertureModeDimensionsForMode:QTMovieApertureModeEncodedPixels].

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

  • The movie load state values. The attributeForKey:QTMovieLoadStateAttribute returns an NSNumber that wraps a long integer; the enumerated constants shown here are the possible values of that long integer.

    Declaration

    Swift

    typealias QTMovieLoadState = Int

    Objective-C

    enum { QTMovieLoadStateError = -1L, QTMovieLoadStateLoading = 1000, QTMovieLoadStateLoaded = 2000, QTMovieLoadStatePlayable = 10000, QTMovieLoadStatePlaythroughOK = 20000, QTMovieLoadStateComplete = 100000L }; typedef NSInteger QTMovieLoadState;

    Constants

    • QTMovieLoadStateError

      QTMovieLoadStateError

      An error occurred while loading the movie.

      Available in OS X v10.5 and later.

    • QTMovieLoadStateLoading

      QTMovieLoadStateLoading

      The movie is loading.

      Available in OS X v10.5 and later.

    • QTMovieLoadStateLoaded

      QTMovieLoadStateLoaded

      The movie atom has loaded; it’s safe to query movie properties.

      Available in OS X v10.5 and later.

    • QTMovieLoadStatePlayable

      QTMovieLoadStatePlayable

      The movie has loaded enough media data to begin playing.

      Available in OS X v10.5 and later.

    • QTMovieLoadStatePlaythroughOK

      QTMovieLoadStatePlaythroughOK

      The movie has loaded enough media data to play through to the end.

      Available in OS X v10.5 and later.

    • QTMovieLoadStateComplete

      QTMovieLoadStateComplete

      The movie has loaded completely.

      OS X v10.5 and later.

    Import Statement

    Objective-C

    @import QTKit;

    Swift

    import QTKit

    Availability

    Available in OS X v10.5 and later.

  • The following constants specify items in dictionaries passed to QTMovie notifications and delegate methods.

    Declaration

    Objective-C

    NSString * const QTMovieMessageNotificationParameter; NSString * const QTMovieRateDidChangeNotificationParameter; NSString * const QTMovieStatusFlagsNotificationParameter; NSString * const QTMovieStatusCodeNotificationParameter; NSString * const QTMovieStatusStringNotificationParameter; NSString * const QTMovieTargetIDNotificationParameter; NSString * const QTMovieTargetNameNotificationParameter;

    Constants

    • QTMovieMessageNotificationParameter

      QTMovieMessageNotificationParameter

      Used as a key in the userInfo dictionary passed to the QTMovieMessageNotification notification to indicate the message. The associated value is an NSString.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieRateDidChangeNotificationParameter

      QTMovieRateDidChangeNotificationParameter

      Used as a key in the userInfo dictionary passed to the QTMovieRateDidChangeNotification notification to indicate the new playback rate. The associated value is an NSNumber that holds a float.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieStatusFlagsNotificationParameter

      QTMovieStatusFlagsNotificationParameter

      Used as a key in the userInfo dictionary passed to the QTMovieStatusStringPostedNotification notification to indicate status flags. The associated value is an NSNumber that holds a long.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieStatusCodeNotificationParameter

      QTMovieStatusCodeNotificationParameter

      Used as a key in the userInfo dictionary passed to the QTMovieStatusStringPostedNotification notification to indicate a status code (or error code). The associated value is an NSNumber that holds an int.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieStatusStringNotificationParameter

      QTMovieStatusStringNotificationParameter

      Used as a key in the userInfo dictionary passed to the QTMovieStatusStringPostedNotification notification to indicate a status string.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieTargetIDNotificationParameter

      QTMovieTargetIDNotificationParameter

      Used as a key in the dictionary passed to the externalMovie: delegate method to indicate that the delegate should return a QTMovie object that has the movie ID specified by the key’s value.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieTargetNameNotificationParameter

      QTMovieTargetNameNotificationParameter

      Used as a key in the dictionary passed to the externalMovie: delegate method to indicate that the delegate should return a QTMovie object that has the movie name specified by the key’s value.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

  • The following constants are dictionary keys that you can use to specify movie attributes, using the writeToFile method.

    Declaration

    Objective-C

    NSString * const QTMovieExport; NSString * const QTMovieExportType; NSString * const QTMovieFlatten; NSString * const QTMovieExportSettings; NSString * const QTMovieExportManufacturer;

    Constants

    • QTMovieExport

      QTMovieExport

      The movie export setting; the value for this key is of type NSNumber, interpreted as a BOOL.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieExportType

      QTMovieExportType

      The movie export type; the value for this key is of type NSNumber, interpreted as a long.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieFlatten

      QTMovieFlatten

      The movie flatten setting; the value for this key is of type NSNumber, interpreted as a BOOL.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieExportSettings

      QTMovieExportSettings

      The movie export settings; the value of this key is of type NSData, interpreted as a QTAtomContainer.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieExportManufacturer

      QTMovieExportManufacturer

      The export manufacturer value; the value for this key is of type NSNumber, interpreted as a long.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

  • The following constants are dictionary keys that you can use to specify movie attributes, using the addImage method.

    Declaration

    Objective-C

    NSString * const QTAddImageCodecType; NSString * const QTAddImageCodecQuality;

    Constants

    • QTAddImageCodecType

      QTAddImageCodecType

      The image codec string; the value for this key is of type NSString.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTAddImageCodecQuality

      QTAddImageCodecQuality

      The image codec value; the value for this key is of type NSNumber.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

  • The following is a dictionary of attributes that can contain frame image keys, using the frameImageAtTime:withAttributes:error: method.

    Declaration

    Objective-C

    NSString * const QTMovieFrameImageSize; NSString * const QTMovieFrameImageType; NSString * const QTMovieFrameImageTypeNSImage; NSString * const QTMovieFrameImageTypeCGImageRef; NSString * const QTMovieFrameImageTypeCIImage; NSString * const QTMovieFrameImageTypeCVPixelBufferRef; NSString * const QTMovieFrameImageTypeCVOpenGLTextureRef; NSString * const QTMovieFrameImageRepresentationsType; NSString * const QTMovieFrameImageOpenGLContext; NSString * const QTMovieFrameImagePixelFormat; NSString * const QTMovieFrameImageDeinterlaceFields; NSString * const QTMovieFrameImageHighQuality; NSString * const QTMovieFrameImageSingleField; NSString * const QTMovieFrameImageSessionMode;

    Constants

    • QTMovieFrameImageSize

      QTMovieFrameImageSize

      Size of the image. The value is an NSValue containing an NSSize record. The default image size is the current movie size.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImageType

      QTMovieFrameImageType

      Type of the image. The value is an NSString. The default image type is NSImage.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImageTypeNSImage

      QTMovieFrameImageTypeNSImage

      A value for the QTMovieFrameImageType key of the QTMovie frameImageAtTime:withAttributes:error: attributes dictionary. Specifies that the type of image returned should be an NSImage.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImageTypeCGImageRef

      QTMovieFrameImageTypeCGImageRef

      A value for the QTMovieFrameImageType key of the QTMovie frameImageAtTime:withAttributes:error: attributes dictionary. Specifies that the type of image returned should be a CGImageRef.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImageTypeCIImage

      QTMovieFrameImageTypeCIImage

      A value for the QTMovieFrameImageType key of the QTMovie frameImageAtTime:withAttributes:error: attributes dictionary. Specifies that the type of image returned should be a CIImage.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImageTypeCVPixelBufferRef

      QTMovieFrameImageTypeCVPixelBufferRef

      A value for the QTMovieFrameImageType key of the QTMovie frameImageAtTime:withAttributes:error: attributes dictionary. Specifies that the type of image returned should be a CVPixelBufferRef.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImageTypeCVOpenGLTextureRef

      QTMovieFrameImageTypeCVOpenGLTextureRef

      A value for the QTMovieFrameImageType key of the QTMovie frameImageAtTime:withAttributes:error: attributes dictionary. Specifies that the type of image returned should be a CVOpenGLTextureRef. Clients that specify this attribute must also specify the OpenGL context and pixel format for the texture using the QTMovieFrameImageOpenGLContext and QTMovieFrameImagePixelFormat attribute keys.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImageRepresentationsType

      QTMovieFrameImageRepresentationsType

      For NSImage, the image representations in the image. Value is an NSArray of NSString; strings are, for example, NSBitmapImageRep class description. The default is NSBitmapImageRep.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImageOpenGLContext

      QTMovieFrameImageOpenGLContext

      For CVOpenGLTextureRef, the OpenGL context to use. The value is an NSValue (CGLContextObj).

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImagePixelFormat

      QTMovieFrameImagePixelFormat

      For CVOpenGLTextureRef, the pixel format to use. Value is an NSValue (CGLPixelFormatObj).

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImageDeinterlaceFields

      QTMovieFrameImageDeinterlaceFields

      Image is de-interlaced. Value is an NSNumber (BOOL) (default = YEStrue).

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImageHighQuality

      QTMovieFrameImageHighQuality

      Image is high quality. Value is an NSNumber (BOOL) (default = YEStrue).

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImageSingleField

      QTMovieFrameImageSingleField

      Image is single field. Value is an NSNumber (BOOL) (default = YEStrue). The returned object is an autorelease object.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieFrameImageSessionMode

      QTMovieFrameImageSessionMode

      Indicates that two or more calls to frameImageAtTime:withAttributes:error: will be made on the same QTMovie object.

      By adding this key with the associated value that is an NSNumber wrapping the BOOLYEStrue to the dictionary of attributes, an application indicates that it will make more than one call to frameImageAtTime:withAttributes:error: on the same QTMovie object. This knowledge permits QTMovie to cache certain objects and data structures used to generate a frame image, thereby improving performance. When the caller has obtained all the frame images desired from a given QTMovie object, the caller should follow those session calls with a call where this value is NOfalse; this is a signal to QTMovie to dispose of that cached data.

      OS X v10.6; QuickTime 7.6.3 and later.

      Deprecated in OS X v10.9.

  • The following constants are data locators that you can use to specify movie attributes, using the movieWithAttributes and initWithAttributes methods.

    Declaration

    Objective-C

    NSString * const QTMovieDataReferenceAttribute; NSString * const QTMoviePasteboardAttribute; NSString * const QTMovieDataAttribute;

    Constants

    • QTMovieDataReferenceAttribute

      QTMovieDataReferenceAttribute

      The data reference of a QTMovie object;the value for this key is of type QTDataReference.

      This attribute can be read but not written. This attribute can be read but not written when the movie has been initialized with QTMovieOpenForPlaybackAttribute set to YEStrue.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMoviePasteboardAttribute

      QTMoviePasteboardAttribute

      The pasteboard setting of a QTMovie object.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieDataAttribute

      QTMovieDataAttribute

      The data of a QTMovie object.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

  • The following constants are movie instantiation options that you can use to specify movie attributes, using the movieWithAttributes and initWithAttributes methods.

    Declaration

    Objective-C

    NSString * const QTMovieFileOffsetAttribute; NSString * const QTMovieResolveDataRefsAttribute; NSString * const QTMovieAskUnresolvedDataRefsAttribute; NSString * const QTMovieOpenAsyncOKAttribute; NSString * const QTMovieOpenAsyncRequiredAttribute; NSString * const QTMovieOpenForPlaybackAttribute;

    Constants

    • QTMovieFileOffsetAttribute

      QTMovieFileOffsetAttribute

      The file offset value; the value for this key is of type NSNumber, interpreted as a long long.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieResolveDataRefsAttribute

      QTMovieResolveDataRefsAttribute

      Indicates whether external data references in a movie file should be resolved (NSNumber YEStrue) or not resolved (NSNumber NOfalse).

      A movie file can contain references to media data in other locations. By default, QTMovie attempts to resolve these references at the time that the movie file is opened and a QTMovie object is instantiated. You can prevent that resolution from occurring by passing an NSNumber wrapping the value NOfalse as the value of this attribute.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieAskUnresolvedDataRefsAttribute

      QTMovieAskUnresolvedDataRefsAttribute

      Indicates whether the user should be prompted to help find any unresolved data references (NSNumber YEStrue) or not (NSNumber NOfalse).

      When the value of the QTMovieResolveDataRefsAttribute attribute is an NSNumber wrapping the value YEStrue and a movie file contains unresolved data references, this attribute indicates whether the user should be prompted to help find the missing referenced data (NSNumber YEStrue) or not (NSNumber NO). Typically, QTMovie will display a dialog box that allows the user to navigate to the file or URL containing the referenced data. By setting this attribute to NOfalse, you can prevent that dialog box from being displayed and thereby speed up the movie opening and initialization process.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieOpenAsyncOKAttribute

      QTMovieOpenAsyncOKAttribute

      Indicates whether a movie file can be opened asynchronously if possible (NSNumber YEStrue) or not (NSNumber NOfalse).

      Opening a movie file and initializing a QTMovie object for that file may require a considerable amount of time, perhaps to convert the data in the file from one format to another. By setting this attribute to an NSNumber wrapping the value YEStrue, you grant QTMovie permission to return a non-nil QTMovie identifier to your application immediately and then to continue processing the file data internally. If a movie is opened asynchronously, you must monitor the movie load state and ensure that it has reached the appropriate threshold before attempting to perform certain operations on the movie. For instance, you cannot export or copy a QTMovie object until its load state has reached QTMovieLoadStateComplete.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

    • QTMovieOpenAsyncRequiredAttribute

      QTMovieOpenAsyncRequiredAttribute

      Indicates whether the QTMovie must be opened asynchronously (NSNumber YEStrue) or not (NSNumber NOfalse).

      Set this attribute to an NSNumber wrapping YEStrue to indicate that all operations necessary to open the movie file (or other container) and create a valid QTMovie object must occur asynchronously. That is to say, the methods +movieWithAttributes:error: and -initWithAttributes:error: must return almost immediately, performing any lengthy operations on another thread. Your application can monitor the movie load state to determine the progress of those operations.

      If you require asynchronous opening but QTMovie is unable to honor your request, then the methods +movieWithAttributes:error: and -initWithAttributes:error: return nil with an NSError having the error domain QTKitErrorDomain and code QTErrorMovieOpeningCannotBeAsynchronous.

      OS X v10.6 and later; QuickTime 7.6.3 and later.

      Deprecated in OS X v10.9.

    • QTMovieOpenForPlaybackAttribute

      QTMovieOpenForPlaybackAttribute

      Indicates whether the QTMovie will be used only for playback (NSNumber YEStrue) or not (NSNumber NOfalse).

      Set this attribute to an NSNumber wrapping YEStrue to indicate that you intend to use movie playback methods (such as -play or -stop, or corresponding movie view methods such as -play: or -pause:) to control the movie, but do not intend to use other methods that edit, export, or in any way modify the movie. Knowing that you need playback services only may allow QTMovie to use more efficient code paths for some media files.

      This attribute is meaningful only when added to the dictionary passed to -initWithAttributes:error:. In particular, setting this attribute on a QTMovie object that is already open has no effect.

      OS X v10.6 and later; QuickTime 7.6.3 and later.

      Deprecated in OS X v10.9.

  • These constants allow applications to get information about a movie and its chapters, and to navigate within a movie by chapters. Since chapters are a reasonably common feature of movies and podcasts, QTKit enables developers to create them.

    Declaration

    Objective-C

    NSString * const QTMovieChapterName; NSString * const QTMovieChapterStartTime; NSString * const QTMovieChapterTargetTrackAttribute;

    Constants

    • QTMovieChapterName

      QTMovieChapterName

      A key indicating the chapter name in the dictionaries that are array elements in the array returned by QTMoviechapters or passed to QTMovieaddChapters:withAttributes:error.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieChapterStartTime

      QTMovieChapterStartTime

      A key indicating the chapter start time in the dictionaries that are array elements in the array returned by QTMoviechapters or passed to QTMovieaddChapters:withAttributes:error.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

    • QTMovieChapterTargetTrackAttribute

      QTMovieChapterTargetTrackAttribute

      A key indicating the track in the QTMovie object that is the target of the chapter track.

      Available in OS X v10.5 and later.

      Deprecated in OS X v10.9.

  • The following constant is the type of movie data passed on the pasteboard.

    Declaration

    Objective-C

    NSString * const QTMoviePasteboardType;

    Constants

    • QTMoviePasteboardType

      QTMoviePasteboardType

      Specifies the type of movie data passed on the pasteboard.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

  • The following exception is raised when calling a method requiring editing or modification of a movie that is uneditable.

    Declaration

    Objective-C

    NSString * const QTMovieUneditableException;

    Constants

    • QTMovieUneditableException

      QTMovieUneditableException

      Raised when the developer tries to call a method that requires editing or modifying the movie on an uneditable movie.

      Available in OS X v10.4 and later.

      Deprecated in OS X v10.9.

  • Issued when the aperture mode of the target QTMovie object changes.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.5 and later.

    Deprecated in OS X v10.9.

  • Issued when the chapter associated with QTMovie changes.

    This notification contains no information in the userInfo dictionary.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Issued when the chapter list associated with QTMovie changes.

    This notification contains no information in the userInfo dictionary.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when a request is made to close the movie’s window.

    This notification contains no information in the userInfo dictionary.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when the movie is “done” or at its end.

    This notification contains no userInfo parameters. It is equivalent to the standard player controller’s mcActionMovieFinished action.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when the editable state of a movie has changed.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when a movie has been edited.

    This notification contains no userInfo dictionary.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when a request is made to play back a movie in full screen mode.

    This notification contains no information in the userInfo dictionary.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when a request is made to play back a movie in normal windowed mode.

    This notification contains no information in the userInfo dictionary.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when the load state of a movie has changed.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when a change is made in a movie’s looping mode.

    This notification contains no information in the userInfo dictionary.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when a movie message has been received by the movie controller.

    Movie messages can be sent to an application by wired actions (for instance, a wired sprite) or by code that issues the mcActionShowMessageString movie controller action. The userInfo dictionary contains a single entry whose value is of type NSString, which is the movie message.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when the rate of a movie has changed.

    The userInfo dictionary contains a single entry whose value is of type NSNumber that represents a float, which is the new rate.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when the selection of a movie has changed.

    This notification contains no userInfo dictionary.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Posted whenever the natural size (that is, the original dimensions of the movie when it was authored) changes, either because the movie was edited or because new information about the movie was loaded asynchronously.

    All clients that display movies using dimensions based on the QTMovieNaturalSizeAttribute should respond to this notification to update their display as necessary.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    QuickTime 7.6.3 and later.

    Deprecated in OS X v10.9.

  • Sent when the size of a movie has changed.

    This notification contains no userInfo dictionary.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    QuickTime 7.0 and later, but deprecated in QuickTime 7.6.3 and later.

    Deprecated in OS X v10.6.

  • Status messages can be sent by QuickTime’s streaming components or by any code that wants to display a message in the movie controller bar status area.

    The userInfo dictionary contains a single entry whose value is of type NSString, which is the status message.

    The following are keys (notification parameters) for userInfo items for the QTMovieStatusStringPostedNotification notification QTMovieStatusCodeNotificationParameter and QTMovieStatusStringNotificationParameter.

    A status string notification can indicate an error (in which case QTMovieStatusCodeNotificationParameter will have a value), or it can contain a string (in which case QTMovieStatusStringNotificationParameter will have a value). For more information, see mcActionShowStatusString.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when the time in a movie has changed.

    The QTMovieTimeDidChangeNotification is fired whenever the movie time changes to a time other than what it would be during normal playback. So, for example, this notification is not fired every frame.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.

  • Sent when the volume of a movie has changed.

    Import Statement

    Objective-C

    @import QTKit;

    Availability

    Available in OS X v10.4 and later.

    Deprecated in OS X v10.9.