OLD | NEW |
1 /* Copyright (c) 2010 The Chromium Authors. All rights reserved. | 1 /* Copyright (c) 2010 The Chromium Authors. All rights reserved. |
2 * Use of this source code is governed by a BSD-style license that can be | 2 * Use of this source code is governed by a BSD-style license that can be |
3 * found in the LICENSE file. | 3 * found in the LICENSE file. |
4 */ | 4 */ |
5 #ifndef PPAPI_C_DEV_PPB_TESTING_DEV_H_ | 5 #ifndef PPAPI_C_DEV_PPB_TESTING_DEV_H_ |
6 #define PPAPI_C_DEV_PPB_TESTING_DEV_H_ | 6 #define PPAPI_C_DEV_PPB_TESTING_DEV_H_ |
7 | 7 |
8 #include "ppapi/c/pp_bool.h" | 8 #include "ppapi/c/pp_bool.h" |
9 #include "ppapi/c/pp_instance.h" | 9 #include "ppapi/c/pp_instance.h" |
10 #include "ppapi/c/pp_resource.h" | 10 #include "ppapi/c/pp_resource.h" |
11 #include "ppapi/c/pp_stdint.h" | 11 #include "ppapi/c/pp_stdint.h" |
12 | 12 |
13 struct PP_Point; | 13 struct PP_Point; |
14 | 14 |
15 #define PPB_TESTING_DEV_INTERFACE "PPB_Testing(Dev);0.5" | 15 #define PPB_TESTING_DEV_INTERFACE "PPB_Testing(Dev);0.6" |
16 | 16 |
17 // This interface contains functions used for unit testing. Do not use in | 17 // This interface contains functions used for unit testing. Do not use in |
18 // production code. They are not guaranteed to be available in normal plugin | 18 // production code. They are not guaranteed to be available in normal plugin |
19 // environments so you should not depend on them. | 19 // environments so you should not depend on them. |
20 struct PPB_Testing_Dev { | 20 struct PPB_Testing_Dev { |
21 // Reads the bitmap data out of the backing store for the given | 21 // Reads the bitmap data out of the backing store for the given |
22 // DeviceContext2D and into the given image. If the data was successfully | 22 // DeviceContext2D and into the given image. If the data was successfully |
23 // read, it will return PP_TRUE. | 23 // read, it will return PP_TRUE. |
24 // | 24 // |
25 // This function should not generally be necessary for normal plugin | 25 // This function should not generally be necessary for normal plugin |
(...skipping 24 matching lines...) Expand all Loading... |
50 const struct PP_Point* top_left); | 50 const struct PP_Point* top_left); |
51 | 51 |
52 // Runs a nested message loop. The plugin will be reentered from this call. | 52 // Runs a nested message loop. The plugin will be reentered from this call. |
53 // This function is used for unit testing the API. The normal pattern is to | 53 // This function is used for unit testing the API. The normal pattern is to |
54 // issue some asynchronous call that has a callback. Then you call | 54 // issue some asynchronous call that has a callback. Then you call |
55 // RunMessageLoop which will suspend the plugin and go back to processing | 55 // RunMessageLoop which will suspend the plugin and go back to processing |
56 // messages, giving the asynchronous operation time to complete. In your | 56 // messages, giving the asynchronous operation time to complete. In your |
57 // callback, you save the data and call QuitMessageLoop, which will then | 57 // callback, you save the data and call QuitMessageLoop, which will then |
58 // pop back up and continue with the test. This avoids having to write a | 58 // pop back up and continue with the test. This avoids having to write a |
59 // complicated state machine for simple tests for asynchronous APIs. | 59 // complicated state machine for simple tests for asynchronous APIs. |
60 void (*RunMessageLoop)(); | 60 void (*RunMessageLoop)(PP_Instance instance); |
61 | 61 |
62 // Posts a quit message for the outermost nested message loop. Use this to | 62 // Posts a quit message for the outermost nested message loop. Use this to |
63 // exit and return back to the caller after you call RunMessageLoop. | 63 // exit and return back to the caller after you call RunMessageLoop. |
64 void (*QuitMessageLoop)(); | 64 void (*QuitMessageLoop)(PP_Instance instance); |
65 | 65 |
66 // Returns the number of live objects (resources + strings + objects) | 66 // Returns the number of live objects (resources + strings + objects) |
67 // associated with this plugin instance. Used for detecting leaks. Returns | 67 // associated with this plugin instance. Used for detecting leaks. Returns |
68 // (uint32_t)-1 on failure. | 68 // (uint32_t)-1 on failure. |
69 uint32_t (*GetLiveObjectsForInstance)(PP_Instance instance); | 69 uint32_t (*GetLiveObjectsForInstance)(PP_Instance instance); |
70 }; | 70 }; |
71 | 71 |
72 #endif /* PPAPI_C_DEV_PPB_TESTING_DEV_H_ */ | 72 #endif /* PPAPI_C_DEV_PPB_TESTING_DEV_H_ */ |
73 | 73 |
OLD | NEW |