SkRectShaderImageFilter: add a new factory method which takes a CropRect.
This will become the preferred API, and the old Create method will be deprecated.
R=reed@google.com, reed
BUG=
Review URL: https://codereview.chromium.org/26220004
git-svn-id: http://skia.googlecode.com/svn/trunk/include@11773 2bbb7eff-a529-9590-31e7-b0007b416f81
diff --git a/effects/SkRectShaderImageFilter.h b/effects/SkRectShaderImageFilter.h
index 5ad11c1..9a2913c 100644
--- a/effects/SkRectShaderImageFilter.h
+++ b/effects/SkRectShaderImageFilter.h
@@ -15,12 +15,18 @@
class SK_API SkRectShaderImageFilter : public SkImageFilter {
public:
- /**
- * The SkShader object will have its refcnt increased as it becomes a member of the
- * SkRectShaderImageFilter object returned by this function. It cannot be NULL.
- * The region parameter is used to specify on which region the shader is applied.
+ /** Create a new image filter which fills the given rectangle with pixels
+ * produced by the given SkShader. If no rectangle is specified, an output
+ * is produced with the same bounds as the input primitive (even though
+ * the input primitive's pixels are not used for processing).
+ * @param s Shader to call for processing. Cannot be NULL. Will be
+ * ref'ed by the new image filter.
+ * @param rect Rectangle of output pixels in which to apply the shader.
+ * If NULL or a given crop edge is not specified, the source
+ * primitive's bounds are used instead.
*/
- static SkRectShaderImageFilter* Create(SkShader* s, const SkRect& rect);
+ /* DEPRECATED */ static SkRectShaderImageFilter* Create(SkShader* s, const SkRect& rect);
+ static SkRectShaderImageFilter* Create(SkShader* s, const CropRect* rect = NULL);
virtual ~SkRectShaderImageFilter();
SK_DECLARE_PUBLIC_FLATTENABLE_DESERIALIZATION_PROCS(SkRectShaderImageFilter)