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

UPDATE: 2017-09-30

Added 64bit versions for Resolume v6.
Improved alpha transparency support.


IMAGE DESCRIPTION

The product images show test screenshots with a few different scenes in Resolume Arena (version 5.1.4). The left side of the image is without the effect, the right side of the image is with the effect. The effect settings are the same in each example; different looks can be obtained by selecting different colour combinations.

spxlTriTone v2.0


DESCRIPTION

spxlTriTone plugins by subpixel ([email protected])

[spxlTriTone] is a tritone colour mapping FFGL effect plugin for Windows versions of Resolume Arena and Resolume Avenue (and possibly other FFGL host programs). There are three variants:

[spxlTriTone] is built specifically for Resolume v6 (it uses FFGL parameter types specifiv to Resolume), and utilises the new Resolume colour picker widger (which has HSB, RGB and palette pickers). Note that the "Alpha" sliders in the coour pickers are *not* utilised by this effect.

[spxlTriToneRGB] presents three sets of RGB sliders (red, green, blue colour components) to select the three tones. The sliders are coloured in the Resolume v6 interface, but otherwise appear as regular sliders.

[spxlTriToneHSB] presents three sets of HSB sliders (hue, saturation, brightness colour components) to select the three tones.

All three variants produce the same output result; they simply allow differing means of selecting the three tones used.


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 versions of the DLL files need to be in directories that 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 files to the directories listed or add the directories the files are in to the list in Resolume's Preferences. 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.

These 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.


USAGE

Locate [spxlTriTone], [spxlTriToneHSB] and/or [spxlTriToneRGB] in the [Video | FFGL] list of the [Effects] tab. The effect(s) 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").

Each effect has parameters to set three tones (colours). The luminance from the input image/video is mapped to these three tones (with gradients between them). The location of the mid point can be set anywhere between the black point and the white point to create a bias of the black point tone or white point tone colour in the result.


PLUGIN DETAILS


spxlTriToneRGB

Plugin unique ID: _TT1
Plugin name: spxlTriToneRGB
Plugin type: Effect
Description: Tri tone colour mapping with three colours specified by Red, Green and Blue values. The Mid point parameter moves the position of the second colour on the luminance range

Windows 32bit (for Resolume v5 and below)

Filename: spxlTriToneRGB-v2.0-x86.dll
File size: 264 KB (270,848 bytes)
Build date: 2017-09-30
About: v2.0 (x86) by subpixel ([email protected])

Windows 64bit (for Resolume v6 and above)

Filename: spxlTriToneRGB-v2.0-x64.dll
File size: 342 KB (350,208 bytes)
Build date: 2017-09-30
About: v2.0 (x64) by subpixel ([email protected])

[spxlTriToneRGB] is a FFGL effect that tone maps the luminance of the image between three provided colours
(called "Black", "Mid" and "White", referring to the luminance ranges mapped).

Each of the three colous can be set with independent Red, Green and Blue colout components. There is an additional slider to set the position of the "midpoint"; that is to say the luminance at which the "Mid" colour is used.

The effect may work with FFGL host programs besides Resolume Avenue and Arena, though I have not tested any.

Parameters

[Black Red] is the red colour component for the black point
[Black Green] is the green colour component for the black point
[Black Blue] is the blue colour component for the black point

[Mid Red] is the red colour component for the mid point
[Mid Green] is the green colour component for the mid point
[Mid Blue] is the blue colour component for the mid point

[White Red] is the red colour component for the white point
[White Green] is the green colour component for the white point
[WHite Blue] is the blue colour component for the white point

[Mid Position] is the position of the mid point in the luminance range where 0 represents the black point and 1 represents the white point.



spxlTriToneHSB

Plugin unique ID: _TT2
Plugin name: spxlTriToneHSB
Description: Tri tone colour mapping with three colours specified by Hue, Saturation and Brightness values. The Mid point parameter moves the position of the second colour on the luminance range

Windows 32bit (for Resolume v5 and below)

Filename: spxlTriToneHSB-v2.0-x86.dll
File size: 265 KB (271,872 bytes)
Build date: 2017-09-30
About: v2.0 (x86) by subpixel ([email protected])

Windows 64bit (for Resolume v6 and above)

Filename: spxlTriToneHSB-v2.0-x64.dll
File size: 342 KB (350,720 bytes)
Build date: 2017-09-30
About: v2.0 (x64) by subpixel ([email protected])

[spxlTriToneHSB] is a FFGL effect that tone maps the luminance of the image between three provided colours (called "Black", "Mid" and "White", referring to the luminance ranges mapped).

Each of the three colous can be set with independent Hue, Saturation and Brightness colour components. There is an additional slider to set the position of the "midpoint"; that is to say the luminance at which the "Mid" colour is used.

Note regarding hues: the colour gues are on a circular colour wheel starting with red (at 0.0), and progressing through yellow, green, cyan, blue, magenta and back to red (at 1.0).

Parameters

[Black Hue] is the hue colour component for the black point.
[Black Sat.] is the saturation colour component for the black point
[Black Bright.] is the brightness colour component for the black point

[Mid Hue] is the hue colour component for the mid point
[Mid Sat.] is the saturation colour component for the mid point
[Mid Bright.] is the brightness colour component for the mid point

[White Hue] is the hue colour component for the white point
[White Sat.] is the saturation colour component for the white point
[WHite Bright.] is the brightness colour component for the white point

[Mid Position] is the position of the mid point in the luminance range where 0 represents the black point and 1 represents the white point.



spxlTriTone

Plugin unique ID: _TT3
Plugin name: spxlTriTone
Description: Tri tone colour mapping with three colours specified by colour pickers (Red, Green, Blue; or Hue, Saturation, Brightness; or the colour palettes). The Mid point parameter moves the position of the second colour on the luminance range

This plugin has no 32 bit version for Windows.

Windows 64bit (for Resolume v6 and above)

Filename: spxlTriTone-v2.0-x64.dll
File size: 342 KB (350,720 bytes)
Build date: 2017-09-30
About: v2.0 (x64) by subpixel ([email protected])

[spxlTriTone] is a FFGL effect that tone maps the luminance of the image between three provided colours
(called "Black", "Mid" and "White", referring to the luminance ranges mapped).

Each of the three colous can be set using the Resolume colour picker widgets, either the Red, Green, Blue sliders, Hue, Saturation, Brightness sliders, or the colour picker or colour palette. There is an additional slider to set the position of the "midpoint"; that is to say the luminance at which the "Mid" colour is used.

Note regarding hues: the colour gues are on a circular colour wheel starting with red (at 0.0), and progressing through yellow, green, cyan, blue, magenta and back to red (at 1.0).

Parameters

[Black Tone] is the colour for the black point.

[Mid Tone] is the colour for the mid point

[White Tone] is the colour for the white point

[Mid Position] is the position of the mid point in the luminance range where 0 represents the black point and 1 represents the white point.

____________________________________________________________
Powered by