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_INSTANCE_API_H_ 6 #define PPAPI_THUNK_INSTANCE_API_H_ 7 8 #include "base/memory/ref_counted.h" 9 #include "base/memory/scoped_ptr.h" 10 #include "ppapi/c/dev/ppb_url_util_dev.h" 11 #include "ppapi/c/pp_bool.h" 12 #include "ppapi/c/pp_completion_callback.h" 13 #include "ppapi/c/pp_size.h" 14 #include "ppapi/c/ppb_audio_config.h" 15 #include "ppapi/c/ppb_console.h" 16 #include "ppapi/c/ppb_gamepad.h" 17 #include "ppapi/c/ppb_instance.h" 18 #include "ppapi/c/ppb_mouse_cursor.h" 19 #include "ppapi/c/ppb_text_input_controller.h" 20 #include "ppapi/c/private/pp_content_decryptor.h" 21 #include "ppapi/c/private/ppb_instance_private.h" 22 #include "ppapi/shared_impl/api_id.h" 23 #include "ppapi/shared_impl/resource.h" 24 #include "ppapi/shared_impl/singleton_resource_id.h" 25 26 // Windows headers interfere with this file. 27 #ifdef PostMessage 28 #undef PostMessage 29 #endif 30 31 struct PP_DecryptedBlockInfo; 32 struct PP_DecryptedFrameInfo; 33 34 namespace ppapi { 35 36 class Resource; 37 class TrackedCallback; 38 struct ViewData; 39 40 namespace thunk { 41 42 class PPB_Flash_API; 43 44 class PPB_Instance_API { 45 public: 46 virtual ~PPB_Instance_API() {} 47 48 virtual PP_Bool BindGraphics(PP_Instance instance, PP_Resource device) = 0; 49 virtual PP_Bool IsFullFrame(PP_Instance instance) = 0; 50 51 // Unexposed PPAPI functions for proxying. 52 // Returns the internal view data struct. 53 virtual const ViewData* GetViewData(PP_Instance instance) = 0; 54 // Returns the flash fullscreen status. 55 virtual PP_Bool FlashIsFullscreen(PP_Instance instance) = 0; 56 57 // InstancePrivate. 58 virtual PP_Var GetWindowObject(PP_Instance instance) = 0; 59 virtual PP_Var GetOwnerElementObject(PP_Instance instance) = 0; 60 virtual PP_Var ExecuteScript(PP_Instance instance, 61 PP_Var script, 62 PP_Var* exception) = 0; 63 64 // Audio. 65 virtual uint32_t GetAudioHardwareOutputSampleRate(PP_Instance instance) = 0; 66 virtual uint32_t GetAudioHardwareOutputBufferSize(PP_Instance instance) = 0; 67 68 // CharSet. 69 virtual PP_Var GetDefaultCharSet(PP_Instance instance) = 0; 70 71 // Console. 72 virtual void Log(PP_Instance instance, 73 PP_LogLevel log_level, 74 PP_Var value) = 0; 75 virtual void LogWithSource(PP_Instance instance, 76 PP_LogLevel log_level, 77 PP_Var source, 78 PP_Var value) = 0; 79 80 // Find. 81 virtual void NumberOfFindResultsChanged(PP_Instance instance, 82 int32_t total, 83 PP_Bool final_result) = 0; 84 virtual void SelectedFindResultChanged(PP_Instance instance, 85 int32_t index) = 0; 86 87 // Fullscreen. 88 virtual PP_Bool IsFullscreen(PP_Instance instance) = 0; 89 virtual PP_Bool SetFullscreen(PP_Instance instance, 90 PP_Bool fullscreen) = 0; 91 virtual PP_Bool GetScreenSize(PP_Instance instance, PP_Size* size) = 0; 92 93 // This is an implementation-only function which grabs an instance of a 94 // "singleton resource". These are used to implement instance interfaces 95 // (functions which are associated with the instance itself as opposed to a 96 // resource). 97 virtual Resource* GetSingletonResource( 98 PP_Instance instance, SingletonResourceID id) = 0; 99 100 // InputEvent. 101 virtual int32_t RequestInputEvents(PP_Instance instance, 102 uint32_t event_classes) = 0; 103 virtual int32_t RequestFilteringInputEvents(PP_Instance instance, 104 uint32_t event_classes) = 0; 105 virtual void ClearInputEventRequest(PP_Instance instance, 106 uint32_t event_classes) = 0; 107 108 // Messaging. 109 virtual void PostMessage(PP_Instance instance, PP_Var message) = 0; 110 111 // Mouse cursor. 112 virtual PP_Bool SetCursor(PP_Instance instance, 113 PP_MouseCursor_Type type, 114 PP_Resource image, 115 const PP_Point* hot_spot) = 0; 116 117 // MouseLock. 118 virtual int32_t LockMouse(PP_Instance instance, 119 scoped_refptr<TrackedCallback> callback) = 0; 120 virtual void UnlockMouse(PP_Instance instance) = 0; 121 122 // TextInput. 123 virtual void SetTextInputType(PP_Instance instance, 124 PP_TextInput_Type type) = 0; 125 virtual void UpdateCaretPosition(PP_Instance instance, 126 const PP_Rect& caret, 127 const PP_Rect& bounding_box) = 0; 128 virtual void CancelCompositionText(PP_Instance instance) = 0; 129 virtual void SelectionChanged(PP_Instance instance) = 0; 130 virtual void UpdateSurroundingText(PP_Instance instance, 131 const char* text, 132 uint32_t caret, 133 uint32_t anchor) = 0; 134 135 // Zoom. 136 virtual void ZoomChanged(PP_Instance instance, double factor) = 0; 137 virtual void ZoomLimitsChanged(PP_Instance instance, 138 double minimum_factor, 139 double maximum_factor) = 0; 140 // Testing and URLUtil. 141 virtual PP_Var GetDocumentURL(PP_Instance instance, 142 PP_URLComponents_Dev* components) = 0; 143 #if !defined(OS_NACL) 144 // Content Decryptor. 145 virtual void SessionCreated(PP_Instance instance, 146 uint32 session_id, 147 PP_Var web_session_id) = 0; 148 virtual void SessionMessage(PP_Instance instance, 149 uint32 session_id, 150 PP_Var message, 151 PP_Var destination_url) = 0; 152 virtual void SessionReady(PP_Instance instance, uint32 session_id) = 0; 153 virtual void SessionClosed(PP_Instance instance, uint32 session_id) = 0; 154 virtual void SessionError(PP_Instance instance, 155 uint32 session_id, 156 int32_t media_error, 157 int32_t system_error) = 0; 158 virtual void DeliverBlock(PP_Instance instance, 159 PP_Resource decrypted_block, 160 const PP_DecryptedBlockInfo* block_info) = 0; 161 virtual void DecoderInitializeDone(PP_Instance instance, 162 PP_DecryptorStreamType decoder_type, 163 uint32_t request_id, 164 PP_Bool success) = 0; 165 virtual void DecoderDeinitializeDone(PP_Instance instance, 166 PP_DecryptorStreamType decoder_type, 167 uint32_t request_id) = 0; 168 virtual void DecoderResetDone(PP_Instance instance, 169 PP_DecryptorStreamType decoder_type, 170 uint32_t request_id) = 0; 171 virtual void DeliverFrame(PP_Instance instance, 172 PP_Resource decrypted_frame, 173 const PP_DecryptedFrameInfo* frame_info) = 0; 174 virtual void DeliverSamples(PP_Instance instance, 175 PP_Resource audio_frames, 176 const PP_DecryptedSampleInfo* sample_info) = 0; 177 178 // URLUtil. 179 virtual PP_Var ResolveRelativeToDocument( 180 PP_Instance instance, 181 PP_Var relative, 182 PP_URLComponents_Dev* components) = 0; 183 virtual PP_Bool DocumentCanRequest(PP_Instance instance, PP_Var url) = 0; 184 virtual PP_Bool DocumentCanAccessDocument(PP_Instance instance, 185 PP_Instance target) = 0; 186 virtual PP_Var GetPluginInstanceURL(PP_Instance instance, 187 PP_URLComponents_Dev* components) = 0; 188 virtual PP_Var GetPluginReferrerURL(PP_Instance instance, 189 PP_URLComponents_Dev* components) = 0; 190 #endif // !defined(OS_NACL) 191 192 static const ApiID kApiID = API_ID_PPB_INSTANCE; 193 }; 194 195 } // namespace thunk 196 } // namespace ppapi 197 198 #endif // PPAPI_THUNK_INSTANCE_API_H_ 199