2.8.16 SubEffectContainer

A container record that specifies a subordinate time node whose start time depends on the relation to its master time node.

At most one of the following fields MUST exist: timeColorBehavior, timeSetBehavior, or timeCommandBehavior.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

rh

...

timeNodeAtom (40 bytes)

...

...

timePropertyList (variable)

...

timeColorBehavior (variable)

...

timeSetBehavior (variable)

...

timeCommandBehavior (variable)

...

clientVisualElement (variable)

...

rgBeginTimeCondition (variable)

...

rgEndTimeCondition (variable)

...

rgTimeModifierAtom (variable)

...

rh (8 bytes): A RecordHeader structure (section 2.3.1) that specifies the header for this record. Subfields are further specified in the following table.

Field

Meaning

rh.recVer

MUST be 0xF.

rh.recInstance

MUST be 0x001.

rh.recType

MUST be an RT_TimeSubEffectContainer.

timeNodeAtom (40 bytes): A TimeNodeAtom record that specifies some attributes of this subordinate time node. The timeNodeAtom.type subfield MUST be TL_TNT_Behavior or TL_TNT_Media.

timePropertyList (variable): An optional TimePropertyList4TimeNodeContainer record (section 2.8.18) that specifies a list of attributes of the subordinate time node.

timeColorBehavior (variable): An optional TimeColorBehaviorContainer record (section 2.8.52) that specifies a color animation behavior that changes the color of an object. It MUST exist only if timeNodeAtom.type is TL_TNT_Behavior.

timeSetBehavior (variable):  An optional TimeSetBehaviorContainer record (section 2.8.69) that specifies a set animation behavior that assigns a value to a property of an object. It MUST exist only if timeNodeAtom.type is TL_TNT_Behavior.

timeCommandBehavior (variable): An optional TimeCommandBehaviorContainer record (section 2.8.71) that specifies a command-animation behavior that performs a command as an animation. It MUST exist if and only if the timeCommandBehavior.rh.recType field is RT_TimeCommandBehaviorContainer and the timeNodeAtom.type field is TL_TNT_Behavior.

clientVisualElement (variable): An optional ClientVisualElementContainer record (section 2.8.44) that specifies a media to be played. It MUST exist only if timeNodeAtom.type is TL_TNT_Media.

rgBeginTimeCondition (variable):  An optional array of TimeConditionContainer records (section 2.8.75) that specifies the time conditions. It MUST be used when the rh.recInstance field of a TimeConditionContainer record is TL_CT_Begin. Any of these time conditions determine when this subordinate time node will be activated.

The array continues while the rh.recType field of the TimeConditionContainer record is equal to RT_TimeConditionContainer and the situation in the previous paragraph applies.

rgEndTimeCondition (variable):  An optional array of TimeConditionContainer records that specifies the time conditions. It MUST be used when the rh.recInstance field of a TimeConditionContainer item is TL_CT_End. Any of these time conditions determines when this subordinate time node will be deactivated.

The array continues while the rh.recType field of the TimeConditionContainer record is equal to RT_TimeConditionContainer and the previous situation applies.

rgTimeModifierAtom (variable): An optional array of TimeModifierAtom records that specifies the modification records that store the type of data to be modified and the new data value. The array continues while the rh.recType field of the TimeModifierAtom record is equal to RT_TimeModifier.