blob: e5ab98921e34ca0945ec5f34f3900c3bdc96b64c [file] [log] [blame]
[email protected]9f4f3322012-01-18 22:29:561// Copyright (c) 2012 The Chromium Authors. All rights reserved.
license.botbf09a502008-08-24 00:55:552// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
initial.commit09911bf2008-07-26 23:55:294
[email protected]2cff0052011-03-18 16:51:445#ifndef CONTENT_RENDERER_RENDER_WIDGET_H_
6#define CONTENT_RENDERER_RENDER_WIDGET_H_
initial.commit09911bf2008-07-26 23:55:297
[email protected]aa4117f2011-12-09 22:19:218#include <deque>
[email protected]0e241b4b2012-08-18 09:06:279#include <map>
[email protected]010ea08a2009-10-11 20:21:3210
initial.commit09911bf2008-07-26 23:55:2911#include "base/basictypes.h"
[email protected]f3112a52011-09-30 23:47:4912#include "base/compiler_specific.h"
[email protected]3b63f8f42011-03-28 01:54:1513#include "base/memory/ref_counted.h"
[email protected]8704f89b2011-04-15 00:30:0514#include "base/memory/scoped_ptr.h"
[email protected]ed7defa2013-03-12 21:29:5915#include "base/memory/weak_ptr.h"
[email protected]abb522162013-06-28 01:54:1616#include "base/time/time.h"
17#include "base/timer/timer.h"
[email protected]6e84de22013-03-18 06:54:2718#include "cc/debug/rendering_stats.h"
[email protected]3639aa82013-06-04 11:00:0419#include "content/common/browser_rendering_stats.h"
[email protected]f3112a52011-09-30 23:47:4920#include "content/common/content_export.h"
[email protected]ed7defa2013-03-12 21:29:5921#include "content/common/gpu/client/webgraphicscontext3d_command_buffer_impl.h"
[email protected]921f1592011-03-18 00:41:0222#include "content/renderer/paint_aggregator.h"
[email protected]4f86bdb82012-11-10 19:11:1923#include "ipc/ipc_listener.h"
24#include "ipc/ipc_sender.h"
[email protected]5c30b5e02013-05-30 03:46:0825#include "third_party/WebKit/public/platform/WebRect.h"
[email protected]2255a9332013-06-17 05:12:3126#include "third_party/WebKit/public/web/WebCompositionUnderline.h"
27#include "third_party/WebKit/public/web/WebPopupType.h"
28#include "third_party/WebKit/public/web/WebTextDirection.h"
29#include "third_party/WebKit/public/web/WebTextInputInfo.h"
30#include "third_party/WebKit/public/web/WebWidgetClient.h"
[email protected]d65adb12010-04-28 17:26:4931#include "third_party/skia/include/core/SkBitmap.h"
[email protected]ad26ef42011-06-17 07:59:4532#include "ui/base/ime/text_input_type.h"
[email protected]58b48a0df22012-06-13 07:01:3533#include "ui/base/range/range.h"
[email protected]08397d52011-02-05 01:53:3834#include "ui/gfx/native_widget_types.h"
35#include "ui/gfx/rect.h"
[email protected]990278ff2012-11-13 02:12:5536#include "ui/gfx/vector2d.h"
[email protected]a2b5ded2013-05-20 21:32:5337#include "ui/gfx/vector2d_f.h"
[email protected]d353541f2012-05-03 22:45:4138#include "ui/surface/transport_dib.h"
[email protected]19df7002013-05-31 00:25:3939#include "webkit/common/cursors/webcursor.h"
initial.commit09911bf2008-07-26 23:55:2940
[email protected]aa4117f2011-12-09 22:19:2141struct ViewHostMsg_UpdateRect_Params;
[email protected]0fdd5012013-05-29 08:05:5642struct ViewMsg_Resize_Params;
[email protected]aa4117f2011-12-09 22:19:2143class ViewHostMsg_UpdateRect;
44
[email protected]484955942010-08-19 16:13:1845namespace IPC {
46class SyncMessage;
47}
48
[email protected]88efb7ec2009-07-14 16:32:5949namespace WebKit {
[email protected]41d86852012-11-07 12:23:2450class WebGestureEvent;
[email protected]0dea1652012-12-14 00:09:0951class WebInputEvent;
[email protected]f56c7872013-06-18 12:31:5752class WebKeyboardEvent;
[email protected]6a8ddba52010-09-05 04:38:0653class WebMouseEvent;
[email protected]2d0f2e92011-10-03 09:02:2454class WebTouchEvent;
[email protected]e195e582013-03-08 01:32:5955struct WebPoint;
56struct WebRenderingStatsImpl;
[email protected]526476902011-10-06 20:34:0657}
58
[email protected]ba91a792013-02-06 09:48:2859namespace cc { class OutputSurface; }
60
[email protected]4de6d1692011-10-12 08:45:4461namespace ui {
62class Range;
63}
64
[email protected]191eb3f72010-12-21 06:27:5065namespace webkit {
66namespace npapi {
[email protected]f103ab72009-09-02 17:10:5967struct WebPluginGeometry;
[email protected]719b36f2010-12-22 20:36:4668} // namespace npapi
69
70namespace ppapi {
71class PluginInstance;
72} // namespace ppapi
73} // namespace webkit
[email protected]f103ab72009-09-02 17:10:5974
[email protected]e9ff79c2012-10-19 21:31:2675namespace content {
76struct GpuRenderingStats;
[email protected]ba91a792013-02-06 09:48:2877class RenderWidgetCompositor;
[email protected]e9ff79c2012-10-19 21:31:2678class RenderWidgetTest;
79
initial.commit09911bf2008-07-26 23:55:2980// RenderWidget provides a communication bridge between a WebWidget and
81// a RenderWidgetHost, the latter of which lives in a different process.
[email protected]f3112a52011-09-30 23:47:4982class CONTENT_EXPORT RenderWidget
[email protected]c47317e2012-06-20 22:35:3183 : public IPC::Listener,
84 public IPC::Sender,
[email protected]f3112a52011-09-30 23:47:4985 NON_EXPORTED_BASE(virtual public WebKit::WebWidgetClient),
[email protected]ed7defa2013-03-12 21:29:5986 NON_EXPORTED_BASE(public WebGraphicsContext3DSwapBuffersClient),
[email protected]f3112a52011-09-30 23:47:4987 public base::RefCounted<RenderWidget> {
initial.commit09911bf2008-07-26 23:55:2988 public:
89 // Creates a new RenderWidget. The opener_id is the routing ID of the
[email protected]380244092011-10-07 17:26:2790 // RenderView that this widget lives inside.
[email protected]0ebf3872008-11-07 21:35:0391 static RenderWidget* Create(int32 opener_id,
[email protected]842f10652012-06-06 01:54:0492 WebKit::WebPopupType popup_type,
93 const WebKit::WebScreenInfo& screen_info);
initial.commit09911bf2008-07-26 23:55:2994
[email protected]484955942010-08-19 16:13:1895 // Creates a WebWidget based on the popup type.
96 static WebKit::WebWidget* CreateWebWidget(RenderWidget* render_widget);
97
[email protected]c03a6e72011-04-19 21:42:0698 // The compositing surface assigned by the RenderWidgetHost
99 // (or RenderViewHost). Will be gfx::kNullPluginWindow if not assigned yet,
100 // in which case we should not create any GPU command buffers with it.
initial.commit09911bf2008-07-26 23:55:29101 // The routing ID assigned by the RenderProcess. Will be MSG_ROUTING_NONE if
102 // not yet assigned a view ID, in which case, the process MUST NOT send
103 // messages with this ID to the parent.
104 int32 routing_id() const {
105 return routing_id_;
106 }
107
[email protected]9f4f3322012-01-18 22:29:56108 int32 surface_id() const {
109 return surface_id_;
110 }
111
initial.commit09911bf2008-07-26 23:55:29112 // May return NULL when the window is closing.
[email protected]93b9d692011-04-13 00:44:31113 WebKit::WebWidget* webwidget() const { return webwidget_; }
[email protected]ee41e7d22011-10-14 19:34:09114
[email protected]93b9d692011-04-13 00:44:31115 gfx::Size size() const { return size_; }
[email protected]589621b2010-09-23 22:01:07116 bool has_focus() const { return has_focus_; }
[email protected]ee41e7d22011-10-14 19:34:09117 bool is_fullscreen() const { return is_fullscreen_; }
[email protected]204f1df2012-01-04 20:21:13118 bool is_hidden() const { return is_hidden_; }
[email protected]589621b2010-09-23 22:01:07119
[email protected]c47317e2012-06-20 22:35:31120 // IPC::Listener
[email protected]edc64de2011-11-17 20:07:38121 virtual bool OnMessageReceived(const IPC::Message& msg) OVERRIDE;
initial.commit09911bf2008-07-26 23:55:29122
[email protected]c47317e2012-06-20 22:35:31123 // IPC::Sender
[email protected]edc64de2011-11-17 20:07:38124 virtual bool Send(IPC::Message* msg) OVERRIDE;
initial.commit09911bf2008-07-26 23:55:29125
[email protected]4873c7d2009-07-16 06:36:28126 // WebKit::WebWidgetClient
[email protected]9ed83fe2013-02-27 01:52:28127 virtual void suppressCompositorScheduling(bool enable);
[email protected]9cd43a62012-03-26 08:03:56128 virtual void willBeginCompositorFrame();
[email protected]4873c7d2009-07-16 06:36:28129 virtual void didInvalidateRect(const WebKit::WebRect&);
[email protected]990278ff2012-11-13 02:12:55130 virtual void didScrollRect(int dx, int dy,
131 const WebKit::WebRect& clipRect);
[email protected]244ac1892011-12-02 17:04:47132 virtual void didAutoResize(const WebKit::WebSize& new_size);
[email protected]91acd1c2012-03-14 08:32:39133 virtual void didActivateCompositor(int input_handler_identifier);
[email protected]ea162f92011-10-04 23:08:22134 virtual void didDeactivateCompositor();
[email protected]e195e582013-03-08 01:32:59135 virtual void initializeLayerTreeView();
[email protected]8926c602013-01-23 05:32:06136 virtual WebKit::WebLayerTreeView* layerTreeView();
[email protected]3391a0772012-03-28 00:32:07137 virtual void didBecomeReadyForAdditionalInput();
[email protected]58264a32011-11-17 23:36:15138 virtual void didCommitAndDrawCompositorFrame();
139 virtual void didCompleteSwapBuffers();
[email protected]f98d7e3c2010-09-13 22:30:46140 virtual void scheduleComposite();
[email protected]5f8b1022011-01-21 23:34:50141 virtual void scheduleAnimation();
[email protected]4873c7d2009-07-16 06:36:28142 virtual void didFocus();
143 virtual void didBlur();
144 virtual void didChangeCursor(const WebKit::WebCursorInfo&);
145 virtual void closeWidgetSoon();
146 virtual void show(WebKit::WebNavigationPolicy);
147 virtual void runModal() {}
[email protected]9b003482013-05-21 14:00:17148 virtual void didProgrammaticallyScroll(const WebKit::WebPoint& scroll_point);
[email protected]4873c7d2009-07-16 06:36:28149 virtual WebKit::WebRect windowRect();
[email protected]8a9d6ca32011-06-06 20:11:30150 virtual void setToolTipText(const WebKit::WebString& text,
151 WebKit::WebTextDirection hint);
[email protected]4873c7d2009-07-16 06:36:28152 virtual void setWindowRect(const WebKit::WebRect&);
153 virtual WebKit::WebRect windowResizerRect();
154 virtual WebKit::WebRect rootWindowRect();
155 virtual WebKit::WebScreenInfo screenInfo();
[email protected]f660d9c2012-06-06 18:31:21156 virtual float deviceScaleFactor();
[email protected]fa7b1dc2010-06-23 17:53:04157 virtual void resetInputMethod();
[email protected]c68c3e4e2013-01-24 00:36:56158 virtual void didHandleGestureEvent(const WebKit::WebGestureEvent& event,
159 bool event_cancelled);
[email protected]4873c7d2009-07-16 06:36:28160
161 // Called when a plugin is moved. These events are queued up and sent with
162 // the next paint or scroll message to the host.
[email protected]191eb3f72010-12-21 06:27:50163 void SchedulePluginMove(const webkit::npapi::WebPluginGeometry& move);
initial.commit09911bf2008-07-26 23:55:29164
[email protected]268654772009-08-06 23:02:04165 // Called when a plugin window has been destroyed, to make sure the currently
166 // pending moves don't try to reference it.
167 void CleanupWindowInPluginMoves(gfx::PluginWindowHandle window);
168
[email protected]b63d58da12012-11-26 22:37:44169 // Fills in a WebRenderingStatsImpl struct containing information about
[email protected]fef5e3972012-08-07 03:59:47170 // rendering, e.g. count of frames rendered, time spent painting.
[email protected]b63d58da12012-11-26 22:37:44171 void GetRenderingStats(WebKit::WebRenderingStatsImpl&) const;
[email protected]fef5e3972012-08-07 03:59:47172
[email protected]63b465922012-09-06 02:04:52173 // Fills in a GpuRenderingStats struct containing information about
174 // GPU rendering, e.g. count of texture uploads performed, time spent
175 // uploading.
176 // This call is relatively expensive as it blocks on the GPU process
[email protected]e9ff79c2012-10-19 21:31:26177 bool GetGpuRenderingStats(GpuRenderingStats*) const;
[email protected]63b465922012-09-06 02:04:52178
[email protected]3639aa82013-06-04 11:00:04179 void GetBrowserRenderingStats(BrowserRenderingStats* stats);
180
[email protected]24ed0432013-04-24 07:50:31181 RenderWidgetCompositor* compositor() const;
182
[email protected]ba91a792013-02-06 09:48:28183 virtual scoped_ptr<cc::OutputSurface> CreateOutputSurface();
184
[email protected]0e241b4b2012-08-18 09:06:27185 // Callback for use with BeginSmoothScroll.
186 typedef base::Callback<void()> SmoothScrollCompletionCallback;
187
[email protected]a39ca1652012-07-13 21:30:58188 // Directs the host to begin a smooth scroll. This scroll should have the same
[email protected]0e241b4b2012-08-18 09:06:27189 // performance characteristics as a user-initiated scroll. Returns an ID of
[email protected]53beb772013-03-06 01:57:22190 // the scroll gesture. |mouse_event_x| and |mouse_event_y| are expected to be
191 // in local DIP coordinates.
[email protected]0c2ebef2013-04-03 12:14:10192 void BeginSmoothScroll(bool scroll_down,
[email protected]ebd8b5642012-10-09 14:44:29193 const SmoothScrollCompletionCallback& callback,
[email protected]267909d2012-10-20 04:36:19194 int pixels_to_scroll,
[email protected]ebd8b5642012-10-09 14:44:29195 int mouse_event_x,
196 int mouse_event_y);
[email protected]a39ca1652012-07-13 21:30:58197
initial.commit09911bf2008-07-26 23:55:29198 // Close the underlying WebWidget.
[email protected]60c42a8c72009-10-09 04:08:59199 virtual void Close();
initial.commit09911bf2008-07-26 23:55:29200
[email protected]6fceb912013-02-15 06:24:15201 // Notifies about a compositor frame commit operation having finished.
202 virtual void DidCommitCompositorFrame();
203
[email protected]a1127f82011-09-08 17:27:01204 float filtered_time_per_frame() const {
205 return filtered_time_per_frame_;
206 }
207
[email protected]3306f262012-09-21 19:20:42208 enum ShowIme {
209 DO_NOT_SHOW_IME,
210 SHOW_IME_IF_NEEDED
211 };
212
[email protected]66fca5bc2013-05-23 06:58:29213 // Handle common setup/teardown for handling IME events.
214 void StartHandlingImeEvent();
215 void FinishHandlingImeEvent();
216
[email protected]35134e12013-02-22 20:07:40217 virtual void InstrumentWillBeginFrame() {}
218 virtual void InstrumentDidBeginFrame() {}
219 virtual void InstrumentDidCancelFrame() {}
220 virtual void InstrumentWillComposite() {}
221
[email protected]34bb3ac2013-03-08 02:41:28222 virtual bool AllowPartialSwap() const;
[email protected]c8cbae72013-05-23 10:45:03223 bool UsingSynchronousRendererCompositor() const;
[email protected]34bb3ac2013-03-08 02:41:28224
[email protected]557e9eb42013-06-21 06:52:18225 bool is_swapped_out() { return is_swapped_out_; }
226
initial.commit09911bf2008-07-26 23:55:29227 protected:
[email protected]8085dbc82008-09-26 22:53:44228 // Friend RefCounted so that the dtor can be non-public. Using this class
229 // without ref-counting is an error.
230 friend class base::RefCounted<RenderWidget>;
[email protected]7339cd22010-10-27 00:11:20231 // For unit tests.
[email protected]e9ff79c2012-10-19 21:31:26232 friend class RenderWidgetTest;
[email protected]8085dbc82008-09-26 22:53:44233
[email protected]61e2b3cc2012-03-02 16:13:34234 enum ResizeAck {
235 SEND_RESIZE_ACK,
236 NO_RESIZE_ACK,
237 };
238
[email protected]6fd35b72012-03-01 19:46:41239 RenderWidget(WebKit::WebPopupType popup_type,
[email protected]842f10652012-06-06 01:54:04240 const WebKit::WebScreenInfo& screen_info,
[email protected]14392a52012-05-02 20:28:44241 bool swapped_out);
[email protected]ce2b28e2012-08-09 15:53:57242
[email protected]8085dbc82008-09-26 22:53:44243 virtual ~RenderWidget();
initial.commit09911bf2008-07-26 23:55:29244
245 // Initializes this view with the given opener. CompleteInit must be called
246 // later.
[email protected]a635f942012-12-07 10:34:29247 bool Init(int32 opener_id);
initial.commit09911bf2008-07-26 23:55:29248
[email protected]484955942010-08-19 16:13:18249 // Called by Init and subclasses to perform initialization.
[email protected]a635f942012-12-07 10:34:29250 bool DoInit(int32 opener_id,
[email protected]484955942010-08-19 16:13:18251 WebKit::WebWidget* web_widget,
252 IPC::SyncMessage* create_widget_message);
253
initial.commit09911bf2008-07-26 23:55:29254 // Finishes creation of a pending view started with Init.
[email protected]fc4404d2012-11-07 19:53:30255 void CompleteInit();
initial.commit09911bf2008-07-26 23:55:29256
[email protected]992db4c2011-05-12 15:37:15257 // Sets whether this RenderWidget has been swapped out to be displayed by
258 // a RenderWidget in a different process. If so, no new IPC messages will be
259 // sent (only ACKs) and the process is free to exit when there are no other
260 // active RenderWidgets.
261 void SetSwappedOut(bool is_swapped_out);
262
[email protected]661eb9d2009-02-03 02:11:48263 // Paints the given rectangular region of the WebWidget into canvas (a
264 // shared memory segment returned by AllocPaintBuf on Windows). The caller
265 // must ensure that the given rect fits within the bounds of the WebWidget.
[email protected]4fb66842009-12-04 21:41:00266 void PaintRect(const gfx::Rect& rect, const gfx::Point& canvas_origin,
[email protected]9d611ca2012-11-14 13:46:56267 SkCanvas* canvas);
[email protected]4fb66842009-12-04 21:41:00268
269 // Paints a border at the given rect for debugging purposes.
[email protected]9d611ca2012-11-14 13:46:56270 void PaintDebugBorder(const gfx::Rect& rect, SkCanvas* canvas);
initial.commit09911bf2008-07-26 23:55:29271
[email protected]bd37ae252011-06-03 01:28:18272 bool IsRenderingVSynced();
[email protected]52ccd0ea2011-02-16 01:09:05273 void AnimationCallback();
274 void AnimateIfNeeded();
[email protected]65225772011-05-12 21:10:24275 void InvalidationCallback();
276 void DoDeferredUpdateAndSendInputAck();
[email protected]552e6002009-11-19 05:24:57277 void DoDeferredUpdate();
[email protected]2533ce12009-05-09 00:02:24278 void DoDeferredClose();
279 void DoDeferredSetWindowRect(const WebKit::WebRect& pos);
[email protected]f0c2a242013-03-15 19:34:52280 virtual void Composite(base::TimeTicks frame_begin_time);
initial.commit09911bf2008-07-26 23:55:29281
[email protected]699ab0d2009-04-23 23:19:14282 // Set the background of the render widget to a bitmap. The bitmap will be
283 // tiled in both directions if it isn't big enough to fill the area. This is
284 // mainly intended to be used in conjuction with WebView::SetIsTransparent().
285 virtual void SetBackground(const SkBitmap& bitmap);
286
[email protected]61e2b3cc2012-03-02 16:13:34287 // Resizes the render widget.
288 void Resize(const gfx::Size& new_size,
[email protected]60d47ac2013-03-01 23:42:44289 const gfx::Size& physical_backing_size,
[email protected]d9083762013-03-24 01:36:40290 float overdraw_bottom_height,
[email protected]61e2b3cc2012-03-02 16:13:34291 const gfx::Rect& resizer_rect,
292 bool is_fullscreen,
293 ResizeAck resize_ack);
294
initial.commit09911bf2008-07-26 23:55:29295 // RenderWidget IPC message handlers
[email protected]c084330e02013-04-27 01:08:15296 void OnHandleInputEvent(const WebKit::WebInputEvent* event,
[email protected]4b157662013-05-29 04:05:05297 const ui::LatencyInfo& latency_info,
[email protected]c084330e02013-04-27 01:08:15298 bool keyboard_shortcut);
[email protected]34202de2013-05-06 23:36:22299 void OnCursorVisibilityChange(bool is_visible);
[email protected]c084330e02013-04-27 01:08:15300 void OnMouseCaptureLost();
301 virtual void OnSetFocus(bool enable);
initial.commit09911bf2008-07-26 23:55:29302 void OnClose();
[email protected]fc4404d2012-11-07 19:53:30303 void OnCreatingNewAck();
[email protected]0fdd5012013-05-29 08:05:56304 virtual void OnResize(const ViewMsg_Resize_Params& params);
[email protected]b5913d72012-02-07 22:26:54305 void OnChangeResizeRect(const gfx::Rect& resizer_rect);
[email protected]941e4552010-02-01 21:23:43306 virtual void OnWasHidden();
[email protected]9e2e4632012-07-27 16:38:41307 virtual void OnWasShown(bool needs_repainting);
[email protected]992db4c2011-05-12 15:37:15308 virtual void OnWasSwappedOut();
[email protected]53d3f302009-12-21 04:42:05309 void OnUpdateRectAck();
[email protected]8400e032010-02-26 18:50:11310 void OnCreateVideoAck(int32 video_id);
311 void OnUpdateVideoAck(int32 video_id);
[email protected]2533ce12009-05-09 00:02:24312 void OnRequestMoveAck();
[email protected]fa7b1dc2010-06-23 17:53:04313 void OnSetInputMethodActive(bool is_active);
[email protected]56ea1a62011-05-30 07:05:57314 virtual void OnImeSetComposition(
[email protected]fa7b1dc2010-06-23 17:53:04315 const string16& text,
316 const std::vector<WebKit::WebCompositionUnderline>& underlines,
317 int selection_start,
318 int selection_end);
[email protected]4de6d1692011-10-12 08:45:44319 virtual void OnImeConfirmComposition(
320 const string16& text, const ui::Range& replacement_range);
[email protected]3d9ec5052013-01-02 22:05:25321 void OnPaintAtSize(const TransportDIB::Handle& dib_id,
322 int tag,
323 const gfx::Size& page_size,
324 const gfx::Size& desired_size);
[email protected]0bc1f572013-04-17 01:46:31325 void OnRepaint(gfx::Size size_to_paint);
[email protected]4a9dba42013-04-29 18:24:22326 void OnSmoothScrollCompleted();
[email protected]4873c7d2009-07-16 06:36:28327 void OnSetTextDirection(WebKit::WebTextDirection direction);
[email protected]872ae5b2011-05-26 20:20:50328 void OnGetFPS();
[email protected]80ad8622012-11-07 16:33:03329 void OnUpdateScreenRects(const gfx::Rect& view_screen_rect,
330 const gfx::Rect& window_screen_rect);
[email protected]105dffb42013-02-20 03:46:21331#if defined(OS_ANDROID)
332 void OnImeBatchStateChanged(bool is_begin);
[email protected]2384b6cb2013-02-28 23:58:51333 void OnShowImeIfNeeded();
[email protected]105dffb42013-02-20 03:46:21334#endif
[email protected]51a49502013-03-23 01:50:19335 void OnSnapshot(const gfx::Rect& src_subrect);
[email protected]3639aa82013-06-04 11:00:04336 void OnSetBrowserRenderingStats(const BrowserRenderingStats& stats);
initial.commit09911bf2008-07-26 23:55:29337
[email protected]847a2582013-03-09 02:29:51338 // Notify the compositor about a change in viewport size. This should be
339 // used only with auto resize mode WebWidgets, as normal WebWidgets should
340 // go through OnResize.
[email protected]97e1bf72013-03-06 14:06:05341 void AutoResizeCompositor();
342
[email protected]468ac582012-11-20 00:53:19343 virtual void SetDeviceScaleFactor(float device_scale_factor);
344
[email protected]29ed96a2012-02-04 18:12:16345 // Override points to notify derived classes that a paint has happened.
346 // WillInitiatePaint happens when we're about to generate a new bitmap and
347 // send it to the browser. DidInitiatePaint happens when that has completed,
348 // and subsequent rendering won't affect the painted content. DidFlushPaint
349 // happens once we've received the ACK that the screen has been updated.
350 // For a given paint operation, these overrides will always be called in the
351 // order WillInitiatePaint, DidInitiatePaint, DidFlushPaint.
352 virtual void WillInitiatePaint() {}
[email protected]00c39612010-03-06 02:53:28353 virtual void DidInitiatePaint() {}
354 virtual void DidFlushPaint() {}
[email protected]a2f6bc112009-06-27 16:27:25355
[email protected]65225772011-05-12 21:10:24356 // Override and return true when the widget is rendered with a graphics
[email protected]37a6f302011-07-11 23:43:08357 // context that supports asynchronous swapbuffers. When returning true, the
358 // subclass must call OnSwapBuffersPosted() when swap is posted,
359 // OnSwapBuffersComplete() when swaps complete, and OnSwapBuffersAborted if
360 // the context is lost.
[email protected]65225772011-05-12 21:10:24361 virtual bool SupportsAsynchronousSwapBuffers();
[email protected]ed7defa2013-03-12 21:29:59362 virtual GURL GetURLForGraphicsContext3D();
[email protected]65225772011-05-12 21:10:24363
[email protected]479b0172012-10-29 19:27:09364 virtual bool ForceCompositingModeEnabled();
365
[email protected]ed7defa2013-03-12 21:29:59366 // WebGraphicsContext3DSwapBuffersClient implementation.
367
368 // Called by a GraphicsContext associated with this view when swapbuffers
369 // is posted, completes or is aborted.
370 virtual void OnViewContextSwapBuffersPosted() OVERRIDE;
371 virtual void OnViewContextSwapBuffersComplete() OVERRIDE;
372 virtual void OnViewContextSwapBuffersAborted() OVERRIDE;
[email protected]65225772011-05-12 21:10:24373
[email protected]ca4847f2010-09-24 05:39:15374 // Detects if a suitable opaque plugin covers the given paint bounds with no
375 // compositing necessary.
376 //
[email protected]719b36f2010-12-22 20:36:46377 // Returns the plugin instance that's the source of the paint if the paint
378 // can be handled by just blitting the plugin bitmap. In this case, the
379 // location, clipping, and ID of the backing store will be filled into the
380 // given output parameters.
[email protected]ca4847f2010-09-24 05:39:15381 //
[email protected]719b36f2010-12-22 20:36:46382 // A return value of null means optimized painting can not be used and we
[email protected]ca4847f2010-09-24 05:39:15383 // should continue with the normal painting code path.
[email protected]719b36f2010-12-22 20:36:46384 virtual webkit::ppapi::PluginInstance* GetBitmapForOptimizedPluginPaint(
[email protected]ca4847f2010-09-24 05:39:15385 const gfx::Rect& paint_bounds,
386 TransportDIB** dib,
387 gfx::Rect* location,
[email protected]0f3a2d12012-09-01 03:37:20388 gfx::Rect* clip,
389 float* scale_factor);
[email protected]ca4847f2010-09-24 05:39:15390
[email protected]d54169e92011-01-21 09:19:52391 // Gets the scroll offset of this widget, if this widget has a notion of
392 // scroll offset.
[email protected]ceb36f7d2012-10-31 18:33:24393 virtual gfx::Vector2d GetScrollOffset();
[email protected]d54169e92011-01-21 09:19:52394
[email protected]bee16aab2009-08-26 15:55:03395 // Sets the "hidden" state of this widget. All accesses to is_hidden_ should
396 // use this method so that we can properly inform the RenderThread of our
397 // state.
398 void SetHidden(bool hidden);
399
[email protected]2b624c562011-10-27 22:58:26400 void WillToggleFullscreen();
401 void DidToggleFullscreen();
402
[email protected]674741932009-02-04 23:44:46403 bool next_paint_is_resize_ack() const;
404 bool next_paint_is_restore_ack() const;
405 void set_next_paint_is_resize_ack();
406 void set_next_paint_is_restore_ack();
407 void set_next_paint_is_repaint_ack();
[email protected]ec7dc112008-08-06 05:30:12408
[email protected]e99ef6f2011-10-16 01:13:00409 // Checks if the text input state and compose inline mode have been changed.
[email protected]fa7b1dc2010-06-23 17:53:04410 // If they are changed, the new value will be sent to the browser process.
[email protected]cb9e2632013-06-18 11:26:47411 void UpdateTextInputType();
412
413#if defined(OS_ANDROID)
[email protected]3306f262012-09-21 19:20:42414 // |show_ime_if_needed| should be SHOW_IME_IF_NEEDED iff the update may cause
415 // the ime to be displayed, e.g. after a tap on an input field on mobile.
416 void UpdateTextInputState(ShowIme show_ime);
[email protected]cb9e2632013-06-18 11:26:47417#endif
[email protected]e99ef6f2011-10-16 01:13:00418
419 // Checks if the selection bounds have been changed. If they are changed,
420 // the new value will be sent to the browser process.
[email protected]58b48a0df22012-06-13 07:01:35421 virtual void UpdateSelectionBounds();
422
423 // Checks if the composition range or composition character bounds have been
424 // changed. If they are changed, the new value will be sent to the browser
425 // process.
[email protected]88dbe32f2013-06-20 23:31:36426 virtual void UpdateCompositionInfo(bool should_update_range);
[email protected]58b48a0df22012-06-13 07:01:35427
[email protected]56ea1a62011-05-30 07:05:57428 // Override point to obtain that the current input method state and caret
429 // position.
[email protected]ad26ef42011-06-17 07:59:45430 virtual ui::TextInputType GetTextInputType();
[email protected]3f783362011-10-21 22:40:50431 virtual void GetSelectionBounds(gfx::Rect* start, gfx::Rect* end);
[email protected]5b739cb2012-08-21 20:35:21432 virtual ui::TextInputType WebKitToUiTextInputType(
433 WebKit::WebTextInputType type);
[email protected]ad26ef42011-06-17 07:59:45434
[email protected]58b48a0df22012-06-13 07:01:35435 // Override point to obtain that the current composition character bounds.
436 // In the case of surrogate pairs, the character is treated as two characters:
437 // the bounds for first character is actual one, and the bounds for second
438 // character is zero width rectangle.
439 virtual void GetCompositionCharacterBounds(
440 std::vector<gfx::Rect>* character_bounds);
441
[email protected]88dbe32f2013-06-20 23:31:36442 // Returns the range of the text that is being composed or the selection if
443 // the composition does not exist.
444 virtual void GetCompositionRange(ui::Range* range);
445
[email protected]58b48a0df22012-06-13 07:01:35446 // Returns true if the composition range or composition character bounds
447 // should be sent to the browser process.
448 bool ShouldUpdateCompositionInfo(
449 const ui::Range& range,
450 const std::vector<gfx::Rect>& bounds);
451
[email protected]ad26ef42011-06-17 07:59:45452 // Override point to obtain that the current input method state about
453 // composition text.
454 virtual bool CanComposeInline();
[email protected]56ea1a62011-05-30 07:05:57455
initial.commit09911bf2008-07-26 23:55:29456 // Tells the renderer it does not have focus. Used to prevent us from getting
457 // the focus on our own when the browser did not focus us.
458 void ClearFocus();
459
[email protected]2533ce12009-05-09 00:02:24460 // Set the pending window rect.
461 // Because the real render_widget is hosted in another process, there is
462 // a time period where we may have set a new window rect which has not yet
463 // been processed by the browser. So we maintain a pending window rect
464 // size. If JS code sets the WindowRect, and then immediately calls
465 // GetWindowRect() we'll use this pending window rect as the size.
466 void SetPendingWindowRect(const WebKit::WebRect& r);
467
[email protected]446705872009-09-10 07:22:48468 // Called by OnHandleInputEvent() to notify subclasses that a key event was
469 // just handled.
470 virtual void DidHandleKeyEvent() {}
471
[email protected]67bfb83f2011-09-22 03:36:37472 // Called by OnHandleInputEvent() to notify subclasses that a mouse event is
473 // about to be handled.
474 // Returns true if no further handling is needed. In that case, the event
475 // won't be sent to WebKit or trigger DidHandleMouseEvent().
476 virtual bool WillHandleMouseEvent(const WebKit::WebMouseEvent& event);
477
[email protected]f56c7872013-06-18 12:31:57478 // Called by OnHandleInputEvent() to notify subclasses that a key event is
479 // about to be handled.
480 // Returns true if no further handling is needed. In that case, the event
481 // won't be sent to WebKit or trigger DidHandleKeyEvent().
482 virtual bool WillHandleKeyEvent(const WebKit::WebKeyboardEvent& event);
483
[email protected]41d86852012-11-07 12:23:24484 // Called by OnHandleInputEvent() to notify subclasses that a gesture event is
485 // about to be handled.
486 // Returns true if no further handling is needed. In that case, the event
487 // won't be sent to WebKit.
488 virtual bool WillHandleGestureEvent(const WebKit::WebGestureEvent& event);
489
[email protected]6a8ddba52010-09-05 04:38:06490 // Called by OnHandleInputEvent() to notify subclasses that a mouse event was
491 // just handled.
492 virtual void DidHandleMouseEvent(const WebKit::WebMouseEvent& event) {}
493
[email protected]2d0f2e92011-10-03 09:02:24494 // Called by OnHandleInputEvent() to notify subclasses that a touch event was
495 // just handled.
496 virtual void DidHandleTouchEvent(const WebKit::WebTouchEvent& event) {}
497
[email protected]3d5c243b2012-11-30 00:26:01498 // Check whether the WebWidget has any touch event handlers registered
499 // at the given point.
500 virtual bool HasTouchEventHandlersAt(const gfx::Point& point) const;
501
[email protected]ce6689f2013-03-29 12:52:55502 // Check whether the WebWidget has any touch event handlers registered.
503 virtual void hasTouchEventHandlers(bool has_handlers);
504
[email protected]ed7defa2013-03-12 21:29:59505 // Creates a 3D context associated with this view.
[email protected]3ae68c52013-04-12 06:10:05506 WebGraphicsContext3DCommandBufferImpl* CreateGraphicsContext3D(
[email protected]ed7defa2013-03-12 21:29:59507 const WebKit::WebGraphicsContext3D::Attributes& attributes);
508
[email protected]51a49502013-03-23 01:50:19509 bool OnSnapshotHelper(const gfx::Rect& src_subrect, SkBitmap* bitmap);
510
initial.commit09911bf2008-07-26 23:55:29511 // Routing ID that allows us to communicate to the parent browser process
512 // RenderWidgetHost. When MSG_ROUTING_NONE, no messages may be sent.
513 int32 routing_id_;
514
[email protected]9f4f3322012-01-18 22:29:56515 int32 surface_id_;
516
[email protected]c5b3b5e2009-02-13 06:41:11517 // We are responsible for destroying this object via its Close method.
[email protected]4873c7d2009-07-16 06:36:28518 WebKit::WebWidget* webwidget_;
initial.commit09911bf2008-07-26 23:55:29519
[email protected]8926c602013-01-23 05:32:06520 // This is lazily constructed and must not outlive webwidget_.
[email protected]ba91a792013-02-06 09:48:28521 scoped_ptr<RenderWidgetCompositor> compositor_;
[email protected]8926c602013-01-23 05:32:06522
initial.commit09911bf2008-07-26 23:55:29523 // Set to the ID of the view that initiated creating this view, if any. When
524 // the view was initiated by the browser (the common case), this will be
525 // MSG_ROUTING_NONE. This is used in determining ownership when opening
526 // child tabs. See RenderWidget::createWebViewWithRequest.
527 //
528 // This ID may refer to an invalid view if that view is closed before this
529 // view is.
530 int32 opener_id_;
531
initial.commit09911bf2008-07-26 23:55:29532 // The position where this view should be initially shown.
533 gfx::Rect initial_pos_;
534
[email protected]fc4404d2012-11-07 19:53:30535 bool init_complete_;
initial.commit09911bf2008-07-26 23:55:29536
537 // We store the current cursor object so we can avoid spamming SetCursor
538 // messages.
539 WebCursor current_cursor_;
[email protected]88efb7ec2009-07-14 16:32:59540
initial.commit09911bf2008-07-26 23:55:29541 // The size of the RenderWidget.
542 gfx::Size size_;
543
[email protected]b4d08452010-10-05 17:34:35544 // The TransportDIB that is being used to transfer an image to the browser.
545 TransportDIB* current_paint_buf_;
initial.commit09911bf2008-07-26 23:55:29546
[email protected]552e6002009-11-19 05:24:57547 PaintAggregator paint_aggregator_;
initial.commit09911bf2008-07-26 23:55:29548
[email protected]60d47ac2013-03-01 23:42:44549 // The size of the view's backing surface in non-DPI-adjusted pixels.
550 gfx::Size physical_backing_size_;
551
[email protected]d9083762013-03-24 01:36:40552 // The height of the physical backing surface that is overdrawn opaquely in
553 // the browser, for example by an on-screen-keyboard (in DPI-adjusted pixels).
554 float overdraw_bottom_height_;
555
[email protected]f21c613a2009-02-12 14:46:17556 // The area that must be reserved for drawing the resize corner.
557 gfx::Rect resizer_rect_;
558
[email protected]53d3f302009-12-21 04:42:05559 // Flags for the next ViewHostMsg_UpdateRect message.
initial.commit09911bf2008-07-26 23:55:29560 int next_paint_flags_;
561
[email protected]872ae5b2011-05-26 20:20:50562 // Filtered time per frame based on UpdateRect messages.
563 float filtered_time_per_frame_;
564
[email protected]53d3f302009-12-21 04:42:05565 // True if we are expecting an UpdateRect_ACK message (i.e., that a
566 // UpdateRect message has been sent).
567 bool update_reply_pending_;
initial.commit09911bf2008-07-26 23:55:29568
[email protected]847a2582013-03-09 02:29:51569 // Whether the WebWidget is in auto resize mode, which is used for example
570 // by extension popups.
571 bool auto_resize_mode_;
572
[email protected]ea3ee0a2012-05-15 03:43:09573 // True if we need to send an UpdateRect message to notify the browser about
574 // an already-completed auto-resize.
575 bool need_update_rect_for_auto_resize_;
576
[email protected]65225772011-05-12 21:10:24577 // True if the underlying graphics context supports asynchronous swap.
578 // Cached on the RenderWidget because determining support is costly.
579 bool using_asynchronous_swapbuffers_;
580
581 // Number of OnSwapBuffersComplete we are expecting. Incremented each time
582 // WebWidget::composite has been been performed when the RenderWidget subclass
583 // SupportsAsynchronousSwapBuffers. Decremented in OnSwapBuffers. Will block
584 // rendering.
585 int num_swapbuffers_complete_pending_;
586
587 // When accelerated rendering is on, is the maximum number of swapbuffers that
588 // can be outstanding before we start throttling based on
589 // OnSwapBuffersComplete callback.
[email protected]82ca9b92011-09-12 23:33:07590 static const int kMaxSwapBuffersPending = 2;
[email protected]65225772011-05-12 21:10:24591
initial.commit09911bf2008-07-26 23:55:29592 // Set to true if we should ignore RenderWidget::Show calls.
593 bool did_show_;
594
595 // Indicates that we shouldn't bother generated paint events.
596 bool is_hidden_;
597
[email protected]ee41e7d22011-10-14 19:34:09598 // Indicates that we are in fullscreen mode.
599 bool is_fullscreen_;
600
initial.commit09911bf2008-07-26 23:55:29601 // Indicates that we should be repainted when restored. This flag is set to
602 // true if we receive an invalidation / scroll event from webkit while our
603 // is_hidden_ flag is set to true. This is used to force a repaint once we
604 // restore to account for the fact that our host would not know about the
605 // invalidation / scroll event(s) from webkit while we are hidden.
606 bool needs_repainting_on_restore_;
607
608 // Indicates whether we have been focused/unfocused by the browser.
609 bool has_focus_;
610
[email protected]5dd768212009-08-13 23:34:49611 // Are we currently handling an input event?
612 bool handling_input_event_;
613
[email protected]e8f775f2013-02-14 21:00:50614 // Are we currently handling an ime event?
615 bool handling_ime_event_;
616
initial.commit09911bf2008-07-26 23:55:29617 // True if we have requested this widget be closed. No more messages will
618 // be sent, except for a Close.
619 bool closing_;
620
[email protected]992db4c2011-05-12 15:37:15621 // Whether this RenderWidget is currently swapped out, such that the view is
622 // being rendered by another process. If all RenderWidgets in a process are
623 // swapped out, the process can exit.
624 bool is_swapped_out_;
625
[email protected]fa7b1dc2010-06-23 17:53:04626 // Indicates if an input method is active in the browser process.
627 bool input_method_is_active_;
initial.commit09911bf2008-07-26 23:55:29628
[email protected]5b739cb2012-08-21 20:35:21629 // Stores information about the current text input.
630 WebKit::WebTextInputInfo text_input_info_;
631
[email protected]fa7b1dc2010-06-23 17:53:04632 // Stores the current text input type of |webwidget_|.
[email protected]ad26ef42011-06-17 07:59:45633 ui::TextInputType text_input_type_;
634
635 // Stores the current type of composition text rendering of |webwidget_|.
636 bool can_compose_inline_;
[email protected]fa7b1dc2010-06-23 17:53:04637
[email protected]e99ef6f2011-10-16 01:13:00638 // Stores the current selection bounds.
[email protected]7c8873e2013-02-05 08:03:01639 gfx::Rect selection_focus_rect_;
640 gfx::Rect selection_anchor_rect_;
initial.commit09911bf2008-07-26 23:55:29641
[email protected]58b48a0df22012-06-13 07:01:35642 // Stores the current composition character bounds.
643 std::vector<gfx::Rect> composition_character_bounds_;
644
645 // Stores the current composition range.
646 ui::Range composition_range_;
647
[email protected]3e2b375b2010-04-07 17:03:12648 // The kind of popup this widget represents, NONE if not a popup.
649 WebKit::WebPopupType popup_type_;
[email protected]0ebf3872008-11-07 21:35:03650
initial.commit09911bf2008-07-26 23:55:29651 // Holds all the needed plugin window moves for a scroll.
[email protected]191eb3f72010-12-21 06:27:50652 typedef std::vector<webkit::npapi::WebPluginGeometry> WebPluginGeometryVector;
[email protected]268654772009-08-06 23:02:04653 WebPluginGeometryVector plugin_window_moves_;
initial.commit09911bf2008-07-26 23:55:29654
[email protected]699ab0d2009-04-23 23:19:14655 // A custom background for the widget.
656 SkBitmap background_;
657
[email protected]80ad8622012-11-07 16:33:03658 // While we are waiting for the browser to update window sizes, we track the
659 // pending size temporarily.
[email protected]2533ce12009-05-09 00:02:24660 int pending_window_rect_count_;
661 WebKit::WebRect pending_window_rect_;
662
[email protected]80ad8622012-11-07 16:33:03663 // The screen rects of the view and the window that contains it.
664 gfx::Rect view_screen_rect_;
665 gfx::Rect window_screen_rect_;
666
[email protected]12fbad812009-09-01 18:21:24667 scoped_ptr<IPC::Message> pending_input_event_ack_;
668
[email protected]b68a0e52011-12-08 15:11:12669 // Indicates if the next sequence of Char events should be suppressed or not.
670 bool suppress_next_char_events_;
671
[email protected]a79d8a632010-11-18 22:35:56672 // Set to true if painting to the window is handled by the accelerated
673 // compositor.
674 bool is_accelerated_compositing_active_;
[email protected]edbcde932010-05-07 17:10:46675
[email protected]350ce8702012-03-09 04:23:38676 base::OneShotTimer<RenderWidget> animation_timer_;
[email protected]5f8b1022011-01-21 23:34:50677 base::Time animation_floor_time_;
678 bool animation_update_pending_;
[email protected]65225772011-05-12 21:10:24679 bool invalidation_task_posted_;
[email protected]5f8b1022011-01-21 23:34:50680
[email protected]bd37ae252011-06-03 01:28:18681 bool has_disable_gpu_vsync_switch_;
[email protected]0fb93f572011-05-18 23:13:56682 base::TimeTicks last_do_deferred_update_time_;
683
[email protected]b63d58da12012-11-26 22:37:44684 cc::RenderingStats software_stats_;
[email protected]fef5e3972012-08-07 03:59:47685
[email protected]aa4117f2011-12-09 22:19:21686 // UpdateRect parameters for the current compositing pass. This is used to
687 // pass state between DoDeferredUpdate and OnSwapBuffersPosted.
688 scoped_ptr<ViewHostMsg_UpdateRect_Params> pending_update_params_;
689
690 // Queue of UpdateRect messages corresponding to a SwapBuffers. We want to
691 // delay sending of UpdateRect until the corresponding SwapBuffers has been
692 // executed. Since we can have several in flight, we need to keep them in a
693 // queue. Note: some SwapBuffers may not correspond to an update, in which
694 // case NULL is added to the queue.
695 std::deque<ViewHostMsg_UpdateRect*> updates_pending_swap_;
696
[email protected]842f10652012-06-06 01:54:04697 // Properties of the screen hosting this RenderWidget instance.
698 WebKit::WebScreenInfo screen_info_;
699
[email protected]f1cccb32012-06-06 18:29:59700 // The device scale factor. This value is computed from the DPI entries in
701 // |screen_info_| on some platforms, and defaults to 1 on other platforms.
[email protected]faec7b12012-06-19 14:42:13702 float device_scale_factor_;
[email protected]f1cccb32012-06-06 18:29:59703
[email protected]0e241b4b2012-08-18 09:06:27704 // State associated with the BeginSmoothScroll synthetic scrolling function.
[email protected]4a9dba42013-04-29 18:24:22705 SmoothScrollCompletionCallback pending_smooth_scroll_gesture_;
[email protected]0e241b4b2012-08-18 09:06:27706
[email protected]cb6430932012-10-31 00:53:36707 // Specified whether the compositor will run in its own thread.
708 bool is_threaded_compositing_enabled_;
709
[email protected]3639aa82013-06-04 11:00:04710 // The last set of rendering stats received from the browser. This is only
711 // received when using the --enable-gpu-benchmarking flag.
712 BrowserRenderingStats browser_rendering_stats_;
713
[email protected]256737c2013-06-08 04:39:10714 // The latency information for any current non-accelerated-compositing
715 // frame.
716 ui::LatencyInfo latency_info_;
717
[email protected]ed7defa2013-03-12 21:29:59718 base::WeakPtrFactory<RenderWidget> weak_ptr_factory_;
719
[email protected]05d478752009-04-08 23:38:16720 DISALLOW_COPY_AND_ASSIGN(RenderWidget);
initial.commit09911bf2008-07-26 23:55:29721};
722
[email protected]e9ff79c2012-10-19 21:31:26723} // namespace content
724
[email protected]2cff0052011-03-18 16:51:44725#endif // CONTENT_RENDERER_RENDER_WIDGET_H_