add newImage API

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
 
+#include "SkFilterQuality.h"
 #include "SkImageInfo.h"
 #include "SkImageEncoder.h"
 #include "SkRefCnt.h"
 #include "SkScalar.h"
 #include "SkShader.h"
 
 class SkData;
 class SkCanvas;
 class SkImageGenerator;
 class SkPaint;
@@ skipping 100 matching lines @@
 
     /**
      *  Return a new surface that is compatible with this image's internal representation
      *  (e.g. raster or gpu).
      *
      *  If no surfaceprops are specified, the image will attempt to match the props of when it
      *  was created (if it came from a surface).
      */
     SkSurface* newSurface(const SkImageInfo&, const SkSurfaceProps* = NULL) const;
 
+    /**
+     *  Return an image that is a rescale of this image (using newWidth, newHeight).
+     *
+     *  If subset is NULL, then the entire original image is used as the src for the scaling.
+     *  If subset is not NULL, then it specifies subset of src-pixels used for scaling. If
+     *  subset extends beyond the bounds of the original image, then NULL is returned.
+     *
+     *  Note: it is legal for the returned image to be the same instance as the src image
+     *  (if the new dimensions == the src dimensions and any subset encloses the entire src).

[scroggo, 2015/01/05 16:15:33]

This comment seems to conflict with the code and the comment in the previous
paragraph. This comment appears to state that using a "subset" that is bigger
than this SkImage will return this SkImage (whereas we actually return NULL).

[reed1, 2015/01/05 21:58:14]

Done.

+     */
+    SkImage* newImage(int newWidth, int newHeight, const SkIRect* subset = NULL,
+                      SkFilterQuality = kNone_SkFilterQuality) const;
+
 protected:
     SkImage(int width, int height) :
         fWidth(width),
         fHeight(height),
         fUniqueID(NextUniqueID()) {
 
         SkASSERT(width > 0);
         SkASSERT(height > 0);
     }
 
@@ skipping 14 matching lines @@
      *  Draw the image, cropped to the src rect, to the dst rect of a canvas.
      *  If src is larger than the bounds of the image, the rest of the image is
      *  filled with transparent black pixels.
      *
      *  See SkCanvas::drawBitmapRectToRect for similar behavior.
      */
     void drawRect(SkCanvas*, const SkRect* src, const SkRect& dst, const SkPaint*) const;
 };
 
 #endif