| OLD | NEW |
| 1 /* Copyright (c) 2012 The Chromium Authors. All rights reserved. | 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 | 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 | 5 |
| 6 /* From ppb_graphics_3d.idl modified Thu Mar 28 10:12:11 2013. */ | 6 /* From ppb_graphics_3d.idl modified Thu Mar 28 10:12:11 2013. */ |
| 7 | 7 |
| 8 #ifndef PPAPI_C_PPB_GRAPHICS_3D_H_ | 8 #ifndef PPAPI_C_PPB_GRAPHICS_3D_H_ |
| 9 #define PPAPI_C_PPB_GRAPHICS_3D_H_ | 9 #define PPAPI_C_PPB_GRAPHICS_3D_H_ |
| 10 | 10 |
| (...skipping 19 matching lines...) Expand all Loading... |
| 30 | 30 |
| 31 /** | 31 /** |
| 32 * @addtogroup Interfaces | 32 * @addtogroup Interfaces |
| 33 * @{ | 33 * @{ |
| 34 */ | 34 */ |
| 35 /** | 35 /** |
| 36 * <code>PPB_Graphics3D</code> defines the interface for a 3D graphics context. | 36 * <code>PPB_Graphics3D</code> defines the interface for a 3D graphics context. |
| 37 * <strong>Example usage from plugin code:</strong> | 37 * <strong>Example usage from plugin code:</strong> |
| 38 * | 38 * |
| 39 * <strong>Setup:</strong> | 39 * <strong>Setup:</strong> |
| 40 * <code> | 40 * @code |
| 41 * PP_Resource context; | 41 * PP_Resource context; |
| 42 * int32_t attribs[] = {PP_GRAPHICS3DATTRIB_WIDTH, 800, | 42 * int32_t attribs[] = {PP_GRAPHICS3DATTRIB_WIDTH, 800, |
| 43 * PP_GRAPHICS3DATTRIB_HEIGHT, 800, | 43 * PP_GRAPHICS3DATTRIB_HEIGHT, 800, |
| 44 * PP_GRAPHICS3DATTRIB_NONE}; | 44 * PP_GRAPHICS3DATTRIB_NONE}; |
| 45 * context = g3d->Create(instance, attribs, &context); | 45 * context = g3d->Create(instance, attribs, &context); |
| 46 * inst->BindGraphics(instance, context); | 46 * inst->BindGraphics(instance, context); |
| 47 * </code> | 47 * @endcode |
| 48 * | 48 * |
| 49 * <strong>Present one frame:</strong> | 49 * <strong>Present one frame:</strong> |
| 50 * <code> | 50 * @code |
| 51 * gles2->Clear(context, GL_COLOR_BUFFER); | 51 * gles2->Clear(context, GL_COLOR_BUFFER); |
| 52 * g3d->SwapBuffers(context); | 52 * g3d->SwapBuffers(context); |
| 53 * </code> | 53 * @endcode |
| 54 * | 54 * |
| 55 * <strong>Shutdown:</strong> | 55 * <strong>Shutdown:</strong> |
| 56 * <code> | 56 * @code |
| 57 * core->ReleaseResource(context); | 57 * core->ReleaseResource(context); |
| 58 * </code> | 58 * @endcode |
| 59 */ | 59 */ |
| 60 struct PPB_Graphics3D_1_0 { | 60 struct PPB_Graphics3D_1_0 { |
| 61 /** | 61 /** |
| 62 * GetAttribMaxValue() retrieves the maximum supported value for the | 62 * GetAttribMaxValue() retrieves the maximum supported value for the |
| 63 * given attribute. This function may be used to check if a particular | 63 * given attribute. This function may be used to check if a particular |
| 64 * attribute value is supported before attempting to create a context. | 64 * attribute value is supported before attempting to create a context. |
| 65 * | 65 * |
| 66 * @param[in] instance The module instance. | 66 * @param[in] instance The module instance. |
| 67 * @param[in] attribute The attribute for which maximum value is queried. | 67 * @param[in] attribute The attribute for which maximum value is queried. |
| 68 * Attributes that can be queried for include: | 68 * Attributes that can be queried for include: |
| (...skipping 100 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 169 * structure for this function. All attributes specified in | 169 * structure for this function. All attributes specified in |
| 170 * <code>PPB_Graphics3D::Create</code> can be queried for. | 170 * <code>PPB_Graphics3D::Create</code> can be queried for. |
| 171 * | 171 * |
| 172 * @return Returns <code>PP_OK</code> on success or: | 172 * @return Returns <code>PP_OK</code> on success or: |
| 173 * - <code>PP_ERROR_BADRESOURCE</code> if context is invalid | 173 * - <code>PP_ERROR_BADRESOURCE</code> if context is invalid |
| 174 * - <code>PP_ERROR_BADARGUMENT</code> if attrib_list is 0 or any attribute | 174 * - <code>PP_ERROR_BADARGUMENT</code> if attrib_list is 0 or any attribute |
| 175 * in the <code>attrib_list</code> is not a valid attribute. | 175 * in the <code>attrib_list</code> is not a valid attribute. |
| 176 * | 176 * |
| 177 * <strong>Example usage:</strong> To get the values for rgb bits in the | 177 * <strong>Example usage:</strong> To get the values for rgb bits in the |
| 178 * color buffer, this function must be called as following: | 178 * color buffer, this function must be called as following: |
| 179 * <code> | 179 * @code |
| 180 * int attrib_list[] = {PP_GRAPHICS3DATTRIB_RED_SIZE, 0, | 180 * int attrib_list[] = {PP_GRAPHICS3DATTRIB_RED_SIZE, 0, |
| 181 * PP_GRAPHICS3DATTRIB_GREEN_SIZE, 0, | 181 * PP_GRAPHICS3DATTRIB_GREEN_SIZE, 0, |
| 182 * PP_GRAPHICS3DATTRIB_BLUE_SIZE, 0, | 182 * PP_GRAPHICS3DATTRIB_BLUE_SIZE, 0, |
| 183 * PP_GRAPHICS3DATTRIB_NONE}; | 183 * PP_GRAPHICS3DATTRIB_NONE}; |
| 184 * GetAttribs(context, attrib_list); | 184 * GetAttribs(context, attrib_list); |
| 185 * int red_bits = attrib_list[1]; | 185 * int red_bits = attrib_list[1]; |
| 186 * int green_bits = attrib_list[3]; | 186 * int green_bits = attrib_list[3]; |
| 187 * int blue_bits = attrib_list[5]; | 187 * int blue_bits = attrib_list[5]; |
| 188 * </code> | 188 * @endcode |
| 189 */ | 189 */ |
| 190 int32_t (*GetAttribs)(PP_Resource context, int32_t attrib_list[]); | 190 int32_t (*GetAttribs)(PP_Resource context, int32_t attrib_list[]); |
| 191 /** | 191 /** |
| 192 * SetAttribs() sets the values for each attribute in | 192 * SetAttribs() sets the values for each attribute in |
| 193 * <code>attrib_list</code>. | 193 * <code>attrib_list</code>. |
| 194 * | 194 * |
| 195 * @param[in] context The 3D graphics context. | 195 * @param[in] context The 3D graphics context. |
| 196 * @param[in] attrib_list The list of attributes whose values need to be set. | 196 * @param[in] attrib_list The list of attributes whose values need to be set. |
| 197 * <code>attrib_list</code> has the same structure as described for | 197 * <code>attrib_list</code> has the same structure as described for |
| 198 * <code>PPB_Graphics3D::Create</code>. | 198 * <code>PPB_Graphics3D::Create</code>. |
| (...skipping 87 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 286 struct PP_CompletionCallback callback); | 286 struct PP_CompletionCallback callback); |
| 287 }; | 287 }; |
| 288 | 288 |
| 289 typedef struct PPB_Graphics3D_1_0 PPB_Graphics3D; | 289 typedef struct PPB_Graphics3D_1_0 PPB_Graphics3D; |
| 290 /** | 290 /** |
| 291 * @} | 291 * @} |
| 292 */ | 292 */ |
| 293 | 293 |
| 294 #endif /* PPAPI_C_PPB_GRAPHICS_3D_H_ */ | 294 #endif /* PPAPI_C_PPB_GRAPHICS_3D_H_ */ |
| 295 | 295 |
| OLD | NEW |