Microsoft Audio/Video Interleaved - Revision history

Clone2727: typo

2010-02-05T05:06:07Z

typo

← Older revision		Revision as of 22:06, 4 February 2010
Line 2:		Line 2:
	* Company: [[Microsoft]]		* Company: [[Microsoft]]
	* Technical Description From Microsoft: http://msdn.microsoft.com/en-us/library/ms779636(VS.85).aspx		* Technical Description From Microsoft: http://msdn.microsoft.com/en-us/library/ms779636(VS.85).aspx
	* Another AVI format ~~ducumentation~~: http://www.alexander-noe.com/video/documentation/avi.pdf		* Another AVI format documentation: http://www.alexander-noe.com/video/documentation/avi.pdf
	* John McGowan's AVI Overview: http://www.jmcgowan.com/avi.html		* John McGowan's AVI Overview: http://www.jmcgowan.com/avi.html
	* MIME Types:		* MIME Types:

LoveBug356: update microsoft link

2008-05-23T13:49:58Z

update microsoft link

← Older revision		Revision as of 06:49, 23 May 2008
Line 1:		Line 1:
	* Extensions: avi		* Extensions: avi
	* Company: [[Microsoft]]		* Company: [[Microsoft]]
	* Technical Description From Microsoft: http://msdn.microsoft.com~~/library/default.asp?url=/library~~/en-us/~~directshow~~/~~htm/avifileformat~~.~~asp~~		* Technical Description From Microsoft: http://msdn.microsoft.com/en-us/library/ms779636(VS.85).aspx
	* Another AVI format ducumentation: http://www.alexander-noe.com/video/documentation/avi.pdf		* Another AVI format ducumentation: http://www.alexander-noe.com/video/documentation/avi.pdf
	* John McGowan's AVI Overview: http://www.jmcgowan.com/avi.html		* John McGowan's AVI Overview: http://www.jmcgowan.com/avi.html

Merbanan: Added another avi documentation source.

2008-04-21T09:57:01Z

Added another avi documentation source.

← Older revision		Revision as of 02:57, 21 April 2008
Line 2:		Line 2:
	* Company: [[Microsoft]]		* Company: [[Microsoft]]
	* Technical Description From Microsoft: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/directshow/htm/avifileformat.asp		* Technical Description From Microsoft: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/directshow/htm/avifileformat.asp
			* Another AVI format ducumentation: http://www.alexander-noe.com/video/documentation/avi.pdf
	* John McGowan's AVI Overview: http://www.jmcgowan.com/avi.html		* John McGowan's AVI Overview: http://www.jmcgowan.com/avi.html
	* MIME Types:		* MIME Types:

Multimedia Mike: start filling in MIME types for container formats

2007-10-30T20:49:24Z

start filling in MIME types for container formats

← Older revision		Revision as of 13:49, 30 October 2007
Line 3:		Line 3:
	* Technical Description From Microsoft: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/directshow/htm/avifileformat.asp		* Technical Description From Microsoft: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/directshow/htm/avifileformat.asp
	* John McGowan's AVI Overview: http://www.jmcgowan.com/avi.html		* John McGowan's AVI Overview: http://www.jmcgowan.com/avi.html
			* MIME Types:
			** video/msvideo
			** video/x-msvideo

	'''Microsoft Audio/Video Interleaved''' ('''AVI''') is a multimedia format based on the [[RIFF]] container format. For a long time, AVI was the de facto standard for multimedia files on Windows (recently, [[ASF]] has supplanted AVI on the Windows platform). While there is some contention		'''Microsoft Audio/Video Interleaved''' ('''AVI''') is a multimedia format based on the [[RIFF]] container format. For a long time, AVI was the de facto standard for multimedia files on Windows (recently, [[ASF]] has supplanted AVI on the Windows platform). While there is some contention

Andux: moved section on RIFF to its own article; added links and improved opening blurb a bit

2007-07-02T12:17:07Z

moved section on RIFF to its own article; added links and improved opening blurb a bit

@@ Line 4: / Line 4: @@
 * John McGowan's AVI Overview: http://www.jmcgowan.com/avi.html
-For a long time, AVI was the de facto standard for multimedia files on Windows (recently, [[ASF]] has supplanted AVI on the Windows platform). While there is some contention
+'''Microsoft Audio/Video Interleaved''' ('''AVI''') is a multimedia format based on the [[RIFF]] container format. For a long time, AVI was the de facto standard for multimedia files on Windows (recently, [[ASF]] has supplanted AVI on the Windows platform). While there is some contention
 regarding the originator of the format, the fact remains that there were, and still are, a wide variety of computer applications that create AVI files. This leads to a lot of fragmentation and application-specific nuances in a standard that was never particularly well-defined in the first place.
