Microsoft DirectX 8.0

GROUP Element

XML Reference

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  

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.