1 files changed, 55 insertions, 0 deletions
diff --git a/ppapi/api/ppb_instance.idl b/ppapi/api/ppb_instance.idl
new file mode 100644
index 0000000..f237edb
--- /dev/null
+++ b/ppapi/api/ppb_instance.idl
@@ -0,0 +1,55 @@
+/* Copyright (c) 2011 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.
+ */
+
+/* This file defines the PPB_Instance interface implemented by the
+ * browser and containing pointers to functions related to
+ * the module instance on a web page.
+ */
+
+/* The PPB_Instance interface contains pointers to functions
+ * related to the module instance on a web page.
+ */
+interface PPB_Instance_0_5 {
+  /* BindGraphics is a pointer to a function that binds the given
+   * graphics as the current drawing surface. The
+   * contents of this device is what will be displayed in the plugin's area
+   * on the web page. The device must be a 2D or a 3D device.
+   *
+   * You can pass a NULL 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 PP_TRUE and will do
+   * nothing. Unbinding a device will drop any pending flush callbacks.
+   *
+   * Any previously-bound device will be Release()d. It is an error to bind
+   * a device when it is already bound to another plugin 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.
+   *
+   * Returns PP_Bool containing PP_TRUE if bind was successful or PP_FALSE if
+   * the device was not the correct type. On success, a reference to the
+   * device will be held by the plugin instance, so the caller can release
+   * its reference if it chooses.
+   */
+  PP_Bool BindGraphics(
+      /* A PP_Instance indentifying one instance of a module. */
+      [in] PP_Instance instance,
+      /* A PP_Resourse representing the graphics device. */
+      [in] PP_Resource device);
+
+  /* IsFullFrame is a pointer to a function that determines if the
+   * module instance is full-frame (repr). Such a module 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 plugin.
+   *
+   * Returns a PP_Bool containing PP_TRUE if the instance is full-frame.
+   */
+  PP_Bool IsFullFrame(
+      /* A PP_Instance indentifying one instance of a module. */
+      [in] PP_Instance instance);
+};