Instance Method

makeSampleCursorWithPresentationTimeStamp:

Creates an instance of a sample cursor and positions it at or near the specified presentation timestamp.

Declaration

- (AVSampleCursor *)makeSampleCursorWithPresentationTimeStamp:(CMTime)presentationTimeStamp;

Parameters

presentationTimeStamp

The desired initial presentation timestamp of the AVSampleCursor.

Return Value

An instance of AVSampleCursor.

Discussion

If the receiver's asset property value for providesPreciseDurationAndTiming is YES, the sample cursor is accurately positioned at the receiver's last media sample with a presentation timestamp less than or equal to the desired timestamp, or, if there are no such samples, the first sample in presentation order.

If the receiver's asset property value for providesPreciseDurationAndTiming is NO, and it is prohibitively expensive to locate the precise sample at the desired timestamp, the sample cursor may be approximately positioned.

See Also

Creating Sample Cursors

canProvideSampleCursors

A Boolean value that indicates whether the asset track can provide instances of sample cursors to traverse its media samples and discover information.

- makeSampleCursorAtFirstSampleInDecodeOrder

Creates an instance of a sample cursor and positions it at the receiver's first media sample in decode order.

- makeSampleCursorAtLastSampleInDecodeOrder

Creates an instance of a sample cursor and positions it at the receiver's last media sample in decode order.