2.8.73 TimeIterateDataAtom

Referenced by: ExtTimeNodeContainer

An atom record that specifies how an animation is applied to sub-elements of the target object for a repeated effect. It can be applied to the letters, words, or shapes within a target object.


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

...

iterateInterval

iterateType

iterateDirection

iterateIntervalType

A

B

C

D

reserved

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

Field

Meaning

rh.recVer

MUST be 0x0.

rh.recInstance

MUST be 0x000.

rh.recType

MUST be an RT_TimeIterateData.

rh.recLen

MUST be 0x00000014.

iterateInterval (4 bytes): An unsigned integer that specifies the interval time of iterations, which can be either absolute time or a percentage as specified in iterateIntervalType. It MUST be ignored if fIterateIntervalPropertyUsed is FALSE and a value of 0x00000000 MUST be used instead.

iterateType (4 bytes): An unsigned integer that specifies the type of iteration behavior. It MUST be ignored if fIterateTypePropertyUsed is FALSE and a value of 0x00000000 MUST be used instead. It MUST be a value from the following table.

Value

Meaning

0x00000000

All at once: all sub-elements animate together with no interval time.

0x00000001

By word: sub-elements are words.

0x00000002

By letter: sub-elements are letters.

iterateDirection (4 bytes): An unsigned integer that specifies the direction of the iteration behavior. It MUST be ignored if fIterateDirectionPropertyUsed is FALSE and a value of 0x00000001 MUST be used instead. It MUST be a value from the following table.

Value

Meaning

0x00000000

Backwards: from the last sub-element to the first sub-element.

0x00000001

Forwards: from the first sub-element to the last sub-element.

iterateIntervalType (4 bytes): An unsigned integer that specifies the type of interval time as specified in iterateInterval. It MUST be ignored if fIterateIntervalTypePropertyUsed is FALSE and a value of 0x00000000 MUST be used instead. It MUST be a value from the following table.

Value

Meaning

0x00000000

Seconds: iterateInterval is absolute time in milliseconds.

0x00000001

Percentage: iterateInterval is a percentage of animation duration, in tenths of a percent.

A - fIterateDirectionPropertyUsed (1 bit): A bit that specifies whether iterateDirection was explicitly set by a user interface action.

B - fIterateTypePropertyUsed (1 bit): A bit that specifies whether iterateType was explicitly set by a user interface action.

C - fIterateIntervalPropertyUsed (1 bit): A bit that specifies whether iterateInterval was explicitly set by a user interface action.

D - fIterateIntervalTypePropertyUsed (1 bit): A bit that specifies whether iterateIntervalType was explicitly set by a user interface action.

reserved (28 bits): MUST be zero, and MUST be ignored.