Instance Method

finishWithError:

Notifies AVFoundation that you cannot fulfill the image filtering request.

Declaration

- (void)finishWithError:(NSError *)error;

Parameters

error

An error object describing the reason to

Discussion

Call this method if you cannot process the input image and wish to abort playback as a result—for example, if the outputImage object from your filter chain is nil. (If instead you want to fall back to rendering an unfiltered image, call the finishWithImage:context: and pass the sourceImage object to the filteredImage parameter.)

Calling this method causes AVFoundation to post a notification named AVPlayerItemFailedToPlayToEndTimeNotification. Observers of this notification can use the AVPlayerItemFailedToPlayToEndTimeErrorKey key to examine the error you provide.

See Also

Returning the Filtered Image

- finishWithImage:context:

Provides the filtered video frame image to AVFoundation for further processing or display.