GROUP Element

Defines a group, the top-level object in a timeline.

Example

<GROUP TYPE="video" WIDTH="640" HEIGHT="480" FRAMERATE="30"> </GROUP>

Attributes

Name Description Type C/C++ Equivalent

BITDEPTH Bit depth of the output video, in bits per pixel. Must be 16, 24, or 32. Set this attribute only if the TYPE attribute is video. The default value is 16. Integer

BUFFERING Number of frames to render in advance during preview. Must be a number greater than 1. The default value is 30. Integer IAMTimelineGroup::SetOutputBuffering

FRAMERATE Output frame rate, in frames per second. Do not use values with more than seven decimal digits. Float IAMTimelineGroup::SetOutputFPS

HEIGHT Height of the output video, in pixels. Set this attribute only if the TYPE attribute is video. Integer

LOCK Specifies whether the group is locked (should not be edited).

TRUE: The group is locked.
FALSE: The group is not locked. (Default)
Boolean IAMTimelineObj::SetLocked

MUTE Specifies the group's mute state.

TRUE: The group and all of its children are not rendered.
FALSE: The group is rendered; children are rendered according to their own mute state. (Default)
Boolean IAMTimelineObj::SetMuted

PREVIEWMODE Preview mode for the group.

TRUE: Frames might be dropped during preview. (Default)
FALSE: No frames are dropped.
Under the default setting, frames are dropped while previewing slow effects or transitions, to keep the video synchronized with the audio. The video might look choppy as a result. Setting this attribute to FALSE forces every frame to render during preview, possibly resulting in the video becoming out of sync with the audio. (Frames are never dropped when writing to a file.) Boolean IAMTimelineGroup::SetPreviewMode

SAMPLINGRATE Sampling rate of the output audio, in Hz. Must be 8000, 11025, 22050, 32000, 44100, or 48000. Set this attribute only if the TYPE attribute is audio. The default value is 44100. Integer

TYPE Group media type. Must be either video or audio. String IAMTimelineGroup::SetMediaType

USERDATA Application-defined persistent data. Must be an even number of digits. The values A–F must be capitalized. Do not use a prefix such as 0x. Example: 123ABC. Hexadecimal IAMTimelineObj::SetUserData

USERID Application-defined identifier for the object. Integer IAMTimelineObj::SetUserID

USERNAME Application-defined name for the object. String IAMTimelineObj::SetUserName

WIDTH Width of the output video, in pixels. Set this attribute only if the TYPE attribute is video. Integer

Name	Description	Type	C/C++ Equivalent
BITDEPTH	Bit depth of the output video, in bits per pixel. Must be 16, 24, or 32. Set this attribute only if the TYPE attribute is video. The default value is 16.	Integer
BUFFERING	Number of frames to render in advance during preview. Must be a number greater than 1. The default value is 30.	Integer	IAMTimelineGroup::SetOutputBuffering
FRAMERATE	Output frame rate, in frames per second. Do not use values with more than seven decimal digits.	Float	IAMTimelineGroup::SetOutputFPS
HEIGHT	Height of the output video, in pixels. Set this attribute only if the TYPE attribute is video.	Integer
LOCK	Specifies whether the group is locked (should not be edited). TRUE: The group is locked. FALSE: The group is not locked. (Default)	Boolean	IAMTimelineObj::SetLocked
MUTE	Specifies the group's mute state. TRUE: The group and all of its children are not rendered. FALSE: The group is rendered; children are rendered according to their own mute state. (Default)	Boolean	IAMTimelineObj::SetMuted
PREVIEWMODE	Preview mode for the group. TRUE: Frames might be dropped during preview. (Default) FALSE: No frames are dropped. Under the default setting, frames are dropped while previewing slow effects or transitions, to keep the video synchronized with the audio. The video might look choppy as a result. Setting this attribute to FALSE forces every frame to render during preview, possibly resulting in the video becoming out of sync with the audio. (Frames are never dropped when writing to a file.)	Boolean	IAMTimelineGroup::SetPreviewMode
SAMPLINGRATE	Sampling rate of the output audio, in Hz. Must be 8000, 11025, 22050, 32000, 44100, or 48000. Set this attribute only if the TYPE attribute is audio. The default value is 44100.	Integer
TYPE	Group media type. Must be either video or audio.	String	IAMTimelineGroup::SetMediaType
USERDATA	Application-defined persistent data. Must be an even number of digits. The values A–F must be capitalized. Do not use a prefix such as 0x. Example: 123ABC.	Hexadecimal	IAMTimelineObj::SetUserData
USERID	Application-defined identifier for the object.	Integer	IAMTimelineObj::SetUserID
USERNAME	Application-defined name for the object.	String	IAMTimelineObj::SetUserName
WIDTH	Width of the output video, in pixels. Set this attribute only if the TYPE attribute is video.	Integer

Parent/Child Information

Parent TIMELINE

Children COMPOSITE, EFFECT, TRACK

Remarks

Within a GROUP element, the priority of nested layers is determined implicitly by the order in which they appear inside the tag. The first layer has priority 0, and subsequent layers have increasing priority values.