


transcode(filter)       3th February 2008       transcode(filter)


NAME
       transcode - filter modules collection

SYNOPSIS
       transcode -J filters [other options]

COPYRIGHT
       transcode  is  Copyright  (C)  2001-2003 by Thomas Oestreich, 2003-2004
       Tilmann Bitterberg, 2004-2008 Transcode Team


MODULE OPTIONS
       The syntax for filter options is simple. A filter is specified with

           -J filter=optionstring

       The optionstring can contain multiple options which  are  separated  by
       colons `:'

           -J filter=option1:option2:option3

       An option can have an argument or non (bool). For options with an argu-
       ment, the format in which the argument has to be given to the option is
       specified  in  a  printf(1)  like  string. The most common case is `%d'
       which simply means a number. The argument has to be seperated from  the
       option by a `='.

           -J filter=bool1:option1=15:option2=20x30

       Most  filters  try  to do the right thing with the default options. You
       should play with various parameters if you are not satisfied  with  the
       default  behaviour.  If  you  have no idea what a filter does, its very
       likely that you don't need it.

       If a filter takes (for eg.) a filename as an argument, make  sure  that
       the  filename  does not contain a `:' or a `='. Its a limitation of the
       parser. A comma `,' is possible but must be extra quoted. For the  text
       filter that is

           -J text=string="Hello\, World"


FILTER MODULES
       To  see  what filter modules are avalaible for your transcode installa-
       tion, do a

           ls -1 $( tcmodinfo -p )/filter*.so

       A complete transcode installation has the following filter modules:


       29to23 - frame rate conversion filter (interpolating 29 to 23)
           29to23 was written by Max Alekseyev, Tilmann Bitterberg.  The  ver-
           sion  documented here is v0.3 (2003-07-18). This is a video filter.



1                            modules                            1





transcode(filter)       3th February 2008       transcode(filter)


           It can handle RGB and YUV mode. It is a pre-processing only filter.

       32detect - 3:2 pulldown / interlace detection plugin
           32detect  was  written  by  Thomas.  The version documented here is
           v0.2.4 (2003-07-22). This is a video filter. It can handle RGB  and
           YUV  mode. It supports multiple instances and can run as a pre-pro-
           cessing and/or as a post-processing filter.

           o threshold = %d  [default 9]
              Interlace detection threshold
           o chromathres = %d  [default 4]
              Interlace detection chroma threshold
           o equal = %d  [default 10]
              threshold for equal colors
           o chromaeq = %d  [default 5]
              threshold for equal chroma
           o diff = %d  [default 30]
              threshold for different colors
           o chromadi = %d  [default 15]
              threshold for different chroma
           o force_mode = %d  [default 0]
              set internal force de-interlace flag with mode -I N
           o pre = %d  [default 1]
              run as pre filter
           o verbose (bool)
              show results

                  This filter checks for interlaced video frames.   Subsequent
                  de-interlacing   with   transcode   can   be  enforced  with
                  'force_mode' option

       32drop - 3:2 inverse telecine removal plugin
           32drop was written by Thomas Oestreich. The version documented here
           is v0.4 (2003-02-01). This is a video filter. It can handle RGB and
           YUV mode. It is a pre-processing only filter.

       aclip - generate audio clips from source
           aclip was written by Thomas Oestreich. The version documented  here
           is  v0.1.1  (2003-09-04).  This is a audio filter. It is a pre-pro-
           cessing only filter.

           o level = %d  [default 10]
              The audio must be under this level to be skipped
           o range = %d  [default 25]
              Number of samples over level will be keyframes

       astat - audio statistics filter plugin
           astat was written by Thomas Oestreich. The version documented  here
           is  v0.1.3  (2003-09-04).  This is a audio filter. It is a pre-pro-
           cessing only filter.

           o file = %s
              File to save the calculated volume rescale number to




1                            modules                            2





transcode(filter)       3th February 2008       transcode(filter)


       compare - compare with other image to find a pattern
           compare was written by Antonio Beamud. The version documented  here
           is  v0.1.2  (2003-08-29). This is a video filter. It can handle RGB
           and YUV mode. It supports multiple instances. It is a post-process-
           ing only filter.

           o pattern = %s
              Pattern image file path
           o results = %s
              Results file path
           o delta = %f  [default 45.000000]
              Delta error

                  Generate  a file in with information about the times, frame,
                  etc the pattern defined in the image parameter is  observed.

           The  format of the command file is framenumber followed by at least
           one whitespace followed by the command followed  by  at  least  one
           whitespace  followed by arguments for the command.  Empty lines and
           lines starting with a `#' are ignored. The frame  numbers  must  be
           sorted ascending.

                 # Example file
                 # At frame 10 load the smooth filter
                 10 load smooth
                 # reconfigure at 20
                 20 configure smooth=strength=0.9
                 99 disable smooth



       cpaudio - copy one audio channel to the other channel filter plugin
           cpaudio  was  written  by  William H Wittig. The version documented
           here is v0.1 (2003-04-30). This is a audio filter. It  is  a  post-
           processing only filter.

           o source = %c  [default l]
              Source channel (l=left, r=right)

                  Copies audio from one channel to another

       decimate - NTSC decimation plugin
           decimate  was written by Thanassis Tsiodras. The version documented
           here is v0.4 (2003-04-22). This is a video filter.  It  can  handle
           YUV mode only. It is a post-processing only filter.

           o verbose (bool)
              print verbose information

                  see /docs/README.Inverse.Telecine.txt

       denoise3d - High speed 3D Denoiser
           denoise3d  was  written by Daniel Moreno & A'rpi. The version docu-
           mented here is v1.0.6 (2003-12-20). This is a video filter. It  can



