resource_creation_api.h revision 58537e28ecd584eab876aee8be7156509866d23a 
1// Copyright (c) 2012 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 PPAPI_THUNK_RESOURCE_CREATION_API_H_
6#define PPAPI_THUNK_RESOURCE_CREATION_API_H_
7
8#include "ppapi/c/dev/ppb_file_chooser_dev.h"
9#include "ppapi/c/pp_bool.h"
10#include "ppapi/c/pp_instance.h"
11#include "ppapi/c/pp_resource.h"
12#include "ppapi/c/ppb_audio.h"
13#include "ppapi/c/ppb_audio_config.h"
14#include "ppapi/c/ppb_file_system.h"
15#include "ppapi/c/ppb_graphics_3d.h"
16#include "ppapi/c/ppb_image_data.h"
17#include "ppapi/c/ppb_input_event.h"
18#include "ppapi/c/ppb_websocket.h"
19#include "ppapi/c/dev/pp_video_dev.h"
20#include "ppapi/c/dev/ppb_truetype_font_dev.h"
21#include "ppapi/c/private/pp_private_font_charset.h"
22#include "ppapi/c/private/ppb_network_monitor_private.h"
23#include "ppapi/shared_impl/api_id.h"
24#include "ppapi/shared_impl/ppb_image_data_shared.h"
25
26struct PP_Flash_Menu;
27struct PP_FontDescription_Dev;
28struct PP_BrowserFont_Trusted_Description;
29struct PP_NetAddress_IPv4;
30struct PP_NetAddress_IPv6;
31struct PP_NetAddress_Private;
32struct PP_Size;
33
34namespace ppapi {
35
36struct PPB_FileRef_CreateInfo;
37struct URLRequestInfoData;
38struct URLResponseInfoData;
39
40namespace thunk {
41
42// A functional API for creating resource types. Separating out the creation
43// functions here allows us to implement most resources as a pure "resource
44// API", meaning all calls are routed on a per-resource-object basis. The
45// creation functions are not per-object (since there's no object during
46// creation) so need functional routing based on the instance ID.
47class ResourceCreationAPI {
48 public:
49  virtual ~ResourceCreationAPI() {}
50
51  virtual PP_Resource CreateFileIO(PP_Instance instance) = 0;
52  virtual PP_Resource CreateFileRef(PP_Instance instance,
53                                    PP_Resource file_system,
54                                    const char* path) = 0;
55  // Like the above version but takes a serialized file ref. The resource
56  // in the serialized file ref is passed into this, which takes ownership of
57  // the reference. In the proxy, the return value will be a plugin resource.
58  // In the impl, the return value will be the same resource ID.
59  virtual PP_Resource CreateFileRef(
60      const PPB_FileRef_CreateInfo& serialized) = 0;
61  virtual PP_Resource CreateFileSystem(PP_Instance instance,
62                                       PP_FileSystemType type) = 0;
63  virtual PP_Resource CreateIMEInputEvent(PP_Instance instance,
64                                          PP_InputEvent_Type type,
65                                          PP_TimeTicks time_stamp,
66                                          struct PP_Var text,
67                                          uint32_t segment_number,
68                                          const uint32_t* segment_offsets,
69                                          int32_t target_segment,
70                                          uint32_t selection_start,
71                                          uint32_t selection_end) = 0;
72  virtual PP_Resource CreateKeyboardInputEvent(
73      PP_Instance instance,
74      PP_InputEvent_Type type,
75      PP_TimeTicks time_stamp,
76      uint32_t modifiers,
77      uint32_t key_code,
78      struct PP_Var character_text) = 0;
79  virtual PP_Resource CreateMouseInputEvent(
80      PP_Instance instance,
81      PP_InputEvent_Type type,
82      PP_TimeTicks time_stamp,
83      uint32_t modifiers,
84      PP_InputEvent_MouseButton mouse_button,
85      const PP_Point* mouse_position,
86      int32_t click_count,
87      const PP_Point* mouse_movement) = 0;
88  virtual PP_Resource CreateTouchInputEvent(
89      PP_Instance instance,
90      PP_InputEvent_Type type,
91      PP_TimeTicks time_stamp,
92      uint32_t modifiers) = 0;
93  virtual PP_Resource CreateResourceArray(PP_Instance instance,
94                                          const PP_Resource elements[],
95                                          uint32_t size) = 0;
96  virtual PP_Resource CreateTrueTypeFont(
97      PP_Instance instance,
98      const PP_TrueTypeFontDesc_Dev* desc) = 0;
99  virtual PP_Resource CreateURLLoader(PP_Instance instance) = 0;
100  virtual PP_Resource CreateURLRequestInfo(
101      PP_Instance instance) = 0;
102
103  virtual PP_Resource CreateWheelInputEvent(
104      PP_Instance instance,
105      PP_TimeTicks time_stamp,
106      uint32_t modifiers,
107      const PP_FloatPoint* wheel_delta,
108      const PP_FloatPoint* wheel_ticks,
109      PP_Bool scroll_by_page) = 0;
110
111  virtual PP_Resource CreateAudio1_0(PP_Instance instance,
112                                     PP_Resource config_id,
113                                     PPB_Audio_Callback_1_0 audio_callback,
114                                     void* user_data) = 0;
115  virtual PP_Resource CreateAudio(PP_Instance instance,
116                                  PP_Resource config_id,
117                                  PPB_Audio_Callback audio_callback,
118                                  void* user_data) = 0;
119  virtual PP_Resource CreateAudioTrusted(PP_Instance instance) = 0;
120  virtual PP_Resource CreateAudioConfig(PP_Instance instance,
121                                        PP_AudioSampleRate sample_rate,
122                                        uint32_t sample_frame_count) = 0;
123  virtual PP_Resource CreateFileChooser(PP_Instance instance,
124                                        PP_FileChooserMode_Dev mode,
125                                        const PP_Var& accept_types) = 0;
126  virtual PP_Resource CreateGraphics2D(PP_Instance instance,
127                                       const PP_Size* size,
128                                       PP_Bool is_always_opaque) = 0;
129  virtual PP_Resource CreateGraphics3D(PP_Instance instance,
130                                       PP_Resource share_context,
131                                       const int32_t* attrib_list) = 0;
132  virtual PP_Resource CreateGraphics3DRaw(PP_Instance instance,
133                                          PP_Resource share_context,
134                                          const int32_t* attrib_list) = 0;
135  virtual PP_Resource CreateHostResolver(PP_Instance instance) = 0;
136  virtual PP_Resource CreateHostResolverPrivate(PP_Instance instance) = 0;
137  virtual PP_Resource CreateImageData(PP_Instance instance,
138                                      PP_ImageDataFormat format,
139                                      const PP_Size* size,
140                                      PP_Bool init_to_zero) = 0;
141  virtual PP_Resource CreateImageDataSimple(PP_Instance instance,
142                                            PP_ImageDataFormat format,
143                                            const PP_Size* size,
144                                            PP_Bool init_to_zero) = 0;
145  virtual PP_Resource CreateNetAddressFromIPv4Address(
146      PP_Instance instance,
147      const PP_NetAddress_IPv4* ipv4_addr) = 0;
148  virtual PP_Resource CreateNetAddressFromIPv6Address(
149      PP_Instance instance,
150      const PP_NetAddress_IPv6* ipv6_addr) = 0;
151  virtual PP_Resource CreateNetAddressFromNetAddressPrivate(
152      PP_Instance instance,
153      const PP_NetAddress_Private& private_addr) = 0;
154  virtual PP_Resource CreateNetworkMonitorPrivate(PP_Instance instance) = 0;
155  virtual PP_Resource CreatePrinting(PP_Instance instance) = 0;
156  virtual PP_Resource CreateTCPServerSocketPrivate(PP_Instance instance) = 0;
157  virtual PP_Resource CreateTCPSocket(PP_Instance instace) = 0;
158  virtual PP_Resource CreateTCPSocketPrivate(PP_Instance instace) = 0;
159  virtual PP_Resource CreateUDPSocket(PP_Instance instace) = 0;
160  virtual PP_Resource CreateUDPSocketPrivate(PP_Instance instace) = 0;
161  virtual PP_Resource CreateVideoDestination(PP_Instance instance) = 0;
162  virtual PP_Resource CreateVideoSource(PP_Instance instance) = 0;
163  virtual PP_Resource CreateWebSocket(PP_Instance instance) = 0;
164  virtual PP_Resource CreateX509CertificatePrivate(PP_Instance instance) = 0;
165#if !defined(OS_NACL)
166  virtual PP_Resource CreateAudioInput(PP_Instance instance) = 0;
167  virtual PP_Resource CreateBroker(PP_Instance instance) = 0;
168  virtual PP_Resource CreateBrowserFont(
169      PP_Instance instance,
170      const PP_BrowserFont_Trusted_Description* description) = 0;
171  virtual PP_Resource CreateBuffer(PP_Instance instance, uint32_t size) = 0;
172  virtual PP_Resource CreateFlashDRM(PP_Instance instance) = 0;
173  virtual PP_Resource CreateFlashFontFile(
174      PP_Instance instance,
175      const PP_BrowserFont_Trusted_Description* description,
176      PP_PrivateFontCharset charset) = 0;
177  virtual PP_Resource CreateFlashMenu(PP_Instance instance,
178                                      const PP_Flash_Menu* menu_data) = 0;
179  virtual PP_Resource CreateFlashMessageLoop(PP_Instance instance) = 0;
180  virtual PP_Resource CreateScrollbar(PP_Instance instance,
181                                      PP_Bool vertical) = 0;
182  virtual PP_Resource CreateTalk(PP_Instance instance) = 0;
183  virtual PP_Resource CreateVideoCapture(PP_Instance instance) = 0;
184  virtual PP_Resource CreateVideoDecoder(
185      PP_Instance instance,
186      PP_Resource context3d_id,
187      PP_VideoDecoder_Profile profile) = 0;
188#endif  // !defined(OS_NACL)
189
190  static const ApiID kApiID = API_ID_RESOURCE_CREATION;
191};
192
193}  // namespace thunk
194}  // namespace ppapi
195
196#endif  // PPAPI_THUNK_RESOURCE_CREATION_API_H_
197