[Android WebView] Implement the capture picture API.

android_webview/native/aw_contents.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef ANDROID_WEBVIEW_NATIVE_AW_CONTENTS_H_
 #define ANDROID_WEBVIEW_NATIVE_AW_CONTENTS_H_
 
 #include <jni.h>
 #include <string>
 
 #include "android_webview/browser/find_helper.h"
 #include "android_webview/browser/renderer_host/aw_render_view_host_ext.h"
 #include "android_webview/public/browser/draw_gl.h"
 #include "base/android/scoped_java_ref.h"
 #include "base/android/jni_helper.h"
 #include "base/memory/scoped_ptr.h"
 #include "content/public/browser/android/compositor.h"
 #include "content/public/browser/javascript_dialogs.h"
+#include "skia/ext/refptr.h"
+#include "third_party/skia/include/core/SkPicture.h"
 
 typedef void* EGLContext;
 class TabContents;
 
 namespace cc {
 class Layer;
 }
 
 namespace content {
 class Compositor;
@@ skipping 65 matching lines @@
                                bool window_visible,
                                bool view_visible);
   void OnAttachedToWindow(JNIEnv* env, jobject obj, int w, int h);
   void OnDetachedFromWindow(JNIEnv* env, jobject obj);
   base::android::ScopedJavaLocalRef<jbyteArray> GetOpaqueState(
       JNIEnv* env, jobject obj);
   jboolean RestoreFromOpaqueState(JNIEnv* env, jobject obj, jbyteArray state);
   void SetScrollForHWFrame(JNIEnv* env, jobject obj,
                            int scroll_x, int scroll_y);
   void FocusFirstNode(JNIEnv* env, jobject obj);
+  base::android::ScopedJavaLocalRef<jobject> CapturePicture(JNIEnv* env,
+                                                            jobject obj);
+  void EnableOnNewPicture(JNIEnv* env,
+                          jobject obj,
+                          jboolean enabled,
+                          jboolean invalidation_only);
 
   // Geolocation API support
   void OnGeolocationShowPrompt(int render_process_id,
                              int render_view_id,
                              int bridge_id,
                              const GURL& requesting_frame);
   void OnGeolocationHidePrompt();
 
   // Find-in-page API and related methods.
   jint FindAllSync(JNIEnv* env, jobject obj, jstring search_string);
@@ skipping 12 matching lines @@
   // content::Compositor::Client implementation.
   virtual void ScheduleComposite() OVERRIDE;
   virtual void OnSwapBuffersCompleted() OVERRIDE;
 
   void SetPendingWebContentsForPopup(scoped_ptr<content::WebContents> pending);
   jint ReleasePopupWebContents(JNIEnv* env, jobject obj);
 
   // AwRenderViewHostExt::Client implementation.
   virtual void OnPictureUpdated(int process_id, int render_view_id) OVERRIDE;
 
+  // Returns the latest locally available picture if any.
+  // If none is available will synchronously request the latest one.

[joth, 2013/01/12 02:36:28]

.. and block until the result is received.
(I know that's what synchronously means, but worth being explicit).

[Leandro Graciá Gil, 2013/01/12 17:59:14]

Done.

+  skia::RefPtr<SkPicture> GetLastCapturedPicture();
+
  private:
   void Invalidate();
   void SetWebContents(content::WebContents* web_contents);
   void SetCompositorVisibility(bool visible);
   void ResetCompositor();
   void AttachLayerTree();
 
   JavaObjectWeakGlobalRef java_ref_;
   scoped_ptr<content::WebContents> web_contents_;
   scoped_ptr<AwWebContentsDelegate> web_contents_delegate_;
   scoped_ptr<AwRenderViewHostExt> render_view_host_ext_;
   scoped_ptr<FindHelper> find_helper_;
   scoped_ptr<content::WebContents> pending_contents_;
 
   // Compositor-specific state.
   scoped_ptr<content::Compositor> compositor_;
   scoped_refptr<cc::Layer> scissor_clip_layer_;
   scoped_refptr<cc::Layer> transform_layer_;
   scoped_refptr<cc::Layer> view_clip_layer_;
   gfx::Point hw_rendering_scroll_;
   gfx::Size view_size_;
   bool view_visible_;
   bool compositor_visible_;
   bool is_composite_pending_;
+  bool on_new_picture_enabled_;
+  bool on_new_picture_invalidation_only_;
 
   // Used only for detecting Android View System context changes.
   // Not to be used between draw calls.
   EGLContext last_frame_context_;
 
   DISALLOW_COPY_AND_ASSIGN(AwContents);
 };
 
 bool RegisterAwContents(JNIEnv* env);
 
 }  // namespace android_webview
 
 #endif  // ANDROID_WEBVIEW_NATIVE_AW_CONTENTS_H_