1                            modules                            3





transcode(filter)       3th February 2008       transcode(filter)


           handle  YUV  mode  only.  It supports multiple instances. It can be
           used as a pre-processing or as a post-processing filter.

           o luma = %f  [default 4.000000]
              spatial luma strength
           o chroma = %f  [default 3.000000]
              spatial chroma strength
           o luma_strength = %f  [default 6.000000]
              temporal luma strength
           o chroma_strength = %f  [default 4.000000]
              temporal chroma strength
           o pre = %d  [default 0]
              run as a pre filter

                  What: The denoise3d filter from mplayer (sibling of hqdn3d).
                  Works  very  crude and simple but also very fast. In fact it
                  is even faster than the original from mplayer as  I  managed
                  to tweak some things (a.o. zero frame copying).

                  Who:  Everyone who wants to have their captured frames thor-
                  oughly denoised (i.e. who want to encode to mpeg  or  mjpeg)
                  but  do not have enough processing power to real-time encode
                  AND use hqdn3d (better quality but a lot slower) or dnr (yet
                  slower),  not  to  mention the other denoisers that are even
                  slower. Quality is really good for  static  scenes  (if  fed
                  with the right parameters), moving objects may show a little
                  ghost-image (also depends on parameters) though. Your milage
                  may vary.

                  How:  Parameters are the same as the hqdn3d module, although
                  in practice you'll not end up with exactly the same  values.
                  Just  experiment.  Particular for this version of the filter
                  is that if you supply -1 to  either  component's  parameters
                  (luma/chroma),  that  component  will  not  have  the filter
                  applied to. If you're still short on CPU  cycles,  try  dis-
                  abling  the  luma filter, this will not make much difference
                  in the effectiveness of the filter!

       detectclipping - detect clipping parameters (-j or -Y)
           detectclipping was written by Tilmann Bitterberg, A'rpi.  The  ver-
           sion  documented  here is v0.1.0 (2003-11-01). This is a video fil-
           ter. It can handle RGB and YUV mode. It supports multiple instances
           and can run as a pre-processing and/or as a post-processing filter.

           o range = %u-%u/%d  [default 0-4294967295/1]
              apply filter to [start-end]/step frames
           o limit = %d  [default 24]
              the sum of a line must be below this limit to be  considered  as
              black
           o post (bool)
              run as a POST filter (calc -Y instead of the default -j)

                  Detect  black  regions  on top, bottom, left and right of an
                  image.  It is suggested that the filter is  run  for  around



1                            modules                            4





transcode(filter)       3th February 2008       transcode(filter)


                  100  frames.   It  will  print its detected parameters every
                  frame. If you don't notice any change in the printout for  a
                  while, the filter probably won't find any other values.  The
                  filter converges, meaning it will learn.

       detectsilence - audio silence detection with tcmp3cut commandline gen-
       eration
           detectsilence  was written by Tilmann Bitterberg. The version docu-
           mented here is v0.0.1 (2003-07-26). This is a audio filter. It is a
           pre-processing only filter.

       divxkey - check for DivX 4.xx / OpenDivX / DivX;-) keyframe
           divxkey  was  written  by  Thomas Oestreich. The version documented
           here is v0.1 (2002-01-15). This is a video filter. It is a pre-pro-
           cessing only filter.

       dnr - dynamic noise reduction
           dnr  was  written by Gerhard Monzel. The version documented here is
           v0.2 (2003-01-21). This is a video filter. It can  handle  RGB  and
           YUV mode. It is a post-processing only filter.

           o lt = %d  [default 10]
              Threshold to blend luma/red
           o ll = %d  [default 4]
              Threshold to lock luma/red
           o ct = %d  [default 16]
              Threshold to blend croma/green+blue
           o cl = %d  [default 8]
              Threshold to lock croma/green+blue
           o sc = %d  [default 30]
              Percentage of picture difference (scene change)

                  see /docs/filter_dnr.txt (german only)

       doublefps - double frame rate by deinterlacing fields into frames
           doublefps was written by Andrew Church. The version documented here
           is v1.1 (2006-05-14). This is a video and audio filter. It can han-
           dle YUV and YUV422 modes. It is a pre-processing only filter.

           o topfirst = %d  [default 0 when height=480, else 1]
              Assume top field is displayed first
           o fullheight = %d  [default 0]
              Output full-height frames

           Doubles the frame rate of interlaced video by separating each field
           into a separate frame.  The fields can either be left as is (giving
           a  progessive  video  with  half the height of the original) or re-
           interlaced into their original height (at the doubled  frame  rate)
           for the application of a separate deinterlacing filter.

           Note  that  due to transcode limitations, it is currently necessary
           to use the -Z option to specify the output frame  size  when  using
           half-height  mode (this does not slow the program down if no actual
           zooming is done).



1                            modules                            5





