# HG changeset patch
# User michael
# Date 1163431425 0
# Node ID 01f57f7226de08a0aa2742e47a110289b041b091
# Parent  a49261b5a5b47ffc894bca2a74c9a93650d318b7
pts definition by mans
dts definition and decode_delay definition by me

diff -r a49261b5a5b4 -r 01f57f7226de DOCS/tech/nut.txt
--- a/DOCS/tech/nut.txt	Mon Nov 13 12:45:46 2006 +0000
+++ b/DOCS/tech/nut.txt	Mon Nov 13 15:23:45 2006 +0000
@@ -68,6 +68,11 @@
     keyframe status of the current frame but instead just set the frame as
     non keyframe
     (FIXME maybe move somewhere else?)
+pts
+    presentation time of the first frame/sample that is completed by decoding
+    the coded frame.
+dts
+    of a frame is the time when it is input into the decoder
 
 
 Syntax:
@@ -542,10 +547,13 @@
     MUST be <16
 
 decode_delay
-    maximum time between input and output for a codec, used to generate
-    dts from pts
-    is set to 0 for streams without B-frames, and set to 1 for streams with
-    B-frames, may be larger for future codecs
+    size of the reordering buffer used to convert pts to dts
+    codecs which dont support b frames normaly use 0
+    mpeg1/mpeg2 style codecs with b frames use 1
+    h264 style b pyramid uses 2
+    h264 and future codecs might need values >2
+    audio codecs generally use 0 (we arent aware of any which doesnt
+    but its theoretically possible that one exists which needs it >0)
     decode_delay MUST NOT be set higher than necessary for a codec.
 
 stream_flags