codekingpro/portable-devtools
114k
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 7.1.1 -->4 <head>5 <meta charset="utf-8">6 <title>7 NUT8 </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 class="container">15 <h1>16 NUT17 </h1>18 19 20 21<a name="SEC_Top"></a>22 23<div class="element-contents" id="SEC_Contents">24<h2 class="contents-heading">Table of Contents</h2>25 26<div class="contents">27 28<ul class="toc-numbered-mark">29 <li><a id="toc-Description" href="#Description">1 Description</a></li>30 <li><a id="toc-Modes" href="#Modes">2 Modes</a>31 <ul class="toc-numbered-mark">32 <li><a id="toc-BROADCAST" href="#BROADCAST">2.1 BROADCAST</a></li>33 <li><a id="toc-PIPE" href="#PIPE">2.2 PIPE</a></li>34 </ul></li>35 <li><a id="toc-Container_002dspecific-codec-tags" href="#Container_002dspecific-codec-tags">3 Container-specific codec tags</a>36 <ul class="toc-numbered-mark">37 <li><a id="toc-Generic-raw-YUVA-formats" href="#Generic-raw-YUVA-formats">3.1 Generic raw YUVA formats</a></li>38 <li><a id="toc-Raw-Audio" href="#Raw-Audio">3.2 Raw Audio</a></li>39 <li><a id="toc-Subtitles" href="#Subtitles">3.3 Subtitles</a></li>40 <li><a id="toc-Raw-Data" href="#Raw-Data">3.4 Raw Data</a></li>41 <li><a id="toc-Codecs" href="#Codecs">3.5 Codecs</a></li>42 </ul></li>43</ul>44</div>45</div>46 47<a name="Description"></a>48<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>49<p>NUT is a low overhead generic container format. It stores audio, video,50subtitle and user-defined streams in a simple, yet efficient, way.51</p>52<p>It was created by a group of FFmpeg and MPlayer developers in 200353and was finalized in 2008.54</p>55<p>The official nut specification is at svn://svn.mplayerhq.hu/nut56In case of any differences between this text and the official specification,57the official specification shall prevail.58</p>59<a name="Modes"></a>60<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>61<p>NUT has some variants signaled by using the flags field in its main header.62</p>63<table class="multitable">64<tbody><tr><td width="40%">BROADCAST</td><td width="40%">Extend the syncpoint to report the sender wallclock</td></tr>65<tr><td width="40%">PIPE</td><td width="40%">Omit completely the syncpoint</td></tr>66</tbody>67</table>68 69<a name="BROADCAST"></a>70<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>71 72<p>The BROADCAST variant provides a secondary time reference to facilitate73detecting endpoint latency and network delays.74It assumes all the endpoint clocks are synchronized.75To be used in real-time scenarios.76</p>77<a name="PIPE"></a>78<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>79 80<p>The PIPE variant assumes NUT is used as non-seekable intermediate container,81by not using syncpoint removes unneeded overhead and reduces the overall82memory usage.83</p>84<a name="Container_002dspecific-codec-tags"></a>85<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>86 87<a name="Generic-raw-YUVA-formats"></a>88<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>89 90<p>Since many exotic planar YUVA pixel formats are not considered by91the AVI/QuickTime FourCC lists, the following scheme is adopted for92representing them.93</p>94<p>The first two bytes can contain the values:95Y1 = only Y96Y2 = Y+A97Y3 = YUV98Y4 = YUVA99</p>100<p>The third byte represents the width and height chroma subsampling101values for the UV planes, that is the amount to shift the luma102width/height right to find the chroma width/height.103</p>104<p>The fourth byte is the number of bits used (8, 16, ...).105</p>106<p>If the order of bytes is inverted, that means that each component has107to be read big-endian.108</p>109<a name="Raw-Audio"></a>110<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>111 112<table class="multitable">113<tbody><tr><td width="40%">ALAW</td><td width="40%">A-LAW</td></tr>114<tr><td width="40%">ULAW</td><td width="40%">MU-LAW</td></tr>115<tr><td width="40%">P<type><interleaving><bits></td><td width="40%">little-endian PCM</td></tr>116<tr><td width="40%"><bits><interleaving><type>P</td><td width="40%">big-endian PCM</td></tr>117</tbody>118</table>119 120<p><type> is S for signed integer, U for unsigned integer, F for IEEE float121<interleaving> is D for default, P is for planar.122<bits> is 8/16/24/32123</p>124<div class="example">125<pre class="example-preformatted">PFD[32] would for example be signed 32 bit little-endian IEEE float126</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 class="multitable">132<tbody><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</tbody>137</table>138 139<a name="Raw-Data"></a>140<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>141 142<table class="multitable">143<tbody><tr><td width="40%">UTF8</td><td width="40%">Raw UTF-8</td></tr>144</tbody>145</table>146 147<a name="Codecs"></a>148<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>149 150<table class="multitable">151<tbody><tr><td width="40%">3IV1</td><td width="40%">non-compliant MPEG-4 generated by old 3ivx</td></tr>152<tr><td width="40%">ASV1</td><td width="40%">Asus Video</td></tr>153<tr><td width="40%">ASV2</td><td width="40%">Asus Video 2</td></tr>154<tr><td width="40%">CVID</td><td width="40%">Cinepak</td></tr>155<tr><td width="40%">CYUV</td><td width="40%">Creative YUV</td></tr>156<tr><td width="40%">DIVX</td><td width="40%">non-compliant MPEG-4 generated by old DivX</td></tr>157<tr><td width="40%">DUCK</td><td width="40%">Truemotion 1</td></tr>158<tr><td width="40%">FFV1</td><td width="40%">FFmpeg video 1</td></tr>159<tr><td width="40%">FFVH</td><td width="40%">FFmpeg Huffyuv</td></tr>160<tr><td width="40%">H261</td><td width="40%">ITU H.261</td></tr>161<tr><td width="40%">H262</td><td width="40%">ITU H.262</td></tr>162<tr><td width="40%">H263</td><td width="40%">ITU H.263</td></tr>163<tr><td width="40%">H264</td><td width="40%">ITU H.264</td></tr>164<tr><td width="40%">HFYU</td><td width="40%">Huffyuv</td></tr>165<tr><td width="40%">I263</td><td width="40%">Intel H.263</td></tr>166<tr><td width="40%">IV31</td><td width="40%">Indeo 3.1</td></tr>167<tr><td width="40%">IV32</td><td width="40%">Indeo 3.2</td></tr>168<tr><td width="40%">IV50</td><td width="40%">Indeo 5.0</td></tr>169<tr><td width="40%">LJPG</td><td width="40%">ITU JPEG (lossless)</td></tr>170<tr><td width="40%">MJLS</td><td width="40%">ITU JPEG-LS</td></tr>171<tr><td width="40%">MJPG</td><td width="40%">ITU JPEG</td></tr>172<tr><td width="40%">MPG4</td><td width="40%">MS MPEG-4v1 (not ISO MPEG-4)</td></tr>173<tr><td width="40%">MP42</td><td width="40%">MS MPEG-4v2</td></tr>174<tr><td width="40%">MP43</td><td width="40%">MS MPEG-4v3</td></tr>175<tr><td width="40%">MP4V</td><td width="40%">ISO MPEG-4 Part 2 Video (from old encoders)</td></tr>176<tr><td width="40%">mpg1</td><td width="40%">ISO MPEG-1 Video</td></tr>177<tr><td width="40%">mpg2</td><td width="40%">ISO MPEG-2 Video</td></tr>178<tr><td width="40%">MRLE</td><td width="40%">MS RLE</td></tr>179<tr><td width="40%">MSVC</td><td width="40%">MS Video 1</td></tr>180<tr><td width="40%">RT21</td><td width="40%">Indeo 2.1</td></tr>181<tr><td width="40%">RV10</td><td width="40%">RealVideo 1.0</td></tr>182<tr><td width="40%">RV20</td><td width="40%">RealVideo 2.0</td></tr>183<tr><td width="40%">RV30</td><td width="40%">RealVideo 3.0</td></tr>184<tr><td width="40%">RV40</td><td width="40%">RealVideo 4.0</td></tr>185<tr><td width="40%">SNOW</td><td width="40%">FFmpeg Snow</td></tr>186<tr><td width="40%">SVQ1</td><td width="40%">Sorenson Video 1</td></tr>187<tr><td width="40%">SVQ3</td><td width="40%">Sorenson Video 3</td></tr>188<tr><td width="40%">theo</td><td width="40%">Xiph Theora</td></tr>189<tr><td width="40%">TM20</td><td width="40%">Truemotion 2.0</td></tr>190<tr><td width="40%">UMP4</td><td width="40%">non-compliant MPEG-4 generated by UB Video MPEG-4</td></tr>191<tr><td width="40%">VCR1</td><td width="40%">ATI VCR1</td></tr>192<tr><td width="40%">VP30</td><td width="40%">VP 3.0</td></tr>193<tr><td width="40%">VP31</td><td width="40%">VP 3.1</td></tr>194<tr><td width="40%">VP50</td><td width="40%">VP 5.0</td></tr>195<tr><td width="40%">VP60</td><td width="40%">VP 6.0</td></tr>196<tr><td width="40%">VP61</td><td width="40%">VP 6.1</td></tr>197<tr><td width="40%">VP62</td><td width="40%">VP 6.2</td></tr>198<tr><td width="40%">VP70</td><td width="40%">VP 7.0</td></tr>199<tr><td width="40%">WMV1</td><td width="40%">MS WMV7</td></tr>200<tr><td width="40%">WMV2</td><td width="40%">MS WMV8</td></tr>201<tr><td width="40%">WMV3</td><td width="40%">MS WMV9</td></tr>202<tr><td width="40%">WV1F</td><td width="40%">non-compliant MPEG-4 generated by ?</td></tr>203<tr><td width="40%">WVC1</td><td width="40%">VC-1</td></tr>204<tr><td width="40%">XVID</td><td width="40%">non-compliant MPEG-4 generated by old Xvid</td></tr>205<tr><td width="40%">XVIX</td><td width="40%">non-compliant MPEG-4 generated by old Xvid with interlacing bug</td></tr>206</tbody>207</table>208 <p style="font-size: small;">209 This document was generated using <a class="uref" href="https://www.gnu.org/software/texinfo/"><em class="emph">makeinfo</em></a>.210 </p>211 </div>212 </body>213</html>214