Bifrost plugin for Vapoursynth (and Avisynth)
Clone or download
Latest commit 3082823 Aug 13, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Avoid double free Aug 13, 2016
.gitignore Delete config.{guess,sub} Aug 13, 2016
Makefile.am Add build system Nov 7, 2013
autogen.sh Add build system Nov 7, 2013
configure.ac Add build system Nov 7, 2013
readme.rst Update readme.rst Nov 7, 2013

readme.rst

Description

Bifrost is a temporal derainbowing filter created by Fredrik Mellbin.

The original Avisynth plugin (version 1.1) worked on the whole frame or not at all. This version works on blocks, meaning that static parts of the image can be processed even if something moves on screen.

The VapourSynth plugin will accept any 8 bit YUV formats. The Avisynth plugin is still limited to YV12.

Usage

bifrost.Bifrost(clip clip[, clip altclip=clip, float luma_thresh=10.0, int variation=5, bint conservative_mask=False, bint interlaced=True, int blockx=4, int blocky=4])
  • altclip

    Bifrost will copy from this clip the chroma of the blocks it can't process. This allows moving blocks to be processed with some other filter. altclip must have the same format, dimensions and length as clip.

  • luma_thresh

    Blocks where the luma changes less than this are considered static and may be processed.

  • variation

    Controls how big a chroma change must be in order to be considered a rainbow. Increasing this can reduce false positives.

  • conservative_mask

    If true, only pixels detected as rainbows will be processed. Otherwise, pixels that have rainbows above and below them will also be processed.

  • interlaced

    If true, SeparateFields, DoubleWeave and SelectEvery will be invoked in order to process the top and bottom fields separatedly.

  • blockx

  • blocky

    The dimensions of the blocks. Smaller is probably better. The default 4×4 should be good enough.

Note: If the dimensions of the image aren't divisible by blockx and blocky, the right and/or bottom edges won't be processed. Pad or crop the image before using Bifrost.

Types of rainbows

When dealing with telecined material you must determine if the rainbows were added before or after the telecine process. Find a scene with clearly visible rainbows and use the following:

src = your.Source()
separated = std.SeparateFields(src)
even = std.SelectEvery(separated, 2, 0)

If the rainbows change every frame, they were added after telecine. If there is a duplicate every five frames, they were added before.

Rainbows added before telecine

First you must fix the telecine, then use Bifrost in progressive mode:

ret = d2v.Source("rainbows1.d2v")
ret = vivtc.VFM(ret, order=1, chroma=False, mchroma=False)
ret = vivtc.VDecimate(ret, chroma=False)
ret = bifrost.Bifrost(ret, interlaced=False)

Rainbows added after telecine

In this case, Bifrost should be used in interlaced mode, right after the source filter:

ret = d2v.Source("rainbows2.d2v")
ret = bifrost.Bifrost(ret, interlaced=True)
# ivtc here

Compilation

./autogen.sh
./configure
make

DLLs for VapourSynth and for Avisynth 2.5.8+ can be found in the "releases" section.