IAMTimelineTrans::SetCutsOnly

 
Microsoft DirectShow 9.0

IAMTimelineTrans::SetCutsOnly

The SetCutsOnly method specifies whether the transition is rendered as a cut. If so, the transition occurs instantly at the cut point. If a transition takes a long time to render, you might want to preview it as a cut to speed preview.

Syntax

  HRESULT SetCutsOnly(
    BOOL Val
);

Parameters

Val

Boolean value that specifies whether to render the transition as a cut. If TRUE, the transition is rendered as an instantaneous cut. If FALSE, the transition renders over its normal duration.

Return Value

Returns S_OK.

Remarks

Rendering a transition as a cut is not compatible with swapping the inputs. (See IAMTimelineTrans::SetSwapInputs.) If you call SetCutsOnly with a value of TRUE, it temporarily overrides the SetSwapInputs setting. The cuts-only setting is intended for preview, however, so this limitation does not affect file output—just remember to call SetCutsOnly with the value FALSE before writing the file.

Requirements

Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.

Library: Use strmiids.lib.

See Also