comparison DOCS/tech/mpcf.txt @ 12501:cd0d9a99b730

remove index flag max_short_distance reserved_v -> reserved_count header repeation rules some of this is from rich

12500:a6c9198b538d

	main_startcode				f(64)
	packet header
	version					v
	stream_count				v
	max_distance				v
	global_time_base_nom			v
	global_time_base_denom			v
	short_startcode				v
	for(i=0; i<256; ){
		tmp_flag			v

			flags[i]= tmp_flag;
			stream_id_plus1[i]= tmp_stream;
			data_size_mul[i]= tmp_mul;
			data_size_lsb[i]= tmp_size + j;
			timestamp_delta[i]= tmp_timestamp;
			reserved_v[i]= tmp_res;
		}
	}
	reserved_bytes
	checksum				u(32)

	time_base_nom				v
	time_base_denom				v
	msb_timestamp_shift			v
	decode_delay				v
	fixed_fps				u(1)
	index_flag				u(1)
	reserved				u(6)
	for(;;){
		codec_specific_data_type	v
		if(codec_specific_data_type==0) break;
		codec_specific_data		vb

		coded_timestamp			v
	}
	if(flags[frame_code]&1){
		data_size_msb			v
	}
	for(i=0; i<reserved_v[frame_code]; i++)
		reserved			v
	data
                
Index:
	index_startcode				f(64)
	packet header
	stream_id				v
	index_length				v
	for(i=0; i<index_length; i++){
		index_timestamp			v
		index_position			v
	}

max_distance
	max distance of frame_startcodes, the distance may only be larger if
	there is only a single frame between the 2 frame_startcodes
	this can be used by the demuxer to detect damaged frame headers if the
	damage results in a too long chain
	SHOULD be set to <=16384 to ensure reasonable error recovery

short_startcode
	MUST be 3 bytes long and MUST have 'N' as first byte, the second byte
	MUST not be a printable uppercase letter / must not be within 65..90, 
	default is 0x4EFE79
        
stream_id
	Note: streams with a lower relative class MUST have a lower relative id
	so a stream with class 0 MUST allways have a id which is lower then any
	stream with class > 0
	stream_id MUST be < stream_count

...
stream_header (id=n)

headers may be repated, but if they are then they MUST all be repeated together
and repeated headers MUST be identical

headers MUST be repeated every 10sec at least ? FIXME
headers MUST be repeated BEFORE keyframes
headers MUST be repeated at least twice (so they exist 3 times in a file)

		Index
the index can be repeated but there SHOULD be at least one for each stream at
the end
Note: in case of realtime streaming there is no end, so no index there either

for realtime streaming info packets will normally be transmitted when they apply
for example, the current song title & artist of the currently shown music video

		Unknown packets
MUST be ignored by the demuxer

			Sample code (GPL, & untested)

typedef BufferContext{
	uint8_t *buf;

12501:cd0d9a99b730

	main_startcode				f(64)
	packet header
	version					v
	stream_count				v
	max_distance				v
	max_short_distance			v
	global_time_base_nom			v
	global_time_base_denom			v
	short_startcode				v
	for(i=0; i<256; ){
		tmp_flag			v

			flags[i]= tmp_flag;
			stream_id_plus1[i]= tmp_stream;
			data_size_mul[i]= tmp_mul;
			data_size_lsb[i]= tmp_size + j;
			timestamp_delta[i]= tmp_timestamp;
			reserved_count[i]= tmp_res;
		}
	}
	reserved_bytes
	checksum				u(32)

	time_base_nom				v
	time_base_denom				v
	msb_timestamp_shift			v
	decode_delay				v
	fixed_fps				u(1)
	reserved				u(6)
	for(;;){
		codec_specific_data_type	v
		if(codec_specific_data_type==0) break;
		codec_specific_data		vb

		coded_timestamp			v
	}
	if(flags[frame_code]&1){
		data_size_msb			v
	}
	for(i=0; i<reserved_count[frame_code]; i++)
		reserved			v
	data
                
Index:
	index_startcode				f(64)
	packet header
	index_length				v
	for(i=0; i<index_length; i++){
		index_timestamp			v
		index_position			v
	}

max_distance
	max distance of frame_startcodes, the distance may only be larger if
	there is only a single frame between the 2 frame_startcodes
	this can be used by the demuxer to detect damaged frame headers if the
	damage results in a too long chain
	SHOULD be set to <=32768 or at least <=65536 unless there is a very good
	reason to set it higher otherwise reasonable error recovery will be
	impossible

max_short_distance
	max distance of short startcodes or frame_startcodes, the distance may
	only be larger if there is only a single frame between the 2 
	frame_startcodes/short startcodes this can be used by the demuxer to
	detect damaged frame headers if the damage results in a too long chain
	SHOULD be set to <=4096 or at least <=8192 unless there is a very good
	reason to set it higher otherwise reasonable error recovery will be
	impossible


short_startcode
	MUST be 3 bytes long and MUST have 'N' as first byte, the second byte
	MUST not be a printable uppercase letter / must not be within 65..90, 
	default is 0x4EFE79

stream_id
	Note: streams with a lower relative class MUST have a lower relative id
	so a stream with class 0 MUST allways have a id which is lower then any
	stream with class > 0
	stream_id MUST be < stream_count

...
stream_header (id=n)

headers may be repated, but if they are then they MUST all be repeated together
and repeated headers MUST be identical
headers MAY only repeated at the closest possible positions after 2^x where x is 
an integer and the file end, so the headers may be repeated at 4102 if thats the
closest possition after 2^12=4096 at which the headers can be placed

headers MUST be placed at least at the begin of the file and immedeatly before
the index or at the file end if there is no index
headers MUST be repeated at least twice (so they exist 3 times in a file)

a demuxer MUST not demux a stream which contains more than one stream, or which
is wrapped in a structure to facilitate more than one stream or otherwise 
duplicate the role of a container. any such file is to be considered invalid

		Index
the index can be repeated but there SHOULD be at least one for each stream at
the end
Note: in case of realtime streaming there is no end, so no index there either

for realtime streaming info packets will normally be transmitted when they apply
for example, the current song title & artist of the currently shown music video

		Unknown packets
MUST be ignored by the demuxer

			demuxer (non-normative)

in the absence of valid header at beginning, players SHOULD search for backup
headers starting at offset 2^x for each x players SHOULD end their search from a
particular offset when any startcode is found (including syncpoint)


			Sample code (GPL, & untested)

typedef BufferContext{
	uint8_t *buf;