src/ui/views/bubble/bubble_border.cc

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #include "ui/views/bubble/bubble_border.h"
   6
   7 #include <algorithm>
   8
   9 #include "base/logging.h"
  10 #include "base/memory/scoped_ptr.h"
  11 #include "grit/ui_resources.h"
  12 #include "ui/base/resource/resource_bundle.h"
  13 #include "ui/gfx/canvas.h"
  14 #include "ui/gfx/image/image_skia.h"
  15 #include "ui/gfx/rect.h"
  16 #include "ui/gfx/skia_util.h"
  17 #include "ui/views/painter.h"
  18 #include "ui/views/view.h"
  19
  20 namespace views {
  21
  22 namespace internal {
  23
  24 // A helper that combines each border image-set painter with arrows and metrics.
  25 struct BorderImages {
  26   BorderImages(const int border_image_ids[],
  27                const int arrow_image_ids[],
  28                int border_interior_thickness,
  29                int arrow_interior_thickness,
  30                int corner_radius);
  31
  32   scoped_ptr<Painter> border_painter;
  33   gfx::ImageSkia left_arrow;
  34   gfx::ImageSkia top_arrow;
  35   gfx::ImageSkia right_arrow;
  36   gfx::ImageSkia bottom_arrow;
  37
  38   // The thickness of border and arrow images and their interior areas.
  39   // Thickness is the width of left/right and the height of top/bottom images.
  40   // The interior is measured without including stroke or shadow pixels.
  41   int border_thickness;
  42   int border_interior_thickness;
  43   int arrow_thickness;
  44   int arrow_interior_thickness;
  45   // The corner radius of the bubble's rounded-rect interior area.
  46   int corner_radius;
  47 };
  48
  49 BorderImages::BorderImages(const int border_image_ids[],
  50                            const int arrow_image_ids[],
  51                            int border_interior_thickness,
  52                            int arrow_interior_thickness,
  53                            int corner_radius)
  54     : border_painter(Painter::CreateImageGridPainter(border_image_ids)),
  55       border_thickness(0),
  56       border_interior_thickness(border_interior_thickness),
  57       arrow_thickness(0),
  58       arrow_interior_thickness(arrow_interior_thickness),
  59       corner_radius(corner_radius) {
  60   ResourceBundle& rb = ResourceBundle::GetSharedInstance();
  61   border_thickness = rb.GetImageSkiaNamed(border_image_ids[0])->width();
  62   if (arrow_image_ids[0] != 0) {
  63     left_arrow = *rb.GetImageSkiaNamed(arrow_image_ids[0]);
  64     top_arrow = *rb.GetImageSkiaNamed(arrow_image_ids[1]);
  65     right_arrow = *rb.GetImageSkiaNamed(arrow_image_ids[2]);
  66     bottom_arrow = *rb.GetImageSkiaNamed(arrow_image_ids[3]);
  67     arrow_thickness = top_arrow.height();
  68   }
  69 }
  70
  71 }  // namespace internal
  72
  73 namespace {
  74
  75 // The border and arrow stroke size used in image assets, in pixels.
  76 const int kStroke = 1;
  77
  78 // Bubble border and arrow image resource ids. They don't use the IMAGE_GRID
  79 // macro because there is no center image.
  80 const int kNoShadowImages[] = {
  81     IDR_BUBBLE_TL, IDR_BUBBLE_T, IDR_BUBBLE_TR,
  82     IDR_BUBBLE_L,  0,            IDR_BUBBLE_R,
  83     IDR_BUBBLE_BL, IDR_BUBBLE_B, IDR_BUBBLE_BR };
  84 const int kNoShadowArrows[] = {
  85     IDR_BUBBLE_L_ARROW, IDR_BUBBLE_T_ARROW,
  86     IDR_BUBBLE_R_ARROW, IDR_BUBBLE_B_ARROW, };
  87
  88 const int kBigShadowImages[] = {
  89     IDR_WINDOW_BUBBLE_SHADOW_BIG_TOP_LEFT,
  90     IDR_WINDOW_BUBBLE_SHADOW_BIG_TOP,
  91     IDR_WINDOW_BUBBLE_SHADOW_BIG_TOP_RIGHT,
  92     IDR_WINDOW_BUBBLE_SHADOW_BIG_LEFT,
  93     0,
  94     IDR_WINDOW_BUBBLE_SHADOW_BIG_RIGHT,
  95     IDR_WINDOW_BUBBLE_SHADOW_BIG_BOTTOM_LEFT,
  96     IDR_WINDOW_BUBBLE_SHADOW_BIG_BOTTOM,
  97     IDR_WINDOW_BUBBLE_SHADOW_BIG_BOTTOM_RIGHT };
  98 const int kBigShadowArrows[] = {
  99     IDR_WINDOW_BUBBLE_SHADOW_SPIKE_BIG_LEFT,
 100     IDR_WINDOW_BUBBLE_SHADOW_SPIKE_BIG_TOP,
 101     IDR_WINDOW_BUBBLE_SHADOW_SPIKE_BIG_RIGHT,
 102     IDR_WINDOW_BUBBLE_SHADOW_SPIKE_BIG_BOTTOM };
 103
 104 const int kSmallShadowImages[] = {
 105     IDR_WINDOW_BUBBLE_SHADOW_SMALL_TOP_LEFT,
 106     IDR_WINDOW_BUBBLE_SHADOW_SMALL_TOP,
 107     IDR_WINDOW_BUBBLE_SHADOW_SMALL_TOP_RIGHT,
 108     IDR_WINDOW_BUBBLE_SHADOW_SMALL_LEFT,
 109     0,
 110     IDR_WINDOW_BUBBLE_SHADOW_SMALL_RIGHT,
 111     IDR_WINDOW_BUBBLE_SHADOW_SMALL_BOTTOM_LEFT,
 112     IDR_WINDOW_BUBBLE_SHADOW_SMALL_BOTTOM,
 113     IDR_WINDOW_BUBBLE_SHADOW_SMALL_BOTTOM_RIGHT };
 114 const int kSmallShadowArrows[] = {
 115     IDR_WINDOW_BUBBLE_SHADOW_SPIKE_SMALL_LEFT,
 116     IDR_WINDOW_BUBBLE_SHADOW_SPIKE_SMALL_TOP,
 117     IDR_WINDOW_BUBBLE_SHADOW_SPIKE_SMALL_RIGHT,
 118     IDR_WINDOW_BUBBLE_SHADOW_SPIKE_SMALL_BOTTOM };
 119
 120 using internal::BorderImages;
 121
 122 // Returns the cached BorderImages for the given |shadow| type.
 123 BorderImages* GetBorderImages(BubbleBorder::Shadow shadow) {
 124   // Keep a cache of bubble border image-set painters, arrows, and metrics.
 125   static BorderImages* kBorderImages[BubbleBorder::SHADOW_COUNT] = { NULL };
 126
 127   CHECK_LT(shadow, BubbleBorder::SHADOW_COUNT);
 128   struct BorderImages*& set = kBorderImages[shadow];
 129   if (set)
 130     return set;
 131
 132   switch (shadow) {
 133     case BubbleBorder::NO_SHADOW:
 134     case BubbleBorder::NO_SHADOW_OPAQUE_BORDER:
 135       set = new BorderImages(kNoShadowImages, kNoShadowArrows, 6, 7, 4);
 136       break;
 137     case BubbleBorder::BIG_SHADOW:
 138       set = new BorderImages(kBigShadowImages, kBigShadowArrows, 23, 9, 2);
 139       break;
 140     case BubbleBorder::SMALL_SHADOW:
 141       set = new BorderImages(kSmallShadowImages, kSmallShadowArrows, 5, 6, 2);
 142       break;
 143     case BubbleBorder::SHADOW_COUNT:
 144       NOTREACHED();
 145       break;
 146   }
 147
 148   return set;
 149 }
 150
 151 }  // namespace
 152
 153 BubbleBorder::BubbleBorder(Arrow arrow, Shadow shadow, SkColor color)
 154     : arrow_(arrow),
 155       arrow_offset_(0),
 156       arrow_paint_type_(PAINT_NORMAL),
 157       alignment_(ALIGN_ARROW_TO_MID_ANCHOR),
 158       shadow_(shadow),
 159       background_color_(color) {
 160   DCHECK(shadow < SHADOW_COUNT);
 161   images_ = GetBorderImages(shadow);
 162 }
 163
 164 BubbleBorder::~BubbleBorder() {}
 165
 166 gfx::Rect BubbleBorder::GetBounds(const gfx::Rect& anchor_rect,
 167                                   const gfx::Size& contents_size) const {
 168   int x = anchor_rect.x();
 169   int y = anchor_rect.y();
 170   int w = anchor_rect.width();
 171   int h = anchor_rect.height();
 172   const gfx::Size size(GetSizeForContentsSize(contents_size));
 173   const int arrow_offset = GetArrowOffset(size);
 174   const int arrow_size =
 175       images_->arrow_interior_thickness + kStroke - images_->arrow_thickness;
 176   const bool mid_anchor = alignment_ == ALIGN_ARROW_TO_MID_ANCHOR;
 177
 178   // Calculate the bubble coordinates based on the border and arrow settings.
 179   if (is_arrow_on_horizontal(arrow_)) {
 180     if (is_arrow_on_left(arrow_)) {
 181       x += mid_anchor ? w / 2 - arrow_offset : kStroke - GetBorderThickness();
 182     } else if (is_arrow_at_center(arrow_)) {
 183       x += w / 2 - arrow_offset;
 184     } else {
 185       x += mid_anchor ? w / 2 + arrow_offset - size.width() :
 186                         w - size.width() + GetBorderThickness() - kStroke;
 187     }
 188     y += is_arrow_on_top(arrow_) ? h + arrow_size : -arrow_size - size.height();
 189   } else if (has_arrow(arrow_)) {
 190     x += is_arrow_on_left(arrow_) ? w + arrow_size : -arrow_size - size.width();
 191     if (is_arrow_on_top(arrow_)) {
 192       y += mid_anchor ? h / 2 - arrow_offset : kStroke - GetBorderThickness();
 193     } else if (is_arrow_at_center(arrow_)) {
 194       y += h / 2 - arrow_offset;
 195     } else {
 196       y += mid_anchor ? h / 2 + arrow_offset - size.height() :
 197                         h - size.height() + GetBorderThickness() - kStroke;
 198     }
 199   } else {
 200     x += (w - size.width()) / 2;
 201     y += (arrow_ == NONE) ? h : (h - size.height()) / 2;
 202   }
 203
 204   return gfx::Rect(x, y, size.width(), size.height());
 205 }
 206
 207 int BubbleBorder::GetBorderThickness() const {
 208   return images_->border_thickness - images_->border_interior_thickness;
 209 }
 210
 211 int BubbleBorder::GetBorderCornerRadius() const {
 212   return images_->corner_radius;
 213 }
 214
 215 int BubbleBorder::GetArrowOffset(const gfx::Size& border_size) const {
 216   const int edge_length = is_arrow_on_horizontal(arrow_) ?
 217       border_size.width() : border_size.height();
 218   if (is_arrow_at_center(arrow_) && arrow_offset_ == 0)
 219     return edge_length / 2;
 220
 221   // Calculate the minimum offset to not overlap arrow and corner images.
 222   const int min = images_->border_thickness + (images_->top_arrow.width() / 2);
 223   // Ensure the returned value will not cause image overlap, if possible.
 224   return std::max(min, std::min(arrow_offset_, edge_length - min));
 225 }
 226
 227 void BubbleBorder::Paint(const views::View& view, gfx::Canvas* canvas) {
 228   gfx::Rect bounds(view.GetContentsBounds());
 229   bounds.Inset(-GetBorderThickness(), -GetBorderThickness());
 230   const gfx::Rect arrow_bounds = GetArrowRect(view.GetLocalBounds());
 231   if (arrow_bounds.IsEmpty()) {
 232     Painter::PaintPainterAt(canvas, images_->border_painter.get(), bounds);
 233     return;
 234   }
 235
 236   // Clip the arrow bounds out to avoid painting the overlapping edge area.
 237   canvas->Save();
 238   SkRect arrow_rect(gfx::RectToSkRect(arrow_bounds));
 239   canvas->sk_canvas()->clipRect(arrow_rect, SkRegion::kDifference_Op);
 240   Painter::PaintPainterAt(canvas, images_->border_painter.get(), bounds);
 241   canvas->Restore();
 242
 243   DrawArrow(canvas, arrow_bounds);
 244 }
 245
 246 gfx::Insets BubbleBorder::GetInsets() const {
 247   // The insets contain the stroke and shadow pixels outside the bubble fill.
 248   const int inset = GetBorderThickness();
 249   if ((arrow_paint_type_ == PAINT_NONE) || !has_arrow(arrow_))
 250     return gfx::Insets(inset, inset, inset, inset);
 251
 252   int first_inset = inset;
 253   int second_inset = std::max(inset, images_->arrow_thickness);
 254   if (is_arrow_on_horizontal(arrow_) ?
 255       is_arrow_on_top(arrow_) : is_arrow_on_left(arrow_))
 256     std::swap(first_inset, second_inset);
 257   return is_arrow_on_horizontal(arrow_) ?
 258       gfx::Insets(first_inset, inset, second_inset, inset) :
 259       gfx::Insets(inset, first_inset, inset, second_inset);
 260 }
 261
 262 gfx::Size BubbleBorder::GetMinimumSize() const {
 263   return GetSizeForContentsSize(gfx::Size());
 264 }
 265
 266 gfx::Size BubbleBorder::GetSizeForContentsSize(
 267     const gfx::Size& contents_size) const {
 268   // Enlarge the contents size by the thickness of the border images.
 269   gfx::Size size(contents_size);
 270   const gfx::Insets insets = GetInsets();
 271   size.Enlarge(insets.width(), insets.height());
 272
 273   // Ensure the bubble is large enough to not overlap border and arrow images.
 274   const int min = 2 * images_->border_thickness;
 275   const int min_with_arrow_width = min + images_->top_arrow.width();
 276   const int min_with_arrow_thickness = images_->border_thickness +
 277       std::max(images_->arrow_thickness + images_->border_interior_thickness,
 278                images_->border_thickness);
 279   // Only take arrow image sizes into account when the bubble tip is shown.
 280   if (arrow_paint_type_ == PAINT_TRANSPARENT || !has_arrow(arrow_))
 281     size.SetToMax(gfx::Size(min, min));
 282   else if (is_arrow_on_horizontal(arrow_))
 283     size.SetToMax(gfx::Size(min_with_arrow_width, min_with_arrow_thickness));
 284   else
 285     size.SetToMax(gfx::Size(min_with_arrow_thickness, min_with_arrow_width));
 286   return size;
 287 }
 288
 289 gfx::ImageSkia* BubbleBorder::GetArrowImage() const {
 290   if (!has_arrow(arrow_))
 291     return NULL;
 292   if (is_arrow_on_horizontal(arrow_)) {
 293     return is_arrow_on_top(arrow_) ?
 294         &images_->top_arrow : &images_->bottom_arrow;
 295   }
 296   return is_arrow_on_left(arrow_) ?
 297       &images_->left_arrow : &images_->right_arrow;
 298 }
 299
 300 gfx::Rect BubbleBorder::GetArrowRect(const gfx::Rect& bounds) const {
 301   if (!has_arrow(arrow_) || arrow_paint_type_ != PAINT_NORMAL)
 302     return gfx::Rect();
 303
 304   gfx::Point origin;
 305   int offset = GetArrowOffset(bounds.size());
 306   const int half_length = images_->top_arrow.width() / 2;
 307   const gfx::Insets insets = GetInsets();
 308
 309   if (is_arrow_on_horizontal(arrow_)) {
 310     origin.set_x(is_arrow_on_left(arrow_) || is_arrow_at_center(arrow_) ?
 311         offset : bounds.width() - offset);
 312     origin.Offset(-half_length, 0);
 313     if (is_arrow_on_top(arrow_))
 314       origin.set_y(insets.top() - images_->arrow_thickness);
 315     else
 316       origin.set_y(bounds.height() - insets.bottom());
 317   } else {
 318     origin.set_y(is_arrow_on_top(arrow_)  || is_arrow_at_center(arrow_) ?
 319         offset : bounds.height() - offset);
 320     origin.Offset(0, -half_length);
 321     if (is_arrow_on_left(arrow_))
 322       origin.set_x(insets.left() - images_->arrow_thickness);
 323     else
 324       origin.set_x(bounds.width() - insets.right());
 325   }
 326   return gfx::Rect(origin, GetArrowImage()->size());
 327 }
 328
 329 void BubbleBorder::DrawArrow(gfx::Canvas* canvas,
 330                              const gfx::Rect& arrow_bounds) const {
 331   canvas->DrawImageInt(*GetArrowImage(), arrow_bounds.x(), arrow_bounds.y());
 332   const bool horizontal = is_arrow_on_horizontal(arrow_);
 333   const int thickness = images_->arrow_interior_thickness;
 334   float tip_x = horizontal ? arrow_bounds.CenterPoint().x() :
 335       is_arrow_on_left(arrow_) ? arrow_bounds.right() - thickness :
 336                                  arrow_bounds.x() + thickness;
 337   float tip_y = !horizontal ? arrow_bounds.CenterPoint().y() + 0.5f :
 338       is_arrow_on_top(arrow_) ? arrow_bounds.bottom() - thickness :
 339                                 arrow_bounds.y() + thickness;
 340   const bool positive_offset = horizontal ?
 341       is_arrow_on_top(arrow_) : is_arrow_on_left(arrow_);
 342   const int offset_to_next_vertex = positive_offset ?
 343       images_->arrow_interior_thickness : -images_->arrow_interior_thickness;
 344
 345   SkPath path;
 346   path.incReserve(4);
 347   path.moveTo(SkDoubleToScalar(tip_x), SkDoubleToScalar(tip_y));
 348   path.lineTo(SkDoubleToScalar(tip_x + offset_to_next_vertex),
 349               SkDoubleToScalar(tip_y + offset_to_next_vertex));
 350   const int multiplier = horizontal ? 1 : -1;
 351   path.lineTo(SkDoubleToScalar(tip_x - multiplier * offset_to_next_vertex),
 352               SkDoubleToScalar(tip_y + multiplier * offset_to_next_vertex));
 353   path.close();
 354
 355   SkPaint paint;
 356   paint.setStyle(SkPaint::kFill_Style);
 357   paint.setColor(background_color_);
 358
 359   canvas->DrawPath(path, paint);
 360 }
 361
 362 void BubbleBackground::Paint(gfx::Canvas* canvas, views::View* view) const {
 363   if (border_->shadow() == BubbleBorder::NO_SHADOW_OPAQUE_BORDER)
 364     canvas->DrawColor(border_->background_color());
 365
 366   // Fill the contents with a round-rect region to match the border images.
 367   SkPaint paint;
 368   paint.setAntiAlias(true);
 369   paint.setStyle(SkPaint::kFill_Style);
 370   paint.setColor(border_->background_color());
 371   SkPath path;
 372   gfx::Rect bounds(view->GetLocalBounds());
 373   bounds.Inset(border_->GetInsets());
 374
 375   SkScalar radius = SkIntToScalar(border_->GetBorderCornerRadius());
 376   path.addRoundRect(gfx::RectToSkRect(bounds), radius, radius);
 377   canvas->DrawPath(path, paint);
 378 }
 379
 380 }  // namespace views