This is a quick bugfix release. It fixes an incorrect output bug in 3×3 (and smaller) convolutions and several AVFS output issues that were carried over from the original code. You should update.
Why do we need a trigger warning you ask? Because the mere idea of FFMS2 being updated is a big shock to most people? No. In fact it was caused by me once again declaring that XP is a dead end. This time using slightly different wording. If you meet any of these unfortunate users in real life don’t tell them that XP support ended long ago. They may go on a violent rampage or even worse, be offended.
Also a pile of bugs got fixed but nobody actually cares about that, after all we’ve now got a controversy surrounding this release and that’s more interesting.
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
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.
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!
Already a new release because I created a memory leak in filters like Invert and Binarize. Update OR DIE!
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
It’s once again time to slow down in development. It’s a bit of a tradition around here. Maybe I’ll make R33 a really small bugfix release but don’t expect big changes to happen for a while.
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.
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.
All code is bug free until someone else tries to run it. It’s a scientific fact!
This release fixes all known resizer issues that have been discovered so far. Fortunately none of them led to image corruption, just incorrect rejection of certain conversions.
And it can’t be a release without warning about something that’s slightly changed in some way. So here comes the warning. The installer now writes the registry keys related to the 64bit version into HKLM64 which makes more sense. All the old entries will also be kept until everyone has switched to the new ones. This is in preparation of the day the 32bit VapourSynth windows version stops existing, which unfortunately won’t be anytime soon despite it being over 12 years since we got x64.