cc/playback/raster_source.h

   1 // Copyright 2014 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_PLAYBACK_RASTER_SOURCE_H_
   6 #define CC_PLAYBACK_RASTER_SOURCE_H_
   7
   8 #include <vector>
   9
  10 #include "base/memory/ref_counted.h"
  11 #include "cc/base/cc_export.h"
  12 #include "cc/debug/traced_value.h"
  13 #include "skia/ext/pixel_ref_utils.h"
  14 #include "skia/ext/refptr.h"
  15 #include "third_party/skia/include/core/SkColor.h"
  16 #include "third_party/skia/include/core/SkPixelRef.h"
  17 #include "ui/gfx/geometry/rect.h"
  18 #include "ui/gfx/geometry/size.h"
  19
  20 class SkCanvas;
  21 class SkPicture;
  22
  23 namespace cc {
  24
  25 class Picture;
  26
  27 class CC_EXPORT RasterSource : public base::RefCountedThreadSafe<RasterSource> {
  28  public:
  29   struct CC_EXPORT SolidColorAnalysis {
  30     SolidColorAnalysis()
  31         : is_solid_color(false), solid_color(SK_ColorTRANSPARENT) {}
  32     ~SolidColorAnalysis() {}
  33
  34     bool is_solid_color;
  35     SkColor solid_color;
  36   };
  37
  38   // Raster a subrect of this RasterSource into the given canvas. It is
  39   // assumed that contents_scale has already been applied to this canvas.
  40   // Writes the total number of pixels rasterized and the time spent
  41   // rasterizing to the stats if the respective pointer is not nullptr.
  42   // It is assumed that the canvas passed here will only be rasterized by
  43   // this raster source via this call.
  44   virtual void PlaybackToCanvas(SkCanvas* canvas,
  45                                 const gfx::Rect& canvas_bitmap_rect,
  46                                 const gfx::Rect& canvas_playback_rect,
  47                                 float contents_scale) const = 0;
  48
  49   // Similar to above, except that the canvas passed here can (or was already)
  50   // rasterized into by another raster source. That is, it is not safe to clear
  51   // the canvas or discard its underlying memory.
  52   virtual void PlaybackToSharedCanvas(SkCanvas* canvas,
  53                                       const gfx::Rect& canvas_rect,
  54                                       float contents_scale) const = 0;
  55
  56   // Analyze to determine if the given rect at given scale is of solid color in
  57   // this raster source.
  58   virtual void PerformSolidColorAnalysis(
  59       const gfx::Rect& content_rect,
  60       float contents_scale,
  61       SolidColorAnalysis* analysis) const = 0;
  62
  63   // Returns true iff the whole raster source is of solid color.
  64   virtual bool IsSolidColor() const = 0;
  65
  66   // Returns the color of the raster source if it is solid color. The results
  67   // are unspecified if IsSolidColor returns false.
  68   virtual SkColor GetSolidColor() const = 0;
  69
  70   // Returns the size of this raster source.
  71   virtual gfx::Size GetSize() const = 0;
  72
  73   // Populate the given list with all SkPixelRefs that may overlap the given
  74   // rect at given scale.
  75   virtual void GatherPixelRefs(
  76       const gfx::Rect& content_rect,
  77       float contents_scale,
  78       std::vector<skia::PositionPixelRef>* pixel_refs) const = 0;
  79
  80   // Return true iff this raster source can raster the given rect at given
  81   // scale.
  82   virtual bool CoversRect(const gfx::Rect& content_rect,
  83                           float contents_scale) const = 0;
  84
  85   // Returns true if this raster source has anything to rasterize.
  86   virtual bool HasRecordings() const = 0;
  87
  88   // Informs the raster source that it should attempt to use distance field text
  89   // during rasterization.
  90   virtual void SetShouldAttemptToUseDistanceFieldText() = 0;
  91
  92   // Return true iff this raster source would benefit from using distance
  93   // field text.
  94   virtual bool ShouldAttemptToUseDistanceFieldText() const = 0;
  95
  96   // Tracing functionality.
  97   virtual void DidBeginTracing() = 0;
  98   virtual void AsValueInto(base::trace_event::TracedValue* array) const = 0;
  99   virtual skia::RefPtr<SkPicture> GetFlattenedPicture() = 0;
 100   virtual size_t GetPictureMemoryUsage() const = 0;
 101
 102   // Return true if LCD anti-aliasing may be used when rastering text.
 103   virtual bool CanUseLCDText() const = 0;
 104
 105   virtual scoped_refptr<RasterSource> CreateCloneWithoutLCDText() const = 0;
 106
 107  protected:
 108   friend class base::RefCountedThreadSafe<RasterSource>;
 109
 110   RasterSource() {}
 111   virtual ~RasterSource() {}
 112
 113  private:
 114   DISALLOW_COPY_AND_ASSIGN(RasterSource);
 115 };
 116
 117 }  // namespace cc
 118
 119 #endif  // CC_PLAYBACK_RASTER_SOURCE_H_