QTMovieView Class Reference

Instance Methods

add:

Adds the contents of the clipboard to the movie at the current movie time.

- (IBAction)add:(id)sender

Discussion

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

addScaled:

Adds the contents of the clipboard to the movie, scaled to fit into the current movie selection.

- (IBAction)addScaled:(id)sender

Discussion

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

areStepButtonsVisible

Returns the current visibility state of the specified controller bar button.

- (BOOL)areStepButtonsVisible

Related Sample Code

• QTKitButtonTester

areZoomButtonsVisible

Returns the current visibility state of the specified controller bar button.

- (BOOL)areZoomButtonsVisible

Discussion

These methods allow applications to hide and show specific buttons in the movie controller bar.

Related Sample Code

• QTKitButtonTester

controllerBarHeight

Returns the height of the controller bar.

- (float)controllerBarHeight

Related Sample Code

• QTAudioExtractionPanel
• QTKitAdvancedDocument

copy:

Copies the current movie selection onto the clipboard.

- (IBAction)copy:(id)sender

Discussion

If there is no selection, the current frame is copied. The movie does not need to be editable.

cut:

Deletes the current movie selection from the movie, placing it on the clipboard.

- (IBAction)cut:(id)sender

Discussion

If there is no selection, the current frame is deleted. This action is undoable. If the movie is not editable, this method raises an exception.

delegate

Returns the receiver’s delegate.

- (id)delegate

delete:

Deletes the current movie selection from the movie, placing it on the clipboard.

- (IBAction)delete:(id)sender

Discussion

If there is no selection, the current frame is deleted. This action is undoable. If the movie is not editable, this method raises an exception.

fillColor

Returns the fill color of the QTMovieView.

- (NSColor *)fillColor

Parameters

fillColor

The fill color of the QTMovieView object.

Related Sample Code

• QTAudioContextInsert
• QTAudioExtractionPanel
• QTKitImport
• QTKitPlayer

gotoBeginning:

Sets the current movie time to the beginning of the movie.

- (IBAction)gotoBeginning:(id)sender

Discussion

This action method sets the current movie time to the beginning of the movie. If the movie is playing, the movie continues playing from the new position.

gotoEnd:

Sets the current movie time to the end of the movie.

- (IBAction)gotoEnd:(id)sender

Discussion

This action method sets the current movie time to the end of the movie. If the movie is playing in one of the looping modes, the movie continues playing accordingly; otherwise, play stops.

gotoNextSelectionPoint:

Sets the current movie time to the next selection point.

- (IBAction)gotoNextSelectionPoint:(id)sender

Discussion

This action method sets the current movie time to the next selection point.

gotoPosterFrame:

Sets the current movie time to the movie poster frame.

- (IBAction)gotoPosterFrame:(id)sender

gotoPreviousSelectionPoint:

Sets the current movie time to the previous selection point.

- (IBAction)gotoPreviousSelectionPoint:(id)sender

initWithFrame:

Initializes a newly allocated QTMovieView with frame as its frame rectangle.

- (id)initWithFrame:(NSRect)frame

Parameters

frame

The NSRect object with which to initialize the QTMovieView with its frame rectangle.

Discussion

The new movie view object must be inserted into the view hierarchy of an NSWindow before it can be used. This method is the designated initializer for the QTMovieView class.

isBackButtonVisible

Returns the current visibility state of the specified controller bar button.

- (BOOL)isBackButtonVisible

Related Sample Code

• QTKitButtonTester

isControllerVisible

Returns an indication of whether the QTMovieView has been requested to display a built-in movie controller user interface.

- (BOOL)isControllerVisible

Discussion

Using the setControllerVisible: method, the client tells QTMovieView whether or not to display a user interface for controlling the movie within its bounds. Using the isControllerVisible method, the client can determine whether a QTMovieView has been configured to display such an interface. By using the controllerBarHeight method, you can determine the height of the portion of the QTMovieView that is required to display that interface. Note that some types of QuickTime content are authored to display their own user interface; for those types of content it is possible for the controllerBarHeight method to return 0 even when the isControllerVisible method is YES.

