time_base description by Rich Felker | dalias, aerifal cx
authorMichael Niedermayer <michaelni@gmx.at>
Sun, 21 Aug 2005 22:31:01 +0000 (22:31 +0000)
committerMichael Niedermayer <michaelni@gmx.at>
Sun, 21 Aug 2005 22:31:01 +0000 (22:31 +0000)
Originally committed as revision 4536 to svn://svn.ffmpeg.org/ffmpeg/trunk

libavcodec/avcodec.h
libavformat/avformat.h
output_example.c

index ab00920bc1b1b731d5903d2a8049283a97950ad0..e4900dc33505803d8d014c6da5cb62641731818e 100644 (file)
@@ -732,14 +732,17 @@ typedef struct AVCodecContext {
     void *extradata;
     int extradata_size;
     
-    /* video only */
     /**
-     * time base in which the timestamps are specified.
+     * this is the fundamental unit of time (in seconds) in terms
+     * of which frame timestamps are represented. for fixed-fps content,
+     * timebase should be 1/framerate and timestamp increments should be
+     * identically 1.
      * - encoding: MUST be set by user
      * - decoding: set by lavc.
      */
     AVRational time_base;
     
+    /* video only */
     /**
      * picture width / height.
      * - encoding: MUST be set by user. 
index e891b9768dd6f5c551d590a9cc368832c9d90e3d..8b751520c37401775990db963b0b581eb8295288 100644 (file)
@@ -229,6 +229,13 @@ typedef struct AVStream {
     int codec_info_nb_frames;
     /* encoding: PTS generation when outputing stream */
     AVFrac pts;
+
+    /**
+     * this is the fundamental unit of time (in seconds) in terms
+     * of which frame timestamps are represented. for fixed-fps content,
+     * timebase should be 1/framerate and timestamp increments should be
+     * identically 1.
+     */
     AVRational time_base;
     int pts_wrap_bits; /* number of bits in pts (used for wrapping control) */
     /* ffmpeg.c private use */
index f61229dedd45c2dd30929bd30167fc5ce58cedab..6091d850895efa3731f7079c8f67f41ed3586b41 100644 (file)
@@ -199,7 +199,10 @@ AVStream *add_video_stream(AVFormatContext *oc, int codec_id)
     /* resolution must be a multiple of two */
     c->width = 352;  
     c->height = 288;
-    /* frames per second */
+    /* time base: this is the fundamental unit of time (in seconds) in terms
+       of which frame timestamps are represented. for fixed-fps content,
+       timebase should be 1/framerate and timestamp increments should be
+       identically 1. */
     c->time_base.den = STREAM_FRAME_RATE;  
     c->time_base.num = 1;
     c->gop_size = 12; /* emit one intra frame every twelve frames at most */