Permalink
Browse files

doc: initial nut documentation

  • Loading branch information...
1 parent ee964fb commit c9e04a1923e0d45ee88a073621227573fa32fb00 @lu-zero committed Dec 13, 2011
Showing with 130 additions and 0 deletions.
  1. +130 −0 doc/formats/nut.texi
View
@@ -0,0 +1,130 @@
+\input texinfo @c -*- texinfo -*-
+
+@settitle NUT
+
+@titlepage
+@center @titlefont{NUT}
+@end titlepage
+
+@top
+
+@contents
+
+@chapter Description
+NUT is a low overhead generic container format. It stores audio, video,
+subtitle and user defined streams in a simple yet efficient way.
+
+It had been created by a group of FFmpeg and MPlayer developers in 2003
+and had been finalized in 2008.
+
+@chapter Container specific codec tags
+
+@section Generic raw YUVA formats
+
+Since many exotic planar YUVA pixel formats are not contemplated by
+the AVI/QuickTime FourCC lists, the following scheme is adopted for
+representing them.
+
+The first two bytes can contain the values:
+Y1 = only Y
+Y2 = Y+A
+Y3 = YUV
+Y4 = YUVA
+
+The third byte represents the width and height chroma subsampling
+values for the UV planes, that is the amount to shift the luma
+width/height right to find the chroma width/height.
+
+The fourth byte is the number of bits used (8, 16, ...).
+
+If the order of bytes is inverted, that means that each component has
+to be read big-endian.
+
+@section Raw Audio
+
+ALAW A-LAW
+ULAW MU-LAW
+P<type><interleaving><bits> little-endian PCM
+<bits><interleaving><type>P big-endian PCM
+ <type> is S for signed integer, U for unsigned integer, F for IEEE float
+ <interleaving> is D for default (left, right)
+ <bits> is 8/16/24/32
+PFD[32] would for example be signed 32 bit little-endian IEEE float
+
+Subtitles:
+UTF8 Raw utf8
+SSA[0] SubStation Alpha
+DVDS DVD subtitles
+DVBS DVB subtitles
+
+@section Subtitles
+
+UTF8 Raw utf8
+SSA[0] SubStation Alpha
+DVDS DVD subtitles
+DVBS DVB subtitles
+
+
+@section Codecs
+
+@table
+@item 3IV1 @tab non compliant MPEG4 generated by old 3ivx
+@item ASV1 @tab Asus Video
+@item ASV2 @tab Asus Video 2
+@item CVID @tab Cinepak
+@item CYUV @tab Creative YUV
+@item DIVX @tab non compliant MPEG4 generated by old divx
+@item DUCK @tab Truemotion 1
+@item FFV1 @tab FFmpeg video 1
+@item FFVH @tab FFmpeg Huffyuv
+@item H261 @tab ITU H.261
+@item H262 @tab ITU H.262
+@item H263 @tab ITU H.263
+@item H264 @tab ITU H.264
+@item HFYU @tab Huffyuv
+@item I263 @tab Intel H.263
+@item IV31 @tab Indeo 3.1
+@item IV32 @tab Indeo 3.2
+@item IV50 @tab Indeo 5.0
+@item LJPG @tab ITU JPEG (lossless)
+@item MJLS @tab ITU JPEG-LS
+@item MJPG @tab ITU JPEG
+@item MPG4 @tab MS MPEG-4v1 (not ISO MPEG-4)
+@item MP42 @tab MS MPEG-4v2
+@item MP43 @tab MS MPEG-4v3
+@item MP4V @tab ISO MPEG-4 Part 2 Video (from old encoders)
+@item mpg1 @tab ISO MPEG-1 Video
+@item mpg2 @tab ISO MPEG-2 Video
+@item MRLE @tab MS RLE
+@item MSVC @tab MS Video 1
+@item RT21 @tab Indeo 2.1
+@item RV10 @tab Real Video 1.0
+@item RV20 @tab Real Video 2.0
+@item RV30 @tab Real Video 3.0
+@item RV40 @tab Real Video 4.0
+@item SNOW @tab FFmpeg Snow
+@item SVQ1 @tab Sorenson Video 1
+@item SVQ3 @tab Sorenson Video 3
+@item theo @tab Xiph Theora
+@item TM20 @tab Truemotion 2.0
+@item UMP4 @tab non compliant MPEG4 generated by UB Video MPEG-4
+@item VCR1 @tab ATI VCR1
+@item VP30 @tab VP 3.0
+@item VP31 @tab VP 3.1
+@item VP50 @tab VP 5.0
+@item VP60 @tab VP 6.0
+@item VP61 @tab VP 6.1
+@item VP62 @tab VP 6.2
+@item VP70 @tab VP 7.0
+@item WMV1 @tab MS WMV7
+@item WMV2 @tab MS WMV8
+@item WMV3 @tab MS WMV9
+@item WV1F @tab non compliant MPEG4 generated by ?
+@item WVC1 @tab VC-1
+@item XVID @tab non compliant MPEG4 generated by old xvid
+@item XVIX @tab non compliant MPEG4 generated by old xvid with interlacing bug
+@end table
+
+@table
+
+@end table

0 comments on commit c9e04a1

Please sign in to comment.