You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
86 lines
2.9 KiB
86 lines
2.9 KiB
/* Copyright (c) 2012 The Chromium Authors. All rights reserved.
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
* found in the LICENSE file.
|
|
*/
|
|
|
|
/* From ppb_instance.idl modified Fri Dec 07 12:57:46 2012. */
|
|
|
|
#ifndef PPAPI_C_PPB_INSTANCE_H_
|
|
#define PPAPI_C_PPB_INSTANCE_H_
|
|
|
|
#include "pp_bool.h"
|
|
#include "pp_instance.h"
|
|
#include "pp_macros.h"
|
|
#include "pp_resource.h"
|
|
#include "pp_stdint.h"
|
|
|
|
#define PPB_INSTANCE_INTERFACE_1_0 "PPB_Instance;1.0"
|
|
#define PPB_INSTANCE_INTERFACE PPB_INSTANCE_INTERFACE_1_0
|
|
|
|
/**
|
|
* @file
|
|
* This file defines the <code>PPB_Instance</code> interface implemented by the
|
|
* browser and containing pointers to functions related to
|
|
* the module instance on a web page.
|
|
*/
|
|
|
|
|
|
/**
|
|
* @addtogroup Interfaces
|
|
* @{
|
|
*/
|
|
/**
|
|
* The PPB_Instance interface contains pointers to functions
|
|
* related to the module instance on a web page.
|
|
*/
|
|
struct PPB_Instance_1_0 {
|
|
/**
|
|
* BindGraphics() binds the given graphics as the current display surface.
|
|
* The contents of this device is what will be displayed in the instance's
|
|
* area on the web page. The device must be a 2D or a 3D device.
|
|
*
|
|
* You can pass a <code>NULL</code> resource as the device parameter to
|
|
* unbind all devices from the given instance. The instance will then appear
|
|
* transparent. Re-binding the same device will return <code>PP_TRUE</code>
|
|
* and will do nothing.
|
|
*
|
|
* Any previously-bound device will be released. It is an error to bind
|
|
* a device when it is already bound to another instance. If you want
|
|
* to move a device between instances, first unbind it from the old one, and
|
|
* then rebind it to the new one.
|
|
*
|
|
* Binding a device will invalidate that portion of the web page to flush the
|
|
* contents of the new device to the screen.
|
|
*
|
|
* @param[in] instance A PP_Instance identifying one instance of a module.
|
|
* @param[in] device A PP_Resource corresponding to a graphics device.
|
|
*
|
|
* @return <code>PP_Bool</code> containing <code>PP_TRUE</code> if bind was
|
|
* successful or <code>PP_FALSE</code> if the device was not the correct
|
|
* type. On success, a reference to the device will be held by the
|
|
* instance, so the caller can release its reference if it chooses.
|
|
*/
|
|
PP_Bool (*BindGraphics)(PP_Instance instance, PP_Resource device);
|
|
/**
|
|
* IsFullFrame() determines if the instance is full-frame. Such an instance
|
|
* represents the entire document in a frame rather than an embedded
|
|
* resource. This can happen if the user does a top-level navigation or the
|
|
* page specifies an iframe to a resource with a MIME type registered by the
|
|
* module.
|
|
*
|
|
* @param[in] instance A <code>PP_Instance</code> identifying one instance
|
|
* of a module.
|
|
*
|
|
* @return A <code>PP_Bool</code> containing <code>PP_TRUE</code> if the
|
|
* instance is full-frame.
|
|
*/
|
|
PP_Bool (*IsFullFrame)(PP_Instance instance);
|
|
};
|
|
|
|
typedef struct PPB_Instance_1_0 PPB_Instance;
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* PPAPI_C_PPB_INSTANCE_H_ */
|
|
|
|
|