-== RIFF ==
+== Structure ==
-General structure for all RIFF nodes:
+An AVI has this [[RIFF]] structure:
   RIFF "AVI " (space at end)

Multimedia Mike: note quirk about 0x19 in signature

2007-02-07T18:00:44Z

note quirk about 0x19 in signature

← Older revision		Revision as of 11:00, 7 February 2007
Line 103:		Line 103:
	time = ((dwSampleSize ? (bytepos / dwSampleSize) : chunkpos) * dwRate / dwScale		time = ((dwSampleSize ? (bytepos / dwSampleSize) : chunkpos) * dwRate / dwScale
	floats will gradually drift into error.		floats will gradually drift into error.

			== Quirks ==
			* Some AVI files are seen in the wild with the signature 'AVI\x19'. There is a 0x19 number in the fourth byte rather than a 0x20.

	[[Category:Container Formats]]		[[Category:Container Formats]]

Multimedia Mike: moved intro

2006-06-03T22:28:35Z

moved intro

← Older revision		Revision as of 15:28, 3 June 2006
Line 4:		Line 4:
	* John McGowan's AVI Overview: http://www.jmcgowan.com/avi.html		* John McGowan's AVI Overview: http://www.jmcgowan.com/avi.html

	~~Uses RIFF tree~~ for ~~structure~~.		For a long time, AVI was the de facto standard for multimedia files on Windows (recently, [[ASF]] has supplanted AVI on the Windows platform). While there is some contention
			regarding the originator of the format, the fact remains that there were, and still are, a wide variety of computer applications that create AVI files. This leads to a lot of fragmentation and application-specific nuances in a standard that was never particularly well-defined in the first place.

	== RIFF ==		== RIFF ==

Multimedia Mike: /* Introduction */ Wiki link and info shuffle

2006-06-03T22:28:09Z

Introduction: Wiki link and info shuffle

← Older revision		Revision as of 15:28, 3 June 2006
Line 56:		Line 56:

	=== Introduction ===		=== Introduction ===
	~~For a long time, AVI was the de facto standard for multimedia files on Windows (recently, [[ASF]] has supplanted AVI on the Windows platform). While there is some contention~~		A'rpi is the originator of the [[MPlayer]] media application for Linux. It's an open source movie player that can decode AVI files, as well as a number of other file formats. He has encountered a lot of AVIs created by a lot of different programs and is qualified to write about some of the quirks and nuances a programmer might encounter when writing a general purpose AVI file decoder.
	regarding the originator of the format, the fact remains that there were, and still are, a wide variety of computer applications that create AVI files. This leads to a lot of fragmentation and application-specific nuances in a standard that was never particularly well-defined in the first place.

	A'rpi is the originator of the MPlayer media application for Linux. It's an open source movie player that can decode AVI files, as well as a number of other file formats. He has encountered a lot of AVIs created by a lot of different programs and is qualified to write about some of the quirks and nuances a programmer might encounter when writing a general purpose AVI file decoder.

	=== Random Tips For Processing AVI File ===		=== Random Tips For Processing AVI File ===

Multimedia Mike: /* Idiosyncracies */

2006-06-03T22:27:07Z

Idiosyncracies

← Older revision		Revision as of 15:27, 3 June 2006
Line 53:		Line 53:

	== Idiosyncracies ==		== Idiosyncracies ==
			''This section comes from the document 'AVI Files: Tips & Quirks' by Arpad "A'rpi" Gereoffy found at http://multimedia.cx/avistuff.txt''

			=== Introduction ===
			For a long time, AVI was the de facto standard for multimedia files on Windows (recently, [[ASF]] has supplanted AVI on the Windows platform). While there is some contention
			regarding the originator of the format, the fact remains that there were, and still are, a wide variety of computer applications that create AVI files. This leads to a lot of fragmentation and application-specific nuances in a standard that was never particularly well-defined in the first place.

			A'rpi is the originator of the MPlayer media application for Linux. It's an open source movie player that can decode AVI files, as well as a number of other file formats. He has encountered a lot of AVIs created by a lot of different programs and is qualified to write about some of the quirks and nuances a programmer might encounter when writing a general purpose AVI file decoder.

			=== Random Tips For Processing AVI File ===
			In short, these are some things I discovered while writing/fixing my AVI demuxer:

			* AVI files are built from variable length chunks.
			* Each chunk has a 4-byte fourcc and a 4-byte length (dword).
			* If the chunk size is bad/broken, it will kill the whole demuxer process.
			* Chunks are padded to 2*n offset.

			AVI files usually have:
			* RIFF avi header, containing general parameters (used for file type detection)
			* stream headers, containing common format stream descriptor, and type-specific audio/video/other header
			* single 'movi' chunk contains the audio and video packets.
			* index chunk contains index table (16 bytes for each chunk in 'movi')

			The AVI header has a dwFlags field. It contains useful information, like type of interleaving, "have index" chunk and so on. Ignore it. Really. It's broken in too many files. Windows players ignore it too.

			AVI docs say that 'XXdb' are uncompressed and 'XXdc' are compressed video chunk fourccs. (XX = stream id in HEX. Some specs says it's in DEC. Funny.) Ignore it. Just use the first 2 chars as a hex number, and get stream type from stream header for that stream id. I've seen even XXim FourCCs...

			Stream header has some interesting fields:
			* dwRate, dwScale: These specify the playback samplerate of the stream.
			* dwStart: Specifies delay of the stream; rarely used, but must be supported.
			* dwSampleSize: This is the sample size (bytes / sample). It may be 0, which means variable sample sizes -> 1 chunk == 1 sample. For non-zero samplesize, chunks may contain more than one sample.

			Regarding VBR audio in AVI, see VirtualDub site mentioned in the references. The 3 AVI parsers in Windows behave differently with such streams. 1 normal (0=vbr), 1 tricky (rounds up zero to blockalign), 1 crashes.

			In AVI, audio specific header contains WAVEFORMATEX and video spec. hdr contains BITMAPINFOHEADER. Both can have optional codec-dependent extra data appended after the struct. Don't crop it, it will break decoding!

			About the movi chunk:
			Recently I got some AVI files with bad movi chunk sizes. So, I have to say: Ignore it. Read chunks from the file while not EOF, and not while filepos < movi_end.

			About index:
			* It contains chunk pos, chunk size, chunk fourcc and flags. Bit 4 of the flags field (flags & 0x10) means that chunk represents a keyframe.
			* Offset is relative to `cat /dev/urandom`. Really. Or dunno.
			* I calculate an offset_of_offset value from the movi_start and first chunk offset. It works in 99% of cases. I saw different methods in other players, handling some common cases (such as relative to avi chunk, relative to movie chunk, etc.) and fallback to absolute value.
			* Chunk info in chunk header (first 4+4 bytes of chunks) and index table should be equal. They aren't. Sometimes the size values differ by +/-1. Strange. Sometimes fourccs 'type' part (last 2 char) differ. Even more strange. Sometimes they leave chunk header. I think Windows parsers don't use chunk headers at all, and use only the index. This may be why they are unable to play files without index.

			On the subject of interleaving, there are 3 categories of interleaving for AVI files (taken from DOCS/tech/formats.txt in the [[MPlayer]] distribution):
			# Interleaved: Audio and video content is interleaved. It's faster and requires only 1 reading thread, so it's recommended (and most commonly used).
			# Non-interleaved: Audio and video aren't interleaved. The file stores all of the video data followed by all the audio data. Such a file requires 2 reading processes or 1 reading with lots of seeking. This is very bad when playing the data from a network or CD-ROM.
			# Badly-interleaved streams: Some AVI files claim to be interleaved but with bad sync. These files should be treated as non-interleaved.

			About A/V sync, you should rely on samplerate (dwRate/dwScale), samplesize and stream positions. Use an integer, not a floating-point number, for byte positions. When calculating time for each frame:
			time = ((dwSampleSize ? (bytepos / dwSampleSize) : chunkpos) * dwRate / dwScale
			floats will gradually drift into error.

	[[Category:Container Formats]]		[[Category:Container Formats]]

Multimedia Mike: add more links and outline a new section

2006-06-03T22:21:52Z

add more links and outline a new section

← Older revision		Revision as of 15:21, 3 June 2006
Line 1:		Line 1:
	* Extensions: avi		* Extensions: avi
	* Company: [[Microsoft]]		* Company: [[Microsoft]]
			* Technical Description From Microsoft: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/directshow/htm/avifileformat.asp
			* John McGowan's AVI Overview: http://www.jmcgowan.com/avi.html

	Uses RIFF tree for structure.		Uses RIFF tree for structure.
Line 49:		Line 51:
	...		...
	DATA "idx1"		DATA "idx1"

			== Idiosyncracies ==

	[[Category:Container Formats]]		[[Category:Container Formats]]