Simplify life for people trying to pick a "readable" foreground color by not ...

app/gfx/color_utils.h

 // Copyright (c) 2009 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 APP_GFX_COLOR_UTILS_H_
 #define APP_GFX_COLOR_UTILS_H_
 
 #include "third_party/skia/include/core/SkColor.h"
 
 class SkBitmap;
@@ skipping 39 matching lines @@
 SkColor GetAverageColorOfFavicon(SkBitmap* bitmap, SkAlpha alpha);
 
 // Builds a histogram based on the Y' of the Y'UV representation of
 // this image.
 void BuildLumaHistogram(SkBitmap* bitmap, int histogram[256]);
 
 // Returns a blend of the supplied colors, ranging from |background| (for
 // |alpha| == 0) to |foreground| (for |alpha| == 255).
 SkColor AlphaBlend(SkColor foreground, SkColor background, SkAlpha alpha);
 
-// Given two possible foreground colors, return the one that is more readable
-// over |background|.
-SkColor PickMoreReadableColor(SkColor foreground1,
-                              SkColor foreground2,
-                              SkColor background);
+// Given a 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.
+//
+// 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).
+SkColor GetReadableColor(SkColor foreground, SkColor background);
 
 // Gets a Windows system color as a SkColor
 SkColor GetSysSkColor(int which);
 
 }  // namespace color_utils
 
 #endif  // APP_GFX_COLOR_UTILS_H_