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.
5 #ifndef CC_LAYERS_PICTURE_LAYER_IMPL_H_
6 #define CC_LAYERS_PICTURE_LAYER_IMPL_H_
12 #include "cc/base/cc_export.h"
13 #include "cc/base/scoped_ptr_vector.h"
14 #include "cc/layers/layer_impl.h"
15 #include "cc/resources/picture_layer_tiling.h"
16 #include "cc/resources/picture_layer_tiling_set.h"
17 #include "cc/resources/picture_pile_impl.h"
18 #include "skia/ext/refptr.h"
19 #include "third_party/skia/include/core/SkPicture.h"
23 struct AppendQuadsData;
24 class MicroBenchmarkImpl;
27 class CC_EXPORT PictureLayerImpl
29 NON_EXPORTED_BASE(public PictureLayerTilingClient) {
31 struct CC_EXPORT Pair {
33 Pair(PictureLayerImpl* active_layer, PictureLayerImpl* pending_layer);
36 PictureLayerImpl* active;
37 PictureLayerImpl* pending;
40 class CC_EXPORT LayerRasterTileIterator {
42 LayerRasterTileIterator();
43 LayerRasterTileIterator(PictureLayerImpl* layer, bool prioritize_low_res);
44 ~LayerRasterTileIterator();
47 const Tile* operator*() const;
48 LayerRasterTileIterator& operator++();
49 operator bool() const;
52 enum IteratorType { LOW_RES, HIGH_RES, NUM_ITERATORS };
54 void AdvanceToNextStage();
56 PictureLayerImpl* layer_;
58 struct IterationStage {
59 IteratorType iterator_type;
60 TilePriority::PriorityBin tile_type;
63 size_t current_stage_;
65 // One low res stage, and three high res stages.
66 IterationStage stages_[4];
67 PictureLayerTiling::TilingRasterTileIterator iterators_[NUM_ITERATORS];
70 class CC_EXPORT LayerEvictionTileIterator {
72 LayerEvictionTileIterator();
73 LayerEvictionTileIterator(PictureLayerImpl* layer,
74 TreePriority tree_priority);
75 ~LayerEvictionTileIterator();
78 const Tile* operator*() const;
79 LayerEvictionTileIterator& operator++();
80 operator bool() const;
83 bool AdvanceToNextCategory();
84 bool AdvanceToNextTilingRangeType();
85 bool AdvanceToNextTiling();
87 PictureLayerTilingSet::TilingRange CurrentTilingRange() const;
88 size_t CurrentTilingIndex() const;
90 PictureLayerImpl* layer_;
91 TreePriority tree_priority_;
93 PictureLayerTiling::EvictionCategory current_category_;
94 PictureLayerTilingSet::TilingRangeType current_tiling_range_type_;
95 size_t current_tiling_;
96 PictureLayerTiling::TilingEvictionTileIterator current_iterator_;
99 static scoped_ptr<PictureLayerImpl> Create(LayerTreeImpl* tree_impl, int id) {
100 return make_scoped_ptr(new PictureLayerImpl(tree_impl, id));
102 ~PictureLayerImpl() override;
104 // LayerImpl overrides.
105 const char* LayerTypeAsString() const override;
106 scoped_ptr<LayerImpl> CreateLayerImpl(LayerTreeImpl* tree_impl) override;
107 void PushPropertiesTo(LayerImpl* layer) override;
108 void AppendQuads(RenderPass* render_pass,
109 const Occlusion& occlusion_in_content_space,
110 AppendQuadsData* append_quads_data) override;
111 void UpdateTiles(const Occlusion& occlusion_in_content_space,
112 bool resourceless_software_draw) override;
113 void NotifyTileStateChanged(const Tile* tile) override;
114 void DidBecomeActive() override;
115 void DidBeginTracing() override;
116 void ReleaseResources() override;
117 skia::RefPtr<SkPicture> GetPicture() override;
119 // PictureLayerTilingClient overrides.
120 scoped_refptr<Tile> CreateTile(PictureLayerTiling* tiling,
121 const gfx::Rect& content_rect) override;
122 RasterSource* GetRasterSource() override;
123 gfx::Size CalculateTileSize(const gfx::Size& content_bounds) const override;
124 const Region* GetPendingInvalidation() override;
125 const PictureLayerTiling* GetPendingOrActiveTwinTiling(
126 const PictureLayerTiling* tiling) const override;
127 PictureLayerTiling* GetRecycledTwinTiling(
128 const PictureLayerTiling* tiling) override;
129 size_t GetMaxTilesForInterestArea() const override;
130 float GetSkewportTargetTimeInSeconds() const override;
131 int GetSkewportExtrapolationLimitInContentPixels() const override;
132 WhichTree GetTree() const override;
133 bool RequiresHighResToDraw() const override;
135 // PushPropertiesTo active tree => pending tree.
136 void SyncTiling(const PictureLayerTiling* tiling);
138 // Mask-related functions.
139 void GetContentsResourceId(ResourceProvider::ResourceId* resource_id,
140 gfx::Size* resource_size) const override;
142 size_t GPUMemoryUsageInBytes() const override;
144 void RunMicroBenchmark(MicroBenchmarkImpl* benchmark) override;
146 // Functions used by tile manager.
147 PictureLayerImpl* GetPendingOrActiveTwinLayer() const;
148 bool IsOnActiveOrPendingTree() const;
149 // Virtual for testing.
150 virtual bool HasValidTilePriorities() const;
151 bool AllTilesRequiredForActivationAreReadyToDraw() const;
154 friend class LayerRasterTileIterator;
156 PictureLayerImpl(LayerTreeImpl* tree_impl, int id);
157 PictureLayerTiling* AddTiling(float contents_scale);
158 void RemoveTiling(float contents_scale);
159 void RemoveAllTilings();
160 void SyncFromActiveLayer(const PictureLayerImpl* other);
161 void AddTilingsForRasterScale();
162 void UpdateTilePriorities(const Occlusion& occlusion_in_content_space);
163 virtual bool ShouldAdjustRasterScale() const;
164 virtual void RecalculateRasterScales();
165 void CleanUpTilingsOnActiveLayer(
166 std::vector<PictureLayerTiling*> used_tilings);
167 float MinimumContentsScale() const;
168 float SnappedContentsScale(float new_contents_scale);
169 void ResetRasterScale();
170 gfx::Rect GetViewportForTilePriorityInContentSpace() const;
171 PictureLayerImpl* GetRecycledTwinLayer() const;
172 void UpdatePile(scoped_refptr<PicturePileImpl> pile);
174 void DoPostCommitInitializationIfNeeded() {
175 if (needs_post_commit_initialization_)
176 DoPostCommitInitialization();
178 void DoPostCommitInitialization();
180 bool CanHaveTilings() const;
181 bool CanHaveTilingWithScale(float contents_scale) const;
182 void SanityCheckTilingState() const;
184 bool ShouldAdjustRasterScaleDuringScaleAnimations() const;
186 void GetDebugBorderProperties(SkColor* color, float* width) const override;
187 void GetAllTilesForTracing(std::set<const Tile*>* tiles) const override;
188 void AsValueInto(base::debug::TracedValue* dict) const override;
190 virtual void UpdateIdealScales();
191 float MaximumTilingContentsScale() const;
193 PictureLayerImpl* twin_layer_;
195 scoped_ptr<PictureLayerTilingSet> tilings_;
196 scoped_refptr<PicturePileImpl> pile_;
197 Region invalidation_;
199 float ideal_page_scale_;
200 float ideal_device_scale_;
201 float ideal_source_scale_;
202 float ideal_contents_scale_;
204 float raster_page_scale_;
205 float raster_device_scale_;
206 float raster_source_scale_;
207 float raster_contents_scale_;
208 float low_res_raster_contents_scale_;
210 bool raster_source_scale_is_fixed_;
211 bool was_screen_space_transform_animating_;
212 bool needs_post_commit_initialization_;
213 // A sanity state check to make sure UpdateTilePriorities only gets called
214 // after a CalculateContentsScale/ManageTilings.
215 bool should_update_tile_priorities_;
216 bool only_used_low_res_last_append_quads_;
218 // Any draw properties derived from |transform|, |viewport|, and |clip|
219 // parameters in LayerTreeHostImpl::SetExternalDrawConstraints are not valid
220 // for prioritizing tiles during resourceless software draws. This is because
221 // resourceless software draws can have wildly different transforms/viewports
222 // from regular draws. Save a copy of the required draw properties of the last
223 // frame that has a valid viewport for prioritizing tiles.
224 gfx::Rect visible_rect_for_tile_priority_;
226 friend class PictureLayer;
227 DISALLOW_COPY_AND_ASSIGN(PictureLayerImpl);
232 #endif // CC_LAYERS_PICTURE_LAYER_IMPL_H_