OLD | NEW |
| (Empty) |
1 // Copyright (c) 2011 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_C_DEV_PPB_GRAPHICS_3D_TRUSTED_DEV_H_ | |
6 #define PPAPI_C_DEV_PPB_GRAPHICS_3D_TRUSTED_DEV_H_ | |
7 | |
8 #include "ppapi/c/pp_bool.h" | |
9 #include "ppapi/c/pp_instance.h" | |
10 #include "ppapi/c/pp_resource.h" | |
11 #include "ppapi/c/pp_stdint.h" | |
12 | |
13 #define PPB_GRAPHICS_3D_TRUSTED_DEV_INTERFACE_0_1 \ | |
14 "PPB_Graphics3DTrusted(Dev);0.1" | |
15 #define PPB_GRAPHICS_3D_TRUSTED_DEV_INTERFACE \ | |
16 PPB_GRAPHICS_3D_TRUSTED_DEV_INTERFACE_0_1 | |
17 | |
18 typedef enum { | |
19 PPB_GRAPHICS3D_TRUSTED_ERROR_OK, | |
20 PPB_GRAPHICS3D_TRUSTED_ERROR_GENERICERROR, | |
21 PPB_GRAPHICS3D_TRUSTED_ERROR_INVALIDARGUMENTS, | |
22 PPB_GRAPHICS3D_TRUSTED_ERROR_INVALIDSIZE, | |
23 PPB_GRAPHICS3D_TRUSTED_ERROR_LOSTCONTEXT, | |
24 PPB_GRAPHICS3D_TRUSTED_ERROR_OUTOFBOUNDS, | |
25 PPB_GRAPHICS3D_TRUSTED_ERROR_UNKNOWNCOMMAND | |
26 } PPB_Graphics3DTrustedError; | |
27 | |
28 struct PP_Graphics3DTrustedState { | |
29 // Size of the command buffer in command buffer entries. | |
30 int32_t num_entries; | |
31 | |
32 // The offset (in entries) from which the reader is reading. | |
33 int32_t get_offset; | |
34 | |
35 // The offset (in entries) at which the writer is writing. | |
36 int32_t put_offset; | |
37 | |
38 // The current token value. This is used by the writer to defer | |
39 // changes to shared memory objects until the reader has reached a certain | |
40 // point in the command buffer. The reader is responsible for updating the | |
41 // token value, for example in response to an asynchronous set token command | |
42 // embedded in the command buffer. The default token value is zero. | |
43 int32_t token; | |
44 | |
45 // Error status. | |
46 PPB_Graphics3DTrustedError error; | |
47 | |
48 // Generation index of this state. The generation index is incremented every | |
49 // time a new state is retrieved from the command processor, so that | |
50 // consistency can be kept even if IPC messages are processed out-of-order. | |
51 uint32_t generation; | |
52 }; | |
53 | |
54 struct PPB_Graphics3DTrusted_Dev { | |
55 // Creates a raw Graphics3D resource. A raw Graphics3D is intended to be used | |
56 // with the trusted interface, through the command buffer (for proxying). | |
57 PP_Resource (*CreateRaw)(PP_Instance instance_id, | |
58 PP_Config3D_Dev config, | |
59 PP_Resource share_context, | |
60 const int32_t* attrib_list); | |
61 | |
62 // Initializes the command buffer with the given size. | |
63 PP_Bool (*InitCommandBuffer)(PP_Resource context_id, int32_t size); | |
64 | |
65 // Gets the ring buffer for the command buffer. | |
66 PP_Bool (*GetRingBuffer)(PP_Resource context_id, | |
67 int* shm_handle, | |
68 uint32_t* shm_size); | |
69 | |
70 // Returns the current state. | |
71 struct PP_Graphics3DTrustedState (*GetState)(PP_Resource context); | |
72 | |
73 // Create a transfer buffer and return a handle that uniquely | |
74 // identifies it or -1 on error. | |
75 int32_t (*CreateTransferBuffer)(PP_Resource context, uint32_t size); | |
76 | |
77 // Destroy a transfer buffer and recycle the handle. | |
78 PP_Bool (*DestroyTransferBuffer)(PP_Resource context, int32_t id); | |
79 | |
80 // Get the transfer buffer associated with a handle. | |
81 PP_Bool (*GetTransferBuffer)(PP_Resource context, | |
82 int32_t id, | |
83 int* shm_handle, | |
84 uint32_t* shm_size); | |
85 | |
86 // The writer calls this to update its put offset. | |
87 PP_Bool (*Flush)(PP_Resource context, int32_t put_offset); | |
88 | |
89 // The writer calls this to update its put offset. This function returns the | |
90 // reader's most recent get offset. Does not return until after the put offset | |
91 // change callback has been invoked. | |
92 struct PP_Graphics3DTrustedState (*FlushSync)(PP_Resource context, | |
93 int32_t put_offset); | |
94 | |
95 // Like FlushSync, but returns before processing commands if the get offset is | |
96 // different than last_known_get. Allows synchronization with the command | |
97 // processor without forcing immediate command execution. | |
98 struct PP_Graphics3DTrustedState (*FlushSyncFast)(PP_Resource context, | |
99 int32_t put_offset, | |
100 int32_t last_known_get); | |
101 }; | |
102 | |
103 #endif // PPAPI_C_DEV_PPB_GRAPHICS_3D_TRUSTED_DEV_H_ | |
104 | |
OLD | NEW |