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 LegacyBitmapMode {
+        kRO_LegacyBitmapMode,
+        kRW_LegacyBitmapMode,
+    };
+
+    /**
+     *  Attempt to create a bitmap with the same pixels as the image. The result will always be
+     *  a raster-backed bitmap (texture-backed bitmaps are DEPRECATED, and not supported here).
+     *
+     *  If the mode is kRO (read-only), the resulting bitmap will be marked as immutable.
+     *
+     *  On succcess, returns true. On failure, returns false and the bitmap parameter will be reset
+     *  to empty.
+     */
+    bool asLegacyBitmap(SkBitmap*, LegacyBitmapMode) 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