Source/WebCore/platform/graphics/ColorSerialization.cpp

/*
 * Copyright (C) 2020-2021 Apple Inc. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 * THE POSSIBILITY OF SUCH DAMAGE.
 */

#include "config.h"
#include "ColorSerialization.h"

#include "Color.h"
#include <wtf/Assertions.h>
#include <wtf/HexNumber.h>
#include <wtf/MathExtras.h>
#include <wtf/text/StringBuilder.h>
#include <wtf/text/StringConcatenateNumbers.h>

namespace WebCore {

struct NumericComponent { float value; };
struct PercentageComponent { float value; };

static NumericComponent numericComponent(float value)
{
    return { value };
}


static PercentageComponent percentageComponent(float value)
{
    return { value };
}

};

namespace WTF {

template<> class StringTypeAdapter<WebCore::NumericComponent> {
public:
    StringTypeAdapter(WebCore::NumericComponent number)
    {
        if (std::isnan(number.value)) {
            m_buffer = { 'n', 'o', 'n', 'e' };
            m_length = 4;
        } else {
            numberToString(number.value, m_buffer);
            m_length = std::strlen(&m_buffer[0]);
        }
    }

    unsigned length() const { return m_length; }
    bool is8Bit() const { return true; }
    template<typename CharacterType> void writeTo(CharacterType* destination) const { StringImpl::copyCharacters(destination, buffer(), m_length); }

private:
    const LChar* buffer() const { return reinterpret_cast<const LChar*>(&m_buffer[0]); }

    NumberToStringBuffer m_buffer;
    unsigned m_length;
};

template<> class StringTypeAdapter<WebCore::PercentageComponent> {
public:
    StringTypeAdapter(WebCore::PercentageComponent percentage)
    {
        if (std::isnan(percentage.value)) {
            m_buffer = { 'n', 'o', 'n', 'e' };
            m_length = 4;
        } else {
            numberToString(percentage.value, m_buffer);
            m_length = std::strlen(&m_buffer[0]) + 1;
            // Utilize the space used for the \0 which is no longer needed to store the percent sign.
            m_buffer[m_length - 1] = '%';
        }
    }

    unsigned length() const { return m_length; }
    bool is8Bit() const { return true; }
    template<typename CharacterType> void writeTo(CharacterType* destination) const { StringImpl::copyCharacters(destination, buffer(), m_length); }

private:
    const LChar* buffer() const { return reinterpret_cast<const LChar*>(&m_buffer[0]); }

    NumberToStringBuffer m_buffer;
    unsigned m_length;
};

}

