buildRgbSolveMatrixQ16()

bool fl::buildRgbSolveMatrixQ16	(	const colorimetric_response::EmitterProfile &	profile,
		EmitterSolveMatrixQ16 *	out )

Invert the emitter matrix for a three-emitter profile.

The profile stores float; its fields are converted by their bits (q16FromFloatBits) and the build is buildRgbSolveMatrixFromQ16, so this links no float runtime either (FastLED#4458).

False when the emitter chromaticities are non-finite, degenerate, or collinear, any of which makes the matrix singular and the solve meaningless.

Definition at line 355 of file device_solve.cpp.hpp.

                                                                     {
    if (out == nullptr) {
        return false;
    }
    // The profile stores float; its fields come across by their bits, and
    // the whole derivation runs in s16.16 (FastLED#4458). The Q16 build
    // refuses what the float one did: a non-positive or out-of-simplex
    // chromaticity, a non-positive luminance, a singular matrix -- and NaN,
    // infinity or an out-of-range value never gets past the conversion.
    EmitterChromaticitiesQ16 q16;
    if (!q16FromFloatBits(profile.xy_r[0], &q16.xy_r[0]) ||
        !q16FromFloatBits(profile.xy_r[1], &q16.xy_r[1]) ||
        !q16FromFloatBits(profile.xy_g[0], &q16.xy_g[0]) ||
        !q16FromFloatBits(profile.xy_g[1], &q16.xy_g[1]) ||
        !q16FromFloatBits(profile.xy_b[0], &q16.xy_b[0]) ||
        !q16FromFloatBits(profile.xy_b[1], &q16.xy_b[1]) ||
        !q16FromFloatBits(profile.lum_r, &q16.lum_r) ||
        !q16FromFloatBits(profile.lum_g, &q16.lum_g) ||
        !q16FromFloatBits(profile.lum_b, &q16.lum_b)) {
        return false;
    }
    return buildRgbSolveMatrixFromQ16(q16, out);
}

References buildRgbSolveMatrixFromQ16(), FL_NO_EXCEPT, and q16FromFloatBits().

Referenced by buildGamutMapQ16(), buildGamutMapRgbwQ16(), buildGamutMapRgbwwQ16(), buildStreamingPipelineQ16(), buildTwoWhiteAllocationQ16(), and buildWhiteAllocationQ16().

Here is the call graph for this function:

Here is the caller graph for this function: