Add image->bitmap

include/core/SkImage.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 SkImage_DEFINED
 #define SkImage_DEFINED
 
@@ skipping 246 matching lines @@
      *    (if the new dimensions == the src dimensions and subset is NULL or == src dimensions).
      *
      *  - it is legal for the "scaled" image to have changed its SkAlphaType from unpremul
      *    to premul (as required by the impl). The image should draw (nearly) identically,
      *    since during drawing we will "apply the alpha" to the pixels. Future optimizations
      *    may take away this caveat, preserving unpremul.
      */
     SkImage* newImage(int newWidth, int newHeight, const SkIRect* subset = NULL,
                       SkFilterQuality = kNone_SkFilterQuality) const;
 
+    // Helper functions to convert to SkBitmap
+
+    enum AsBitmapMode {
+        kRO_AsBitmapMode,
+        kRW_AsBitmapMode,
+    };
+
+    /**
+     *  Attempt to create a bitmap with the same pixels as the image.
+     *
+     *  If the mode is kRO (read-only), an attempt will be made to share the actual pixel memory,
+     *  skipping the cost of a copy. If this can be done, the returned bitmap will be marked
+     *  immutable.
+     *
+     *  If it cannot, or if the mode is kRW (read-write), then a copy of the pixels will be made.
+     *

[robertphillips, 2015/07/08 15:41:26]

success

[reed1, 2015/07/08 19:14:43]

Done.

+     *  On succces, returns true. On failure, returns false and the bitmap parameter will be reset
+     *  to empty.
+     */
+    bool asBitmap(SkBitmap*, AsBitmapMode = kRO_AsBitmapMode) const;
+    
 protected:
     SkImage(int width, int height) :
         fWidth(width),
         fHeight(height),
         fUniqueID(NextUniqueID()) {
 
         SkASSERT(width > 0);
         SkASSERT(height > 0);
     }
 
 private:
     const int       fWidth;
     const int       fHeight;
     const uint32_t  fUniqueID;
 
     static uint32_t NextUniqueID();
 
     typedef SkRefCnt INHERITED;
 };
 
 #endif