diff options
Diffstat (limited to 'chromium/ui/gfx/color_utils.h')
-rw-r--r-- | chromium/ui/gfx/color_utils.h | 89 |
1 files changed, 89 insertions, 0 deletions
diff --git a/chromium/ui/gfx/color_utils.h b/chromium/ui/gfx/color_utils.h new file mode 100644 index 00000000000..c9f62066427 --- /dev/null +++ b/chromium/ui/gfx/color_utils.h @@ -0,0 +1,89 @@ +// Copyright (c) 2012 The Chromium Authors. All rights reserved. +// Use of this source code is governed by a BSD-style license that can be +// found in the LICENSE file. + +#ifndef UI_GFX_COLOR_UTILS_H_ +#define UI_GFX_COLOR_UTILS_H_ + +#include "base/basictypes.h" +#include "third_party/skia/include/core/SkColor.h" +#include "ui/base/ui_export.h" + +class SkBitmap; + +namespace color_utils { + +// Represents an HSL color. +struct HSL { + double h; + double s; + double l; +}; + +UI_EXPORT unsigned char GetLuminanceForColor(SkColor color); + +// Calculated according to http://www.w3.org/TR/WCAG20/#relativeluminancedef +UI_EXPORT double RelativeLuminance(SkColor color); + +// Note: these transformations assume sRGB as the source color space +UI_EXPORT void SkColorToHSL(SkColor c, HSL* hsl); +UI_EXPORT SkColor HSLToSkColor(const HSL& hsl, SkAlpha alpha); + +// HSL-Shift an SkColor. The shift values are in the range of 0-1, with the +// option to specify -1 for 'no change'. The shift values are defined as: +// hsl_shift[0] (hue): The absolute hue value - 0 and 1 map +// to 0 and 360 on the hue color wheel (red). +// hsl_shift[1] (saturation): A saturation shift, with the +// following key values: +// 0 = remove all color. +// 0.5 = leave unchanged. +// 1 = fully saturate the image. +// hsl_shift[2] (lightness): A lightness shift, with the +// following key values: +// 0 = remove all lightness (make all pixels black). +// 0.5 = leave unchanged. +// 1 = full lightness (make all pixels white). +UI_EXPORT SkColor HSLShift(SkColor color, const HSL& shift); + +// Determine if a given alpha value is nearly completely transparent. +bool IsColorCloseToTransparent(SkAlpha alpha); + +// Determine if a color is near grey. +bool IsColorCloseToGrey(int r, int g, int b); + +// Builds a histogram based on the Y' of the Y'UV representation of +// this image. +UI_EXPORT void BuildLumaHistogram(const SkBitmap& bitmap, int histogram[256]); + +// Returns a blend of the supplied colors, ranging from |background| (for +// |alpha| == 0) to |foreground| (for |alpha| == 255). The alpha channels of +// the supplied colors are also taken into account, so the returned color may +// be partially transparent. +UI_EXPORT SkColor AlphaBlend(SkColor foreground, SkColor background, + SkAlpha alpha); + +// Makes a dark color lighter or a light color darker by blending |color| with +// white or black depending on its current luminance. |alpha| controls the +// amount of white or black that will be alpha-blended into |color|. +UI_EXPORT SkColor BlendTowardOppositeLuminance(SkColor color, SkAlpha alpha); + +// Given an opaque foreground and background color, try to return a foreground +// color that is "readable" over the background color by luma-inverting the +// foreground color and then picking whichever foreground color has higher +// contrast against the background color. You should not pass colors with +// non-255 alpha to this routine, since determining the correct behavior in such +// cases can be impossible. +// +// NOTE: This won't do anything but waste time if the supplied foreground color +// has a luma value close to the midpoint (0.5 in the HSL representation). +UI_EXPORT SkColor GetReadableColor(SkColor foreground, SkColor background); + +// Invert a color. +UI_EXPORT SkColor InvertColor(SkColor color); + +// Gets a Windows system color as a SkColor +UI_EXPORT SkColor GetSysSkColor(int which); + +} // namespace color_utils + +#endif // UI_GFX_COLOR_UTILS_H_ |