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 argument, 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 installation, 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 version documented here is v0.3 (2003-07-18). This is a video 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-processing and/or as a post-processing filter.

  • threshold = %d [default 9]

    Interlace detection threshold

    chromathres = %d [default 4]

    Interlace detection chroma threshold

    equal = %d [default 10]

    threshold for equal colors

    chromaeq = %d [default 5]

    threshold for equal chroma

    diff = %d [default 30]

    threshold for different colors

    chromadi = %d [default 15]

    threshold for different chroma

    force_mode = %d [default 0]

    set internal force de-interlace flag with mode -I N

    pre = %d [default 1]

    run as pre filter

    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-processing only filter.

  • level = %d [default 10]

    The audio must be under this level to be skipped

    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-processing only filter.

  • file = %s

    File to save the calculated volume rescale number to

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-processing only filter.

  • pattern = %s

    Pattern image file path

    results = %s

    Results file path

    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.

  • 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.

  • 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 documented here is v1.0.6 (2003-12-20). 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.

  • luma = %f [default 4.000000]

    spatial luma strength

    chroma = %f [default 3.000000]

    spatial chroma strength

    luma_strength = %f [default 6.000000]

    temporal luma strength

    chroma_strength = %f [default 4.000000]

    temporal chroma strength

    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 thoroughly 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 disabling 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 version documented here is v0.1.0 (2003-11-01). This is a video filter. 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.

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

    apply filter to [start-end]/step frames

    limit = %d [default 24]

    the sum of a line must be below this limit to be considered as black

    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 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 generation

detectsilence was written by Tilmann Bitterberg. The version documented 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-processing 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.

  • lt = %d [default 10]

    Threshold to blend luma/red

    ll = %d [default 4]

    Threshold to lock luma/red

    ct = %d [default 16]

    Threshold to blend croma/green+blue

    cl = %d [default 8]

    Threshold to lock croma/green+blue

    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 handle YUV and YUV422 modes. It is a pre-processing only filter.

  • topfirst = %d [default 0 when height=480, else 1]

    Assume top field is displayed first

    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).

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-processing filter.

  • track = %d [default 0]

    Subtitle track to render

    vertshift = %d [default 0]

    offset of subtitle with respect to bottom of frame in rows

    timeshift = %d [default 0]

    global display start time correction in msec

    antialias = %d [default 1]

    anti-aliasing the rendered text (0=off,1=on)

    pre = %d [default 1]

    Run as a pre filter

    color1 = %d [default 0]

    Make a subtitle color visible with given intensity

    color2 = %d [default 0]

    Make a subtitle color visible with given intensity

    ca = %d [default 0]

    Shuffle the color assignment by choosing another subtitle color

    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 handle RGB,YUV and YUV422 mode. It is a pre-processing only filter.

  • interlacediff = %f [default 1.1]

    Minimum temporal inter-field difference for detecting interlaced video

    unknowndiff = %f [default 1.5]

    Maximum inter-frame change vs. detail differences for neglecting interlaced video

    progressivediff = %f [default 8]

    Minimum inter-frame change vs. detail differences for detecting progressive video

    progressivechange = %f [default 0.2]

    Minimum temporal change needed for detecting progressive video

    changedifmore = %f [default 10]

    Minimum temporal change for detecting truly changed frames

    forcetelecinedetect = %d [default 0]

    Detect telecine even on non-NTSC (29.97fps) video

    verbose = %d [default 0]

    Output analysis for every frame

    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 YUV mode. It is a pre-processing only filter.

  • flip (bool)

    Exchange the top field and bottom field of each frame

    shift (bool)

    Shift the video by one field

    flip_first (bool)

    Normally shifting is performed before flipping, this option reverses that

    • The 'fields' filter is designed to shift, reorder, and generally 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 digitally, the two fields of each frame are usually merged together into one flat (planar) image per frame. This usually produces reasonable results, however there are conditions which can cause this merging to be performed incorrectly 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 discrepancies if YV12 is used as the internal transcode video 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-processing 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 hexadecimal numbers are supported too. This is intended to be backward 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.

  • luma = %f [default 4.000000]

    spatial luma strength

    chroma = %f [default 3.000000]

    spatial chroma strength

    luma_strength = %f [default 6.000000]

    temporal luma strength

    chroma_strength = %f [default 4.500000]

    temporal chroma strength

    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.

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

    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.

  • verbose (bool)

    print verbose information

    field = %d [default 0]

    which field to replace (0=top 1=bottom)

    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.

  • input = %d-%d [default 0-255]

    input luma range (black-white)

    gamma = %f [default 1.000000]

    input luma gamma

    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.

  • file = %s

    Image filename

    posdef = %d [default 0]

    Position (0=None, 1=TopL, 2=TopR, 3=BotL, 4=BotR, 5=Center)

    pos = %dx%d [default 0x0]

    Position (0-width x 0-height)

    range = %u-%u [default 0-0]

    Restrict rendering to framerange

    ignoredelay (bool)

    Ignore delay specified in animations

    rgbswap (bool)

    Swap red/blue colors

    grayout (bool)

    YUV only: don't write Cb and Cr, makes a nice effect

    flip (bool)

    Mirror image

    • This filter renders an user specified image into the video. Any image format ImageMagick can read is accepted. Transparent images are also supported. Image origin is at the very top left.

      see /docs/filter_logo.txt