transcode(filter)       3th February 2008       transcode(filter)


       extsub - DVD subtitle overlay plugin
           extsub was written by Thomas Oestreich. The version documented here
           is  0.3.5  (2003-10-15).  This is a video filter. It can handle RGB
           and YUV mode. It can be used as a pre-processing or as a  post-pro-
           cessing filter.

           o track = %d  [default 0]
              Subtitle track to render
           o vertshift = %d  [default 0]
              offset of subtitle with respect to bottom of frame in rows
           o timeshift = %d  [default 0]
              global display start time correction in msec
           o antialias = %d  [default 1]
              anti-aliasing the rendered text (0=off,1=on)
           o pre = %d  [default 1]
              Run as a pre filter
           o color1 = %d  [default 0]
              Make a subtitle color visible with given intensity
           o color2 = %d  [default 0]
              Make a subtitle color visible with given intensity
           o ca = %d  [default 0]
              Shuffle the color assignment by choosing another subtitle color
           o cb = %d  [default 0]
              Shuffle the color assignment by choosing another subtitle color

       fieldanalysis - Field analysis for detecting interlace and telecine
           fieldanalysis  was written by Matthias Hopf. The version documented
           here is v1.0 pl1 (2004-08-13). This is a video filter. It can  han-
           dle RGB,YUV and YUV422 mode. It is a pre-processing only filter.

           o interlacediff = %f  [default 1.1]
              Minimum temporal inter-field difference for detecting interlaced
              video
           o unknowndiff = %f  [default 1.5]
              Maximum inter-frame change vs. detail differences for neglecting
              interlaced video
           o progressivediff = %f  [default 8]
              Minimum  inter-frame change vs. detail differences for detecting
              progressive video
           o progressivechange = %f  [default 0.2]
              Minimum temporal change needed for detecting progressive video
           o changedifmore = %f  [default 10]
              Minimum temporal change for detecting truly changed frames
           o forcetelecinedetect = %d  [default 0]
              Detect telecine even on non-NTSC (29.97fps) video
           o verbose = %d  [default 0]
              Output analysis for every frame
           o outdiff = %d  [default 0]
              Output internal debug frames as  luminance  of  YUV  video  (see
              source)

       fields - Field adjustment plugin
           fields  was written by Alex Stewart. The version documented here is
           v0.1.1 (2003-01-21). This is a video filter. It can handle RGB  and



1                            modules                            6





transcode(filter)       3th February 2008       transcode(filter)


           YUV mode. It is a pre-processing only filter.

           o flip (bool)
              Exchange the top field and bottom field of each frame
           o shift (bool)
              Shift the video by one field
           o flip_first (bool)
              Normally  shifting  is  performed  before  flipping, this option
              reverses that

                  The 'fields' filter is designed to shift, reorder, and  gen-
                  erally  rearrange  independent fields of an interlaced video
                  input.  Input retrieved  from  broadcast  (PAL,  NTSC,  etc)
                  video  sources  generally  comes in an interlaced form where
                  each pass from top to bottom of the  screen  displays  every
                  other  scanline,  and  then the next pass displays the lines
                  between the lines from the first pass.  Each pass  is  known
                  as  a  "field"  (there  are generally two fields per frame).
                  When this form of video is captured  and  manipulated  digi-
                  tally,  the  two  fields  of  each  frame are usually merged
                  together into one flat (planar) image per frame.  This  usu-
                  ally  produces  reasonable results, however there are condi-
                  tions which can cause this merging to  be  performed  incor-
                  rectly  or  less-than-optimally,  which is where this filter
                  can help.

                  The following options are supported for  this  filter  (they
                  can be separated by colons):

                    shift - Shift the video by one field (half a frame),
                            changing frame boundaries appropriately.  This is
                            useful if a video capture started grabbing video
                            half a frame (one field) off from where frame
                            boundaries were actually intended to be.

                    flip  - Exchange the top field and bottom field of each
                            frame.  This can be useful if the video signal was
                            sent "bottom field first" (which can happen
                            sometimes with PAL video sources) or other
                            oddities occurred which caused the frame
                            boundaries to be at the right place, but the
                            scanlines to be swapped.

                    flip_first
                          - Normally shifting is performed before flipping if
                            both are specified.  This option reverses that
                            behavior.  You should not normally need to use
                            this unless you have some extremely odd input
                            material, it is here mainly for completeness.

                    help  - Print this text.

                  Note: the 'shift' function may produce slight color discrep-
                  ancies  if  YV12  is  used  as  the internal transcode video



1                            modules                            7





transcode(filter)       3th February 2008       transcode(filter)


                  format (default).  This is because  YV12  does  not  contain
                  enough  information  to  do field shifting cleanly. For best
                  (but slower) results, use RGB mode for field shifting.

       fps - convert video frame rate, gets defaults from -f and --export_fps
           fps was written by Christopher Cramer. The version documented  here
           is v1.1 (2004-05-01). This is a video filter. It can handle RGB and
           YUV mode. It can be used as a pre-processing or as a  post-process-
           ing filter.


                  options:  <input  fps>:<output fps> example: -J fps=25:29.97
                  will convert from PAL to  NTSC  If  no  options  are  given,
                  defaults or -f/--export_fps/--export_frc will be used.  Some
                  examples:

                       -J fps=10:5:pre          convert from 10 fps to 5  fps,
                  preprocess       -J  fps=10:post:12   convert from 10 to 12,
                  postprocess      -J fps=pre=1:7:5    convert from  7  to  5,
                  postprocess       -J fps=9:3.1:post=-0x7   convert from 9 to
                  3.1, postprocess

                  If that last one is confusing you, remember that 0 is  false
                  and  everything else is true. Of course, octal and hexadeci-
                  mal numbers are supported too.  This is intended to be back-
                  ward compatible with the old format.

       hqdn3d - High Quality 3D Denoiser
           hqdn3d was written by Daniel Moreno & A'rpi. The version documented
           here is v1.0.2 (2003-08-15). This is a video filter. It can  handle
           YUV  mode only. It supports multiple instances. It can be used as a
           pre-processing or as a post-processing filter.

           o luma = %f  [default 4.000000]
              spatial luma strength
           o chroma = %f  [default 3.000000]
              spatial chroma strength
           o luma_strength = %f  [default 6.000000]
              temporal luma strength
           o chroma_strength = %f  [default 4.500000]
              temporal chroma strength
           o pre = %d  [default 0]
              run as a pre filter

                  This filter aims to  reduce  image  noise  producing  smooth
                  images  and  making  still  images really still (This should
                  enhance compressibility).

       invert - invert the image
           invert was written by Tilmann Bitterberg.  The  version  documented
           here  is v0.1.4 (2003-10-12). This is a video filter. It can handle
           RGB,YUV and YUV422 mode. It is a post-processing only filter.

           o range = %u-%u/%d  [default 0-4294967295/1]



