comparison DOCS/tech/mpcf.txt @ 17726:541738aa3079

return index_ptr to inside index add max_size disallow reserved headers after index

17725:d7dd016cb97a

    fourcc                              vb
    time_base_nom                       v
    time_base_denom                     v
    msb_pts_shift                       v
    max_pts_distance                    v
    decode_delay                        v
    reserved                            u(7)
    fixed_fps                           u(1)
    codec_specific_data                 vb
    if(stream_class == video){

                keyframe_pts[j][i] = last_pts + A
                last_pts += A + B
            }
        }
    }

info_packet:
    stream_id_plus1                     v
    chapter_id                          v
    chapter_start                       v

            Complete definition:

file:
    file_id_string
    while(bytes_left > 8){
        if(next_byte == 'N'){
            startcode                           f(64)
            forward_ptr                         v
            switch(startcode){
                case      main_startcode:  main_header; break;

            reserved_bytes
            checksum                    u(32)
        }else
            frame
    }
    index_ptr                           u(64)

the structure of a undamaged file should look like the following, but
demuxers should be flexible and be able to deal with damaged headers so the
above is a better loop in practice (not to mention its simpler)
note, demuxers MUST be able to deal with new and unknown headers

        packet_footer
    }

file:
    file_id_string
    while(bytes_left > 8){
        packet_header, main_header, packet_footer
        reserved_headers
        for(i=0; i<stream_count; i++){
            packet_header, stream_header, packet_footer
            reserved_headers
        }
        while(next_code == info_startcode){
            packet_header, info_packet, packet_footer
            reserved_headers
        }
        while(next_code == index_startcode){
            packet_header, index_packet, packet_footer
            reserved_headers
        }
        if (bytes_left > 8) while(next_code != main_startcode){
            if(next_code == syncpoint_startcode){
                packet_header, syncpoint, packet_footer
            }
            frame
            reserved_headers
        }
    }
    index_ptr                           u(64)


Tag description:
----------------

max_pts_distance
    max absoloute difference of pts of new frame from last_pts in the
    timebase of the stream, without a checksum after the frameheader
    Note that last_pts is not necessarily the pts of the last frame
    on the same stream, as it is altered by syncpoint timestamps.

stream_id
    Stream identifier
    stream_id MUST be < stream_count

    EOR frames MUST be zero-length and must be set keyframe.
    All streams SHOULD end with EOR, where the pts of the EOR indicates the
    end presentation time of the final frame.
    An EOR set stream is unset by the first content frames.
    EOR can only be unset in streams with zero decode_delay .
    has_checksum must be set if the frame is larger then 2*max_distance or its
    pts differs by more then max_pts_distance from the last frame

stream_id_plus1[frame_code]
    must be <250
    if it is 0, then the stream_id is coded in the frame

eor_pts
    Coded only if EOR is set at the position of the syncpoint. The pts of
    that EOR. EOR is unset by the first keyframe after it.

index_ptr
    absolute location in the file of the first byte of the startcode of the 
    first index packet, or 0 if there is no index

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

stream_id_plus1

Index:
------

Note: with realtime streaming, there is no end, so no index there either
Index MAY only be repeated after main headers.


Info:
-----

17726:541738aa3079

    fourcc                              vb
    time_base_nom                       v
    time_base_denom                     v
    msb_pts_shift                       v
    max_pts_distance                    v
    max_size                            v
    decode_delay                        v
    reserved                            u(7)
    fixed_fps                           u(1)
    codec_specific_data                 vb
    if(stream_class == video){

                keyframe_pts[j][i] = last_pts + A
                last_pts += A + B
            }
        }
    }
last 8 reserved_bytes of index:
    index_ptr                           u(64)

info_packet:
    stream_id_plus1                     v
    chapter_id                          v
    chapter_start                       v

            Complete definition:

file:
    file_id_string
    while(!eof){
        if(next_byte == 'N'){
            startcode                           f(64)
            forward_ptr                         v
            switch(startcode){
                case      main_startcode:  main_header; break;

            reserved_bytes
            checksum                    u(32)
        }else
            frame
    }

the structure of a undamaged file should look like the following, but
demuxers should be flexible and be able to deal with damaged headers so the
above is a better loop in practice (not to mention its simpler)
note, demuxers MUST be able to deal with new and unknown headers

        packet_footer
    }

file:
    file_id_string
    while(!eof){
        packet_header, main_header, packet_footer
        reserved_headers
        for(i=0; i<stream_count; i++){
            packet_header, stream_header, packet_footer
            reserved_headers
        }
        while(next_code == info_startcode){
            packet_header, info_packet, packet_footer
            reserved_headers
        }
        if(next_code == index_startcode){
            packet_header, index_packet, packet_footer
        }
        if (!eof) while(next_code != main_startcode){
            if(next_code == syncpoint_startcode){
                packet_header, syncpoint, packet_footer
            }
            frame
            reserved_headers
        }
    }


Tag description:
----------------

max_pts_distance
    max absoloute difference of pts of new frame from last_pts in the
    timebase of the stream, without a checksum after the frameheader
    Note that last_pts is not necessarily the pts of the last frame
    on the same stream, as it is altered by syncpoint timestamps.

max_size
    max frame size without a checksum after the frameheader.
    MUST be <=4*max_distance. If stored value is bigger than max_size MUST
    be set to 4*max_distance .

stream_id
    Stream identifier
    stream_id MUST be < stream_count

    EOR frames MUST be zero-length and must be set keyframe.
    All streams SHOULD end with EOR, where the pts of the EOR indicates the
    end presentation time of the final frame.
    An EOR set stream is unset by the first content frames.
    EOR can only be unset in streams with zero decode_delay .
    FLAG_CHECKSUM must be set if the frame is larger than max_size or its
    pts differs by more then max_pts_distance from the last frame

stream_id_plus1[frame_code]
    must be <250
    if it is 0, then the stream_id is coded in the frame

eor_pts
    Coded only if EOR is set at the position of the syncpoint. The pts of
    that EOR. EOR is unset by the first keyframe after it.

index_ptr
    Length in bytes of the entire index, from the first byte of the
    startcode until the last byte of the checksum.
    Note: A demuxer can use this to find the index when it is written at
    EOF, as index_ptr will always be 12 bytes before the end of file if
    there is an index at all.


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

stream_id_plus1

Index:
------

Note: with realtime streaming, there is no end, so no index there either
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:
-----