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 CreateIsolatedFileSystem(PP_Instance instance,
64                                               const char* fsid) = 0;
65  virtual PP_Resource CreateIMEInputEvent(PP_Instance instance,
66                                          PP_InputEvent_Type type,
67                                          PP_TimeTicks time_stamp,
68                                          struct PP_Var text,
69                                          uint32_t segment_number,
70                                          const uint32_t* segment_offsets,
71                                          int32_t target_segment,
72                                          uint32_t selection_start,
73                                          uint32_t selection_end) = 0;
74  virtual PP_Resource CreateKeyboardInputEvent(
75      PP_Instance instance,
76      PP_InputEvent_Type type,
77      PP_TimeTicks time_stamp,
78      uint32_t modifiers,
79      uint32_t key_code,
80      struct PP_Var character_text) = 0;
81  virtual PP_Resource CreateMouseInputEvent(
82      PP_Instance instance,
83      PP_InputEvent_Type type,
84      PP_TimeTicks time_stamp,
85      uint32_t modifiers,
86      PP_InputEvent_MouseButton mouse_button,
87      const PP_Point* mouse_position,
88      int32_t click_count,
89      const PP_Point* mouse_movement) = 0;
90  virtual PP_Resource CreateTouchInputEvent(
91      PP_Instance instance,
92      PP_InputEvent_Type type,
93      PP_TimeTicks time_stamp,
94      uint32_t modifiers) = 0;
95  virtual PP_Resource CreateResourceArray(PP_Instance instance,
96                                          const PP_Resource elements[],
97                                          uint32_t size) = 0;
98  virtual PP_Resource CreateTrueTypeFont(
99      PP_Instance instance,
100      const PP_TrueTypeFontDesc_Dev* desc) = 0;
101  virtual PP_Resource CreateURLLoader(PP_Instance instance) = 0;
102  virtual PP_Resource CreateURLRequestInfo(
103      PP_Instance instance) = 0;
104
105  virtual PP_Resource CreateWheelInputEvent(
106      PP_Instance instance,
107      PP_TimeTicks time_stamp,
108      uint32_t modifiers,
109      const PP_FloatPoint* wheel_delta,
110      const PP_FloatPoint* wheel_ticks,
111      PP_Bool scroll_by_page) = 0;
112
113  virtual PP_Resource CreateAudio(PP_Instance instance,
114                                  PP_Resource config_id,
115                                  PPB_Audio_Callback audio_callback,
116                                  void* user_data) = 0;
117  virtual PP_Resource CreateAudioTrusted(PP_Instance instance) = 0;
118  virtual PP_Resource CreateAudioConfig(PP_Instance instance,
119                                        PP_AudioSampleRate sample_rate,
120                                        uint32_t sample_frame_count) = 0;
121  virtual PP_Resource CreateFileChooser(PP_Instance instance,
122                                        PP_FileChooserMode_Dev mode,
123                                        const PP_Var& accept_types) = 0;
124  virtual PP_Resource CreateGraphics2D(PP_Instance instance,
125                                       const PP_Size* size,
126                                       PP_Bool is_always_opaque) = 0;
127  virtual PP_Resource CreateGraphics3D(PP_Instance instance,
128                                       PP_Resource share_context,
129                                       const int32_t* attrib_list) = 0;
130  virtual PP_Resource CreateGraphics3DRaw(PP_Instance instance,
131                                          PP_Resource share_context,
132                                          const int32_t* attrib_list) = 0;
133  virtual PP_Resource CreateHostResolver(PP_Instance instance) = 0;
134  virtual PP_Resource CreateHostResolverPrivate(PP_Instance instance) = 0;
135  virtual PP_Resource CreateImageData(PP_Instance instance,
136                                      PP_ImageDataFormat format,
137                                      const PP_Size* size,
138                                      PP_Bool init_to_zero) = 0;
139  virtual PP_Resource CreateImageDataSimple(PP_Instance instance,
140                                            PP_ImageDataFormat format,
141                                            const PP_Size* size,
142                                            PP_Bool init_to_zero) = 0;
143  virtual PP_Resource CreateNetAddressFromIPv4Address(
144      PP_Instance instance,
145      const PP_NetAddress_IPv4* ipv4_addr) = 0;
146  virtual PP_Resource CreateNetAddressFromIPv6Address(
147      PP_Instance instance,
148      const PP_NetAddress_IPv6* ipv6_addr) = 0;
149  virtual PP_Resource CreateNetAddressFromNetAddressPrivate(
150      PP_Instance instance,
151      const PP_NetAddress_Private& private_addr) = 0;
152  virtual PP_Resource CreateNetworkMonitor(
153      PP_Instance instance,
154      PPB_NetworkMonitor_Callback callback,
155      void* user_data) = 0;
156  virtual PP_Resource CreatePrinting(PP_Instance instance) = 0;
157  virtual PP_Resource CreateTCPServerSocketPrivate(PP_Instance instance) = 0;
158  virtual PP_Resource CreateTCPSocket(PP_Instance instace) = 0;
159  virtual PP_Resource CreateTCPSocketPrivate(PP_Instance instace) = 0;
160  virtual PP_Resource CreateUDPSocket(PP_Instance instace) = 0;
161  virtual PP_Resource CreateUDPSocketPrivate(PP_Instance instace) = 0;
162  virtual PP_Resource CreateVideoDestination(PP_Instance instance) = 0;
163  virtual PP_Resource CreateVideoSource(PP_Instance instance) = 0;
164  virtual PP_Resource CreateWebSocket(PP_Instance instance) = 0;
165  virtual PP_Resource CreateX509CertificatePrivate(PP_Instance instance) = 0;
166#if !defined(OS_NACL)
167  virtual PP_Resource CreateAudioInput(PP_Instance instance) = 0;
168  virtual PP_Resource CreateBroker(PP_Instance instance) = 0;
169  virtual PP_Resource CreateBrowserFont(
170      PP_Instance instance,
171      const PP_BrowserFont_Trusted_Description* description) = 0;
172  virtual PP_Resource CreateBuffer(PP_Instance instance, uint32_t size) = 0;
173  virtual PP_Resource CreateFlashDRM(PP_Instance instance) = 0;
174  virtual PP_Resource CreateFlashFontFile(
175      PP_Instance instance,
176      const PP_BrowserFont_Trusted_Description* description,
177      PP_PrivateFontCharset charset) = 0;
178  virtual PP_Resource CreateFlashMenu(PP_Instance instance,
179                                      const PP_Flash_Menu* menu_data) = 0;
180  virtual PP_Resource CreateFlashMessageLoop(PP_Instance instance) = 0;
181  virtual PP_Resource CreateScrollbar(PP_Instance instance,
182                                      PP_Bool vertical) = 0;
183  virtual PP_Resource CreateTalk(PP_Instance instance) = 0;
184  virtual PP_Resource CreateVideoCapture(PP_Instance instance) = 0;
185  virtual PP_Resource CreateVideoDecoder(
186      PP_Instance instance,
187      PP_Resource context3d_id,
188      PP_VideoDecoder_Profile profile) = 0;
189#endif  // !defined(OS_NACL)
190
191  static const ApiID kApiID = API_ID_RESOURCE_CREATION;
192};
193
194}  // namespace thunk
195}  // namespace ppapi
196
197#endif  // PPAPI_THUNK_RESOURCE_CREATION_API_H_
198