mplayer.hg: DOCS/tech/mpcf.txt comparison

comparison DOCS/tech/mpcf.txt @ 14471:6cdd5669e930

Here is an updated draft with the bits discussed previously merged: - short startcode removed - QT/Microsoft codec_specific_data removed, reverted to a neutral format - meta packet removed, merged in the info packet. - stream class simplified, added metadata stream patch by (Luca Barbato <lu_zero gentoo org>)

author	michael
date	Wed, 12 Jan 2005 11:54:30 +0000
parents	8ff17d153414
children	ebc5136f2a56

comparison

equal deleted inserted replaced

-:0db5d481d31b
+:6cdd5669e930
-		NUT Open Container Format DRAFT 20040911
+		NUT Open Container Format DRAFT 20050111
 		----------------------------------------
 			Intro:
 	main_startcode				f(64)
 	packet header
 	version					v
 	stream_count				v
 	max_distance				v
-	max_short_distance			v
+	max_index_distance			v
 	global_time_base_nom			v
 	global_time_base_denom			v
-	short_startcode				v
 	for(i=0; i<256; ){
 		tmp_flag			v
 		tmp_fields			v
 		if(tmp_fields>0) tmp_timestamp	s
 		if(tmp_fields>1) tmp_mul	v
 	time_base_denom				v
 	msb_timestamp_shift			v
 	decode_delay				v
 	fixed_fps				u(1)
 	reserved				u(6)
-	for(;;){
+	codec_specific_data			vb
-		codec_specific_data_type	v
-		if(codec_specific_data_type==0) break;
-		codec_specific_data		vb
-	}
 video_stream_header:
 	stream_header
 	width					v
 	height					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
 	}
 	reserved_bytes
 	checksum				u(32)
-info_packet: (optional) (file global)
+info_packet: (optional)
 	info_startcode				f(64)
 	packet header
 	for(;;){
 		id				v
 		if(id==0) break
 		else
 			value			vb
 	}
 	reserved_bytes
 checksum				u(32)
-meta_packet: (optional) (stream specific)
-	meta_startcode				f(64)
-	packet header
-	stream_id				v
-	for(;;){
-		id				v
-		if(id==0) break
-		name= meta_table[id][0]
-		type= meta_table[id][1]
-		if(type==NULL)
-			type			vb
-		if(name==NULL)
-			name			vb
-		if(type=="v")
-			value			v
-		else
-			value			vb
-	}
-	reserved_bytes
-checksum				u(32)
 sync_point
 	frame_startcode				f(64)
 		global_timestamp		v
 		}
 		while(next_code != main_startcode){
 			if(next_code == info_startcode)
 				info_packet
 			else{
-				if(next_code == short_startcode)
+				if(next_code == frame_startcode)
-					short_startcode    u(24)
-				else if(next_code == frame_startcode)
 					sync_point
 				frame
 			}
 		}
 	}
 index_startcode
 	0xDD672F23E64EULL + (((uint64_t)('N'<<8) + 'X')<<48)
 info_startcode
 	0xAB68B596BA78ULL + (((uint64_t)('N'<<8) + 'I')<<48)
-meta_startcode
-	FIXME
 version
 	2 for now
 max_distance
 	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_index_distance
-	max distance of short startcodes or frame_startcodes, the distance may
+	max distance of keyframes which are represented in the index, the
-	only be larger if there is only a single frame between the 2
+	distance between consecutive entries A and B may only be larger if
-	frame_startcodes/short startcodes this can be used by the demuxer to
+	there are no keyframes within this stream between A and B
-	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
-	SHOULD be set to <=4096 or at least <=8192 unless there is a very good
+	reason to set it higher
-	reason to set it higher otherwise reasonable error recovery will be
-	impossible
+stream_id[FIXME]
-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
+	so a stream with class 0 MUST always have a id which is lower then any
 	stream with class > 0
 	stream_id MUST be < stream_count
 stream_class
 	0	video
-	32	audio
+	1	audio
-	64	subtiles
+	2	subtiles
+	3	metadata
 	Note the remaining values are reserved and MUST NOT be used
 	     a demuxer MUST ignore streams with reserved classes
 fourcc
 	identification for the codec
 	example: "H264"
 	MUST contain 2 or 4 bytes, note, this might be increased in the future
 	if needed