1                            modules                            8





transcode(filter)       3th February 2008       transcode(filter)


              apply filter to [start-end]/step frames

       ivtc - NTSC inverse telecine plugin
           ivtc was written by Thanassis Tsiodras. The version documented here
           is  v0.4.1  (2004-06-01). This is a video filter. It can handle YUV
           mode only. It is a pre-processing only filter.

           o verbose (bool)
              print verbose information
           o field = %d  [default 0]
              which field to replace (0=top 1=bottom)
           o magic = %d  [default 0]
              perform magic? (0=no 1=yes)

                  see /docs/README.Inverse.Telecine.txt

       levels - Luminosity level scaler
           levels was written by Bryan Mayland. The version documented here is
           v1.0.0 (2004-06-09). This is a video filter. It can handle YUV mode
           only. It supports multiple instances. It is a post-processing  only
           filter.

           o input = %d-%d  [default 0-255]
              input luma range (black-white)
           o gamma = %f  [default 1.000000]
              input luma gamma
           o output = %d-%d  [default 0-255]
              output luma range (black-white)

       logo - render image in videostream
           logo was written by Tilmann Bitterberg. The version documented here
           is v0.10 (2003-10-16). This is a video filter. It  can  handle  RGB
           and YUV mode. It is a post-processing only filter.

           o file = %s
              Image filename
           o posdef = %d  [default 0]
              Position (0=None, 1=TopL, 2=TopR, 3=BotL, 4=BotR, 5=Center)
           o pos = %dx%d  [default 0x0]
              Position (0-width x 0-height)
           o range = %u-%u  [default 0-0]
              Restrict rendering to framerange
           o ignoredelay (bool)
              Ignore delay specified in animations
           o rgbswap (bool)
              Swap red/blue colors
           o grayout (bool)
              YUV only: don't write Cb and Cr, makes a nice effect
           o flip (bool)
              Mirror image

                  This  filter renders an user specified image into the video.
                  Any image format ImageMagick can read is  accepted.   Trans-
                  parent  images  are  also supported.  Image origin is at the



1                            modules                            9





transcode(filter)       3th February 2008       transcode(filter)


                  very top left.

                  see /docs/filter_logo.txt

       logoaway - remove an image from the video
           logoaway was written by Thomas Wehrspann <thomas@wehrspann.de>. The
           version  documented here is v0.5 (2004-03-07). This is a video fil-
           ter. It can handle RGB and YUV mode. It is a  post-processing  only
           filter. It supports multiple instances.

           o range = %d-%d  [default 0-4294967295]
              Frame Range
           o pos = %dx%d  [default -1x-1]
              Position of logo
           o size = %dx%d  [default -2x-2]
              Size of logo
           o mode = %d  [default 0]
              Filter Mode (0=none,1=solid,2=xy,3=shape)
           o border (bool)
              Visible Border
           o dump (bool)
              Dump filterarea to file
           o xweight = %d  [default 50]
              X-Y Weight(0%-100%)
           o fill = %2x%2x%2x  [default 000]
              Solid Fill Color(RGB)
           o file = %s
              Image with alpha/shape information

                  This  filter  removes an image in a user specified area from
                  the video.  You can choose from different methods.

                  see /docs/filter_logoaway.txt

       lowpass - High and low pass filter
           lowpass was written by Tilmann Bitterberg. The  version  documented
           here  is  v0.1.0 (2002-02-26). This is a audio filter. It is a pre-
           processing only filter.

           o taps = %d  [default 30]
              strength (may be negative)

       mask - Filter through a rectangular Mask
           mask was written by Thomas Oestreich, Chad Page. The version  docu-
           mented  here is v0.2.3 (2003-10-12). This is a video filter. It can
           handle RGB,YUV and YUV422 mode. It is a pre-processing only filter.

           o lefttop = %dx%d  [default 0x0]
              Upper left corner of the box
           o rightbot = %dx%d  [default 32x32]
              Lower right corner of the box

                  This  filter  applies  an  rectangular  mask  to  the video.
                  Everything outside the mask is set to black.



1                            modules                           10