namespace WebCore {

static String serializationForCSS(const A98RGB<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const A98RGB<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const A98RGB<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const DisplayP3<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const DisplayP3<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const DisplayP3<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const ExtendedA98RGB<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const ExtendedA98RGB<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const ExtendedA98RGB<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const ExtendedDisplayP3<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const ExtendedDisplayP3<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const ExtendedDisplayP3<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const ExtendedLinearSRGBA<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const ExtendedLinearSRGBA<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const ExtendedLinearSRGBA<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const ExtendedProPhotoRGB<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const ExtendedProPhotoRGB<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const ExtendedProPhotoRGB<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const ExtendedRec2020<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const ExtendedRec2020<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const ExtendedRec2020<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const ExtendedSRGBA<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const ExtendedSRGBA<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const ExtendedSRGBA<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const HSLA<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const HSLA<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const HSLA<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const HWBA<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const HWBA<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const HWBA<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const LCHA<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const LCHA<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const LCHA<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const Lab<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const Lab<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const Lab<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const LinearSRGBA<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const LinearSRGBA<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const LinearSRGBA<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const OKLCHA<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const OKLCHA<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const OKLCHA<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const OKLab<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const OKLab<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const OKLab<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const ProPhotoRGB<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const ProPhotoRGB<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const ProPhotoRGB<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const Rec2020<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const Rec2020<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const Rec2020<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(const SRGBA<float>&, bool useColorFunctionSerialization);
static String serializationForHTML(const SRGBA<float>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const SRGBA<float>&, bool useColorFunctionSerialization);

static String serializationForCSS(SRGBA<uint8_t>, bool useColorFunctionSerialization);
static String serializationForHTML(SRGBA<uint8_t>, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(SRGBA<uint8_t>, bool useColorFunctionSerialization);

static String serializationForCSS(const XYZA<float, WhitePoint::D50>&, bool useColorFunctionSerialization);
static String serializationForHTML(const XYZA<float, WhitePoint::D50>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const XYZA<float, WhitePoint::D50>&, bool useColorFunctionSerialization);

static String serializationForCSS(const XYZA<float, WhitePoint::D65>&, bool useColorFunctionSerialization);
static String serializationForHTML(const XYZA<float, WhitePoint::D65>&, bool useColorFunctionSerialization);
static String serializationForRenderTreeAsText(const XYZA<float, WhitePoint::D65>&, bool useColorFunctionSerialization);

String serializationForCSS(const Color& color)
{
    return color.callOnUnderlyingType([&] (auto underlyingColor) {
        return serializationForCSS(underlyingColor, color.usesColorFunctionSerialization());
    });
}

String serializationForHTML(const Color& color)
{
    return color.callOnUnderlyingType([&] (auto underlyingColor) {
        return serializationForHTML(underlyingColor, color.usesColorFunctionSerialization());
    });
}

String serializationForRenderTreeAsText(const Color& color)
{
    return color.callOnUnderlyingType([&] (auto underlyingColor) {
        return serializationForRenderTreeAsText(underlyingColor, color.usesColorFunctionSerialization());
    });
}

static ASCIILiteral serialization(ColorSpace colorSpace)
{
    switch (colorSpace) {
    case ColorSpace::A98RGB:
    case ColorSpace::ExtendedA98RGB:
        return "a98-rgb"_s;
    case ColorSpace::DisplayP3:
    case ColorSpace::ExtendedDisplayP3:
        return "display-p3"_s;
    case ColorSpace::HSL:
        return "hsl"_s;
    case ColorSpace::HWB:
        return "hwb"_s;
    case ColorSpace::LCH:
        return "lch"_s;
    case ColorSpace::Lab:
        return "lab"_s;
    case ColorSpace::LinearSRGB:
    case ColorSpace::ExtendedLinearSRGB:
        return "srgb-linear"_s;
    case ColorSpace::OKLCH:
        return "oklch"_s;
    case ColorSpace::OKLab:
        return "oklab"_s;
    case ColorSpace::ProPhotoRGB:
    case ColorSpace::ExtendedProPhotoRGB:
        return "prophoto-rgb"_s;
    case ColorSpace::Rec2020:
    case ColorSpace::ExtendedRec2020:
        return "rec2020"_s;
    case ColorSpace::SRGB:
    case ColorSpace::ExtendedSRGB:
        return "srgb"_s;
    case ColorSpace::XYZ_D50:
        return "xyz-d50"_s;
    case ColorSpace::XYZ_D65:
        return "xyz-d65"_s;
    }

    ASSERT_NOT_REACHED();
    return ""_s;
}

template<typename ColorType> static String serializationUsingColorFunction(const ColorType& color)
{
    static_assert(std::is_same_v<typename ColorType::ComponentType, float>);

    auto [c1, c2, c3, alpha] = color.unresolved();
    if (WTF::areEssentiallyEqual(alpha, 1.0f))
        return makeString("color(", serialization(ColorSpaceFor<ColorType>), ' ', numericComponent(c1), ' ', numericComponent(c2), ' ', numericComponent(c3), ')');
    return makeString("color(", serialization(ColorSpaceFor<ColorType>), ' ', numericComponent(c1), ' ', numericComponent(c2), ' ', numericComponent(c3), " / ", numericComponent(alpha), ')');
}

static String serializationUsingColorFunction(const SRGBA<uint8_t>& color)
{
    return serializationUsingColorFunction(convertColor<SRGBA<float>>(color));
}

// MARK: A98RGB<float> overloads

String serializationForCSS(const A98RGB<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const A98RGB<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const A98RGB<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

// MARK: DisplayP3<float> overloads

String serializationForCSS(const DisplayP3<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const DisplayP3<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const DisplayP3<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

// MARK: ExtendedA98RGB<float> overloads

String serializationForCSS(const ExtendedA98RGB<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const ExtendedA98RGB<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const ExtendedA98RGB<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

// MARK: ExtendedDisplayP3<float> overloads

String serializationForCSS(const ExtendedDisplayP3<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const ExtendedDisplayP3<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const ExtendedDisplayP3<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

// MARK: ExtendedLinearSRGBA<float> overloads

String serializationForCSS(const ExtendedLinearSRGBA<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const ExtendedLinearSRGBA<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const ExtendedLinearSRGBA<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

// MARK: ExtendedProPhotoRGB<float> overloads

String serializationForCSS(const ExtendedProPhotoRGB<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const ExtendedProPhotoRGB<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const ExtendedProPhotoRGB<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

// MARK: ExtendedRec2020<float> overloads

String serializationForCSS(const ExtendedRec2020<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const ExtendedRec2020<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const ExtendedRec2020<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

// MARK: ExtendedSRGBA<float> overloads

String serializationForCSS(const ExtendedSRGBA<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const ExtendedSRGBA<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const ExtendedSRGBA<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

// MARK: HSLA<float> overloads

String serializationForCSS(const HSLA<float>& color, bool useColorFunctionSerialization)
{
    return serializationForCSS(convertColor<SRGBA<uint8_t>>(color), useColorFunctionSerialization);
}

String serializationForHTML(const HSLA<float>& color, bool useColorFunctionSerialization)
{
    return serializationForHTML(convertColor<SRGBA<uint8_t>>(color), useColorFunctionSerialization);
}

String serializationForRenderTreeAsText(const HSLA<float>& color, bool useColorFunctionSerialization)
{
    return serializationForRenderTreeAsText(convertColor<SRGBA<uint8_t>>(color), useColorFunctionSerialization);
}

// MARK: HWBA<float> overloads

String serializationForCSS(const HWBA<float>& color, bool useColorFunctionSerialization)
{
    return serializationForCSS(convertColor<SRGBA<uint8_t>>(color), useColorFunctionSerialization);
}

String serializationForHTML(const HWBA<float>& color, bool useColorFunctionSerialization)
{
    return serializationForHTML(convertColor<SRGBA<uint8_t>>(color), useColorFunctionSerialization);
}

String serializationForRenderTreeAsText(const HWBA<float>& color, bool useColorFunctionSerialization)
{
    return serializationForRenderTreeAsText(convertColor<SRGBA<uint8_t>>(color), useColorFunctionSerialization);
}

// MARK: LCHA<float> overloads

String serializationForCSS(const LCHA<float>& color, bool)
{
    // https://www.w3.org/TR/css-color-4/#serializing-lab-lch
    auto [c1, c2, c3, alpha] = color.unresolved();
    if (WTF::areEssentiallyEqual(alpha, 1.0f))
        return makeString("lch(", percentageComponent(c1), ' ', numericComponent(c2), ' ', numericComponent(c3), ')');
    return makeString("lch(", percentageComponent(c1), ' ', numericComponent(c2), ' ', numericComponent(c3), " / ", numericComponent(alpha), ')');
}

String serializationForHTML(const LCHA<float>& color, bool useColorFunctionSerialization)
{
    return serializationForCSS(color, useColorFunctionSerialization);
}

String serializationForRenderTreeAsText(const LCHA<float>& color, bool useColorFunctionSerialization)
{
    return serializationForCSS(color, useColorFunctionSerialization);
}

// MARK: Lab<float> overloads

String serializationForCSS(const Lab<float>& color, bool)
{
    // https://www.w3.org/TR/css-color-4/#serializing-lab-lch
    auto [c1, c2, c3, alpha] = color.unresolved();
    if (WTF::areEssentiallyEqual(alpha, 1.0f))
        return makeString("lab(", percentageComponent(c1), ' ', numericComponent(c2), ' ', numericComponent(c3), ')');
    return makeString("lab(", percentageComponent(c1), ' ', numericComponent(c2), ' ', numericComponent(c3), " / ", numericComponent(alpha), ')');
}

String serializationForHTML(const Lab<float>& color, bool useColorFunctionSerialization)
{
    return serializationForCSS(color, useColorFunctionSerialization);
}

String serializationForRenderTreeAsText(const Lab<float>& color, bool useColorFunctionSerialization)
{
    return serializationForCSS(color, useColorFunctionSerialization);
}

// MARK: LinearSRGBA<float> overloads

String serializationForCSS(const LinearSRGBA<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const LinearSRGBA<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const LinearSRGBA<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

// MARK: OKLCHA<float> overloads

String serializationForCSS(const OKLCHA<float>& color, bool)
{
    auto [c1, c2, c3, alpha] = color.unresolved();
    if (WTF::areEssentiallyEqual(alpha, 1.0f))
        return makeString("oklch(", percentageComponent(c1), ' ', numericComponent(c2), ' ', numericComponent(c3), ')');
    return makeString("oklch(", percentageComponent(c1), ' ', numericComponent(c2), ' ', numericComponent(c3), " / ", numericComponent(alpha), ')');
}

String serializationForHTML(const OKLCHA<float>& color, bool useColorFunctionSerialization)
{
    return serializationForCSS(color, useColorFunctionSerialization);
}

String serializationForRenderTreeAsText(const OKLCHA<float>& color, bool useColorFunctionSerialization)
{
    return serializationForCSS(color, useColorFunctionSerialization);
}

// MARK: OKLab<float> overloads

String serializationForCSS(const OKLab<float>& color, bool)
{
    auto [c1, c2, c3, alpha] = color.unresolved();
    if (WTF::areEssentiallyEqual(alpha, 1.0f))
        return makeString("oklab(", percentageComponent(c1), ' ', numericComponent(c2), ' ', numericComponent(c3), ')');
    return makeString("oklab(", percentageComponent(c1), ' ', numericComponent(c2), ' ', numericComponent(c3), " / ", numericComponent(alpha), ')');
}

String serializationForHTML(const OKLab<float>& color, bool useColorFunctionSerialization)
{
    return serializationForCSS(color, useColorFunctionSerialization);
}

String serializationForRenderTreeAsText(const OKLab<float>& color, bool useColorFunctionSerialization)
{
    return serializationForCSS(color, useColorFunctionSerialization);
}

// MARK: ProPhotoRGB<float> overloads

String serializationForCSS(const ProPhotoRGB<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const ProPhotoRGB<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const ProPhotoRGB<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

// MARK: Rec2020<float> overloads

String serializationForCSS(const Rec2020<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const Rec2020<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const Rec2020<float>& color, bool)
{
    return serializationUsingColorFunction(color);
}

// MARK: SRGBA<float> overloads

String serializationForCSS(const SRGBA<float>& color, bool useColorFunctionSerialization)
{
    if (useColorFunctionSerialization)
        return serializationUsingColorFunction(color);

    return serializationForCSS(convertColor<SRGBA<uint8_t>>(color), useColorFunctionSerialization);
}

String serializationForHTML(const SRGBA<float>& color, bool useColorFunctionSerialization)
{
    return serializationForCSS(color, useColorFunctionSerialization);
}

String serializationForRenderTreeAsText(const SRGBA<float>& color, bool useColorFunctionSerialization)
{
    return serializationForCSS(color, useColorFunctionSerialization);
}

// MARK: SRGBA<uint8_t> overloads

static char decimalDigit(unsigned number)
{
    ASSERT(number < 10);
    return '0' + number;
}

static std::array<char, 4> fractionDigitsForFractionalAlphaValue(uint8_t alpha)
{
    ASSERT(alpha > 0);
    ASSERT(alpha < 0xFF);
    if (((alpha * 100 + 0x7F) / 0xFF * 0xFF + 50) / 100 != alpha)
        return { { decimalDigit(alpha * 10 / 0xFF % 10), decimalDigit(alpha * 100 / 0xFF % 10), decimalDigit((alpha * 1000 + 0x7F) / 0xFF % 10), '\0' } };
    if (int thirdDigit = (alpha * 100 + 0x7F) / 0xFF % 10)
        return { { decimalDigit(alpha * 10 / 0xFF), decimalDigit(thirdDigit), '\0', '\0' } };
    return { { decimalDigit((alpha * 10 + 0x7F) / 0xFF), '\0', '\0', '\0' } };
}

String serializationForCSS(SRGBA<uint8_t> color, bool useColorFunctionSerialization)
{
    if (useColorFunctionSerialization)
        return serializationUsingColorFunction(color);

    auto [red, green, blue, alpha] = color.resolved();
    switch (alpha) {
    case 0:
        return makeString("rgba(", red, ", ", green, ", ", blue, ", 0)");
    case 0xFF:
        return makeString("rgb(", red, ", ", green, ", ", blue, ')');
    default:
        return makeString("rgba(", red, ", ", green, ", ", blue, ", 0.", fractionDigitsForFractionalAlphaValue(alpha).data(), ')');
    }
}

String serializationForHTML(SRGBA<uint8_t> color, bool useColorFunctionSerialization)
{
    if (useColorFunctionSerialization)
        return serializationUsingColorFunction(color);

    auto [red, green, blue, alpha] = color.resolved();
    if (alpha == 0xFF)
        return makeString('#', hex(red, 2, Lowercase), hex(green, 2, Lowercase), hex(blue, 2, Lowercase));
    return serializationForCSS(color);
}

String serializationForRenderTreeAsText(SRGBA<uint8_t> color, bool useColorFunctionSerialization)
{
    if (useColorFunctionSerialization)
        return serializationUsingColorFunction(color);

    auto [red, green, blue, alpha] = color.resolved();
    if (alpha < 0xFF)
        return makeString('#', hex(red, 2), hex(green, 2), hex(blue, 2), hex(alpha, 2));
    return makeString('#', hex(red, 2), hex(green, 2), hex(blue, 2));
}

// MARK: XYZA<float, WhitePoint::D50> overloads

String serializationForCSS(const XYZA<float, WhitePoint::D50>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const XYZA<float, WhitePoint::D50>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const XYZA<float, WhitePoint::D50>& color, bool)
{
    return serializationUsingColorFunction(color);
}

// MARK: XYZA<float, WhitePoint::D65> overloads

String serializationForCSS(const XYZA<float, WhitePoint::D65>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForHTML(const XYZA<float, WhitePoint::D65>& color, bool)
{
    return serializationUsingColorFunction(color);
}

String serializationForRenderTreeAsText(const XYZA<float, WhitePoint::D65>& color, bool)
{
    return serializationUsingColorFunction(color);
}

}