Merge commit '0ebfdae099d2749240b6a565abcdf0bf62589748'
authorMichael Niedermayer <michaelni@gmx.at>
Wed, 4 Sep 2013 12:06:46 +0000 (14:06 +0200)
committerMichael Niedermayer <michaelni@gmx.at>
Wed, 4 Sep 2013 12:06:46 +0000 (14:06 +0200)
* commit '0ebfdae099d2749240b6a565abcdf0bf62589748':
  doc: Describe TB option of setpts filter

Conflicts:
doc/filters.texi

Merged-by: Michael Niedermayer <michaelni@gmx.at>
1  2 
doc/filters.texi

@@@ -9173,16 -2100,6 +9173,13 @@@ the time in seconds of the first fram
  @item INTERLACED
  tell if the current frame is interlaced
  
- @item TB
- the time base
 +@item T
 +the time in seconds of the current frame
 +
 +@item POS
 +original position in the file of the frame, or undefined if undefined
 +for the current frame
 +
  @item PREV_INPTS
  previous input PTS
  
@@@ -9201,65 -2111,175 +9198,69 @@@ instead
  
  @item RTCSTART
  wallclock (RTC) time at the start of the movie in microseconds
+ @item TB
+ timebase of the input timestamps
  @end table
  
 -Some examples follow:
 +@subsection Examples
  
 +@itemize
 +@item
 +Start counting PTS from zero
  @example
 -# start counting PTS from zero
 -setpts=expr=PTS-STARTPTS
 +setpts=PTS-STARTPTS
 +@end example
  
 -# fast motion
 -setpts=expr=0.5*PTS
 +@item
 +Apply fast motion effect:
 +@example
 +setpts=0.5*PTS
 +@end example
  
 -# slow motion
 +@item
 +Apply slow motion effect:
 +@example
  setpts=2.0*PTS
 +@end example
  
 -# fixed rate 25 fps
 +@item
 +Set fixed rate of 25 frames per second:
 +@example
  setpts=N/(25*TB)
 +@end example
  
 -# fixed rate 25 fps with some jitter
 +@item
 +Set fixed rate 25 fps with some jitter:
 +@example
  setpts='1/(25*TB) * (N + 0.05 * sin(N*2*PI/25))'
 -
 -# generate timestamps from a "live source" and rebase onto the current timebase
 -setpts='(RTCTIME - RTCSTART) / (TB * 1000000)"
  @end example
  
 -@anchor{setsar}
 -@section setsar
 -
 -Set the Sample (aka Pixel) Aspect Ratio for the filter output video.
 -
 -Note that as a consequence of the application of this filter, the
 -output display aspect ratio will change according to the following
 -equation:
 -@math{DAR = HORIZONTAL_RESOLUTION / VERTICAL_RESOLUTION * SAR}
 -
 -Keep in mind that the sample aspect ratio set by this filter may be
 -changed by later filters in the filterchain, e.g. if another "setsar"
 -or a "setdar" filter is applied.
 -
 -This filter accepts the following options:
 -
 -@table @option
 -
 -@item sar
 -Output sample aspect ratio, as a rational or decimal number.
 -
 -@end table
 -
 -For example to change the sample aspect ratio to 10:11, specify:
 +@item
 +Apply an offset of 10 seconds to the input PTS:
  @example
 -setsar=sar=10/11
 +setpts=PTS+10/TB
  @end example
  
 -@section settb
 -
 -Set the timebase to use for the output frames timestamps.
 -It is mainly useful for testing timebase configuration.
 -
 -This filter accepts the following options:
 -
 -@table @option
 -
 -@item expr
 -The expression which is evaluated into the output timebase.
 -
 -@end table
 -
 -The expression can contain the constants "PI", "E", "PHI", "AVTB" (the
 -default timebase), and "intb" (the input timebase).
 -
 -The default value for the input is "intb".
 -
 -Follow some examples.
 -
 +@item
 +Generate timestamps from a "live source" and rebase onto the current timebase:
  @example
 -# set the timebase to 1/25
 -settb=expr=1/25
 -
 -# set the timebase to 1/10
 -settb=expr=0.1
 -
 -#set the timebase to 1001/1000
 -settb=1+0.001
 -
 -#set the timebase to 2*intb
 -settb=2*intb
 -
 -#set the default timebase value
 -settb=AVTB
 +setpts='(RTCTIME - RTCSTART) / (TB * 1000000)'
  @end example
  
 -@section showinfo
 -
 -Show a line containing various information for each input video frame.
 -The input video is not modified.
 -
 -The shown line contains a sequence of key/value pairs of the form
 -@var{key}:@var{value}.
 -
 -A description of each shown parameter follows:
 -
 -@table @option
 -@item n
 -sequential number of the input frame, starting from 0
 -
 -@item pts
 -Presentation TimeStamp of the input frame, expressed as a number of
 -time base units. The time base unit depends on the filter input pad.
 -
 -@item pts_time
 -Presentation TimeStamp of the input frame, expressed as a number of
 -seconds
 -
 -@item pos
 -position of the frame in the input stream, -1 if this information in
 -unavailable and/or meaningless (for example in case of synthetic video)
 -
 -@item fmt
 -pixel format name
 -
 -@item sar
 -sample aspect ratio of the input frame, expressed in the form
 -@var{num}/@var{den}
 -
 -@item s
 -size of the input frame, expressed in the form
 -@var{width}x@var{height}
 -
 -@item i
 -interlaced mode ("P" for "progressive", "T" for top field first, "B"
 -for bottom field first)
 -
 -@item iskey
 -1 if the frame is a key frame, 0 otherwise
 -
 -@item type
 -picture type of the input frame ("I" for an I-frame, "P" for a
 -P-frame, "B" for a B-frame, "?" for unknown type).
 -Check also the documentation of the @code{AVPictureType} enum and of
 -the @code{av_get_picture_type_char} function defined in
 -@file{libavutil/avutil.h}.
 -
 -@item checksum
 -Adler-32 checksum of all the planes of the input frame
 -
 -@item plane_checksum
 -Adler-32 checksum of each plane of the input frame, expressed in the form
 -"[@var{c0} @var{c1} @var{c2} @var{c3}]"
 -@end table
 -
 -@section split
 -
 -Split input video into several identical outputs.
 -
 -The filter accepts a single parameter which specifies the number of outputs. If
 -unspecified, it defaults to 2.
 -
 -For example
 +@item
 +Generate timestamps by counting samples:
  @example
 -avconv -i INPUT -filter_complex split=5 OUTPUT
 +asetpts=N/SR/TB
  @end example
 -will create 5 copies of the input video.
  
 -@section transpose
 +@end itemize
  
 -Transpose rows with columns in the input video and optionally flip it.
 +@section settb, asettb
 +
 +Set the timebase to use for the output frames timestamps.
 +It is mainly useful for testing timebase configuration.
  
  This filter accepts the following options: