Back to FabImage Library website

You are here: Start » Function Reference » Image » Image Metrics » ColorDistance_CIE94

ColorDistance_CIE94


Header: FIL.h
Namespace: fil
Module: FoundationPro

Compares two pixels using CIE94 delta E. Assumes RGB color space.

Syntax

C++
C#
 
void fil::ColorDistance_CIE94
(
	const fil::Pixel& inPixelA,
	const fil::Pixel& inPixelB,
	const float inKL,
	const float inKC,
	const float inKH,
	const float inK1,
	const float inK2,
	float& outDistance
)

Parameters

Name Type Range Default Description
Input value inPixelA const Pixel&
Input value inPixelB const Pixel&
Input value inKL const float 0.0 - 1.0f The luminance weighting factor (best to use 1.0 for graphic arts and 2.0 for textiles)
Input value inKC const float 0.0 - 1.0f The chroma weighting factor (usually 1.0)
Input value inKH const float 0.0 - 1.0f The hue weighting factor (usually 1.0)
Input value inK1 const float 0.0 - 1.0 0.045f The secondary chroma weighting factor (best to use 0.045 for graphic arts and 0.048 for textiles)
Input value inK2 const float 0.0 - 1.0 0.015f The secondary luminance weighting factor (best to use 0.015 for graphic arts and 0.014 for textiles)
Output value outDistance float&

Errors

List of possible exceptions:

Error type Description
RuntimeError Each pixel component must be nonnegative in ColorDistance_CIE94.