logoaway - remove an image from the video

logoaway was written by Thomas Wehrspann <[email protected]>. The version documented here is v0.5 (2004-03-07). This is a video filter. It can handle RGB and YUV mode. It is a post-processing only filter. It supports multiple instances.

  • range = %d-%d [default 0-4294967295]

    Frame Range

    pos = %dx%d [default -1x-1]

    Position of logo

    size = %dx%d [default -2x-2]

    Size of logo

    mode = %d [default 0]

    Filter Mode (0=none,1=solid,2=xy,3=shape)

    border (bool)

    Visible Border

    dump (bool)

    Dump filterarea to file

    xweight = %d [default 50]

    X-Y Weight(0%-100%)

    fill = %2x%2x%2x [default 000]

    Solid Fill Color(RGB)

    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.

  • taps = %d [default 30]

    strength (may be negative)

mask - Filter through a rectangular Mask

mask was written by Thomas Oestreich, Chad Page. The version documented 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.

  • lefttop = %dx%d [default 0x0]

    Upper left corner of the box

    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.

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.

  • mode = %d [default 1]

    mode of operation

    infps = %f [default 25.000000]

    Original fps

    infrc = %d [default 0]

    Original frc

    buffer = %d [default 5]

    How many frames to buffer

    subsample = %d [default 32]

    How many pixels to subsample

    clonetype = %d [default 0]

    How to clone frames

    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.

  • strength = %d [default 100]

    How much of the effect

    threshold = %d [default 10]

    How close a pixel must be to the brightest or dimmest pixel to be mapped

    highq = %d [default 1]

    Tradeoff speed for quality of detail detection

    mask = %d [default 0]

    Areas to be sharpened are shown in white

    • This plugin implements an unusual concept in spatial sharpening. 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]
          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 detection. Set it to false for maximum speed.
      

