|An array of comment string vectors. |
|An array of corresponding string vector lengths in bytes. |
|The total number of comment string vectors. |
|The vendor string identifying the encoder, null terminated. |
This structure holds the in-stream metadata corresponding to the 'comment' header packet.
Meta data is stored as a series of (tag, value) pairs, in length-encoded string vectors. The first occurence of the '=' character delimits the tag and value. A particular tag may occur more than once. The character set encoding for the strings is always UTF-8, but the tag names are limited to case-insensitive ASCII. See the spec for details.
In filling in this structure, theora_decode_header() will null-terminate the user_comment strings for safety. However, the bitstream format itself treats them as 8-bit clean, and so the length array should be treated as authoritative for their length.
An array of corresponding string vector lengths in bytes.
The total number of comment string vectors.
An array of comment string vectors.
The vendor string identifying the encoder, null terminated.