daala_comment (3) - Linux Manuals
NAME
daala_comment -
SYNOPSIS
Data Fields
char ** user_comments
The array of comment string vectors.
int * comment_lengths
An array of the corresponding lengths of each vector, in bytes.
int comments
The total number of comment strings.
char * vendor
The null-terminated vendor string.
Detailed Description
The comment information.
This structure holds in the in-stream metadata corresponding to the 'comment' header packet. The comment header is meant to be used much like someone jotting a quick note on the label of a disc. It should be a short, to the point text note that can be more than a couple words, but not more than a short paragraph.
The metadata is stored as a series of (tag, value) pairs, in length-encoded string vectors. The first occurrence of the '=' character delimits the tag and value. A particular tag may occur more than once, and order is significant. The character set encoding for the strings is always UTF-8, but the tag names are limited to ASCII, and treated as case-insensitive. See the Daala specification for details.
In filling in this structure, daala_decode_header_in() will null-terminate the user_comment strings for safety. However, the bitstream format itself treats them as 8-bit clean vectors, possibly containing null characters, and so the length array should be treated as their authoritative length.
Field Documentation
char** daala_comment::user_comments
The array of comment string vectors.
int* daala_comment::comment_lengths
An array of the corresponding lengths of each vector, in bytes.
int daala_comment::comments
The total number of comment strings.
char* daala_comment::vendor
The null-terminated vendor string. This identifies the software used to encode the stream.
Author
Generated automatically by Doxygen for daala from the source code.