interfaces_ppb_public_stable.h revision 5d1f7b1de12d16ceb2c938c56701a3e8bfa558f7
15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved.
25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be
35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file.
45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/thunk/interfaces_preamble.h"
65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This file contains lists of interfaces. It's intended to be included by
85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// another file which defines implementations of the macros. This allows files
95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// to do specific registration tasks for each supported interface.
105d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)//
115d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// When adding an interface, you must also add the hash value for the
125d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// interface's name to tools/metrics/histograms/histograms.xml. This is so we
135d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// get human-readable UMA tracking for interface usage.
145d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)//
155d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// Use the 'pepper_hash_for_uma' tool in ppapi/tools to determine the hash for
165d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// a given interface string.
175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Api categories
195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// --------------
205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Enumerates the categories of APIs. These correspnd to the *_api.h files in
215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// this directory. One API may implement one or more actual interfaces.
225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//
235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// For PROXIED_APIs, these also correspond to *_Proxy objects. The proxied ones
245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// define factory functions for each of these classes. UNPROXIED_APIs are ones
255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// that exist in the webkit/plugins/ppapi/*_impl.h, but not in the proxy.
265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)PROXIED_API(PPB_Audio)
275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)PROXIED_API(PPB_Core)
285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)PROXIED_API(PPB_Graphics3D)
295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)PROXIED_API(PPB_ImageData)
305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)PROXIED_API(PPB_Instance)
315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// AudioConfig isn't proxied in the normal way, we have only local classes and
335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// serialize it to a struct when we need it on the host side.
345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)UNPROXIED_API(PPB_AudioConfig)
355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Interfaces
375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// ----------
385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Enumerates interfaces as (api_name, interface_name, interface_struct).
395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//
405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// The api_name corresponds to the class in the list above for the object
415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// that implements the API. Some things may be special and aren't implemented
425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// by any specific API object, and we use "NoAPIName" for those. Implementors
435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// of these macros should handle this case. There can be more than one line
445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// referring to the same api_name (typically different versions of the
455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// same interface).
465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//
475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// The interface_name is the string that corresponds to the interface.
485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//
495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// The interface_struct is the typename of the struct corresponding to the
505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// interface string.
515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Note: Core is special and is registered manually.
525d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_AUDIO_INTERFACE_1_0, PPB_Audio_1_0)
535d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_AUDIO_INTERFACE_1_1, PPB_Audio_1_1)
545d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_FILEREF_INTERFACE_1_0, PPB_FileRef_1_0)
555d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_FILEREF_INTERFACE_1_1, PPB_FileRef_1_1)
565d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_FILEREF_INTERFACE_1_2, PPB_FileRef_1_2)
575d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_FILESYSTEM_INTERFACE_1_0, PPB_FileSystem_1_0)
585d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_GRAPHICS_3D_INTERFACE_1_0, PPB_Graphics3D_1_0)
595d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_IMAGEDATA_INTERFACE_1_0, PPB_ImageData_1_0)
605d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_CONSOLE_INTERFACE_1_0, PPB_Console_1_0)
615d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_GAMEPAD_INTERFACE_1_0, PPB_Gamepad_1_0)
625d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_INSTANCE_INTERFACE_1_0, PPB_Instance_1_0)
635d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_FILEIO_INTERFACE_1_0, PPB_FileIO_1_0)
645d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_FILEIO_INTERFACE_1_1, PPB_FileIO_1_1)
655d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_GRAPHICS_2D_INTERFACE_1_0, PPB_Graphics2D_1_0)
665d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_GRAPHICS_2D_INTERFACE_1_1, PPB_Graphics2D_1_1)
675d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_HOSTRESOLVER_INTERFACE_1_0, PPB_HostResolver_1_0)
685d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_IME_INPUT_EVENT_INTERFACE_1_0, PPB_IMEInputEvent_1_0)
695d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_INPUT_EVENT_INTERFACE_1_0, PPB_InputEvent_1_0)
705d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_KEYBOARD_INPUT_EVENT_INTERFACE_1_0,
715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)              PPB_KeyboardInputEvent_1_0)
725d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_KEYBOARD_INPUT_EVENT_INTERFACE_1_2,
735d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)              PPB_KeyboardInputEvent_1_2)
745d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_MOUSE_INPUT_EVENT_INTERFACE_1_0, PPB_MouseInputEvent_1_0)
755d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_MOUSE_INPUT_EVENT_INTERFACE_1_1, PPB_MouseInputEvent_1_1)
765d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_WHEEL_INPUT_EVENT_INTERFACE_1_0, PPB_WheelInputEvent_1_0)
775d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_TOUCH_INPUT_EVENT_INTERFACE_1_0, PPB_TouchInputEvent_1_0)
785d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_FULLSCREEN_INTERFACE_1_0, PPB_Fullscreen_1_0)
795d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_MESSAGING_INTERFACE_1_0, PPB_Messaging_1_0)
805d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_MOUSECURSOR_INTERFACE_1_0, PPB_MouseCursor_1_0)
815d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_MOUSELOCK_INTERFACE_1_0, PPB_MouseLock_1_0)
825d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_NETADDRESS_INTERFACE_1_0, PPB_NetAddress_1_0)
835d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_NETWORKLIST_INTERFACE_1_0, PPB_NetworkList_1_0)
845d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_NETWORKMONITOR_INTERFACE_1_0, PPB_NetworkMonitor_1_0)
855d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_NETWORKPROXY_INTERFACE_1_0, PPB_NetworkProxy_1_0)
865d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_TCPSOCKET_INTERFACE_1_0, PPB_TCPSocket_1_0)
875d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_TCPSOCKET_INTERFACE_1_1, PPB_TCPSocket_1_1)
885d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_TEXTINPUTCONTROLLER_INTERFACE_1_0,
89a36e5920737c6adbddd3e43b760e5de8431db6e0Torne (Richard Coles)              PPB_TextInputController_1_0)
905d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_UDPSOCKET_INTERFACE_1_0, PPB_UDPSocket_1_0)
915d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_URLLOADER_INTERFACE_1_0, PPB_URLLoader_1_0)
925d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_URLREQUESTINFO_INTERFACE_1_0, PPB_URLRequestInfo_1_0)
935d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_URLRESPONSEINFO_INTERFACE_1_0, PPB_URLResponseInfo_1_0)
945d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_VAR_ARRAY_INTERFACE_1_0, PPB_VarArray_1_0)
955d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_VAR_DICTIONARY_INTERFACE_1_0, PPB_VarDictionary_1_0)
965d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_WEBSOCKET_INTERFACE_1_0, PPB_WebSocket_1_0)
975821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
985821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Note: PPB_Var and PPB_VarArrayBuffer are special and registered manually.
995d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_VIEW_INTERFACE_1_0, PPB_View_1_0)
1005d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_VIEW_INTERFACE_1_1, PPB_View_1_1)
1015821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
1025821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This has no corresponding _Proxy object since it does no IPC.
1035d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_AUDIO_CONFIG_INTERFACE_1_0, PPB_AudioConfig_1_0)
1045d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)PROXIED_IFACE(PPB_AUDIO_CONFIG_INTERFACE_1_1, PPB_AudioConfig_1_1)
1055821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
1065821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "ppapi/thunk/interfaces_postamble.h"
107