Revision 2

New Platform Sequence Storage Format

Note: all multi-byte integral types are in big-endian format unless otherwise specified. All fields without a value specified may be any value.

Block Type
Value Block Type
0 Message
1 Sequence

Transitions

It should be noted that a given sign is not required to implement any or all transitions, and a message with an unrecognized transition should not be considered an error.

Version 0

The sequence storage format
Size Data Type Value Description
1 unsigned byte 1 Block type. (see below)
1 unsigned byte 0 Sequence storage format version
2 unsigned short The number of bytes in the title. (This is a short, rather than a byte, for simplicity in reading the formats in Java.)
0 – (216-1) bytes The sequence's title, encoded in UTF-8
4 integer (block_count) The number of display blocks in the sequence. (see display block entry)
4 integer (payload_count) The number of data payloads in the sequence. (see data payloads entry)
4 integer Reserved
variable Display Block[block_count] The display blocks. The display block format is specified below.
variable Data Payload[payload_count] The data payloads. (Data payloads are embeded messages and sequences whose display order and time are indicated by the data blocks. Animated graphics are stored as regular sequences, so inserting an animated graphic into a sequence is accomplished by embedding the animated graphic's sequence.)
The display block format
Size Data Type Value Description
4 integer The index of the data payload to display (indexes start at 0)
4 integer display time (in milliseconds)
4 integer Transition special effect type (see below)
Special Effect Transition Types
Value Transition Effect
0 No Transition
1 Short blank transition
2 Pixelated (morphing) transition
3 Right-moving shudder transition
4 Left-moving shudder transition
5 Top-to-bottom wipe transition
6 Bottom-to-top wipe transition
7 Inside-to-outside rectangular wipe transition
8 Outside-to-inside rectangular wipe transition
9 Left-to-right wipe transition
10 Right-to-left wipe transition

Version 1

NOTE: version 1 is not yet finalized.

Version 1 adds annotations to the sequence storage format.
The sequence storage format
Size Data Type Value Description
1 unsigned byte 1 Block type. (see below)
1 unsigned byte 1 Sequence storage format version
2 unsigned short The number of bytes in the title. (This is a short, rather than a byte, for simplicity in reading the formats in Java.)
0 – (216-1) bytes The sequence's title, encoded in UTF-8
1 unsigned byte (annotation_count) The number of annotation blocks which follow.
variable annotation_count Annotation Blocks, which apply to the sequence as a whole. Annotation blocks for particular Display Block are embedded in the Display Block itself.
4 integer (block_count) The number of display blocks in the sequence. (see display block entry)
4 integer (payload_count) The number of data payloads in the sequence. (see data payloads entry)
variable Display Block[block_count] The display blocks. The display block format is specified below.
variable Data Payload[payload_count] The data payloads. (Data payloads are embeded messages and sequences whose display order and time are indicated by the data blocks. Animated graphics are stored as regular sequences, so inserting an animated graphic into a sequence is accomplished by embedding the animated graphic's sequence.)
The display block format
Size Data Type Value Description
4 integer The index of the data payload to display (indexes start at 0)
4 integer display time (in milliseconds)
4 integer Transition special effect type (see below)
1 unsigned byte (annotation_count) The number of annotation blocks which follow
variable annotation_count Annotation Blocks
Annotation Block
Size Data Type Value Description
1 unsigned byte the annotation ID
2 unsigned short (asize) the number of bytes in this annotation (not including the ID or this size)
asize data the annotation data (see annotations)
Special Effect Transition Types
Value Transition Effect
0 No Transition
1 Short blank transition
2 Pixelated (morphing) transition
3 Right-moving shudder transition
4 Left-moving shudder transition
5 Top-to-bottom wipe transition
6 Bottom-to-top wipe transition
7 Inside-to-outside rectangular wipe transition
8 Outside-to-inside rectangular wipe transition
9 Left-to-right wipe transition
10 Right-to-left wipe transition
11 Top -> Bottom slide transition
12 Bottom -> Top slide transition
13 Left -> Right slide transition
14 Right -> Left slide transition
15 Horizontal Inside->Outside Reveal transition
16 Horizontal Outside->Inside Reveal transition
17 Vertical Inside->Outside Reveal transition
18 Vertical Outside->Inside Reveal transition


Last modified: Wed Sep 15 15:20:20 Eastern Daylight Time 2004