Microsoft DirectX 9.0

IAMTimelineGroup Interface

The IAMTimelineGroup interface sets and retrieves properties on groups in DirectShow Editing Services (DES).

A group contains one or more tracks, and possibly one or more compositions, which in turn contain source clips of a uniform type, such as video or audio. Groups are the topmost compositions in a timeline, and also expose the IAMTimelineComp interface. A timeline can contain multiple groups.

Each group has the following attributes.

An associated media type.
The frame rate at which the group renders, in frames per second (FPS). All edits occur at a time rounded to the nearest frame boundary, as defined by the group's FPS setting.
A priority level, for writing files with multiple streams of the same media type (for example, a two-video-stream AVI file).

To create a group object, call IAMTimeline::CreateEmptyNode with the value TIMELINE_MAJOR_TYPE_GROUP. You can query the returned IAMTimelineObj pointer for the IAMTimelineGroup interface.

In addition to the methods inherited from IUnknown, the IAMTimelineGroup interface exposes the following methods.

Method	Description
ClearRecompressFormatDirty	Not supported.
GetGroupName	Retrieves the application-defined name of the group.
GetMediaType	Retrieves the uncompressed media type for the group.
GetOutputBuffering	Retrieves the number of frames rendered in advance during preview.
GetOutputFPS	Retrieves the output frame rate of this group.
GetPreviewMode	Retrieves the preview mode for the group.
GetPriority	Retrieves the group's priority.
GetSmartRecompressFormat	Retrieves the current compression format for smart recompression.
GetTimeline	Retrieves the timeline to which this group belongs.
IsRecompressFormatDirty	Not supported.
IsSmartRecompressFormatSet	Determines whether a smart compression format was set for the group.
SetGroupName	Sets the application-defined name of the group.
SetMediaType	Sets the uncompressed media type for the group.
SetMediaTypeForVB	Specifies the group media type, for Automation clients.
SetOutputBuffering	Specifies the number of frames rendered in advance during preview.
SetOutputFPS	Sets the uncompressed output frame rate for this group.
SetPreviewMode	Sets the preview mode for the group.
SetSmartRecompressFormat	Specifies a compression format to use for smart recompression.
SetRecompFormatFromSource	Sets the video recompression format using the compression format from a source file.
SetTimeline	Not supported.

Requirements

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

Library: Use strmiids.lib.