add isClipEmpty() -- encourage clients to call this rather than checking clipFoo() results

include/core/SkCanvas.h

Index: include/core/SkCanvas.h
diff --git a/include/core/SkCanvas.h b/include/core/SkCanvas.h
index 754fd167a3aae77a9af02f72a3ef79530fe7bb63..6a68310a4cb3d9ed348b8f1f448a8818e5365183 100644
--- a/include/core/SkCanvas.h
+++ b/include/core/SkCanvas.h
@@ -972,6 +972,15 @@ public:
 
     //////////////////////////////////////////////////////////////////////////
 
+    /**
+     *  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,

[robertphillips, 2014/02/24 19:33:13]

restore?

[reed1, 2014/02/24 19:36:18]

Done.

+     *  which can happen on any clip..() call or rester().
+     */
+    bool isClipEmpty() const;
+
     /** Return the current matrix on the canvas.
         This does not account for the translate in any of the devices.
         @return The current matrix on the canvas.