Implement SkBaseDevice snapshot support

include/core/SkSurface.h

 /*
  * Copyright 2012 Google Inc.
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 #ifndef SkSurface_DEFINED
 #define SkSurface_DEFINED
 
@@ skipping 91 matching lines @@
                                       const SkSurfaceProps* = NULL);
 
     static SkSurface* NewRenderTarget(GrContext* gr, Budgeted b, const SkImageInfo& info) {
         return NewRenderTarget(gr, b, info, 0, NULL);
     }
 
     int width() const { return fWidth; }
     int height() const { return fHeight; }
 
     /**
-     *  Returns a unique non-zero, unique value identifying the content of this
-     *  surface. Each time the content is changed changed, either by drawing
-     *  into this surface, or explicitly calling notifyContentChanged()) this
-     *  method will return a new value.
+     *  Returns a unique non-zero value identifying the content of this
+     *  surface. Each time the content is changed changed by drawing
+     *  into this surface through the canvas, this method will return a new
+     *  value.
      *
-     *  If this surface is empty (i.e. has a zero-dimention), this will return
+     *  Implementations guarantee that all generationIDs are unique among
+     *  all possible SkSurfaces and their possible contents.
+     *
+     *  If this surface is empty (i.e. has a zero-dimension), this will return
      *  0.
      */
-    uint32_t generationID();
-
-    /**
-     *  Modes that can be passed to notifyContentWillChange
-     */
-    enum ContentChangeMode {
-        /**
-         *  Use this mode if it is known that the upcoming content changes will
-         *  clear or overwrite prior contents, thus making them discardable.
-         */
-        kDiscard_ContentChangeMode,
-        /**
-         *  Use this mode if prior surface contents need to be preserved or
-         *  if in doubt.
-         */
-        kRetain_ContentChangeMode,
-    };
-
-    /**
-     *  Call this if the contents are about to change. This will (lazily) force a new
-     *  value to be returned from generationID() when it is called next.
-     */
-    void notifyContentWillChange(ContentChangeMode mode);
+    virtual uint32_t generationID() = 0;
 
     /**
      *  Return a canvas that will draw into this surface. This will always
      *  return the same canvas for a given surface, and is manged/owned by the
      *  surface. It should not be used when its parent surface has gone out of
      *  scope.
      */
     SkCanvas* getCanvas();
 
     /**
@@ skipping 61 matching lines @@
      */
     bool readPixels(const SkImageInfo& dstInfo, void* dstPixels, size_t dstRowBytes,
                     int srcX, int srcY);
 
     const SkSurfaceProps& props() const { return fProps; }
 
 protected:
     SkSurface(int width, int height, const SkSurfaceProps*);
     SkSurface(const SkImageInfo&, const SkSurfaceProps*);
 
-    // called by subclass if their contents have changed
-    void dirtyGenerationID() {
-        fGenerationID = 0;
-    }
-
 private:
     const SkSurfaceProps fProps;
     const int            fWidth;
     const int            fHeight;
-    uint32_t             fGenerationID;
 
     typedef SkRefCnt INHERITED;
 };
 
 #endif