spxlAutoMask - 32bit and 64bit FFGL Effect Plugins for Resolume Arena and Resolume Avenue (Windows)

UPDATE: 2017-10-05

Fixed a problem relating to premultiplied alpha.


VIDEO DESCRIPTION

The video shows the [spxlAutoMask] effect on the left side and the original Resolume [Auto Mask] effect on the right side. Individual scenes were created live using the Record function within Resolume Arena v6 (Beta), and assembled in Adobe Premiere without further colour, etc processing. The clips with the two versions of the effect are overlaid on a chequerboard pattern background to make the transparency obvious and mirrored to make the left/right comparison less stressful. The "slider" in the middle visualises the [Upper] parameter (value range: 1.0 to 0.5) for [spxlAutoMask] .and the [Contrast] parameter (value range: 0.5 to 1.0) for Resolume's [Auto Mask].


IMAGE DESCRIPTION

The three product images show a test composition with two active layers in Resolume Arena (version 5.1.4). The first layer has a lines effect for a nice contrasty background. The second is an opaque layer consisting of the coloured cubes on black background image, with the Blend Mode set to [Alpha] (Opacity = 1). The second product image shows the result of applying the original [Auto Mask] effect (Contrast = 1) to the second layer. The third product image shows the result of applying the new [spxlAutoMask] effect (default parameters: Lower = 0, Upper = 0.875).


spxlAutoMask v2.1



DESCRIPTION

[spxlAutoMask] is a replacement effect plugin for the [Auto Mask] effect that comes with Resolume Avenue and Resolume Arena. The [Auto Mask] effect is one that I use very often, and the version I have made looks a lot nicer to me. Remember the colour blue? The original [Auto Mask] doesn't make the brightest blues "solid", even with the [Contrast] parameter set to maximum. [spxlAutoMask] can give you your blues back, and also remove some nasty fringing effects that the orirignal introduced with high [Contrast] settings.

There is a demonstration video showing a comparison between [spxlAutoMask] and Resolume's [Auto Mask] on YouTube:

spxlAutoMask FFGL Plugin demo | SPXL
-- https://www.youtube.com/watch?v=yl8jwz025x8


INSTALLATION

Resolume v6 is 64 bit software. Prior versions are 32 bit software. Resolume v6 therefore requires 64 bit plugins (x64) and previous versions require 32 bit plugins (x86).

The correct version of the DLL file needs to be in a directory that your version Resolume looks in for video plugins when it starts. The [FreeFrame (FFGL) Plugin Directories] are listed in Resolume's [Preferences] in the [Video] Section.

Either copy the relevant DLL file to one of the directories listed or add the directory it is in to the list. If you add the file or the directory after Resolume is started, you need to quit and load again. Don't forget to save what you were working on, supposing you may have been changing other things.

The original v1.1 (x86) plugin will probably work with 32 bit FFGL host programs besides Resolume Avenue and Arena; no other hosts have been tested.

The newer v2.1 plugins may not work with other FFGL host programs since the SDK has been modified by the Resolume team; no other hosts have been tested.

You should only place one of the x86 plugin DLL files in the Resolume video plugin folder. They should both work for Resolume v5; the main difference is that the older version is a smaller file.


USAGE

Usage is very similar to the [Auto Mask] effect that comes with Resolume Avenue and Arena. Locate [spxlAutoMask] in the [Video | FFGL] list of the [Effects] tab. The effect may be at the end of the list (after [Wave Warp]), since character code ordering is used instead of dictionary ordering. (Lower case "a-z" come after upper case "A-Z").

The effect makes most sense when applied to an individual clip (including as an effect clip) or to a layer. The effect can be applied in the [Composition] tab, and that may offer some creative options with layering [Advanced Output] slices.

The parameters [Lower] and [Upper] set boundaries outside of which the alpha value is clamped to 0 and 1 (fully transparent, and fully opaque, respectively).

As you increase the [Lower] parameter from zero, darker areas of your image will begin to disappear, similar to the [Pixel Low Pass] effect. As you decrease the [Upper] parameter from 1, more of the lighter areas of your image will remain opaque.

It is possible to set the [Lower] and [Upper] values such that [Lower] is greater than [Upper]. The effect does not crash, but it is probably not a nice result. A choice was made to allow the user (you!) to "do the wrong thing"; since there is no obvious nor easy way to change the user interface within Resolume, this is the easiest way to deal with it. An alternative would be to make the [Lower] parameter value represent a fraction of the [Upper] parameter value; the problem with that approach is that changing the [Upper] parameter then affects both the uppper and lower cutoff values, which may not be desirable.


PLUGIN DETAILS


Windows 32 bit

Plugin built using FreeFrameGL SDK 1.5
See FreeFramGL-SDK-License.txt for license information

Plugin unique ID: _AM1
Plugin name: spxlAutoMask
Plugin type: Effect
Description: Create an alpha channel from the RGB values for each pixel
About: v1.2 (x86) by subpixel ([email protected])

Filename: SpxlAutoMask-v1.2-x86.dll
File size: 21.0 KB (21,504 bytes)
Build date: 2017-10-05



Updated plugin, built using the FFGL repository supplied by Resolume
See https://github.com/resolume/ffgl

Plugin unique ID: _AM1
Plugin name: spxlAutoMask
Plugin type: Effect
Description: Create an alpha channel from the RGB values for each pixel
About: v2.2 (x86) by subpixel ([email protected])

Filename: SpxlAutoMask-v2.2-x86.dll
File size: 263 KB (269,824 bytes)
Build date: 2017-10-05

Windows 64 bit

Built using the FFGL repository supplied by Resolume
See https://github.com/resolume/ffgl

Plugin unique ID: _AM1
Plugin name: spxlAutoMask
Plugin type: Effect
Description: Create an alpha channel from the RGB values for each pixel
About: v2.2 (x64) by subpixel ([email protected])

Filename: SpxlAutoMask-v2.2-x64.dll
File size: 340 KB (348,160 bytes)
Build date: 2017-10-05
Powered by