Related Sample Code

• QTAudioContextInsert
• QTAudioExtractionPanel
• QTKitImport
• QTKitPlayer

isCustomButtonVisible

Returns the current visibility state of the specified controller bar button.

- (BOOL)isCustomButtonVisible

Related Sample Code

• QTKitButtonTester

isEditable

Returns YES if the QTMovieView object is editable.

- (BOOL)isEditable

Parameters

isEditable

The editable state being returned by the QTMovieView object.

Discussion

When editable, a movie can be modified using editing methods and associated key commands. The default is NO.

isHotSpotButtonVisible

Returns the current visibility state of the specified controller bar button.

- (BOOL)isHotSpotButtonVisible

Related Sample Code

• QTKitButtonTester

isTranslateButtonVisible

Returns the current visibility state of the specified controller bar button.

- (BOOL)isTranslateButtonVisible

Related Sample Code

• QTKitButtonTester

isVolumeButtonVisible

Returns the current visibility state of the specified controller bar button.

- (BOOL)isVolumeButtonVisible

Related Sample Code

• QTKitButtonTester

menuForEventDelegate:

Returns an NSMenu object that is the contextual menu for the specified event.

- (NSMenu *)menuForEventDelegate:(NSEvent *)event

Parameters

event

An NSEvent object that specifies an event.

Discussion

This delegate method can be used instead of subclassing QTMovieView in cases where an application cannot hard-link against the QTKit framework.

movie

Returns the QTMovie object associated with the QTMovieView.

- (QTMovie *)movie

Parameters

movie

The QuickTime movie to be returned with the QTMovieView object.

Related Sample Code

• iChatTheater
• MyMediaPlayer
• QTKitThreadedExport
• QTKitTimeCode

movieBounds

Returns the rectangle currently occupied by the movie in a QTMovieView.

- (NSRect)movieBounds

Parameters

movieBounds

The NSRect rectangle returned by the movie in a QTMovieView object.

Discussion

This rectangle does not include the area occupied by the movie controller bar (if it’s visible).

movieControllerBounds

Returns the rectangle currently occupied by the movie controller bar (if it’s visible) in a QTMovieView.

- (NSRect)movieControllerBounds

Related Sample Code

• QTAudioExtractionPanel
• QTKitImport
• QTKitPlayer

paste:

Inserts the contents of the clipboard (if it contains a movie clip) into the movie at the current play position.

- (IBAction)paste:(id)sender

Discussion

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

pause:

Pauses the movie playing.

- (IBAction)pause:(id)sender

Discussion

This action method pauses the movie playback. This method does nothing if the movie is already paused.

Related Sample Code

• ExtractMovieAudioToAIFF
• MyMovieFilter
• QTExtractAndConvertToAIFF

play:

Starts the movie playing at its current location.

- (IBAction)play:(id)sender

Discussion

This action method starts the movie playing at its current location. This method does nothing if the movie is already playing.

Related Sample Code

• iChatTheater
• MyMediaPlayer
• MyMovieFilter

preservesAspectRatio

Returns YES if the QTMovieView object maintains the aspect ratio of the movie when drawing it in the view.

- (BOOL)preservesAspectRatio

Parameters

preservesAspectRatio

The state of the aspect ratio returned by the QTMovieView object.

Discussion

The remainder is filled with fillColor.

Related Sample Code

• QTAudioContextInsert
• QTAudioExtractionPanel
• QTKitImport
• QTKitPlayer

replace:

Replaces the current movie selection with the contents of the clipboard.

- (IBAction)replace:(id)sender

Discussion

If there is no selection, the contents of the clipboard replace the entire movie. This action is undoable. If the movie is not editable, this method raises an exception.

selectAll:

Selects the entire movie.

- (IBAction)selectAll:(id)sender

selectNone:

Selects nothing.

- (IBAction)selectNone:(id)sender

Discussion

Note that this method does not change the movie time.

setBackButtonVisible:

Sets the specified controller bar button to be visible or invisible, according to the state parameter.

