15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef UI_VIEWS_PAINTER_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define UI_VIEWS_PAINTER_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h" 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/compiler_specific.h" 10a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)#include "base/memory/scoped_ptr.h" 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "third_party/skia/include/core/SkColor.h" 125d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)#include "ui/base/nine_image_painter_factory.h" 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ui/views/views_export.h" 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace gfx { 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class Canvas; 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class ImageSkia; 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class Insets; 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class Rect; 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class Size; 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace views { 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 25a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles)class View; 26a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Painter, as the name implies, is responsible for painting in a particular 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// region. Think of Painter as a Border or Background that can be painted 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// in any region of a View. 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class VIEWS_EXPORT Painter { 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 3290dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) Painter(); 3390dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) virtual ~Painter(); 3490dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A convenience method for painting a Painter in a particular region. 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // This translates the canvas to x/y and paints the painter. 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static void PaintPainterAt(gfx::Canvas* canvas, 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) Painter* painter, 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const gfx::Rect& rect); 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 41a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) // Convenience that paints |focus_painter| only if |view| HasFocus() and 42a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) // |focus_painter| is non-NULL. 43a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) static void PaintFocusPainter(View* view, 44a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) gfx::Canvas* canvas, 45a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) Painter* focus_painter); 46a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Creates a painter that draws a gradient between the two colors. 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static Painter* CreateHorizontalGradient(SkColor c1, SkColor c2); 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static Painter* CreateVerticalGradient(SkColor c1, SkColor c2); 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Creates a painter that draws a multi-color gradient. |colors| contains the 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // gradient colors and |pos| the relative positions of the colors. The first 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // element in |pos| must be 0.0 and the last element 1.0. |count| contains 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // the number of elements in |colors| and |pos|. 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static Painter* CreateVerticalMultiColorGradient(SkColor* colors, 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SkScalar* pos, 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) size_t count); 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Creates a painter that divides |image| into nine regions. The four corners 602a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) // are rendered at the size specified in insets (eg. the upper-left corner is 61c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // rendered at 0 x 0 with a size of insets.left() x insets.top()). The center 62c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // and edge images are stretched to fill the painted area. 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) static Painter* CreateImagePainter(const gfx::ImageSkia& image, 642a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) const gfx::Insets& insets); 652a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) 66c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // Creates a painter that paints images in a scalable grid. The images must 67c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // share widths by column and heights by row. The corners are painted at full 68c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // size, while center and edge images are stretched to fill the painted area. 69c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // The center image may be zero (to be skipped). This ordering must be used: 70c2e0dbddbe15c98d52c4786dac06cb8952a8ae6dTorne (Richard Coles) // Top-Left/Top/Top-Right/Left/[Center]/Right/Bottom-Left/Bottom/Bottom-Right. 712a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles) static Painter* CreateImageGridPainter(const int image_ids[]); 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 73a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) // Factory methods for creating painters intended for rendering focus. 74a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) static scoped_ptr<Painter> CreateDashedFocusPainter(); 75a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) static scoped_ptr<Painter> CreateDashedFocusPainterWithInsets( 76a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) const gfx::Insets& insets); 77a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) static scoped_ptr<Painter> CreateSolidFocusPainter(SkColor color, 78a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) const gfx::Insets& insets); 79a3f6a49ab37290eeeb8db0f41ec0f1cb74a68be7Torne (Richard Coles) 8090dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // Returns the minimum size this painter can paint without obvious graphical 8190dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // problems (e.g. overlapping images). 8290dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) virtual gfx::Size GetMinimumSize() const = 0; 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Paints the painter in the specified region. 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void Paint(gfx::Canvas* canvas, const gfx::Size& size) = 0; 8690dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) 8790dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) private: 8890dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(Painter); 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 915821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// HorizontalPainter paints 3 images into a box: left, center and right. The 925821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// left and right images are drawn to size at the left/right edges of the 935821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// region. The center is tiled in the remaining space. All images must have the 945821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// same height. 955821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class VIEWS_EXPORT HorizontalPainter : public Painter { 965821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Constructs a new HorizontalPainter loading the specified image names. 985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The images must be in the order left, right and center. 995821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) explicit HorizontalPainter(const int image_resource_names[]); 10090dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) virtual ~HorizontalPainter(); 1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 10290dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) // Painter: 10390dce4d38c5ff5333bea97d859d4e484e27edf0cTorne (Richard Coles) virtual gfx::Size GetMinimumSize() const OVERRIDE; 1045821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual void Paint(gfx::Canvas* canvas, const gfx::Size& size) OVERRIDE; 1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 1075821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The image chunks. 1085821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) enum BorderElements { 1095821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) LEFT, 1105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CENTER, 1115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) RIGHT 1125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) }; 1135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // NOTE: the images are owned by ResourceBundle. Don't free them. 1155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) const gfx::ImageSkia* images_[3]; 1165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(HorizontalPainter); 1185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 1195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace views 1215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 1225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // UI_VIEWS_PAINTER_H_ 123