OLD | NEW |
| (Empty) |
1 // Copyright (c) 2006-2009 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 WEBKIT_GLUE_WEBPLUGIN_H_ | |
6 #define WEBKIT_GLUE_WEBPLUGIN_H_ | |
7 | |
8 #include <string> | |
9 #include <vector> | |
10 | |
11 #include "base/basictypes.h" | |
12 #include "gfx/native_widget_types.h" | |
13 #include "gfx/rect.h" | |
14 | |
15 // TODO(port): this typedef is obviously incorrect on non-Windows | |
16 // platforms, but now a lot of code now accidentally depends on them | |
17 // existing. #ifdef out these declarations and fix all the users. | |
18 typedef void* HANDLE; | |
19 | |
20 class GURL; | |
21 struct NPObject; | |
22 | |
23 namespace WebKit { | |
24 class WebFrame; | |
25 } | |
26 | |
27 namespace webkit_glue { | |
28 | |
29 class WebPluginDelegate; | |
30 class WebPluginParentView; | |
31 class WebPluginResourceClient; | |
32 #if defined(OS_MACOSX) | |
33 class WebPluginAcceleratedSurface; | |
34 #endif | |
35 | |
36 // Describes the new location for a plugin window. | |
37 struct WebPluginGeometry { | |
38 WebPluginGeometry(); | |
39 ~WebPluginGeometry(); | |
40 | |
41 bool Equals(const WebPluginGeometry& rhs) const; | |
42 | |
43 // On Windows, this is the plugin window in the plugin process. | |
44 // On X11, this is the XID of the plugin-side GtkPlug containing the | |
45 // GtkSocket hosting the actual plugin window. | |
46 // | |
47 // On Mac OS X, all of the plugin types are currently "windowless" | |
48 // (window == 0) except for the special case of the GPU plugin, | |
49 // which currently performs rendering on behalf of the Pepper 3D API | |
50 // and WebGL. The GPU plugin uses a simple integer for the | |
51 // PluginWindowHandle which is used to map to a side data structure | |
52 // containing information about the plugin. Soon this plugin will be | |
53 // generalized, at which point this mechanism will be rethought or | |
54 // removed. | |
55 gfx::PluginWindowHandle window; | |
56 gfx::Rect window_rect; | |
57 // Clip rect (include) and cutouts (excludes), relative to | |
58 // window_rect origin. | |
59 gfx::Rect clip_rect; | |
60 std::vector<gfx::Rect> cutout_rects; | |
61 bool rects_valid; | |
62 bool visible; | |
63 }; | |
64 | |
65 // The WebKit side of a plugin implementation. It provides wrappers around | |
66 // operations that need to interact with the frame and other WebCore objects. | |
67 class WebPlugin { | |
68 public: | |
69 virtual ~WebPlugin() {} | |
70 | |
71 // Called by the plugin delegate to let the WebPlugin know if the plugin is | |
72 // windowed (i.e. handle is not NULL) or windowless (handle is NULL). This | |
73 // tells the WebPlugin to send mouse/keyboard events to the plugin delegate, | |
74 // as well as the information about the HDC for paint operations. | |
75 virtual void SetWindow(gfx::PluginWindowHandle window) = 0; | |
76 | |
77 // Whether input events should be sent to the delegate. | |
78 virtual void SetAcceptsInputEvents(bool accepts) = 0; | |
79 | |
80 // Called by the plugin delegate to let it know that the window is being | |
81 // destroyed. | |
82 virtual void WillDestroyWindow(gfx::PluginWindowHandle window) = 0; | |
83 #if defined(OS_WIN) | |
84 // The pump_messages_event is a event handle which is valid only for | |
85 // windowless plugins and is used in NPP_HandleEvent calls to pump messages | |
86 // if the plugin enters a modal loop. | |
87 // Cancels a pending request. | |
88 virtual void SetWindowlessPumpEvent(HANDLE pump_messages_event) = 0; | |
89 #endif | |
90 virtual void CancelResource(unsigned long id) = 0; | |
91 virtual void Invalidate() = 0; | |
92 virtual void InvalidateRect(const gfx::Rect& rect) = 0; | |
93 | |
94 // Returns the NPObject for the browser's window object. | |
95 virtual NPObject* GetWindowScriptNPObject() = 0; | |
96 | |
97 // Returns the DOM element that loaded the plugin. | |
98 virtual NPObject* GetPluginElement() = 0; | |
99 | |
100 // Cookies | |
101 virtual void SetCookie(const GURL& url, | |
102 const GURL& first_party_for_cookies, | |
103 const std::string& cookie) = 0; | |
104 virtual std::string GetCookies(const GURL& url, | |
105 const GURL& first_party_for_cookies) = 0; | |
106 | |
107 // Shows a modal HTML dialog containing the given URL. json_arguments are | |
108 // passed to the dialog via the DOM 'window.chrome.dialogArguments', and the | |
109 // retval is the string returned by 'window.chrome.send("DialogClose", | |
110 // retval)'. | |
111 virtual void ShowModalHTMLDialog(const GURL& url, int width, int height, | |
112 const std::string& json_arguments, | |
113 std::string* json_retval) = 0; | |
114 | |
115 // When a default plugin has downloaded the plugin list and finds it is | |
116 // available, it calls this method to notify the renderer. Also it will update | |
117 // the status when user clicks on the plugin to install. | |
118 virtual void OnMissingPluginStatus(int status) = 0; | |
119 | |
120 // Handles GetURL/GetURLNotify/PostURL/PostURLNotify requests initiated | |
121 // by plugins. If the plugin wants notification of the result, notify_id will | |
122 // be non-zero. | |
123 virtual void HandleURLRequest(const char* url, | |
124 const char* method, | |
125 const char* target, | |
126 const char* buf, | |
127 unsigned int len, | |
128 int notify_id, | |
129 bool popups_allowed, | |
130 bool notify_redirects) = 0; | |
131 | |
132 // Cancels document load. | |
133 virtual void CancelDocumentLoad() = 0; | |
134 | |
135 // Initiates a HTTP range request for an existing stream. | |
136 virtual void InitiateHTTPRangeRequest(const char* url, | |
137 const char* range_info, | |
138 int range_request_id) = 0; | |
139 | |
140 // Returns true iff in off the record (Incognito) mode. | |
141 virtual bool IsOffTheRecord() = 0; | |
142 | |
143 // Called when the WebPluginResourceClient instance is deleted. | |
144 virtual void ResourceClientDeleted( | |
145 WebPluginResourceClient* resource_client) {} | |
146 | |
147 // Defers the loading of the resource identified by resource_id. This is | |
148 // controlled by the defer parameter. | |
149 virtual void SetDeferResourceLoading(unsigned long resource_id, | |
150 bool defer) = 0; | |
151 | |
152 #if defined(OS_MACOSX) | |
153 // Enables/disables plugin IME. | |
154 virtual void SetImeEnabled(bool enabled) {}; | |
155 | |
156 // Synthesize a fake window handle for the plug-in to identify the instance | |
157 // to the browser, allowing mapping to a surface for hardware accelleration | |
158 // of plug-in content. The browser generates the handle which is then set on | |
159 // the plug-in. |opaque| indicates whether the content should be treated as | |
160 // opaque or translucent. | |
161 // TODO(stuartmorgan): Move this into WebPluginProxy. | |
162 virtual void BindFakePluginWindowHandle(bool opaque) {} | |
163 | |
164 // Returns the accelerated surface abstraction for accelerated plugins. | |
165 virtual WebPluginAcceleratedSurface* GetAcceleratedSurface() { return NULL; } | |
166 #endif | |
167 | |
168 // Gets the WebPluginDelegate that implements the interface. | |
169 // This API is only for use with Pepper, and is only overridden | |
170 // by in-renderer implementations. | |
171 virtual WebPluginDelegate* delegate(); | |
172 | |
173 // Handles NPN_URLRedirectResponse calls issued by plugins in response to | |
174 // HTTP URL redirect notifications. | |
175 virtual void URLRedirectResponse(bool allow, int resource_id) = 0; | |
176 }; | |
177 | |
178 // Simpler version of ResourceHandleClient that lends itself to proxying. | |
179 class WebPluginResourceClient { | |
180 public: | |
181 virtual ~WebPluginResourceClient() {} | |
182 virtual void WillSendRequest(const GURL& url, int http_status_code) = 0; | |
183 // The request_is_seekable parameter indicates whether byte range requests | |
184 // can be issued for the underlying stream. | |
185 virtual void DidReceiveResponse(const std::string& mime_type, | |
186 const std::string& headers, | |
187 uint32 expected_length, | |
188 uint32 last_modified, | |
189 bool request_is_seekable) = 0; | |
190 virtual void DidReceiveData(const char* buffer, int length, | |
191 int data_offset) = 0; | |
192 virtual void DidFinishLoading() = 0; | |
193 virtual void DidFail() = 0; | |
194 virtual bool IsMultiByteResponseExpected() = 0; | |
195 virtual int ResourceId() = 0; | |
196 }; | |
197 | |
198 } // namespace webkit_glue | |
199 | |
200 #endif // #ifndef WEBKIT_GLUE_WEBPLUGIN_H_ | |
OLD | NEW |