IAMTimeline Interface
Microsoft DirectShow 9.0 |
IAMTimeline Interface
The IAMTimeline interface provides methods for manipulating the timeline , the central object in Microsoft DirectShow Editing Services (DES). A timeline is a collection of time-ordered elements, such as video clips, audio clips, effects, and transitions between clips. The render engine uses the timeline to create a filter graph, from which the application can generate the rendered output.
IAMTimeline performs three basic services. It
- Creates the objects in the timeline.
- Acts as a container for those objects.
- Sets and retrieves general parameters of the timeline.
To create the timeline object, call CoCreateInstance with the class identifier CLSID_AMTimeline.
In addition to the methods inherited from IUnknown, the IAMTimeline interface exposes the following methods.
Method | Description |
AddGroup | Adds a group to the timeline. |
ClearAllGroups | Removes all groups from the timeline, along with all objects contained in those groups. |
CreateEmptyNode | Creates a new timeline object. |
EffectsEnabled | Determines whether effects are enabled. |
EnableEffects | Enables or disables all effects in the timeline. |
EnableTransitions | Enables or disables all transitions in the timeline. |
GetCountOfType | Retrieves the number of objects of the specified type that are contained in a specified group and all of its children. |
GetDefaultEffect | Retrieves the default effect. |
GetDefaultEffectB | Retrieves the default effect as a BSTR value. |
GetDefaultFPS | Retrieves the default output frame rate, in frames per second. |
GetDefaultTransition | Retrieves the default transition. |
GetDefaultTransitionB | Retrieves the default transition as a BSTR value. |
GetDirtyRange | Not supported. |
GetDuration | Retrieves the timeline duration. |
GetDuration2 | Retrieves the timeline duration as a double. |
GetGroup | Retrieves a specified group. |
GetGroupCount | Retrieves the number of groups that are contained in the timeline. |
GetInsertMode | Not supported. |
IsDirty | Not supported. |
RemGroupFromList | Not supported. |
SetDefaultEffect | Sets the default effect. |
SetDefaultEffectB | Sets the default effect as a BSTR value. |
SetDefaultFPS | Sets the default output frame rate, in frames per second. |
SetDefaultTransition | Sets the default transition. |
SetDefaultTransitionB | Sets the default transition as a BSTR value. |
SetInsertMode | Not implemented. |
SetInterestRange | Not implemented. |
TransitionsEnabled | Determines whether transitions are enabled. |
ValidateSourceNames | Validates source names in the timeline. |
Requirements
Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.
Library: Use strmiids.lib.