git.sesse.net Git - casparcg/blob - dependencies64/ffmpeg/doc/nut.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html>
   3 <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
   4   <head>
   5     <meta charset="utf-8">
   6     <title>
   7       NUT
   8     </title>
   9     <meta name="viewport" content="width=device-width,initial-scale=1.0">
  10     <link rel="stylesheet" type="text/css" href="bootstrap.min.css">
  11     <link rel="stylesheet" type="text/css" href="style.min.css">
  12   </head>
  13   <body>
  14     <div style="width: 95%; margin: auto">
  15       <h1>
  16       NUT
  17       </h1>
  18 <div align="center">
  19 </div>
  20
  21
  22
  23 <a name="SEC_Top"></a>
  24
  25 <a name="SEC_Contents"></a>
  26 <h2 class="contents-heading">Table of Contents</h2>
  27
  28 <div class="contents">
  29
  30 <ul class="no-bullet">
  31   <li><a name="toc-Description" href="#Description">1 Description</a></li>
  32   <li><a name="toc-Modes" href="#Modes">2 Modes</a>
  33   <ul class="no-bullet">
  34     <li><a name="toc-BROADCAST" href="#BROADCAST">2.1 BROADCAST</a></li>
  35     <li><a name="toc-PIPE" href="#PIPE">2.2 PIPE</a></li>
  36   </ul></li>
  37   <li><a name="toc-Container_002dspecific-codec-tags" href="#Container_002dspecific-codec-tags">3 Container-specific codec tags</a>
  38   <ul class="no-bullet">
  39     <li><a name="toc-Generic-raw-YUVA-formats" href="#Generic-raw-YUVA-formats">3.1 Generic raw YUVA formats</a></li>
  40     <li><a name="toc-Raw-Audio" href="#Raw-Audio">3.2 Raw Audio</a></li>
  41     <li><a name="toc-Subtitles" href="#Subtitles">3.3 Subtitles</a></li>
  42     <li><a name="toc-Raw-Data" href="#Raw-Data">3.4 Raw Data</a></li>
  43     <li><a name="toc-Codecs" href="#Codecs">3.5 Codecs</a></li>
  44   </ul></li>
  45 </ul>
  46 </div>
  47
  48
  49 <a name="Description"></a>
  50 <h2 class="chapter">1 Description<span class="pull-right"><a class="anchor hidden-xs" href="#Description" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Description" aria-hidden="true">TOC</a></span></h2>
  51 <p>NUT is a low overhead generic container format. It stores audio, video,
  52 subtitle and user-defined streams in a simple, yet efficient, way.
  53 </p>
  54 <p>It was created by a group of FFmpeg and MPlayer developers in 2003
  55 and was finalized in 2008.
  56 </p>
  57 <p>The official nut specification is at svn://svn.mplayerhq.hu/nut
  58 In case of any differences between this text and the official specification,
  59 the official specification shall prevail.
  60 </p>
  61 <a name="Modes"></a>
  62 <h2 class="chapter">2 Modes<span class="pull-right"><a class="anchor hidden-xs" href="#Modes" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Modes" aria-hidden="true">TOC</a></span></h2>
  63 <p>NUT has some variants signaled by using the flags field in its main header.
  64 </p>
  65 <table>
  66 <tr><td width="40%">BROADCAST</td><td width="40%">Extend the syncpoint to report the sender wallclock</td></tr>
  67 <tr><td width="40%">PIPE</td><td width="40%">Omit completely the syncpoint</td></tr>
  68 </table>
  69
  70 <a name="BROADCAST"></a>
  71 <h3 class="section">2.1 BROADCAST<span class="pull-right"><a class="anchor hidden-xs" href="#BROADCAST" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-BROADCAST" aria-hidden="true">TOC</a></span></h3>
  72
  73 <p>The BROADCAST variant provides a secondary time reference to facilitate
  74 detecting endpoint latency and network delays.
  75 It assumes all the endpoint clocks are syncronized.
  76 To be used in real-time scenarios.
  77 </p>
  78 <a name="PIPE"></a>
  79 <h3 class="section">2.2 PIPE<span class="pull-right"><a class="anchor hidden-xs" href="#PIPE" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-PIPE" aria-hidden="true">TOC</a></span></h3>
  80
  81 <p>The PIPE variant assumes NUT is used as non-seekable intermediate container,
  82 by not using syncpoint removes unneeded overhead and reduces the overall
  83 memory usage.
  84 </p>
  85 <a name="Container_002dspecific-codec-tags"></a>
  86 <h2 class="chapter">3 Container-specific codec tags<span class="pull-right"><a class="anchor hidden-xs" href="#Container_002dspecific-codec-tags" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Container_002dspecific-codec-tags" aria-hidden="true">TOC</a></span></h2>
  87
  88 <a name="Generic-raw-YUVA-formats"></a>
  89 <h3 class="section">3.1 Generic raw YUVA formats<span class="pull-right"><a class="anchor hidden-xs" href="#Generic-raw-YUVA-formats" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Generic-raw-YUVA-formats" aria-hidden="true">TOC</a></span></h3>
  90
  91 <p>Since many exotic planar YUVA pixel formats are not considered by
  92 the AVI/QuickTime FourCC lists, the following scheme is adopted for
  93 representing them.
  94 </p>
  95 <p>The first two bytes can contain the values:
  96 Y1 = only Y
  97 Y2 = Y+A
  98 Y3 = YUV
  99 Y4 = YUVA
 100 </p>
 101 <p>The third byte represents the width and height chroma subsampling
 102 values for the UV planes, that is the amount to shift the luma
 103 width/height right to find the chroma width/height.
 104 </p>
 105 <p>The fourth byte is the number of bits used (8, 16, ...).
 106 </p>
 107 <p>If the order of bytes is inverted, that means that each component has
 108 to be read big-endian.
 109 </p>
 110 <a name="Raw-Audio"></a>
 111 <h3 class="section">3.2 Raw Audio<span class="pull-right"><a class="anchor hidden-xs" href="#Raw-Audio" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Raw-Audio" aria-hidden="true">TOC</a></span></h3>
 112
 113 <table>
 114 <tr><td width="40%">ALAW</td><td width="40%">A-LAW</td></tr>
 115 <tr><td width="40%">ULAW</td><td width="40%">MU-LAW</td></tr>
 116 <tr><td width="40%">P&lt;type&gt;&lt;interleaving&gt;&lt;bits&gt;</td><td width="40%">little-endian PCM</td></tr>
 117 <tr><td width="40%">&lt;bits&gt;&lt;interleaving&gt;&lt;type&gt;P</td><td width="40%">big-endian PCM</td></tr>
 118 </table>
 119
 120 <p>&lt;type&gt; is S for signed integer, U for unsigned integer, F for IEEE float
 121 &lt;interleaving&gt; is D for default, P is for planar.
 122 &lt;bits&gt; is 8/16/24/32
 123 </p>
 124 <div class="example">
 125 <pre class="example">PFD[32]   would for example be signed 32 bit little-endian IEEE float
 126 </pre></div>
 127
 128 <a name="Subtitles"></a>
 129 <h3 class="section">3.3 Subtitles<span class="pull-right"><a class="anchor hidden-xs" href="#Subtitles" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Subtitles" aria-hidden="true">TOC</a></span></h3>
 130
 131 <table>
 132 <tr><td width="40%">UTF8</td><td width="40%">Raw UTF-8</td></tr>
 133 <tr><td width="40%">SSA[0]</td><td width="40%">SubStation Alpha</td></tr>
 134 <tr><td width="40%">DVDS</td><td width="40%">DVD subtitles</td></tr>
 135 <tr><td width="40%">DVBS</td><td width="40%">DVB subtitles</td></tr>
 136 </table>
 137
 138 <a name="Raw-Data"></a>
 139 <h3 class="section">3.4 Raw Data<span class="pull-right"><a class="anchor hidden-xs" href="#Raw-Data" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Raw-Data" aria-hidden="true">TOC</a></span></h3>
 140
 141 <table>
 142 <tr><td width="40%">UTF8</td><td width="40%">Raw UTF-8</td></tr>
 143 </table>
 144
 145 <a name="Codecs"></a>
 146 <h3 class="section">3.5 Codecs<span class="pull-right"><a class="anchor hidden-xs" href="#Codecs" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Codecs" aria-hidden="true">TOC</a></span></h3>
 147
 148 <table>
 149 <tr><td width="40%">3IV1</td><td width="40%">non-compliant MPEG-4 generated by old 3ivx</td></tr>
 150 <tr><td width="40%">ASV1</td><td width="40%">Asus Video</td></tr>
 151 <tr><td width="40%">ASV2</td><td width="40%">Asus Video 2</td></tr>
 152 <tr><td width="40%">CVID</td><td width="40%">Cinepak</td></tr>
 153 <tr><td width="40%">CYUV</td><td width="40%">Creative YUV</td></tr>
 154 <tr><td width="40%">DIVX</td><td width="40%">non-compliant MPEG-4 generated by old DivX</td></tr>
 155 <tr><td width="40%">DUCK</td><td width="40%">Truemotion 1</td></tr>
 156 <tr><td width="40%">FFV1</td><td width="40%">FFmpeg video 1</td></tr>
 157 <tr><td width="40%">FFVH</td><td width="40%">FFmpeg Huffyuv</td></tr>
 158 <tr><td width="40%">H261</td><td width="40%">ITU H.261</td></tr>
 159 <tr><td width="40%">H262</td><td width="40%">ITU H.262</td></tr>
 160 <tr><td width="40%">H263</td><td width="40%">ITU H.263</td></tr>
 161 <tr><td width="40%">H264</td><td width="40%">ITU H.264</td></tr>
 162 <tr><td width="40%">HFYU</td><td width="40%">Huffyuv</td></tr>
 163 <tr><td width="40%">I263</td><td width="40%">Intel H.263</td></tr>
 164 <tr><td width="40%">IV31</td><td width="40%">Indeo 3.1</td></tr>
 165 <tr><td width="40%">IV32</td><td width="40%">Indeo 3.2</td></tr>
 166 <tr><td width="40%">IV50</td><td width="40%">Indeo 5.0</td></tr>
 167 <tr><td width="40%">LJPG</td><td width="40%">ITU JPEG (lossless)</td></tr>
 168 <tr><td width="40%">MJLS</td><td width="40%">ITU JPEG-LS</td></tr>
 169 <tr><td width="40%">MJPG</td><td width="40%">ITU JPEG</td></tr>
 170 <tr><td width="40%">MPG4</td><td width="40%">MS MPEG-4v1 (not ISO MPEG-4)</td></tr>
 171 <tr><td width="40%">MP42</td><td width="40%">MS MPEG-4v2</td></tr>
 172 <tr><td width="40%">MP43</td><td width="40%">MS MPEG-4v3</td></tr>
 173 <tr><td width="40%">MP4V</td><td width="40%">ISO MPEG-4 Part 2 Video (from old encoders)</td></tr>
 174 <tr><td width="40%">mpg1</td><td width="40%">ISO MPEG-1 Video</td></tr>
 175 <tr><td width="40%">mpg2</td><td width="40%">ISO MPEG-2 Video</td></tr>
 176 <tr><td width="40%">MRLE</td><td width="40%">MS RLE</td></tr>
 177 <tr><td width="40%">MSVC</td><td width="40%">MS Video 1</td></tr>
 178 <tr><td width="40%">RT21</td><td width="40%">Indeo 2.1</td></tr>
 179 <tr><td width="40%">RV10</td><td width="40%">RealVideo 1.0</td></tr>
 180 <tr><td width="40%">RV20</td><td width="40%">RealVideo 2.0</td></tr>
 181 <tr><td width="40%">RV30</td><td width="40%">RealVideo 3.0</td></tr>
 182 <tr><td width="40%">RV40</td><td width="40%">RealVideo 4.0</td></tr>
 183 <tr><td width="40%">SNOW</td><td width="40%">FFmpeg Snow</td></tr>
 184 <tr><td width="40%">SVQ1</td><td width="40%">Sorenson Video 1</td></tr>
 185 <tr><td width="40%">SVQ3</td><td width="40%">Sorenson Video 3</td></tr>
 186 <tr><td width="40%">theo</td><td width="40%">Xiph Theora</td></tr>
 187 <tr><td width="40%">TM20</td><td width="40%">Truemotion 2.0</td></tr>
 188 <tr><td width="40%">UMP4</td><td width="40%">non-compliant MPEG-4 generated by UB Video MPEG-4</td></tr>
 189 <tr><td width="40%">VCR1</td><td width="40%">ATI VCR1</td></tr>
 190 <tr><td width="40%">VP30</td><td width="40%">VP 3.0</td></tr>
 191 <tr><td width="40%">VP31</td><td width="40%">VP 3.1</td></tr>
 192 <tr><td width="40%">VP50</td><td width="40%">VP 5.0</td></tr>
 193 <tr><td width="40%">VP60</td><td width="40%">VP 6.0</td></tr>
 194 <tr><td width="40%">VP61</td><td width="40%">VP 6.1</td></tr>
 195 <tr><td width="40%">VP62</td><td width="40%">VP 6.2</td></tr>
 196 <tr><td width="40%">VP70</td><td width="40%">VP 7.0</td></tr>
 197 <tr><td width="40%">WMV1</td><td width="40%">MS WMV7</td></tr>
 198 <tr><td width="40%">WMV2</td><td width="40%">MS WMV8</td></tr>
 199 <tr><td width="40%">WMV3</td><td width="40%">MS WMV9</td></tr>
 200 <tr><td width="40%">WV1F</td><td width="40%">non-compliant MPEG-4 generated by ?</td></tr>
 201 <tr><td width="40%">WVC1</td><td width="40%">VC-1</td></tr>
 202 <tr><td width="40%">XVID</td><td width="40%">non-compliant MPEG-4 generated by old Xvid</td></tr>
 203 <tr><td width="40%">XVIX</td><td width="40%">non-compliant MPEG-4 generated by old Xvid with interlacing bug</td></tr>
 204 </table>
 205
 206
 207       <p style="font-size: small;">
 208         This document was generated using <a href="http://www.gnu.org/software/texinfo/"><em>makeinfo</em></a>.
 209       </p>
 210     </div>
 211   </body>
 212 </html>