- (void)setBackButtonVisible:(BOOL)state

Related Sample Code

• QTKitButtonTester

setControllerVisible:

Sets the visibility state of the movie controller bar in a QTMovieView to controllerVisible.

- (void)setControllerVisible:(BOOL)controllerVisible

Parameters

controllerVisible

The state of controller visibility set in a QTMovieView object.

Related Sample Code

• QTAudioContextInsert
• QTAudioExtractionPanel
• QTKitImport
• QTKitPlayer

setCustomButtonVisible:

Sets the specified controller bar button to be visible or invisible, according to the state parameter.

- (void)setCustomButtonVisible:(BOOL)state

Related Sample Code

• QTKitButtonTester

setDelegate:

Sets the receiver’s delegate.

- (void)setDelegate:(id)delegate

setEditable:

Sets the edit state of a QTMovieView to editable.

- (void)setEditable:(BOOL)editable

Parameters

editable

The editable state of the QTMovieView object.

Discussion

The default state is NO.

Related Sample Code

• GLUT

setFillColor:

Sets the fill color of a QTMovieView to fillColor.

- (void)setFillColor:(NSColor *)fillColor

Discussion

Note that this may cause a redraw.

Related Sample Code

• QTAudioContextInsert
• QTAudioExtractionPanel
• QTKitImport
• QTKitPlayer

setHotSpotButtonVisible:

Sets the specified controller bar button to be visible or invisible, according to the state parameter.

- (void)setHotSpotButtonVisible:(BOOL)state

Related Sample Code

• QTKitButtonTester

setMovie:

Sets the QTMovie object in a QTMovieView to movie.

- (void)setMovie:(QTMovie *)movie

Discussion

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

Related Sample Code

• ExtractMovieAudioToAIFF
• MyMediaPlayer
• QTAudioExtractionPanel
• QTExtractAndConvertToAIFF
• QTKitPlayer

setPreservesAspectRatio:

Sets the aspect ratio state of a QTMovieView to preservesAspectRatio.

- (void)setPreservesAspectRatio:(BOOL)preservesAspectRatio

Parameters

preservesAspectRatio

The aspect ratio of the movie rectangle.

Discussion

If preservesAspectRatio is YES, the longer side of the movie rectangle is scaled to exactly fit into the view’s frame and the other side is centered in the view frame; the remaining area is filled with the view’s fill color. Note that the movie view may be redrawn, but not resized.

Related Sample Code

• QTAudioContextInsert
• QTAudioExtractionPanel
• QTKitImport
• QTKitPlayer

setShowsResizeIndicator:

Shows or hides the movie controller grow box.

- (void)setShowsResizeIndicator:(BOOL)show

Related Sample Code

• QTKitPlayer

setStepButtonsVisible:

Sets the specified controller bar button to be visible or invisible, according to the state parameter.

- (void)setStepButtonsVisible:(BOOL)state

Related Sample Code

• QTKitButtonTester

setTranslateButtonVisible:

Sets the specified controller bar button to be visible or invisible, according to the state parameter.

- (void)setTranslateButtonVisible:(BOOL)state

Related Sample Code

• QTKitButtonTester

setVolumeButtonVisible:

Sets the specified controller bar button to be visible or invisible, according to the state parameter.

- (void)setVolumeButtonVisible:(BOOL)state

Related Sample Code

• QTKitButtonTester

setZoomButtonsVisible:

Sets the specified controller bar button to be visible or invisible, according to the state parameter.

- (void)setZoomButtonsVisible:(BOOL)state

Related Sample Code

• QTKitButtonTester

stepBackward:

Steps the movie backward one frame.

- (IBAction)stepBackward:(id)sender

stepForward:

Steps the movie forward one frame.

- (IBAction)stepForward:(id)sender

trim:

Trims the movie to the current movie selection.

- (IBAction)trim:(id)sender

Discussion

If there is no selection, the current frame is retained and the remainder of the movie is deleted. This action is undoable. If the movie is not editable, this method raises an exception.