/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ /* * This file is part of the LibreOffice project. * * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. * * This file incorporates work covered by the following license notice: * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed * with this work for additional information regarding copyright * ownership. The ASF licenses this file to you under the Apache * License, Version 2.0 (the "License"); you may not use this file * except in compliance with the License. You may obtain a copy of * the License at http://www.apache.org/licenses/LICENSE-2.0 . */ #ifndef INCLUDED_TOOLS_COLOR_HXX #define INCLUDED_TOOLS_COLOR_HXX #include #include #include #include #include namespace color { constexpr sal_uInt32 extractRGB(sal_uInt32 nColorNumber) { return nColorNumber & 0x00FFFFFF; } constexpr sal_uInt8 ColorChannelMerge(sal_uInt8 nDst, sal_uInt8 nSrc, sal_uInt8 nSrcTrans) { return sal_uInt8(((sal_Int32(nDst) - nSrc) * nSrcTrans + ((nSrc << 8) | nDst)) >> 8); } } // Color class SAL_WARN_UNUSED TOOLS_DLLPUBLIC Color { // data intentionally public; read the commit log! public: union { sal_uInt32 mValue; struct { #ifdef OSL_BIGENDIAN sal_uInt8 A; sal_uInt8 R; sal_uInt8 G; sal_uInt8 B; #else sal_uInt8 B; sal_uInt8 G; sal_uInt8 R; sal_uInt8 A; #endif }; }; public: constexpr Color() : mValue(0) // black {} constexpr Color(sal_uInt32 nColor) : mValue(nColor) {} constexpr Color(sal_uInt8 nTransparency, sal_uInt8 nRed, sal_uInt8 nGreen, sal_uInt8 nBlue) : mValue(sal_uInt32(nBlue) | (sal_uInt32(nGreen) << 8) | (sal_uInt32(nRed) << 16) | (sal_uInt32(nTransparency) << 24)) {} constexpr Color(sal_uInt8 nRed, sal_uInt8 nGreen, sal_uInt8 nBlue) : mValue(sal_uInt32(nBlue) | (sal_uInt32(nGreen) << 8) | (sal_uInt32(nRed) << 16) | (sal_uInt32(0) << 24)) {} // constructor to create a tools-Color from ::basegfx::BColor explicit Color(const basegfx::BColor& rBColor) : Color(0, sal_uInt8(std::lround(rBColor.getRed() * 255.0)), sal_uInt8(std::lround(rBColor.getGreen() * 255.0)), sal_uInt8(std::lround(rBColor.getBlue() * 255.0))) {} /** Casts the color to corresponding uInt32. * Primarily used when passing Color objects to UNO API * @return corresponding sal_uInt32 */ constexpr explicit operator sal_uInt32() const { return mValue; } /** Casts the color to corresponding iInt32. * If there is no transparency, will be positive. * @return corresponding sal_Int32 */ constexpr explicit operator sal_Int32() const { return sal_Int32(mValue); } /* Basic RGBA operations */ /** Gets the red value. * @return R */ sal_uInt8 GetRed() const { return R; } /** Gets the green value. * @return G */ sal_uInt8 GetGreen() const { return G; } /** Gets the blue value. * @return B */ sal_uInt8 GetBlue() const { return B; } /** Gets the transparency value. * @return A */ sal_uInt8 GetTransparency() const { return A; } /** Is the color transparent? * @returns true or false */ bool IsTransparent() const { return (GetTransparency() != 0); } /** Sets the red value. * @param nRed */ void SetRed(sal_uInt8 nRed) { R = nRed; } /** Sets the green value. * @param nGreen */ void SetGreen(sal_uInt8 nGreen) { G = nGreen; } /** Sets the blue value. * @param nBlue */ void SetBlue(sal_uInt8 nBlue) { B = nBlue; } /** Sets the transparency value. * @param nTransparency */ void SetTransparency(sal_uInt8 nTransparency) { A = nTransparency; } /** Returns the same color but ignoring the transparency value. * @return RGB version */ Color GetRGBColor() const { return mValue & 0x00FFFFFF; } /* Comparison and operators */ /** Check if the color RGB value is equal than rColor. * @param rColor * @return is equal */ bool IsRGBEqual( const Color& rColor ) const { return ( mValue & 0x00FFFFFF ) == ( rColor.mValue & 0x00FFFFFF ); } /** Check if the color value is lower than aCompareColor. * @param aCompareColor * @return is lower */ bool operator<(const Color& aCompareColor) const { return mValue < aCompareColor.mValue; } /** Check if the color value is greater than aCompareColor. * @param aCompareColor * @return is greater */ bool operator>(const Color& aCompareColor) const { return mValue > aCompareColor.mValue; } /** Check if the color value is equal than rColor. * @param rColor * @return is equal */ bool operator==(const Color& rColor) const { return mValue == rColor.mValue; } /** Check if the color value is unequal than rColor. * @param rColor * @return is unequal */ bool operator!=(const Color& rColor) const { return mValue != rColor.mValue; } /** Gets the color error compared to another. * It describes how different they are. * It takes the abs of differences in parameters. * @param rCompareColor * @return error */ sal_uInt16 GetColorError(const Color& rCompareColor) const { return static_cast( abs(static_cast(GetBlue()) - rCompareColor.GetBlue()) + abs(static_cast(GetGreen()) - rCompareColor.GetGreen()) + abs(static_cast(GetRed()) - rCompareColor.GetRed())); } /* Light and contrast */ /** Gets the color luminance. It means perceived brightness. * @return luminance */ sal_uInt8 GetLuminance() const { return sal_uInt8((B * 29UL + G * 151UL + R * 76UL) >> 8); } /** Increases the color luminance by cLumInc. * @param cLumInc */ void IncreaseLuminance(sal_uInt8 cLumInc); /** Decreases the color luminance by cLumDec. * @param cLumDec */ void DecreaseLuminance(sal_uInt8 cLumDec); /** Decreases color contrast with white by cContDec. * @param cContDec */ void DecreaseContrast(sal_uInt8 cContDec); /** Comparison with luminance thresholds. * @return is dark */ bool IsDark() const { return sal_uInt8((B * 29UL + G * 151UL + R * 76UL) >> 8) <= 60; } /** Comparison with luminance thresholds. * @return is dark */ bool IsBright() const { return sal_uInt8((B * 29UL + G * 151UL + R * 76UL) >> 8) >= 245; } /* Color filters */ /** * Apply tint or shade to a color. * * The input value is the percentage (in 100th of percent) of how much the * color changes towards the black (shade) or white (tint). If the value * is positive, the color is tinted, if the value is negative, the color is * shaded. **/ void ApplyTintOrShade(sal_Int16 n100thPercent); /** Inverts color. 1 and 0 are switched. * Note that the result will be the complementary color. * For example, if you have red, you will get cyan: FF0000 -> 00FFFF. */ void Invert() { R = ~R; G = ~G; B = ~B; } /** Merges color with rMergeColor. * Allows to get resulting color when superposing another. * @param rMergeColor * @param cTransparency */ void Merge(const Color& rMergeColor, sal_uInt8 cTransparency) { R = color::ColorChannelMerge(R, rMergeColor.R, cTransparency); G = color::ColorChannelMerge(G, rMergeColor.G, cTransparency); B = color::ColorChannelMerge(B, rMergeColor.B, cTransparency); } /* Change of format */ /** Color space conversion tools * The range for h/s/b is: * - Hue: 0-360 degree * - Saturation: 0-100% * - Brightness: 0-100% * @param nHue * @param nSaturation * @param nBrightness * @return rgb color */ static Color HSBtoRGB(sal_uInt16 nHue, sal_uInt16 nSaturation, sal_uInt16 nBrightness); /** Converts a string into a color. Supports: * #RRGGBB * #rrggbb * #RGB * #rgb * RRGGBB * rrggbb * RGB * rgb * If fails returns Color(). */ static Color STRtoRGB(const OUString& colorname); /** Color space conversion tools * @param nHue * @param nSaturation * @param nBrightness */ void RGBtoHSB(sal_uInt16& nHue, sal_uInt16& nSaturation, sal_uInt16& nBrightness) const; /* Return color as RGB hex string: rrggbb * for example "00ff00" for green color * @return hex string */ OUString AsRGBHexString() const; /* Return color as RGB hex string: RRGGBB * for example "00FF00" for green color * @return hex string */ OUString AsRGBHEXString() const; /* get ::basegfx::BColor from this color * @return basegfx color */ basegfx::BColor getBColor() const { return basegfx::BColor(R / 255.0, G / 255.0, B / 255.0); } }; // to reduce the noise when moving these into and out of Any inline bool operator >>=( const css::uno::Any & rAny, Color & value ) { sal_Int32 nTmp = {}; // spurious -Werror=maybe-uninitialized if (!(rAny >>= nTmp)) return false; value = Color(nTmp); return true; } inline void operator <<=( css::uno::Any & rAny, Color value ) { rAny <<= sal_Int32(value); } namespace com::sun::star::uno { template<> inline Any makeAny( Color const & value ) { return Any(sal_Int32(value)); } } // Test compile time conversion of Color to sal_uInt32 static_assert (sal_uInt32(Color(0x00, 0x12, 0x34, 0x56)) == 0x00123456); static_assert (sal_uInt32(Color(0x12, 0x34, 0x56)) == 0x00123456); // Color types constexpr ::Color COL_BLACK ( 0x00, 0x00, 0x00 ); constexpr ::Color COL_BLUE ( 0x00, 0x00, 0x80 ); constexpr ::Color COL_GREEN ( 0x00, 0x80, 0x00 ); constexpr ::Color COL_CYAN ( 0x00, 0x80, 0x80 ); constexpr ::Color COL_RED ( 0x80, 0x00, 0x00 ); constexpr ::Color COL_MAGENTA ( 0x80, 0x00, 0x80 ); constexpr ::Color COL_BROWN ( 0x80, 0x80, 0x00 ); constexpr ::Color COL_GRAY ( 0x80, 0x80, 0x80 ); constexpr ::Color COL_GRAY3 ( 0xCC, 0xCC, 0xCC ); constexpr ::Color COL_GRAY7 ( 0x66, 0x66, 0x66 ); constexpr ::Color COL_LIGHTGRAY ( 0xC0, 0xC0, 0xC0 ); constexpr ::Color COL_LIGHTBLUE ( 0x00, 0x00, 0xFF ); constexpr ::Color COL_LIGHTGREEN ( 0x00, 0xFF, 0x00 ); constexpr ::Color COL_LIGHTCYAN ( 0x00, 0xFF, 0xFF ); constexpr ::Color COL_LIGHTRED ( 0xFF, 0x00, 0x00 ); constexpr ::Color COL_LIGHTMAGENTA ( 0xFF, 0x00, 0xFF ); constexpr ::Color COL_LIGHTGRAYBLUE ( 0xE0, 0xE0, 0xFF ); constexpr ::Color COL_YELLOW ( 0xFF, 0xFF, 0x00 ); constexpr ::Color COL_WHITE ( 0xFF, 0xFF, 0xFF ); constexpr ::Color COL_TRANSPARENT ( 0xFF, 0xFF, 0xFF, 0xFF ); constexpr ::Color COL_AUTO ( 0xFF, 0xFF, 0xFF, 0xFF ); constexpr ::Color COL_AUTHOR1_DARK ( 198, 146, 0 ); constexpr ::Color COL_AUTHOR1_NORMAL ( 255, 255, 158 ); constexpr ::Color COL_AUTHOR1_LIGHT ( 255, 255, 195 ); constexpr ::Color COL_AUTHOR2_DARK ( 6, 70, 162 ); constexpr ::Color COL_AUTHOR2_NORMAL ( 216, 232, 255 ); constexpr ::Color COL_AUTHOR2_LIGHT ( 233, 242, 255 ); constexpr ::Color COL_AUTHOR3_DARK ( 87, 157, 28 ); constexpr ::Color COL_AUTHOR3_NORMAL ( 218, 248, 193 ); constexpr ::Color COL_AUTHOR3_LIGHT ( 226, 250, 207 ); constexpr ::Color COL_AUTHOR4_DARK ( 105, 43, 157 ); constexpr ::Color COL_AUTHOR4_NORMAL ( 228, 210, 245 ); constexpr ::Color COL_AUTHOR4_LIGHT ( 239, 228, 248 ); constexpr ::Color COL_AUTHOR5_DARK ( 197, 0, 11 ); constexpr ::Color COL_AUTHOR5_NORMAL ( 254, 205, 208 ); constexpr ::Color COL_AUTHOR5_LIGHT ( 255, 227, 229 ); constexpr ::Color COL_AUTHOR6_DARK ( 0, 128, 128 ); constexpr ::Color COL_AUTHOR6_NORMAL ( 210, 246, 246 ); constexpr ::Color COL_AUTHOR6_LIGHT ( 230, 250, 250 ); constexpr ::Color COL_AUTHOR7_DARK ( 140, 132, 0 ); constexpr ::Color COL_AUTHOR7_NORMAL ( 237, 252, 163 ); constexpr ::Color COL_AUTHOR7_LIGHT ( 242, 254, 181 ); constexpr ::Color COL_AUTHOR8_DARK ( 53, 85, 107 ); constexpr ::Color COL_AUTHOR8_NORMAL ( 211, 222, 232 ); constexpr ::Color COL_AUTHOR8_LIGHT ( 226, 234, 241 ); constexpr ::Color COL_AUTHOR9_DARK ( 209, 118, 0 ); constexpr ::Color COL_AUTHOR9_NORMAL ( 255, 226, 185 ); constexpr ::Color COL_AUTHOR9_LIGHT ( 255, 231, 199 ); template inline std::basic_ostream& operator <<(std::basic_ostream& rStream, const Color& rColor) { std::ios_base::fmtflags nOrigFlags = rStream.flags(); rStream << "c[" << std::hex << std::setfill ('0') << std::setw(2) << static_cast(rColor.GetRed()) << std::setw(2) << static_cast(rColor.GetGreen()) << std::setw(2) << static_cast(rColor.GetBlue()) << std::setw(2) << static_cast(rColor.GetTransparency()) << "]"; rStream.setf(nOrigFlags); return rStream; } #endif /* vim:set shiftwidth=4 softtabstop=4 expandtab: */