R38 – BoxBlur is Best Blur

This release is mostly kind of a bug fix with minor enhancements as well. Nothing exciting but the restrictions of several filters were re-examined and relaxed a bit to match what the actual code can handle. As a result Transpose doesn’t care about subsampling anymore, horizontal and vertical convolutions have a larger element limit and AverageFrames can average over even more frames. Not very exciting at all for most people.

The other part is the addition of a box blur filter. The main attraction is that it can be used to approximate large radius Gaussian blurs very quickly. Or simply a large area average.

This release dragged on for far too long.

Possibly breaking changes:

  • ImageMagick7 is now required for the imwri plugin
  • Visual Studio 2017 is now officially required to build on windows

R37 – Maintaining Things Again

R37 has been released. It’s mostly just a collection of bug fixes. Ironically the Avisynth 2.6 API was the cause of several of them in AVFS. Expect a long rant about this later.

Note: Both the installer and portable archives were updated to fix various compilation issues so if you experience crashes on resizing/missing dll errors you should re-download.

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