normalize - Volume normalizer

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

  • smooth = %f [default 0.06]

    Value for smoothing ]0.0 1.0[

    smoothlast = %f [default 0.06]

    Value for smoothing last sample ]0.0, 1.0[

    algo = %d [default 1]

    Algorithm to use (1 or 2). 1=uses a 1 value memory and coefficients 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-processing filter.

  • hb = %d:%d [default 64:40]

    Horizontal deblocking filter

    vb = %d:%d [default 64:40]

    Vertical deblocking filter

    h1 (bool)

    Experimental h deblock filter 1

    v1 (bool)

    Experimental v deblock filter 1

    dr (bool)

    Deringing filter

    al (bool)

    Automatic brightness / contrast

    f (bool)

    Stretch luminance to (0..255)

    lb (bool)

    Linear blend deinterlacer

    li (bool)

    Linear interpolating deinterlace

    ci (bool)

    Cubic interpolating deinterlacer

    md (bool)

    Median deinterlacer

    de (bool)

    Default preset (hb:a/vb:a/dr:a/al)

    fa (bool)

    Fast preset (h1:a/v1:a/dr:a/al)

    tn = %d:%d:%d [default 64:128:256]

    Temporal Noise Reducer (1<=2<=3)

    fq = %d [default 15]

    Force quantizer

    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 filter.

  • cache = %d [default 15]

    Number of raw frames to cache for seeking

    skip = %d [default 0]

    display only every Nth frame

    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 coordinates 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.

      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.

  • 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.

    • This filter produces a simple slow-motion effect by duplicating 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 version 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.

  • motionOnly = %d [default 0]

    Show motion areas only

    shiftEven = %d [default 0]

    Blend instead of interpolate in motion areas

    threshold = %d [default 12]

    Motion Threshold

    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.

  • motionOnly = %d [default 0]

    Show motion areas only

    Blend = %d [default 0]

    Blend instead of interpolate in motion areas

    threshold = %d [default 15]

    Motion Threshold

    scenethreshold = %d [default 100]

    Scene Change Threshold

    fieldShift = %d [default 0]

    Phase shift

    inswap = %d [default 0]

    Field swap before phase shift

    outswap = %d [default 0]

    Field swap after phase shift

    noMotion = %d [default 0]

    Disable motion processing

    highq = %d [default 0]

    Motion map denoising for field-only

    diffmode = %d [default 0]

    Motion Detection (0=frame, 1=field, 2=both)

    colordiff = %d [default 1]

    Compare color channels instead of luma

    cubic = %d [default 0]

    Use cubic for interpolation

    • 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.

  • motionOnly = %d [default 0]

    Show motion areas only, blacking out static areas

    diffmode = %d [default 0]

    Motion Detection (0=frame, 1=field, 2=both)

    threshold = %d [default 14]

    Motion Threshold (luma)

    chromathres = %d [default 7]

    Motion Threshold (chroma)

    scenethres = %d [default 31]

    Threshold for detecting scenechanges

    highq = %d [default 1]

    High-Quality processing (motion Map denoising)

    cubic = %d [default 1]

    Do cubic interpolation

    Blend = %d [default 1]

    Blend the frames for deinterlacing

    doChroma = %d [default 1]

    Enable chroma processing (slower but more accurate)

    verbose = %d [default 0]

    Verbose mode

    • This filter is basically a rewrite of the smartdeinter filter 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:chromathres=4:threshold=8:doChroma=1

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.

  • strength = %f [default 0.25]

    Blending factor

    cdiff = %d [default 6]

    Max difference in chroma values

    ldiff = %d [default 8]

    Max difference in luma value

    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 operation. Usually smoothing is done by talking the data of previous 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.

  • 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.

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

    apply filter to [start-end]/step frames

    string = %s

    text to display (no ':') [defaults to `date`]

    font = %s

    full path to font file [defaults to arial.ttf]

    points = %d [default 25]

    size of font (in points)

    dpi = %d [default 96]

    resolution of font (in dpi)

    fade = %d [default 0]

    fade in/out (0=off, 1=slow, 10=fast)

    antialias = %d [default 1]

    Anti-Alias text (0=off 1=on)

    pos = %dx%d [default 0x0]

    Position (0-width x 0-height)

    posdef = %d [default 0]

    Position (0=None 1=TopL 2=TopR 3=BotL 4=BotR 5=Cent 6=BotCent)

    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.

  • TopFirst = %d [default 1]

    Assume the top field should be displayed first

    SearchEffort = %d [default 15]

    CPU time used to find moved pixels

    UseStrangeBob = %d [default 0]

    ?Unknown?

    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.

  • amount = %f [default 0.0]

    Luma and chroma (un)sharpness amount

    matrix = %dx%d [default 0x0]

    Luma and chroma search matrix size

    luma = %f [default 0.0]

    Luma (un)sharpness amount

    chroma = %f [default 0.0]

    Chroma (un)sharpness amount

    luma_matrix = %dx%d [default 0x0]

    Luma search matrix size

    chroma_matrix = %dx%d [default 0x0]

    Chroma search matrix size

    pre = %d [default 0]

    run as a pre filter

    • This filter blurs or sharpens an image depending on the sign of "amount". You can either set amount for both luma and chroma or you can set it individually (recommended). A positive 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 balance

whitebalance was written by Guillaume Cottenceau. The version documented 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.

  • level = %d [default 40]

    Level of blue-to-yellow white balance shifting (can be negative)

    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 version documented here is (1.0b2) (2003-02-12). This is a video filter. It can handle RGB and YUV mode. It is a post-processing only filter.

  • strength = %d [default 200]

    How much of the effect

    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.
      
        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-processing or as a post-processing filter.

  • radius = %d [default 8]

    Search radius

    threshold = %d [default 5]

    Denoiser threshold

    pp_threshold = %d [default 4]

    Pass II threshold

    delay = %d [default 3]

    Average 'n' frames for a time-lowpassed pixel

    postprocess = %d [default 1]

    Filter internal postprocessing

    luma_contrast = %d [default 100]

    Luminance contrast in percent

    chroma_contrast = %d [default 100]

    Chrominance contrast in percent.

    sharpen = %d [default 125]

    Sharpness in percent

    deinterlace = %d [default 0]

    Force deinterlacing

    mode = %d [default 0]

    [0]: Progressive [1]: Interlaced [2]: Fast

    scene_thres = %d%% [default 50]

    Blocks where motion estimation should fail before scenechange

    block_thres = %d [default 1024]

    Every SAD value greater than this will be considered bad

    do_reset = %d [default 2]

    Reset the filter for `n' frames after a scene

    increment_cr = %d [default 2]

    Increment Cr with constant

    increment_cb = %d [default 2]

    Increment Cb with constant

    border = %dx%d-%dx%d [default 0x0-32x32]

    Active image area

    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 version documented here is v0.1.0 (2003-01-24). This is a video filter. It can handle YUV mode only. It can be used as a pre-processing or as a post-processing filter.

  • radius_luma = %d [default 2]

    Radius for median (luma)

    radius_chroma = %d [default 2]

    Radius for median (chroma)

    threshold_luma = %d [default 2]

    Trigger threshold (luma)

    threshold_chroma = %d [default 2]

    Trigger threshold (chroma)

    interlace = %d [default 0]

    Treat input as interlaced

    pre = %d [default 1]

    Run as a PRE filter

AUTHORS

transcode was written by Thomas Oestreich

<[email protected]> with contributions from many others. See AUTHORS for details.

RELATED TO transcode_filter…