transcode(filter)       3th February 2008       transcode(filter)


       modfps - plugin to modify framerate
           modfps was written by Marrq. The version documented here  is  v0.10
           (2003-08-18).  This  is  a  video filter. It can handle RGB and YUV
           mode. It is a pre-processing only filter.

           o mode = %d  [default 1]
              mode of operation
           o infps = %f  [default 25.000000]
              Original fps
           o infrc = %d  [default 0]
              Original frc
           o buffer = %d  [default 5]
              How many frames to buffer
           o subsample = %d  [default 32]
              How many pixels to subsample
           o clonetype = %d  [default 0]
              How to clone frames
           o verbose = %d  [default 1]
              run in verbose mode

                  This filter aims to allow transcode  to  alter  the  fps  of
                  video.   While one can reduce the fps to any amount, one can
                  only increase the fps to at most twice the original fps.

                  There are two modes of operation, buffered  and  unbuffered,
                  unbuffered  is quick, but buffered, especially when dropping
                  frames should look better.

                  For most users, modfps will need either no options, or  just
                  mode=1

                  see /docs/README.filter.modfps

       msharpen - VirtualDub's MSharpen Filter
           msharpen  was written by Donald Graft, William Hawkins. The version
           documented here is (1.0) (2003-07-17). This is a video  filter.  It
           can handle RGB and YUV mode. It is a post-processing only filter.

           o strength = %d  [default 100]
              How much  of the effect
           o threshold = %d  [default 10]
              How  close  a pixel must be to the brightest or dimmest pixel to
              be mapped
           o highq = %d  [default 1]
              Tradeoff speed for quality of detail detection
           o mask = %d  [default 0]
              Areas to be sharpened are shown in white

                  This plugin implements an unusual concept in spatial  sharp-
                  ening.   Although  designed  specifically for anime, it also
                  works well with normal video. The filter is  very  effective
                  at sharpening important edges without amplifying noise.

                    * Strength 'strength' (0-255) [100]



1                            modules                           11





