add SkDrawPictureCallback optional parameter to drawPicture(), which can abort the picture drawing.

include/core/SkPicture.h

 
 /*
  * Copyright 2007 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 SkPicture_DEFINED
 #define SkPicture_DEFINED
 
 #include "SkBitmap.h"
 #include "SkRefCnt.h"
 
 class SkBBoxHierarchy;
 class SkCanvas;
+class SkDrawPictureCallback;
 class SkPicturePlayback;
 class SkPictureRecord;
 class SkStream;
 class SkWStream;
 
 /** \class SkPicture
 
     The SkPicture class records the drawing commands made to a canvas, to
     be played back at a later time.
 */
@@ skipping 115 matching lines @@
     SkCanvas* getRecordingCanvas() const;
     /** Signal that the caller is done recording. This invalidates the canvas
         returned by beginRecording/getRecordingCanvas, and prepares the picture
         for drawing. Note: this happens implicitly the first time the picture
         is drawn.
     */
     void endRecording();
 
     /** Replays the drawing commands on the specified canvas. This internally
         calls endRecording() if that has not already been called.
-        @param surface the canvas receiving the drawing commands.
+        @param canvas the canvas receiving the drawing commands.

[robertphillips, 2013/05/16 15:04:23]

// @param callback optional callback to abort drawing

     */
-    void draw(SkCanvas* surface);
+    void draw(SkCanvas* canvas, SkDrawPictureCallback* = NULL);
 
     /** Return the width of the picture's recording canvas. This
         value reflects what was passed to setSize(), and does not necessarily
         reflect the bounds of what has been recorded into the picture.
         @return the width of the picture's recording canvas
     */
     int width() const { return fWidth; }
 
     /** Return the height of the picture's recording canvas. This
         value reflects what was passed to setSize(), and does not necessarily
@@ skipping 75 matching lines @@
     */
     SkCanvas* getRecordingCanvas() const { return fCanvas; }
 
 private:
     SkPicture*  fPicture;
     SkCanvas*   fCanvas;
 };
 
 
 #endif