R34 – Being Nice to Avisynth

I actually did test this release. I mean it. Not like the previous one where only the core parts got tested. Anyway, this release fixes all known regressions that appeared in R33 and optimizes several internal functions. It also adds support for handling pre-multiplied alpha in MaskedMerge and a PreMultiply filter to apply it.

VSFS was removed and replaced with AVFS, importing all improvements such as faster mount speed and other fixes. The codebase was also unified for both Avisynth and VapourSynth to make maintaining it less annoying in the future. But wait! There’s more! When using recent Avisynth+ builds it can now output exactly the same high bitdepth formats as VapourSynth! Interestingly this makes AVFS considerably better than the current VFW output of Avisynth+.

Possibly breaking changes:

  • Temporalsoften plugin no longer included because it’s horrible, use FrameAverage from miscfilter instead
  • AVFS doesn’t have shell integration unlike the older VSFS

Blindly Copying Avisynth Considered Harmful

Some Avisynth filters are really, really popular and show up many scripts. Some of them like RemoveGrain and TemporalSoften have even been ported because they’re useful and used in so many scripts.

…But what is TemporalSoften really used for?

TemporalSoften is the definition of cargo cult programming, its code and concept gets copied over and over again and nobody knows exactly why. Let’s start with a few facts:

  • TemporalSoften is a horribly bad temporal smoother even compared to its competition over 10 years ago
  • TemporalSoften has never been used to unironically denoise anything the past 10 years

With these facts in mind you have to wonder why anyone’d ever put it in a script from the past decade. The answer is simple, if you set the denoising thresholds to their max values you get a filter that averages an odd number of frames. If you’re creative you can blend several frames with different weights. That’s actually kinda useful sometimes. So useful someone already wrote an Avisynth plugin for it. It’s a shame that it was fairly quickly forgotten. Unfortunately nobody who ported TemporalSoften to VapourSynth stopped to think about what it was actually used for and instead a very optimized version of TemporalSoften was created. And rewritten. And optimized a bit more. Because why not?

To try to counter this madness I’ve made a collection of small useful and experimental functions available. The first version can be found in this thread. Go try it and stop blending frames with TemporalSoften.

Stop Using RemoveGrain

RemoveGrain is kind of an abomination as a filter. Mostly because it has over 20 different modes that effectively are different filters. These are probably just numbered in the order the author came up with them and this can be very confusing. Having that many modes also leads to the big question of what these modes actually do and which ones are actually used. A quick check showed that modes 2, 4, 11, 12, 19 and 20 are the most common (most other modes are useless and/or pointless in case you’re wondering).

Mode 2: 3×3 clipping operation with no nice name

Mode 4: 3×3 median

Mode 11&12: 3×3 convolution using [1 2 1, 2 4 2, 1 2 1]

Mode 19: 3×3 convolution using [1 1 1, 1 0 1, 1 1 1]

Mode 20: 3×3 convolution using [1 1 1, 1 1 1, 1 1 1]

If you’re paying attention you can easily see that all except mode 2 are easily replaceable by easier to read functions that support more input formats. Go do that!

R33 – A Somewhat Experimental Release

What’s to experimental in this release you ask? Basically all the code got modified. Everywhere. To re-factor and optimize things. The most important improvements are:

  • 8-bit and 16-bit integer and float support in all core functions where it makes sense
  • Many commonly used core functions were optimized (Median, Minimum, Maximum, Inflate, Deflate, Convolution)
  • The internal resizers can now have the active region set to achieve things like subpixel shifts
  • VSFS was removed and replaced by AVFS, this AVFS version works with both VapourSynth and Avisynth and has all the latest changes
  • The Python installation to use can now be selected in the installer
  • Release builds are now mostly compiled with clang-cl for improved speed

There are also a few important compatibility related changes from previous versions:

  • AVFS works very differently from VSFS (command line vs shell integration) but can still accomplish more or less the same thing
  • PlaneStats function had the MinMax property split into separate Min and Max
  • GenericFilters is no longer included because the core functions plus the TCanny plugin can now replace 99% of its uses
  • AssVapour was renamed to SubText and uses the sub namespace now

R32 – Interlaced Resizing is Evil

But we added it anyway. Seriously people, just say no to interlaced material. Or de-interlace it properly. And you should all update since a bug that caused caches to not always be automatically inserted where they should be was fixed.

Breaking changes:

Progressive material that’s encoded as interlaced (far too common) may now by default have interlaced resizing applied to it. Use core.std.SetFieldBased(clip, 0) to easily flag it as progressive before resizing.

PlaneAverage has now been removed. Use PlaneStats instead.

VSPipe outputs planar RGB in the GBR plane order now to match what other programs expect as input.

2016-03-26 12.09.00

Unsuspecting flowers having nothing to do with this post