transcode(filter)       3th February 2008       transcode(filter)


                      This  is the strength of the sharpening to be applied to
                  the edge detail areas. It is applied only to the edge detail
                  areas  as  determined by the 'threshold' parameter. Strength
                  255 is the strongest sharpening.
                    * Threshold 'threshold' (0-255) [10]
                      This parameter  determines  what  is  detected  as  edge
                  detail  and  thus  sharpened.  To see what edge detail areas
                  will be sharpened, use the 'mask' parameter.
                    * Mask 'mask' (0-1) [0]
                      When set to true, the areas to be sharpened are shown in
                  white  against a black background. Use this to set the level
                  of detail to be sharpened. This function also makes a  basic
                  edge detection filter.
                    * HighQ 'highq' (0-1) [1]
                      This  parameter  lets  you tradeoff speed for quality of
                  detail detection. Set it to true for the best detail  detec-
                  tion. Set it to false for maximum speed.

       normalize - Volume normalizer
           normalize  was written by pl, Tilmann Bitterberg. The version docu-
           mented here is v0.1.1 (2002-06-18). This is a audio filter. It is a
           pre-processing only filter.

           o smooth = %f  [default 0.06]
              Value for smoothing ]0.0 1.0[
           o smoothlast = %f  [default 0.06]
              Value for smoothing last sample ]0.0, 1.0[
           o algo = %d  [default 1]
              Algorithm  to  use (1 or 2). 1=uses a 1 value memory and coeffi-
              cients new=a*old+b*cur (with a+b=1).   2=uses several samples to
              smooth the variations (standard weighted mean on past samples)

       null - demo filter plugin; does nothing
           null  was  written by Thomas Oestreich. The version documented here
           is v0.2 (2003-09-04). This is a video and audio filter. It  can  be
           used as a pre-processing or as a post-processing filter.

       pp - Mplayers postprocess filters
           pp  was  written  by Michael Niedermayer et al, Gerhard Monzel. The
           version documented here is v1.2.4 (2003-01-24).  This  is  a  video
           filter.   It  can  handle  YUV  mode  only.  It  supports  multiple
           instances. It can be used as a pre-processing or as a post-process-
           ing filter.

           o hb = %d:%d  [default 64:40]
              Horizontal deblocking filter
           o vb = %d:%d  [default 64:40]
              Vertical deblocking filter
           o h1 (bool)
              Experimental h deblock filter 1
           o v1 (bool)
              Experimental v deblock filter 1
           o dr (bool)
              Deringing filter



1                            modules                           12





transcode(filter)       3th February 2008       transcode(filter)


           o al (bool)
              Automatic brightness / contrast
           o f (bool)
              Stretch luminance to (0..255)
           o lb (bool)
              Linear blend deinterlacer
           o li (bool)
              Linear interpolating deinterlace
           o ci (bool)
              Cubic interpolating deinterlacer
           o md (bool)
              Median deinterlacer
           o de (bool)
              Default preset (hb:a/vb:a/dr:a/al)
           o fa (bool)
              Fast preset (h1:a/v1:a/dr:a/al)
           o tn = %d:%d:%d  [default 64:128:256]
              Temporal Noise Reducer (1<=2<=3)
           o fq = %d  [default 15]
              Force quantizer
           o pre (bool)
              Run as a PRE filter

       preview - xv/sdl/gtk preview plugin
           preview  was  written  by  Thomas Oestreich. The version documented
           here is v0.1.4 (2002-10-08). This is a video filter. It can  handle
           RGB and YUV mode. It is a post-processing only filter.


                  XXX: Write me

       pv - xv only preview plugin
           pv was written by Thomas Oestreich, Tilmann Bitterberg. The version
           documented here is v0.2.3 (2004-06-01). This is a video filter.  It
           can  handle  YUV and YUV422 mode. It is a post-processing only fil-
           ter.

           o cache = %d  [default 15]
              Number of raw frames to cache for seeking
           o skip = %d  [default 0]
              display only every Nth frame
           o fullscreen (bool)
              Display in fullscreen mode

                  The filter listens to mouse and key strokes.  If  you  click
                  into  the  preview window, the first time say near the upper
                  left corner and the second time near the lower right corner,
                  transcode will draw a rectangle and will print out the coor-
                  dinates of this rectangle on stdout and the socket. See  the
                  table below for available keys.

                  When you start transcode with the --socket option and the pv
                  filter with (for example) cache=20 you can talk to transcode
                  and the pv filter at runtime using the socket.



1                            modules                           13





transcode(filter)       3th February 2008       transcode(filter)


                  transcode -i file.avi -J pv=cache=30 --socket /tmp/sock


                  Available Commands

                  Key  Socket*   Effect

                  RET     draw redraws the image, applying filters.

                  u       undo goes to image before draw

                  SPACE   pause     pause the preview (and transcode)

                  UP      fastfw    in pause mode, step forward 5 frames

                  RIGHT   slowfw    in pause mode, step forward 1 frame

                  DOWN    fastbw    in pause mode, step back 5 frames

                  LEFT    slowbw    in pause mode, step back 1 frame

                  q       display   toggle display of frames

                  s       slower    slow down

                  f       faster    speed up

                  y       toggle    toggle displaying only every 5 frames

                  j       grab save a JPEG

                  r       rotate    rotate AVI file after next keyframe

                      (*) all commands must be prefixed with "preview ".

       resample - audio resampling filter plugin
           resample  was  written  by Thomas Oestreich. The version documented
           here is v0.1.4 (2003-08-22). This is a audio filter. It is  a  pre-
           processing only filter.

       skip - skip all listed frames
           skip  was  written by Thomas Oestreich. The version documented here
           is v0.0.1 (2001-11-27). This is a video and audio filter. It  is  a
           pre-processing only filter.

           o fstart1-fend1 [ fstart2-fend2 [ .. ] ] = %s
              apply filter [start-end] frames

       slowmo - very cheap slow-motion effect
           slowmo  was  written  by Tilmann Bitterberg. The version documented
           here is v0.3 (2003-29-11). This is a video filter.  It  can  handle
           RGB and YUV mode. It is a pre-processing only filter.





1                            modules                           14





transcode(filter)       3th February 2008       transcode(filter)


                  This  filter  produces a simple slow-motion effect by dupli-
                  cating certain frames. I have seen this  effect  on  TV  and
                  despite  its  the  simple algorithm it works quite well. The
                  filter has no options.

       smartbob - Motion-adaptive deinterlacing for double-frame-rate output.
           smartbob was written by Donald Graft, Tilmann Bitterberg. The  ver-
           sion  documented  here  is  v1.1beta2 (2003-06-23). This is a video
           filter. It can handle RGB and YUV mode.  It  is  a  post-processing
           only filter.

           o motionOnly = %d  [default 0]
              Show motion areas only
           o shiftEven = %d  [default 0]
              Blend instead of interpolate in motion areas
           o threshold = %d  [default 12]
              Motion Threshold
           o denoise = %d  [default 1]
              Phase shift

                  This  filter  only makes sense when fed by -J doublefps.  It
                  will take the field-frames which  filter_doublefps  produces
                  and generates full-sized motion adaptive deinterlaced output
                  at the double import framerate.

       smartdeinter - VirtualDub's smart deinterlacer
           smartdeinter was written by Donald Graft.  The  version  documented
           here  is  v2.7b (2003-02-01). This is a video filter. It can handle
           RGB and YUV mode. It is a pre-processing only filter.

           o motionOnly = %d  [default 0]
              Show motion areas only
           o Blend = %d  [default 0]
              Blend instead of interpolate in motion areas
           o threshold = %d  [default 15]
              Motion Threshold
           o scenethreshold = %d  [default 100]
              Scene Change Threshold
           o fieldShift = %d  [default 0]
              Phase shift
           o inswap = %d  [default 0]
              Field swap before phase shift
           o outswap = %d  [default 0]
              Field swap after phase shift
           o noMotion = %d  [default 0]
              Disable motion processing
           o highq = %d  [default 0]
              Motion map denoising for field-only
           o diffmode = %d  [default 0]
              Motion Detection (0=frame, 1=field, 2=both)
           o colordiff = %d  [default 1]
              Compare color channels instead of luma
           o cubic = %d  [default 0]
              Use cubic for interpolation



1                            modules                           15





transcode(filter)       3th February 2008       transcode(filter)


                  This filter provides  a  smart,  motion-based  deinterlacing
                  capability.  In  static picture areas, interlacing artifacts
                  do not appear, so data from both fields is used  to  provide
                  full detail. In moving areas, deinterlacing is performed

       smartyuv - Motion-adaptive deinterlacing
           smartyuv  was written by Tilmann Bitterberg. The version documented
           here is 0.1.4 (2003-10-13). This is a video filter. It  can  handle
           YUV mode only. It is a pre-processing only filter.

           o motionOnly = %d  [default 0]
              Show motion areas only, blacking out static areas
           o diffmode = %d  [default 0]
              Motion Detection (0=frame, 1=field, 2=both)
           o threshold = %d  [default 14]
              Motion Threshold (luma)
           o chromathres = %d  [default 7]
              Motion Threshold (chroma)
           o scenethres = %d  [default 31]
              Threshold for detecting scenechanges
           o highq = %d  [default 1]
              High-Quality processing (motion Map denoising)
           o cubic = %d  [default 1]
              Do cubic interpolation
           o Blend = %d  [default 1]
              Blend the frames for deinterlacing
           o doChroma = %d  [default 1]
              Enable chroma processing (slower but more accurate)
           o verbose = %d  [default 0]
              Verbose mode

                  This  filter is basically a rewrite of the smartdeinter fil-
                  ter by Donald Graft (without  advanced  processing  options)
                  for YUV mode only. Its faster than using the smartdeinter in
                  YUV mode and is also tuned with its threshold  settings  for
                  YUV  mode.  The filter detects motion and static areas in an
                  image and only deinterlaces (either by blending or by  cubic
                  interpolation) the moving areas. The result is an image with
                  high detail in static areas, no information is lost there.

                  The threshold settings should be sufficent for  most  users.
                  As a rule of thumb, I recommend setting the chroma threshold
                  to about the half of the luma threshold. If  you  want  more
                  deinterlacing, lower the thresholds. The scene threshold can
                  be easily found by turning on verbose mode and  the  preview
                  filter.  In verbose mode, the filter will print out, when it
                  detects a scene change. If  scenechanges  go  by  unnoticed,
                  lower  the scene threshold. You can completly disable chroma
                  processing with the doChroma=0 option.   Here  is  a  sample
                  commandline

                  -J     smartyuv=highq=1:diffmode=2:cubic=1:Blend=1:chromath-
                  res=4:threshold=8:doChroma=1




1                            modules                           16





transcode(filter)       3th February 2008       transcode(filter)


       smooth - (single-frame) smoothing plugin
           smooth was written by Chad Page. The  version  documented  here  is
           v0.2.3 (2003-03-27). This is a video filter. It can handle YUV mode
           only. It is a pre-processing  only  filter.  It  supports  multiple
           instances.

           o strength = %f  [default 0.25]
              Blending factor
           o cdiff = %d  [default 6]
              Max difference in chroma values
           o ldiff = %d  [default 8]
              Max difference in luma value
           o range = %d  [default 4]
              Search Range

                  "single-frame"  means  it only works with the current frame,
                  it does not need the next or the previous frame  for  opera-
                  tion.  Usually smoothing is done by talking the data of pre-
                  vious frames into account to see which parts of the  picture
                  can  be "safely" smoothed, this filter only needs one frame.

           Usage -J subtitler="[no_objects] [subtitle_file=s]  [color_depth=n]
           [font_dir=s]   [font=n]   [font_factor=f  [frame_offset=n]  [debug]
           [help]" f is float, h is hex, n is integer, s is string.

           no_objects           disables subtitles and other objects (off).
           color_depth=         32 or 24 (overrides X auto) (32).
           font=                0 or 1, 1 gives strange symbols... (0).
           font_dir=            place where font.desc is  (~/.subtitles/font).
           font_factor=         .1 to 100 outline characters (10.75).
           frame_offset=         positive  (text  later) or negative (earlier)
           integer (0).
           subtitle_file=        pathfilename.ppml  location  of   ppml   file
           (~/.subtitles/demo.ppml).
           debug                prints debug messages (off).
           help                 prints this list and exit.

       testframe - generate stream of testframes
           testframe  was  written by Thomas Oestreich. The version documented
           here is v0.1.3 (2003-09-04). This is a video filter. It can  handle
           RGB and YUV mode. It is a pre-processing only filter.

           o mode = %d  [default 0]
              Choose the test pattern (0-4 interlaced, 5 colorfull)

       text - write text in the image
           text was written by Tilmann Bitterberg. The version documented here
           is v0.1.4 (2004-02-14). This is a video filter. It can  handle  RGB
           and YUV mode. It is a post-processing only filter.

           o range = %u-%u/%d  [default 0-4294967295/1]
              apply filter to [start-end]/step frames
           o string = %s
              text to display (no ':') [defaults to `date`]



1                            modules                           17





transcode(filter)       3th February 2008       transcode(filter)


           o font = %s
              full path to font file [defaults to arial.ttf]
           o points = %d  [default 25]
              size of font (in points)
           o dpi = %d  [default 96]
              resolution of font (in dpi)
           o fade = %d  [default 0]
              fade in/out (0=off, 1=slow, 10=fast)
           o antialias = %d  [default 1]
              Anti-Alias text (0=off 1=on)
           o pos = %dx%d  [default 0x0]
              Position (0-width x 0-height)
           o posdef = %d  [default 0]
              Position (0=None 1=TopL 2=TopR 3=BotL 4=BotR 5=Cent 6=BotCent)
           o notransparent (bool)
              disable transparency (enables block box)

                  see /docs/filter_text.txt

       tomsmocomp - Tom's MoComp deinterlacing filter
           tomsmocomp  was written by Tom Barry et al.. The version documented
           here is v0.1 (2004-07-31). This is a video filter.  It  can  handle
           YUV and YUV422 mode. It is a pre-processing only filter.

           o TopFirst = %d  [default 1]
              Assume the top field should be displayed first
           o SearchEffort = %d  [default 15]
              CPU time used to find moved pixels
           o UseStrangeBob = %d  [default 0]
              ?Unknown?
           o CpuFlags = %x  [default 5f]
              Manual specification of CPU capabilities

       unsharp - unsharp mask & gaussian blur
           unsharp  was written by Remi Guyomarch. The version documented here
           is v1.0.1 (2003-10-27). This is a video filter. It can  handle  YUV
           mode only. It is a post-processing only filter.

           o amount = %f  [default 0.0]
              Luma and chroma (un)sharpness amount
           o matrix = %dx%d  [default 0x0]
              Luma and chroma search matrix size
           o luma = %f  [default 0.0]
              Luma (un)sharpness amount
           o chroma = %f  [default 0.0]
              Chroma (un)sharpness amount
           o luma_matrix = %dx%d  [default 0x0]
              Luma search matrix size
           o chroma_matrix = %dx%d  [default 0x0]
              Chroma search matrix size
           o pre = %d  [default 0]
              run as a pre filter

                  This filter blurs or sharpens an image depending on the sign



1                            modules                           18





transcode(filter)       3th February 2008       transcode(filter)


                  of "amount". You can either set amount  for  both  luma  and
                  chroma or you can set it individually (recommended). A posi-
                  tive value for amount will sharpen  the  image,  a  negative
                  value  will blur it. A sane range for amount is -1.5 to 1.5.

                  The matrix sizes must be odd and define  the  range/strength
                  of the effect. Sensible ranges are 3x3 to 7x7.

                  It sometimes makes sense to sharpen the sharpen the luma and
                  to blur the chroma. Sample string is:

                  luma=0.8:luma_matrix=7x5:chroma=-0.2:chroma_matrix=3x3

       whitebalance - White Balance Filter - correct images with a broken
       white  bal- ance
           whitebalance was written by Guillaume Cottenceau. The version docu-
           mented  here  is  v0.1 (2003-10-01). This is a video filter. It can
           handle RGB and YUV mode. It is a pre-processing only filter.

           o level = %d  [default 40]
              Level of blue-to-yellow white balance shifting (can be negative)
           o limit = %s
              Limit to specified ranges (+fnumber toggles on, -fnumber toggles
              off)

                  This filter allows correcting movies  with  a  broken  white
                  balance, e.g. bluish movies.

       xharpen - VirtualDub's XSharpen Filter
           xharpen  was  written by Donald Graft, Tilmann Bitterberg. The ver-
           sion documented here is (1.0b2) (2003-02-12). This is a video  fil-
           ter.  It  can handle RGB and YUV mode. It is a post-processing only
           filter.

           o strength = %d  [default 200]
              How much  of the effect
           o threshold = %d  [default 255]
              How close a pixel must be to the brightest or dimmest  pixel  to
              be mapped

                  This  filter performs a subtle but useful sharpening effect.
                  The result is a  sharpening  effect  that  not  only  avoids
                  amplifying  noise,  but  also  tends to reduce it. A welcome
                  side effect is that files processed with this filter tend to
                  compress to smaller files.

                    Strength 'strength' (0-255) [200]
                      When  this  value  is 255, mapped pixels are not blended
                  with the original pixel values, so a full-strength effect is
                  obtained.  As  the  value  is  reduced, each mapped pixel is
                  blended with more of the original pixel. At a  value  of  0,
                  the  original  pixels  are  passed  through  and there is no
                  sharpening effect.




1                            modules                           19





transcode(filter)       3th February 2008       transcode(filter)


                    Threshold 'threshold' (0-255) [255]
                      This value determines how close a pixel must be  to  the
                  brightest  or dimmest pixel to be mapped. If a pixel is more
                  than threshold away from the brightest or dimmest pixel,  it
                  is not mapped.  Thus, as the threshold is reduced, pixels in
                  the mid range start to be spared.

       yuvdenoise - mjpegs YUV denoiser
           yuvdenoise was written by Stefan  Fendt,  Tilmann  Bitterberg.  The
           version  documented  here  is  v0.2.1 (2003-11-26). This is a video
           filter. It can handle YUV mode only. It can be used as  a  pre-pro-
           cessing or as a post-processing filter.

           o radius = %d  [default 8]
              Search radius
           o threshold = %d  [default 5]
              Denoiser threshold
           o pp_threshold = %d  [default 4]
              Pass II threshold
           o delay = %d  [default 3]
              Average 'n' frames for a time-lowpassed pixel
           o postprocess = %d  [default 1]
              Filter internal postprocessing
           o luma_contrast = %d  [default 100]
              Luminance contrast in percent
           o chroma_contrast = %d  [default 100]
              Chrominance contrast in percent.
           o sharpen = %d  [default 125]
              Sharpness in percent
           o deinterlace = %d  [default 0]
              Force deinterlacing
           o mode = %d  [default 0]
              [0]: Progressive [1]: Interlaced [2]: Fast
           o scene_thres = %d%%  [default 50]
              Blocks where motion estimation should fail before scenechange
           o block_thres = %d  [default 1024]
              Every SAD value greater than this will be considered bad
           o do_reset = %d  [default 2]
              Reset the filter for `n' frames after a scene
           o increment_cr = %d  [default 2]
              Increment Cr with constant
           o increment_cb = %d  [default 2]
              Increment Cb with constant
           o border = %dx%d-%dx%d  [default 0x0-32x32]
              Active image area
           o pre = %d  [default 0]
              run this filter as a pre-processing filter

                  see /docs/filter_yuvdenoise.txt

       yuvmedian - mjpegs YUV median filter
           yuvmedian was written by Mike Bernson, Tilmann Bitterberg. The ver-
           sion documented here is v0.1.0 (2003-01-24). This is a  video  fil-
           ter.  It  can  handle  YUV  mode  only.  It  can  be used as a pre-



1                            modules                           20





transcode(filter)       3th February 2008       transcode(filter)


           processing or as a post-processing filter.

           o radius_luma = %d  [default 2]
              Radius for median (luma)
           o radius_chroma = %d  [default 2]
              Radius for median (chroma)
           o threshold_luma = %d  [default 2]
              Trigger threshold (luma)
           o threshold_chroma = %d  [default 2]
              Trigger threshold (chroma)
           o interlace = %d  [default 0]
              Treat input as interlaced
           o pre = %d  [default 1]
              Run as a PRE filter



AUTHORS
       transcode was written by Thomas Oestreich
       <ostreich@theorie.physik.uni-goettingen.de>  with  contributions   from
       many others.  See AUTHORS for details.


SEE ALSO
       transcode(1), transcode_import(1), transcode_export(1), tcmodinfo(1),
































1                            modules                           21


