mirror of https://github.com/dcoredump/dexed.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
360 lines
14 KiB
360 lines
14 KiB
/*
|
|
==============================================================================
|
|
|
|
This file is part of the JUCE library.
|
|
Copyright (c) 2013 - Raw Material Software Ltd.
|
|
|
|
Permission is granted to use this software under the terms of either:
|
|
a) the GPL v2 (or any later version)
|
|
b) the Affero GPL v3
|
|
|
|
Details of these licenses can be found at: www.gnu.org/licenses
|
|
|
|
JUCE is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
|
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
|
|
------------------------------------------------------------------------------
|
|
|
|
To release a closed-source product which uses JUCE, commercial licenses are
|
|
available: visit www.juce.com for more information.
|
|
|
|
==============================================================================
|
|
*/
|
|
|
|
#ifndef JUCE_COLOUR_H_INCLUDED
|
|
#define JUCE_COLOUR_H_INCLUDED
|
|
|
|
|
|
//==============================================================================
|
|
/**
|
|
Represents a colour, also including a transparency value.
|
|
|
|
The colour is stored internally as unsigned 8-bit red, green, blue and alpha values.
|
|
*/
|
|
class JUCE_API Colour
|
|
{
|
|
public:
|
|
//==============================================================================
|
|
/** Creates a transparent black colour. */
|
|
Colour() noexcept;
|
|
|
|
/** Creates a copy of another Colour object. */
|
|
Colour (const Colour& other) noexcept;
|
|
|
|
/** Creates a colour from a 32-bit ARGB value.
|
|
|
|
The format of this number is:
|
|
((alpha << 24) | (red << 16) | (green << 8) | blue).
|
|
|
|
All components in the range 0x00 to 0xff.
|
|
An alpha of 0x00 is completely transparent, alpha of 0xff is opaque.
|
|
|
|
@see getPixelARGB
|
|
*/
|
|
explicit Colour (uint32 argb) noexcept;
|
|
|
|
/** Creates an opaque colour using 8-bit red, green and blue values */
|
|
Colour (uint8 red,
|
|
uint8 green,
|
|
uint8 blue) noexcept;
|
|
|
|
/** Creates an opaque colour using 8-bit red, green and blue values */
|
|
static Colour fromRGB (uint8 red,
|
|
uint8 green,
|
|
uint8 blue) noexcept;
|
|
|
|
/** Creates a colour using 8-bit red, green, blue and alpha values. */
|
|
Colour (uint8 red,
|
|
uint8 green,
|
|
uint8 blue,
|
|
uint8 alpha) noexcept;
|
|
|
|
/** Creates a colour using 8-bit red, green, blue and alpha values. */
|
|
static Colour fromRGBA (uint8 red,
|
|
uint8 green,
|
|
uint8 blue,
|
|
uint8 alpha) noexcept;
|
|
|
|
/** Creates a colour from 8-bit red, green, and blue values, and a floating-point alpha.
|
|
|
|
Alpha of 0.0 is transparent, alpha of 1.0f is opaque.
|
|
Values outside the valid range will be clipped.
|
|
*/
|
|
Colour (uint8 red,
|
|
uint8 green,
|
|
uint8 blue,
|
|
float alpha) noexcept;
|
|
|
|
/** Creates a colour using floating point red, green, blue and alpha values.
|
|
Numbers outside the range 0..1 will be clipped.
|
|
*/
|
|
static Colour fromFloatRGBA (float red,
|
|
float green,
|
|
float blue,
|
|
float alpha) noexcept;
|
|
|
|
/** Creates a colour using floating point hue, saturation and brightness values, and an 8-bit alpha.
|
|
|
|
The floating point values must be between 0.0 and 1.0.
|
|
An alpha of 0x00 is completely transparent, alpha of 0xff is opaque.
|
|
Values outside the valid range will be clipped.
|
|
*/
|
|
Colour (float hue,
|
|
float saturation,
|
|
float brightness,
|
|
uint8 alpha) noexcept;
|
|
|
|
/** Creates a colour using floating point hue, saturation, brightness and alpha values.
|
|
|
|
All values must be between 0.0 and 1.0.
|
|
Numbers outside the valid range will be clipped.
|
|
*/
|
|
Colour (float hue,
|
|
float saturation,
|
|
float brightness,
|
|
float alpha) noexcept;
|
|
|
|
/** Creates a colour using floating point hue, saturation and brightness values, and an 8-bit alpha.
|
|
|
|
The floating point values must be between 0.0 and 1.0.
|
|
An alpha of 0x00 is completely transparent, alpha of 0xff is opaque.
|
|
Values outside the valid range will be clipped.
|
|
*/
|
|
static Colour fromHSV (float hue,
|
|
float saturation,
|
|
float brightness,
|
|
float alpha) noexcept;
|
|
|
|
/** Destructor. */
|
|
~Colour() noexcept;
|
|
|
|
/** Copies another Colour object. */
|
|
Colour& operator= (const Colour& other) noexcept;
|
|
|
|
/** Compares two colours. */
|
|
bool operator== (const Colour& other) const noexcept;
|
|
/** Compares two colours. */
|
|
bool operator!= (const Colour& other) const noexcept;
|
|
|
|
//==============================================================================
|
|
/** Returns the red component of this colour.
|
|
@returns a value between 0x00 and 0xff.
|
|
*/
|
|
uint8 getRed() const noexcept { return argb.getRed(); }
|
|
|
|
/** Returns the green component of this colour.
|
|
@returns a value between 0x00 and 0xff.
|
|
*/
|
|
uint8 getGreen() const noexcept { return argb.getGreen(); }
|
|
|
|
/** Returns the blue component of this colour.
|
|
@returns a value between 0x00 and 0xff.
|
|
*/
|
|
uint8 getBlue() const noexcept { return argb.getBlue(); }
|
|
|
|
/** Returns the red component of this colour as a floating point value.
|
|
@returns a value between 0.0 and 1.0
|
|
*/
|
|
float getFloatRed() const noexcept;
|
|
|
|
/** Returns the green component of this colour as a floating point value.
|
|
@returns a value between 0.0 and 1.0
|
|
*/
|
|
float getFloatGreen() const noexcept;
|
|
|
|
/** Returns the blue component of this colour as a floating point value.
|
|
@returns a value between 0.0 and 1.0
|
|
*/
|
|
float getFloatBlue() const noexcept;
|
|
|
|
/** Returns a premultiplied ARGB pixel object that represents this colour.
|
|
*/
|
|
const PixelARGB getPixelARGB() const noexcept;
|
|
|
|
/** Returns a 32-bit integer that represents this colour.
|
|
|
|
The format of this number is:
|
|
((alpha << 24) | (red << 16) | (green << 16) | blue).
|
|
*/
|
|
uint32 getARGB() const noexcept;
|
|
|
|
//==============================================================================
|
|
/** Returns the colour's alpha (opacity).
|
|
|
|
Alpha of 0x00 is completely transparent, 0xff is completely opaque.
|
|
*/
|
|
uint8 getAlpha() const noexcept { return argb.getAlpha(); }
|
|
|
|
/** Returns the colour's alpha (opacity) as a floating point value.
|
|
|
|
Alpha of 0.0 is completely transparent, 1.0 is completely opaque.
|
|
*/
|
|
float getFloatAlpha() const noexcept;
|
|
|
|
/** Returns true if this colour is completely opaque.
|
|
|
|
Equivalent to (getAlpha() == 0xff).
|
|
*/
|
|
bool isOpaque() const noexcept;
|
|
|
|
/** Returns true if this colour is completely transparent.
|
|
|
|
Equivalent to (getAlpha() == 0x00).
|
|
*/
|
|
bool isTransparent() const noexcept;
|
|
|
|
/** Returns a colour that's the same colour as this one, but with a new alpha value. */
|
|
Colour withAlpha (uint8 newAlpha) const noexcept;
|
|
|
|
/** Returns a colour that's the same colour as this one, but with a new alpha value. */
|
|
Colour withAlpha (float newAlpha) const noexcept;
|
|
|
|
/** Returns a colour that's the same colour as this one, but with a modified alpha value.
|
|
The new colour's alpha will be this object's alpha multiplied by the value passed-in.
|
|
*/
|
|
Colour withMultipliedAlpha (float alphaMultiplier) const noexcept;
|
|
|
|
//==============================================================================
|
|
/** Returns a colour that is the result of alpha-compositing a new colour over this one.
|
|
If the foreground colour is semi-transparent, it is blended onto this colour accordingly.
|
|
*/
|
|
Colour overlaidWith (Colour foregroundColour) const noexcept;
|
|
|
|
/** Returns a colour that lies somewhere between this one and another.
|
|
If amountOfOther is zero, the result is 100% this colour, if amountOfOther
|
|
is 1.0, the result is 100% of the other colour.
|
|
*/
|
|
Colour interpolatedWith (Colour other, float proportionOfOther) const noexcept;
|
|
|
|
//==============================================================================
|
|
/** Returns the colour's hue component.
|
|
The value returned is in the range 0.0 to 1.0
|
|
*/
|
|
float getHue() const noexcept;
|
|
|
|
/** Returns the colour's saturation component.
|
|
The value returned is in the range 0.0 to 1.0
|
|
*/
|
|
float getSaturation() const noexcept;
|
|
|
|
/** Returns the colour's brightness component.
|
|
The value returned is in the range 0.0 to 1.0
|
|
*/
|
|
float getBrightness() const noexcept;
|
|
|
|
/** Returns a skewed brightness value, adjusted to better reflect the way the human
|
|
eye responds to different colour channels. This makes it better than getBrightness()
|
|
for comparing differences in brightness.
|
|
*/
|
|
float getPerceivedBrightness() const noexcept;
|
|
|
|
/** Returns the colour's hue, saturation and brightness components all at once.
|
|
The values returned are in the range 0.0 to 1.0
|
|
*/
|
|
void getHSB (float& hue,
|
|
float& saturation,
|
|
float& brightness) const noexcept;
|
|
|
|
//==============================================================================
|
|
/** Returns a copy of this colour with a different hue. */
|
|
Colour withHue (float newHue) const noexcept;
|
|
|
|
/** Returns a copy of this colour with a different saturation. */
|
|
Colour withSaturation (float newSaturation) const noexcept;
|
|
|
|
/** Returns a copy of this colour with a different brightness.
|
|
@see brighter, darker, withMultipliedBrightness
|
|
*/
|
|
Colour withBrightness (float newBrightness) const noexcept;
|
|
|
|
/** Returns a copy of this colour with it hue rotated.
|
|
|
|
The new colour's hue is ((this->getHue() + amountToRotate) % 1.0)
|
|
|
|
@see brighter, darker, withMultipliedBrightness
|
|
*/
|
|
Colour withRotatedHue (float amountToRotate) const noexcept;
|
|
|
|
/** Returns a copy of this colour with its saturation multiplied by the given value.
|
|
|
|
The new colour's saturation is (this->getSaturation() * multiplier)
|
|
(the result is clipped to legal limits).
|
|
*/
|
|
Colour withMultipliedSaturation (float multiplier) const noexcept;
|
|
|
|
/** Returns a copy of this colour with its brightness multiplied by the given value.
|
|
|
|
The new colour's saturation is (this->getBrightness() * multiplier)
|
|
(the result is clipped to legal limits).
|
|
*/
|
|
Colour withMultipliedBrightness (float amount) const noexcept;
|
|
|
|
//==============================================================================
|
|
/** Returns a brighter version of this colour.
|
|
|
|
@param amountBrighter how much brighter to make it - a value from 0 to 1.0 where 0 is
|
|
unchanged, and higher values make it brighter
|
|
@see withMultipliedBrightness
|
|
*/
|
|
Colour brighter (float amountBrighter = 0.4f) const noexcept;
|
|
|
|
/** Returns a darker version of this colour.
|
|
|
|
@param amountDarker how much darker to make it - a value from 0 to 1.0 where 0 is
|
|
unchanged, and higher values make it darker
|
|
@see withMultipliedBrightness
|
|
*/
|
|
Colour darker (float amountDarker = 0.4f) const noexcept;
|
|
|
|
//==============================================================================
|
|
/** Returns a colour that will be clearly visible against this colour.
|
|
|
|
The amount parameter indicates how contrasting the new colour should
|
|
be, so e.g. Colours::black.contrasting (0.1f) will return a colour
|
|
that's just a little bit lighter; Colours::black.contrasting (1.0f) will
|
|
return white; Colours::white.contrasting (1.0f) will return black, etc.
|
|
*/
|
|
Colour contrasting (float amount = 1.0f) const noexcept;
|
|
|
|
/** Returns a colour that is as close as possible to a target colour whilst
|
|
still being in contrast to this one.
|
|
|
|
The colour that is returned will be the targetColour, but with its luminosity
|
|
nudged up or down so that it differs from the luminosity of this colour
|
|
by at least the amount specified by minLuminosityDiff.
|
|
*/
|
|
Colour contrasting (Colour targetColour, float minLuminosityDiff) const noexcept;
|
|
|
|
/** Returns a colour that contrasts against two colours.
|
|
Looks for a colour that contrasts with both of the colours passed-in.
|
|
Handy for things like choosing a highlight colour in text editors, etc.
|
|
*/
|
|
static Colour contrasting (Colour colour1,
|
|
Colour colour2) noexcept;
|
|
|
|
//==============================================================================
|
|
/** Returns an opaque shade of grey.
|
|
@param brightness the level of grey to return - 0 is black, 1.0 is white
|
|
*/
|
|
static Colour greyLevel (float brightness) noexcept;
|
|
|
|
//==============================================================================
|
|
/** Returns a stringified version of this colour.
|
|
The string can be turned back into a colour using the fromString() method.
|
|
*/
|
|
String toString() const;
|
|
|
|
/** Reads the colour from a string that was created with toString(). */
|
|
static Colour fromString (StringRef encodedColourString);
|
|
|
|
/** Returns the colour as a hex string in the form RRGGBB or AARRGGBB. */
|
|
String toDisplayString (bool includeAlphaValue) const;
|
|
|
|
private:
|
|
//==============================================================================
|
|
PixelARGB argb;
|
|
};
|
|
|
|
|
|
#endif // JUCE_COLOUR_H_INCLUDED
|
|
|