comparison DOCS/tech/mpcf.txt @ 17669:cb73482267a0

info packet stuff, chapters...

17668:b822575a1140

    reserved_bytes
    index_ptr                           u(64)
    checksum                            u(32)

info_frame: (optional)
    for(;;){
        id                              v
        if(id==0) break
        name= info_table[id][0]
        type= info_table[id][1]
        if(type==NULL)
            type                        vb
        if(name==NULL)
            name                        vb
        if(type=="v")
            value                       v
        else if(type=="s")
            value                       s
        else
            value                       vb
    }
    reserved_bytes
    checksum                            u(32)

info_packet: (optional)

    there is an index at all.

Info tags:
----------

id
    the ID of the type/name pair, so it is more compact
    0 means end

type
    for example: "UTF8" -> string or "JPEG" -> JPEG image
    Note: nonstandard fields should be prefixed by "X-"
    Note: MUST be less than 6 byte long (might be increased to 64 later)

info packet types
    the name of the info entry, valid names are
    "StreamId"
        the stream(s) to which the info packet applies
    "Author"
    "Description"
    "Copyright"
    "Encoder"
        the name & version of the software used for encoding
    "Title"
    "Cover"
        image of the (CD, DVD, VHS, ..) cover (preferably PNG or JPEG)
    "Source"
        "DVD", "VCD", "CD", "MD", "FM radio", "VHS", "TV", "LD"
        Optional: appended PAL, NTSC, SECAM, ... in parentheses
    "CaptureDevice"

    "CreationTime"
        "2003-01-20 20:13:15Z", ...
        (ISO 8601 format, see http://www.cl.cam.ac.uk/~mgk25/iso-time.html)
        Note: do not forget the timezone
    "Keywords"
    "TotalTime"
        total length of the stream in msecs
    "Language"
        ISO 639 and ISO 3166 for language/country code
        something like "eng" (US english), can be 0 if unknown
        and "multi" if several languages
        see http://www.loc.gov/standards/iso639-2/englangn.html

    value of this name/type pair

stuffing
    0x80 can be placed in front of any type v entry for stuffing purposes

info_table[][2]={
    {NULL            ,  NULL }, // end
    {NULL            ,  NULL },
    {NULL            , "UTF8"},
    {NULL            , "v"},
    {NULL            , "s"},
    {"StreamId"      , "v"},
    {"Author"        , "UTF8"},
    {"Title"         , "UTF8"},
    {"Language"      , "UTF8"},
    {"Description"   , "UTF8"},
    {"Copyright"     , "UTF8"},
    {"Encoder"       , "UTF8"},
    {"Keyword"       , "UTF8"},
    {"Cover"         , "JPEG"},
    {"Cover"         , "PNG"},
    {"Disposition"   , "UTF8"},
};


Structure:
----------

Index MAY only be repeated after main headers.
If an index is written anywhere in the file, it MUST be written at end of
file as well.


Info frames:
------------

Info frames can be used to describe the file or some part of it (chapters)


demuxer (non-normative):
------------------------

17669:cb73482267a0

    reserved_bytes
    index_ptr                           u(64)
    checksum                            u(32)

info_frame: (optional)
    stream_id_plus1                     v
    chapter_id                          v
    if (chapter_id) {
        chapter_start                   v
        chapter_len                     v
    }
    count                               v
    for(i=0; i<count; i++){
        name                            vb
        value                           s
        if (value==-1){
            type= "UTF-8"
            value                       vb
        }else if (value==-2){
            type                        vb
            value                       vb
        }else if (value==-3){
            type= "signed integer"
            value                       s
        }else if (value<-3){
            type= "rational"
            value.den= -value-2
            value.num                   s
        }else{
            type= "unsigned integer"
        }
    }
    reserved_bytes
    checksum                            u(32)

info_packet: (optional)

    there is an index at all.

Info tags:
----------

stream_id_plus1
    Stream this info packet applies to. If zero, packet applies to whole
    file.

chapter_id
    Id of chapter this packet applies to. If zero, packet applies to whole
    file. Positive chapter_id's are real chapters and MUST NOT overlap.
    Negative chapter_id indicate a sub region of file and not a real
    chapter. chapter_id MUST be unique to the region it represents.

chapter_start
    s= chapter_start % stream_count
    timestamp= chapter_start / stream_count
    timestamp of start of chapter in timebase of stream 's'.

chapter_len
    Length of chapter in same timebase of chapter_start.

type
    for example: "UTF8" -> string or "JPEG" -> JPEG image
    Note: nonstandard fields should be prefixed by "X-"
    Note: MUST be less than 6 byte long (might be increased to 64 later)

info packet types
    the name of the info entry, valid names are
    "Author"
    "Description"
    "Copyright"
    "Encoder"
        the name & version of the software used for encoding
    "Title"
    "Cover" (allowed types are "PNG" and "JPEG")
        image of the (CD, DVD, VHS, ..) cover (preferably PNG or JPEG)
    "Source"
        "DVD", "VCD", "CD", "MD", "FM radio", "VHS", "TV", "LD"
        Optional: appended PAL, NTSC, SECAM, ... in parentheses
    "CaptureDevice"

    "CreationTime"
        "2003-01-20 20:13:15Z", ...
        (ISO 8601 format, see http://www.cl.cam.ac.uk/~mgk25/iso-time.html)
        Note: do not forget the timezone
    "Keywords"
    "Language"
        ISO 639 and ISO 3166 for language/country code
        something like "eng" (US english), can be 0 if unknown
        and "multi" if several languages
        see http://www.loc.gov/standards/iso639-2/englangn.html

    value of this name/type pair

stuffing
    0x80 can be placed in front of any type v entry for stuffing purposes



Structure:
----------

Index MAY only be repeated after main headers.
If an index is written anywhere in the file, it MUST be written at end of
file as well.


Info:
-----

All info packets with the same chapter_id and stream_id are repeated info
packets and MUST be binary identical.

All info packets MUST appear after main headers at begginning of file, and
SHOULD be repeated after all main headers unless they are very large.

Info frames can be used to describe the file or some part of it (chapters)

Info SHOULD be stored in global packets instead of info streams/frames if
possible, and the amount of data is not large.


demuxer (non-normative):
------------------------