color_tools.hpp

// This file is part of slideio project.
// It is subject to the license terms in the LICENSE file found in the top-level directory
// of this distribution and at http://slideio.com/license.html.
#pragma once
//
#include <array>
#include <string>
#include "slideio/core/slideio_core_def.hpp"
 
namespace  slideio {
    enum class HexColorFormat {
        UNKNOWN,
        RGB,        // #RRGGBB (6 hex digits)
        RGBA,       // #RRGGBBAA (8 hex digits, standard web format)
        ARGB        // #AARRGGBB (8 hex digits, OME-TIFF format)
    };
 
    class SLIDEIO_CORE_EXPORTS ColorTools {
    public:
        static HexColorFormat detectHexColorFormat(const std::string& hexColor);
        static std::string HexColorFormatToString(HexColorFormat format);
        static std::array<uint8_t, 4> hexARGBToRGBA(const std::string& hexColor);
        static std::array<uint8_t, 4> hexRGBAToRGBA(const std::string& hexColor);
        static std::array<uint8_t, 4> hexToRGBA(const std::string& hexColor, uint8_t defaultAlpha = 0);
        static std::array<uint8_t, 3> RGBAToRGB(const std::array<uint8_t, 4>& rgba);
        static std::string RGBAToHexARGB(const std::array<uint8_t, 4>& rgba);
        static std::array<uint8_t, 4> smartHexToRGBA(const std::string& hexColor, uint8_t defaultAlpha = 0);
        static std::string RGBAToHexRGBA(const std::array<uint8_t, 4>& rgba);
        static std::string hexToInt32String(const std::string& hexColor);
        static std::string rgbaInt32StringToHexARGB(const std::string& value);
        static std::string rgbCsvToHexRGB(const std::string& csv);
    };
}