android_webview/browser/browser_view_renderer.h

   1 // Copyright (c) 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef ANDROID_WEBVIEW_BROWSER_BROWSER_VIEW_RENDERER_H_
   6 #define ANDROID_WEBVIEW_BROWSER_BROWSER_VIEW_RENDERER_H_
   7
   8 #include "android_webview/browser/parent_compositor_draw_constraints.h"
   9 #include "android_webview/browser/shared_renderer_state.h"
  10 #include "base/callback.h"
  11 #include "base/cancelable_callback.h"
  12 #include "base/trace_event/trace_event.h"
  13 #include "content/public/browser/android/synchronous_compositor.h"
  14 #include "content/public/browser/android/synchronous_compositor_client.h"
  15 #include "skia/ext/refptr.h"
  16 #include "ui/gfx/geometry/rect.h"
  17 #include "ui/gfx/geometry/vector2d_f.h"
  18
  19 class SkCanvas;
  20 class SkPicture;
  21
  22 namespace content {
  23 class WebContents;
  24 }
  25
  26 namespace android_webview {
  27
  28 class BrowserViewRendererClient;
  29 class ChildFrame;
  30
  31 // Interface for all the WebView-specific content rendering operations.
  32 // Provides software and hardware rendering and the Capture Picture API.
  33 class BrowserViewRenderer : public content::SynchronousCompositorClient {
  34  public:
  35   static void CalculateTileMemoryPolicy();
  36   static BrowserViewRenderer* FromWebContents(
  37       content::WebContents* web_contents);
  38
  39   BrowserViewRenderer(
  40       BrowserViewRendererClient* client,
  41       const scoped_refptr<base::SingleThreadTaskRunner>& ui_task_runner);
  42
  43   ~BrowserViewRenderer() override;
  44
  45   void RegisterWithWebContents(content::WebContents* web_contents);
  46
  47   SharedRendererState* GetAwDrawGLViewContext();
  48   bool RequestDrawGL(bool wait_for_completion);
  49
  50   // Called before either OnDrawHardware or OnDrawSoftware to set the view
  51   // state of this frame. |scroll| is the view's current scroll offset.
  52   // |global_visible_rect| is the intersection of the view size and the window
  53   // in window coordinates.
  54   void PrepareToDraw(const gfx::Vector2d& scroll,
  55                      const gfx::Rect& global_visible_rect);
  56
  57   // Main handlers for view drawing. A false return value indicates no new
  58   // frame is produced.
  59   bool OnDrawHardware();
  60   bool OnDrawSoftware(SkCanvas* canvas);
  61
  62   // CapturePicture API methods.
  63   skia::RefPtr<SkPicture> CapturePicture(int width, int height);
  64   void EnableOnNewPicture(bool enabled);
  65
  66   void ClearView();
  67
  68   void SetOffscreenPreRaster(bool enabled);
  69
  70   // View update notifications.
  71   void SetIsPaused(bool paused);
  72   void SetViewVisibility(bool visible);
  73   void SetWindowVisibility(bool visible);
  74   void OnSizeChanged(int width, int height);
  75   void OnAttachedToWindow(int width, int height);
  76   void OnDetachedFromWindow();
  77
  78   // Sets the scale for logical<->physical pixel conversions.
  79   void SetDipScale(float dip_scale);
  80
  81   // Set the root layer scroll offset to |new_value|.
  82   void ScrollTo(gfx::Vector2d new_value);
  83
  84   // Android views hierarchy gluing.
  85   bool IsVisible() const;
  86   gfx::Rect GetScreenRect() const;
  87   bool attached_to_window() const { return attached_to_window_; }
  88   bool hardware_enabled() const { return hardware_enabled_; }
  89   gfx::Size size() const { return size_; }
  90   void ReleaseHardware();
  91
  92   void TrimMemory(const int level, const bool visible);
  93
  94   // SynchronousCompositorClient overrides.
  95   void DidInitializeCompositor(
  96       content::SynchronousCompositor* compositor) override;
  97   void DidDestroyCompositor(
  98       content::SynchronousCompositor* compositor) override;
  99   void SetContinuousInvalidate(bool invalidate) override;
 100   void DidUpdateContent() override;
 101   gfx::Vector2dF GetTotalRootLayerScrollOffset() override;
 102   void UpdateRootLayerState(const gfx::Vector2dF& total_scroll_offset_dip,
 103                             const gfx::Vector2dF& max_scroll_offset_dip,
 104                             const gfx::SizeF& scrollable_size_dip,
 105                             float page_scale_factor,
 106                             float min_page_scale_factor,
 107                             float max_page_scale_factor) override;
 108   bool IsExternalFlingActive() const override;
 109   void DidOverscroll(gfx::Vector2dF accumulated_overscroll,
 110                      gfx::Vector2dF latest_overscroll_delta,
 111                      gfx::Vector2dF current_fling_velocity) override;
 112
 113   void UpdateParentDrawConstraints();
 114   void DetachFunctorFromView();
 115
 116  private:
 117   void SetTotalRootLayerScrollOffset(gfx::Vector2dF new_value_dip);
 118   bool CanOnDraw();
 119   // Checks the continuous invalidate and block invalidate state, and schedule
 120   // invalidates appropriately. If |force_invalidate| is true, then send a view
 121   // invalidate regardless of compositor expectation.
 122   void EnsureContinuousInvalidation(bool force_invalidate);
 123   bool CompositeSW(SkCanvas* canvas);
 124   void DidComposite();
 125   scoped_refptr<base::trace_event::ConvertableToTraceFormat>
 126   RootLayerStateAsValue(const gfx::Vector2dF& total_scroll_offset_dip,
 127                         const gfx::SizeF& scrollable_size_dip);
 128
 129   bool CompositeHw();
 130   void ReturnUnusedResource(scoped_ptr<ChildFrame> frame);
 131   void ReturnResourceFromParent();
 132
 133   // If we call up view invalidate and OnDraw is not called before a deadline,
 134   // then we keep ticking the SynchronousCompositor so it can make progress.
 135   // Do this in a two stage tick due to native MessageLoop favors delayed task,
 136   // so ensure delayed task is inserted only after the draw task returns.
 137   void PostFallbackTick();
 138   void FallbackTickFired();
 139
 140   // Force invoke the compositor to run produce a 1x1 software frame that is
 141   // immediately discarded. This is a hack to force invoke parts of the
 142   // compositor that are not directly exposed here.
 143   void ForceFakeCompositeSW();
 144
 145   gfx::Vector2d max_scroll_offset() const;
 146
 147   size_t CalculateDesiredMemoryPolicy();
 148   // For debug tracing or logging. Return the string representation of this
 149   // view renderer's state.
 150   std::string ToString() const;
 151
 152   BrowserViewRendererClient* client_;
 153   SharedRendererState shared_renderer_state_;
 154   scoped_refptr<base::SingleThreadTaskRunner> ui_task_runner_;
 155
 156   content::SynchronousCompositor* compositor_;
 157
 158   bool is_paused_;
 159   bool view_visible_;
 160   bool window_visible_;  // Only applicable if |attached_to_window_| is true.
 161   bool attached_to_window_;
 162   bool hardware_enabled_;
 163   float dip_scale_;
 164   float page_scale_factor_;
 165   bool on_new_picture_enable_;
 166   bool clear_view_;
 167
 168   bool offscreen_pre_raster_;
 169
 170   gfx::Vector2d last_on_draw_scroll_offset_;
 171   gfx::Rect last_on_draw_global_visible_rect_;
 172
 173   // When true, we should continuously invalidate and keep drawing, for example
 174   // to drive animation. This value is set by the compositor and should always
 175   // reflect the expectation of the compositor and not be reused for other
 176   // states.
 177   bool compositor_needs_continuous_invalidate_;
 178
 179   // Used to block additional invalidates while one is already pending.
 180   bool block_invalidates_;
 181
 182   base::CancelableClosure post_fallback_tick_;
 183   base::CancelableClosure fallback_tick_fired_;
 184   bool fallback_tick_pending_;
 185
 186   gfx::Size size_;
 187
 188   // Current scroll offset in CSS pixels.
 189   gfx::Vector2dF scroll_offset_dip_;
 190
 191   // Max scroll offset in CSS pixels.
 192   gfx::Vector2dF max_scroll_offset_dip_;
 193
 194   // Used to prevent rounding errors from accumulating enough to generate
 195   // visible skew (especially noticeable when scrolling up and down in the same
 196   // spot over a period of time).
 197   gfx::Vector2dF overscroll_rounding_error_;
 198
 199   DISALLOW_COPY_AND_ASSIGN(BrowserViewRenderer);
 200 };
 201
 202 }  // namespace android_webview
 203
 204 #endif  // ANDROID_WEBVIEW_BROWSER_BROWSER_VIEW_RENDERER_H_