1 // Copyright 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 #ifndef CC_RESOURCES_PICTURE_LAYER_TILING_H_ 6 #define CC_RESOURCES_PICTURE_LAYER_TILING_H_ 7 8 #include <utility> 9 #include <vector> 10 11 #include "base/basictypes.h" 12 #include "base/containers/hash_tables.h" 13 #include "base/memory/scoped_ptr.h" 14 #include "cc/base/cc_export.h" 15 #include "cc/base/region.h" 16 #include "cc/base/tiling_data.h" 17 #include "cc/resources/tile.h" 18 #include "cc/resources/tile_priority.h" 19 #include "ui/gfx/rect.h" 20 21 namespace cc { 22 23 class PictureLayerTiling; 24 25 class CC_EXPORT PictureLayerTilingClient { 26 public: 27 // Create a tile at the given content_rect (in the contents scale of the 28 // tiling) This might return null if the client cannot create such a tile. 29 virtual scoped_refptr<Tile> CreateTile( 30 PictureLayerTiling* tiling, 31 gfx::Rect content_rect) = 0; 32 virtual void UpdatePile(Tile* tile) = 0; 33 virtual gfx::Size CalculateTileSize( 34 gfx::Size content_bounds) const = 0; 35 virtual const Region* GetInvalidation() = 0; 36 virtual const PictureLayerTiling* GetTwinTiling( 37 const PictureLayerTiling* tiling) = 0; 38 39 protected: 40 virtual ~PictureLayerTilingClient() {} 41 }; 42 43 class CC_EXPORT PictureLayerTiling { 44 public: 45 ~PictureLayerTiling(); 46 47 // Create a tiling with no tiles. CreateTiles must be called to add some. 48 static scoped_ptr<PictureLayerTiling> Create( 49 float contents_scale, 50 gfx::Size layer_bounds, 51 PictureLayerTilingClient* client); 52 gfx::Size layer_bounds() const { return layer_bounds_; } 53 void SetLayerBounds(gfx::Size layer_bounds); 54 void Invalidate(const Region& layer_region); 55 void CreateMissingTilesInLiveTilesRect(); 56 57 void SetCanUseLCDText(bool can_use_lcd_text); 58 59 void SetClient(PictureLayerTilingClient* client); 60 void set_resolution(TileResolution resolution) { resolution_ = resolution; } 61 TileResolution resolution() const { return resolution_; } 62 63 gfx::Rect ContentRect() const; 64 gfx::SizeF ContentSizeF() const; 65 gfx::Rect live_tiles_rect() const { return live_tiles_rect_; } 66 gfx::Size tile_size() const { return tiling_data_.max_texture_size(); } 67 float contents_scale() const { return contents_scale_; } 68 69 void CreateAllTilesForTesting() { 70 SetLiveTilesRect(gfx::Rect(tiling_data_.total_size())); 71 } 72 73 std::vector<Tile*> AllTilesForTesting() const { 74 std::vector<Tile*> all_tiles; 75 for (TileMap::const_iterator it = tiles_.begin(); 76 it != tiles_.end(); ++it) 77 all_tiles.push_back(it->second.get()); 78 return all_tiles; 79 } 80 81 // Iterate over all tiles to fill content_rect. Even if tiles are invalid 82 // (i.e. no valid resource) this tiling should still iterate over them. 83 // The union of all geometry_rect calls for each element iterated over should 84 // exactly equal content_rect and no two geometry_rects should intersect. 85 class CC_EXPORT CoverageIterator { 86 public: 87 CoverageIterator(); 88 CoverageIterator(const PictureLayerTiling* tiling, 89 float dest_scale, 90 gfx::Rect rect); 91 ~CoverageIterator(); 92 93 // Visible rect (no borders), always in the space of content_rect, 94 // regardless of the contents scale of the tiling. 95 gfx::Rect geometry_rect() const; 96 // Texture rect (in texels) for geometry_rect 97 gfx::RectF texture_rect() const; 98 gfx::Size texture_size() const; 99 100 // Full rect (including borders) of the current tile, always in the space 101 // of content_rect, regardless of the contents scale of the tiling. 102 gfx::Rect full_tile_geometry_rect() const; 103 104 Tile* operator->() const { return current_tile_; } 105 Tile* operator*() const { return current_tile_; } 106 107 CoverageIterator& operator++(); 108 operator bool() const { return tile_j_ <= bottom_; } 109 110 private: 111 const PictureLayerTiling* tiling_; 112 gfx::Rect dest_rect_; 113 float dest_to_content_scale_; 114 115 Tile* current_tile_; 116 gfx::Rect current_geometry_rect_; 117 int tile_i_; 118 int tile_j_; 119 int left_; 120 int top_; 121 int right_; 122 int bottom_; 123 124 friend class PictureLayerTiling; 125 }; 126 127 Region OpaqueRegionInContentRect(gfx::Rect content_rect) const; 128 129 void Reset(); 130 131 void UpdateTilePriorities( 132 WhichTree tree, 133 gfx::Size device_viewport, 134 gfx::Rect viewport_in_layer_space, 135 gfx::Rect visible_layer_rect, 136 gfx::Size last_layer_bounds, 137 gfx::Size current_layer_bounds, 138 float last_layer_contents_scale, 139 float current_layer_contents_scale, 140 const gfx::Transform& last_screen_transform, 141 const gfx::Transform& current_screen_transform, 142 double current_frame_time_in_seconds, 143 size_t max_tiles_for_interest_area); 144 145 // Copies the src_tree priority into the dst_tree priority for all tiles. 146 // The src_tree priority is reset to the lowest priority possible. This 147 // also updates the pile on each tile to be the current client's pile. 148 void DidBecomeActive(); 149 150 void UpdateTilesToCurrentPile(); 151 152 bool NeedsUpdateForFrameAtTime(double frame_time_in_seconds) { 153 return frame_time_in_seconds != last_impl_frame_time_in_seconds_; 154 } 155 156 scoped_ptr<base::Value> AsValue() const; 157 size_t GPUMemoryUsageInBytes() const; 158 159 static gfx::Rect ExpandRectEquallyToAreaBoundedBy( 160 gfx::Rect starting_rect, 161 int64 target_area, 162 gfx::Rect bounding_rect); 163 164 bool has_ever_been_updated() const { 165 return last_impl_frame_time_in_seconds_ != 0.0; 166 } 167 168 protected: 169 typedef std::pair<int, int> TileMapKey; 170 typedef base::hash_map<TileMapKey, scoped_refptr<Tile> > TileMap; 171 172 PictureLayerTiling(float contents_scale, 173 gfx::Size layer_bounds, 174 PictureLayerTilingClient* client); 175 void SetLiveTilesRect(gfx::Rect live_tiles_rect); 176 void CreateTile(int i, int j, const PictureLayerTiling* twin_tiling); 177 Tile* TileAt(int, int) const; 178 179 // Given properties. 180 float contents_scale_; 181 gfx::Size layer_bounds_; 182 TileResolution resolution_; 183 PictureLayerTilingClient* client_; 184 185 // Internal data. 186 TilingData tiling_data_; 187 TileMap tiles_; // It is not legal to have a NULL tile in the tiles_ map. 188 gfx::Rect live_tiles_rect_; 189 190 // State saved for computing velocities based upon finite differences. 191 double last_impl_frame_time_in_seconds_; 192 193 friend class CoverageIterator; 194 195 private: 196 DISALLOW_ASSIGN(PictureLayerTiling); 197 }; 198 199 } // namespace cc 200 201 #endif // CC_RESOURCES_PICTURE_LAYER_TILING_H_ 202