ref_iface_IVDXFilterPreview_SampleFrames

VirtualDub Plugin SDK 1.2

IVDXFilterPreview interface

IVDXFilterPreview:: SampleFrames

Requests analysis of the entire source video stream.

void SampleFrames();

Thread safety

This method is not thread-safe.

Errors

Errors may not be returned from this function (see SetError()).

Remarks

SampleFrames() is usually called in response to a user request to display information about the source video, such as an aggregate image histogram. It causes a series of source frames to be sent to the sampling callback specified by SetSampleCallback().

VirtualDub specific: This method causes UI to be displayed that allows the user to select from several modes for sampling the source video. The user can choose to only sample key frames or key frames at an interval to trade off speed for accuracy.