Hide SkCanvas::{set,get}DrawFilter

include/core/SkCanvas.h

 /*
  * Copyright 2006 The Android Open Source Project
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 #ifndef SkCanvas_DEFINED
 #define SkCanvas_DEFINED
 
@@ skipping 1131 matching lines @@
      *  (e.g. it is recording into a picture) then the drawable will be referenced instead,
      *  to have its draw() method called when the picture is finalized.
      *
      *  If the intent is to force the contents of the drawable into this canvas immediately,
      *  then drawable->draw(canvas) may be called.
      */
     void drawDrawable(SkDrawable* drawable, const SkMatrix* = NULL);
     void drawDrawable(SkDrawable*, SkScalar x, SkScalar y);
 
     //////////////////////////////////////////////////////////////////////////
+#ifdef SK_INTERNAL

[djsollen, 2016/01/21 16:34:27]

why do we need SK_INTERNAL?

[f(malita), 2016/01/21 17:54:16]

The intent is to only hide this for external users.  I figured it'd be nice to
still build & run the related tests/GMs internally, while the feature is still
alive.

+#ifndef SK_SUPPORT_LEGACY_DRAWFLTER
+    #define SK_SUPPORT_LEGACY_DRAWFLTER
+#endif
+#endif
 
+#ifdef SK_SUPPORT_LEGACY_DRAWFLTER
     /** Get the current filter object. The filter's reference count is not
         affected. The filter is saved/restored, just like the matrix and clip.
         @return the canvas' filter (or NULL).
     */
+    SK_ATTR_EXTERNALLY_DEPRECATED("getDrawFilter use is deprecated")
     SkDrawFilter* getDrawFilter() const;
 
     /** Set the new filter (or NULL). Pass NULL to clear any existing filter.
         As a convenience, the parameter is returned. If an existing filter
         exists, its refcnt is decrement. If the new filter is not null, its
         refcnt is incremented. The filter is saved/restored, just like the
         matrix and clip.
         @param filter the new filter (or NULL)
         @return the new filter
     */
+    SK_ATTR_EXTERNALLY_DEPRECATED("setDrawFilter use is deprecated")
     virtual SkDrawFilter* setDrawFilter(SkDrawFilter* filter);
-
+#endif
     //////////////////////////////////////////////////////////////////////////
 
     /**
      *  Return true if the current clip is empty (i.e. nothing will draw).
      *  Note: this is not always a free call, so it should not be used
      *  more often than necessary. However, once the canvas has computed this
      *  result, subsequent calls will be cheap (until the clip state changes,
      *  which can happen on any clip..() or restore() call.
      */
     virtual bool isClipEmpty() const;
@@ skipping 406 matching lines @@
 
 class SkCanvasClipVisitor {
 public:
     virtual ~SkCanvasClipVisitor();
     virtual void clipRect(const SkRect&, SkRegion::Op, bool antialias) = 0;
     virtual void clipRRect(const SkRRect&, SkRegion::Op, bool antialias) = 0;
     virtual void clipPath(const SkPath&, SkRegion::Op, bool antialias) = 0;
 };
 
 #endif