Colour tools - Version 2.0.0#

Module Summary#

Colour helper tools, used to convert between colour spaces.

Module Status#

This IO Module is stable and has been tested internally.

If you encounter any issues with this module, or have any feedback regarding its operation, please contact our support team.

Release Notes#

Version 2.0#

Initial release.

Minor point releases (eg. 1.1.x) will be for small fixes and may not be listed here.

Operation#

All functions are implemented as Conditions, allowing the variables captured by the Trigger to be adjusted before being passed to the Action. As such, if the Condition is set to negate, the Trigger will not fire.

In all modification Conditions, the modified value does not replace the existing variable; it will be added to the end of the Trigger table. In order to confirm the captured and modified variables, check Controllers logs. Multiple Conditions can be used to perform multiple modifications, but a new variable is created each time, so care must be taken with the variable numbers being used.

Note: If you are using multiple Controllers in a project, you will need to ensure that the Trigger has been set to Test Conditions on the Controllers that has been set to be the Network Primary in your project.

Conditions#

CCT to Byte#

Input	Correlated color temperature (CCT)	1000-25000 kelvin
Output	Normalised from Maximum and Minimum and scaled using Scaling	0-255

CCT to DALI DT8(Tc)#

Input	Correlated color temperature (CCT)	1000-25000 kelvin
Output	Suitable for passing to action `Set DALI Output`	0-255

CCT to Mired#

Input	Correlated color temperature (CCT)	1000-25000 kelvin
Output	Micro reciprocal degree (Mired)	Reciprocal megakelvin (MK⁻¹)

CCT to RGB#

Input	Correlated color temperature (CCT)	1000-25000 kelvin
Output	RGB in the selected `Model` and applied `Gamma`	0-255^a, 0-255^a, 0-255^a

^aScaled to fit 0-255

CCT to XYZ#

Input	Correlated color temperature (CCT)	1000-25000 kelvin
Output	CIE 1931 XYZ	0.0-1.0, 0.0-1.0, 0.0-1.0

CCT to xyY#

Input	Correlated color temperature (CCT)	4000-25000 kelvin
Output	CIE 1931 xyY	0.0-1.0, 0.0-1.0, 0.0-1.0

Mired to CCT#

Input	Micro reciprocal degree (Mired)	Reciprocal megakelvin (MK⁻¹)
Output	Correlated color temperature (CCT)	kelvin

RGB to XYZ#

Input	RGB in the selected `Model` and applied `Gamma`	0-255, 0-255, 0-255
Output	CIE 1931 XYZ in the selected `White point`	0.0-1.0, 0.0-1.0, 0.0-1.0

RGB to xyY#

Input	RGB in the selected `Model` and applied `Gamma`	0-255, 0-255, 0-255
Output	CIE 1931 xyY in the selected `White point`	0.0-1.0, 0.0-1.0, 0.0-1.0

XYZ to RGB#

Input	CIE 1931 XYZ in the selected `White point`	0.0-1.0, 0.0-1.0, 0.0-1.0
Output	RGB in the selected `Model` and applied `Gamma`	0-255^a, 0-255^a, 0-255^a

^aRange can be exceeded if the input is outside of the selected RGB model gamut.

XYZ to xyY#

Input	CIE 1931 XYZ	0.0-1.0, 0.0-1.0, 0.0-1.0
Output	CIE 1931 xyY	0.0-1.0, 0.0-1.0, 0.0-1.0

xyY to RGB#

Input	CIE 1931 xyY in the selected `White point`	0.0-1.0, 0.0-1.0, 0.0-1.0^a
Output	RGB in the selected `Model` and applied `Gamma`	0-255^b, 0-255^b, 0-255^b

^aDefaults to 1.0 (aka 100%)
^bRange can be exceeded if the input is outside of the selected RGB model gamut.

xyY to XYZ#

Input	CIE 1931 xyY	0.0-1.0, 0.0-1.0, 0.0-1.0^a
Output	CIE 1931 XYZ	0.0-1.0, 0.0-1.0, 0.0-1.0

^aDefaults to 1.0 (aka 100%)

Support#

If you encounter any issues with this module, please contact our support team.