[Favicon] Add new fallback icon rendering flow.

components/favicon_base/favicon_types.h

 // Copyright 2014 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 COMPONENTS_FAVICON_BASE_FAVICON_TYPES_H_
 #define COMPONENTS_FAVICON_BASE_FAVICON_TYPES_H_
 
 #include "base/memory/ref_counted_memory.h"
+#include "third_party/skia/include/core/SkColor.h"
 #include "ui/gfx/geometry/size.h"
 #include "ui/gfx/image/image.h"
 #include "url/gurl.h"
 
 namespace favicon_base {
 
 typedef int64 FaviconID;
 
 // Defines the icon types. They are also stored in icon_type field of favicons
 // table.
@@ skipping 46 matching lines @@
   GURL icon_url;
 
   // The icon type of the containing favicon.
   IconType icon_type;
 };
 
 // Define type with same structure as FaviconRawBitmapResult for passing data to
 // HistoryBackend::SetFavicons().
 typedef FaviconRawBitmapResult FaviconRawBitmapData;
 
+// Styling specifications of a fallback icon. The icon is composed of a solid
+// rounded square containing a single letter. The specification excludes the
+// icon URL and size, which are given when the icon is rendered.
+struct FallbackIconStyle {
+  FallbackIconStyle();
+  ~FallbackIconStyle();
+
+  // Reassigns |text_color| so it matches well with |background_color|.
+  void MatchTextColorWithBackgroundColor();
+
+  // Returns true if values stored are within bounds.
+  bool is_valid() const;
+
+  // Icon background fill color.
+  SkColor background_color;
+
+  // Icon text color.
+  SkColor text_color;
+
+  // Ratio in [0.0, 1.0] of the text font size (pixels) to the icon size.
+  double font_size_ratio;
+
+  // The roundness of the icon's corners. 0 => square icon, 1 => circle icon.
+  double roundness;
+
+  // If any member changes, also update FallbackIconStyleBuilder.

[stevenjb, 2015/01/29 21:41:08]

Move this comment above the members.

[huangs, 2015/01/29 23:48:27]

This was placed here since adding new member usually occurs at the end.  But
then again change may also mean removing...  Moved above the members.

+};
+
 }  // namespace favicon_base
 
 #endif  // COMPONENTS_FAVICON_BASE_FAVICON_TYPES_H_