/* ============================================================
 *
 * This file is a part of digiKam project
 * https://www.digikam.org
 *
 * Date        : 2005-12-02
 * Description : 8-16 bits color container.
 *
 * SPDX-FileCopyrightText: 2005-2025 by Gilles Caulier <caulier dot gilles at gmail dot com>
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 *
 * ============================================================ */

#pragma once

// C++ includes

#include <cmath>

// Qt includes

#include <QColor>

// Local includes

#include "digikam_export.h"

namespace Digikam
{

class DIGIKAM_EXPORT DColor
{
public:

    /**
     * Initialize with default value, fully transparent eight bit black
     */
    DColor() = default;

    /**
     * Read value from data. Equivalent to setColor()
     */
    explicit DColor(uchar* data, bool sixteenBit = false)
    {
        setColor(data, sixteenBit);
    }

    /**
     * Initialize with given RGBA values
     */
    DColor(int red, int green, int blue, int alpha, bool sixteenBit)
        : m_red         (red),
          m_green       (green),
          m_blue        (blue),
          m_alpha       (alpha),
          m_sixteenBit  (sixteenBit)
    {
    }

    /**
     * Read values from QColor, convert to sixteenBit of sixteenBit is true
     */
    explicit DColor(const QColor& color, bool sixteenBit=false);

    // Use default copy constructor, assignment operator and destructor

    /**
     * Read color values as RGBA from the given memory location.
     * If sixteenBit is false, 4 bytes are read.
     * If sixteenBit is true, 8 bytes are read.
     * Inline method.
     */
    inline void setColor(uchar* const data, bool sixteenBit = false);

    /**
     * Write the values of this color to the given memory location.
     * If sixteenBit is false, 4 bytes are written.
     * If sixteenBit is true, 8 bytes are written.
     * Inline method.
     */
    inline void setPixel(uchar* const data) const;

    int red()                               const
    {
        return m_red;
    }

    int green()                             const
    {
        return m_green;
    }

    int blue()                              const
    {
        return m_blue;
    }

    int alpha()                             const
    {
        return m_alpha;
    }

    bool sixteenBit()                       const
    {
        return m_sixteenBit;
    }

    void setRed(int red)
    {
        m_red = red;
    }

    void setGreen(int green)
    {
        m_green = green;
    }

    void setBlue (int blue)
    {
        m_blue = blue;
    }

    void setAlpha(int alpha)
    {
        m_alpha = alpha;
    }

    void setSixteenBit(bool sixteenBit)
    {
        m_sixteenBit = sixteenBit;
    }

    QColor getQColor() const;

    inline bool isPureGrayValue(int v)
    {
        return ((m_red == v) && (m_green == v) && (m_blue == v));
    }

    inline bool isPureGray()
    {
        return ((m_red == m_green) && (m_red == m_blue));
    }

    /**
     * Convert the color values of this color to and from sixteen bit
     * and set the sixteenBit value accordingly
     */
    void convertToSixteenBit();
    void convertToEightBit();

    /**
     * Premultiply and demultiply this color.
     * DImg stores the color non-premultiplied.
     * Inline methods.
     */
    void premultiply();
    void demultiply();

    /**
     * Return the current RGB color values of this color
     * in the HSL color space.
     * Alpha is ignored for the conversion.
     */
    void getHSL(int* const h, int* const s, int* const l) const;

    /**
     * Set the RGB color values of this color
     * to the given HSL values converted to RGB.
     * Alpha is set to be fully opaque.
     * sixteenBit determines both how the HSL values are interpreted
     * and the sixteenBit value of this color after this operation.
     */
    void setHSL(int h, int s, int l, bool sixteenBit);

    /**
     * Return the current RGB color values of this color
     * in the YCrCb color space.
     * Alpha is ignored for the conversion.
     */
    void getYCbCr(double* const y, double* const cb, double* const cr) const;

    /**
     * Set the RGB color values of this color
     * to the given YCrCb values converted to RGB.
     * Alpha is set to be fully opaque.
     * sixteenBit determines both how the YCrCb values are interpreted
     * and the sixteenBit value of this color after this operation.
     */
    void setYCbCr(double y, double cb, double cr, bool sixteenBit);

private:

    int  m_red          = 0;
    int  m_green        = 0;
    int  m_blue         = 0;
    int  m_alpha        = 0;

    bool m_sixteenBit   = false;

public:

    /**
     * Inline alpha blending helper functions.
     * These functions are used by DColorComposer.
     * Look at that code to learn how to use them for
     * composition if you want to use them in optimized code.
     */
    inline void blendZero();
    inline void blendAlpha8(int alpha);
    inline void blendInvAlpha8(int alpha);
    inline void blendAlpha16(int alpha);
    inline void blendInvAlpha16(int alpha);
    inline void premultiply16(int alpha);
    inline void premultiply8(int alpha);
    inline void demultiply16(int alpha);
    inline void demultiply8(int alpha);
    inline void blendAdd(const DColor& src);
    inline void blendClamp8();
    inline void blendClamp16();
    inline void multiply(float factor);
};

} // namespace Digikam

// Inline methods

#include "dcolorpixelaccess.h"
#include "dcolorblend.h"