-language_code
-	ISO 639 and ISO 3166 for language/country code
-	something like "usen" (US english), can be 0
-	if unknown
-	see http://www.loc.gov/standards/iso639-2/englangn.html
-	and http://www.din.de/gremien/nas/nabd/iso3166ma/codlstp1/en_listp1.html
 time_base_nom / time_base_denom = time_base
 	the number of timer ticks per second, this MUST be equal to the fps
 	if the fixed_fps is 1
 	time_base_denom MUST not be 0
 	be larger for future codecs
 fixed_fps
 	1 indicates that the fps is fixed
-codec_specific_data_type
-	0	none/end
-	1	native
-	2	bitmapinfoheader
-	3	waveformatex
-	4	imagedesc
-	5	sounddesc
-	"native", means a simple api & container independent storage form,
-	for example some mpeg4-es headers
 codec_specific_data
 	private global data for a codec (could be huffman tables or ...)
 frame_code
 	the meaning of this byte is stored in the main header
 checksum
 	adler32 checksum
 index_timestamp
-	value of the timetamp in a sync point relative to the last sync-point
+	value of the timetamp of a keyframe relative to the last keyframe
+	stored in this index
 index_position
-	position in bytes of the first byte of a sync-point, relative to the
+	position in bytes of the first byte of a keyframe, relative to the
-	last sync_point
+	last keyframe stored in this index
+	there MUST be no keyframe with the same stream_id as this index between
+	2 consecutive index entries if they are more then max_index_distance
+	appart
 id
 	the id of the type/name pair, so its more compact
 	0 means end
 	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
 	"CreationTime"	"2003-01-20 20:13:15Z", ...
 			(ISO 8601 format, see http://www.cl.cam.ac.uk/~mgk25/iso-time.html)
 			Note: dont forget the timezone
 	"Keywords"
 	"TotalTime"	total length of the stream in msecs
+	"Language"	ISO 639 and ISO 3166 for language/country code
-meta packet types
+			something like "eng" (US english), can be 0 if unknown
-	"ReplayGain"
+			and "multi" if several languages
-	"Language"	the language code
+			see http://www.loc.gov/standards/iso639-2/englangn.html
+			and http://www.din.de/gremien/nas/nabd/iso3166ma/codlstp1/en_listp1.htmlthe language code
 	"Disposition"	"original", "dub" (translated), "comment", "lyrics", "karaoke"
 	Note: if someone needs some others, please tell us about them, so we can
 	      add them to the official standard (if they are sane)
 	Note: nonstandard fields should be prefixed by "X-"
 	Note: MUST be less than 64 bytes long
 	{NULL			,  NULL }, // end
 	{NULL			,  NULL },
 	{NULL			, "UTF8"},
 	{NULL			, "v"},
 	{NULL			, "s"},
+	{"StreamId"		, "v"},
 	{"Author"		, "UTF8"},
 	{"Titel"		, "UTF8"},
+	{"Language"		, "UTF8"},
 	{"Description"		, "UTF8"},
 	{"Copyright"		, "UTF8"},
 	{"Encoder"		, "UTF8"},
 	{"Keyword"		, "UTF8"},
 	{"Cover"		, "JPEG"},
 	{"Cover"		, "PNG"},
-};
+	{"Disposition"		, "UTF8"},
-meta_table[][2]={
-	{NULL			,  NULL }, // end
-	{NULL			,  NULL },
-	{NULL			, "UTF8"},
-	{NULL			, "v"},
-	{NULL			, "s"},
-	{"Language"		, to be decided},
-	{"Disposition"		, to be decided},
-	{"ReplayGain"		, to be decided},
 };
 			Structure:
 the headers MUST be in exactly the following order (to simplify demuxer design)
 every sync-point must be exacty once in the index
 Note: in case of realtime streaming there is no end, so no index there either
 		Info packets
 the info_packet can be repeated, it can also contain different names & values
-each time but only if allso the time is different
+each time but only if also the time is different
 Info packets can be used to describe the file or some part of it (chapters)
 info packets, SHOULD be placed at the begin of the file at least
 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

Mercurial > mplayer.hg

comparison DOCS/tech/mpcf.txt @ 14471:6cdd5669e930