1 files changed, 99 insertions, 0 deletions
diff --git a/ppapi/c/ppb_image_data.h b/ppapi/c/ppb_image_data.h
new file mode 100644
index 0000000..905e694
--- /dev/null
+++ b/ppapi/c/ppb_image_data.h
@@ -0,0 +1,99 @@
+// Copyright (c) 2010 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.
+
+#ifndef PPAPI_C_PPB_IMAGE_DATA_H_
+#define PPAPI_C_PPB_IMAGE_DATA_H_
+
+#include "ppapi/c/pp_module.h"
+#include "ppapi/c/pp_resource.h"
+#include "ppapi/c/pp_size.h"
+#include "ppapi/c/pp_stdint.h"
+
+typedef enum {
+  PP_IMAGEDATAFORMAT_BGRA_PREMUL,
+  PP_IMAGEDATAFORMAT_RGBA_PREMUL
+} PP_ImageDataFormat;
+
+struct PP_ImageDataDesc {
+  PP_ImageDataFormat format;
+
+  // Size of the bitmap in pixels.
+  PP_Size size;
+
+  // The row width in bytes. This may be different than width * 4 since there
+  // may be padding at the end of the lines.
+  int32_t stride;
+};
+
+#define PPB_IMAGEDATA_INTERFACE "PPB_ImageData;0.1"
+
+/**
+ * @file
+ * Defines the API ...
+ *
+ * @addtogroup PPB
+ * @{
+ */
+
+struct PPB_ImageData {
+  /**
+   * Returns the browser's preferred format for image data. This format will be
+   * the format is uses internally for painting. Other formats may require
+   * internal conversions to paint or may have additional restrictions depending
+   * on the function.
+   */
+  PP_ImageDataFormat (*GetNativeImageDataFormat)();
+
+  /**
+   * Returns true if the given image data format is supported by the browser.
+   */
+  bool (*IsImageDataFormatSupported)(PP_ImageDataFormat format);
+
+  /**
+   * Allocates an image data resource with the given format and size. The
+   * return value will have a nonzero ID on success, or zero on failure.
+   * Failure means the module handle, image size, or format was invalid.
+   *
+   * Set the init_to_zero flag if you want the bitmap initialized to
+   * transparent during the creation process. If this flag is not set, the
+   * current contents of the bitmap will be undefined, and the plugin should
+   * be sure to set all the pixels.
+   *
+   * For security reasons, if uninitialized, the bitmap will not contain random
+   * memory, but may contain data from a previous image produced by the same
+   * plugin if the bitmap was cached and re-used.
+   */
+  PP_Resource (*Create)(PP_Module module,
+                        PP_ImageDataFormat format,
+                        const struct PP_Size* size,
+                        bool init_to_zero);
+
+  /**
+   * Returns true if the given resource is an image data. Returns false if the
+   * resource is invalid or some type other than an image data.
+   */
+  bool (*IsImageData)(PP_Resource image_data);
+
+  /**
+   * Computes the description of the image data. Returns true on success, false
+   * if the resource is not an image data. On false, the |desc| structure will
+   * be filled with 0.
+   */
+  bool (*Describe)(PP_Resource image_data,
+                   struct PP_ImageDataDesc* desc);
+
+  /**
+   * Maps this bitmap into the plugin address space and returns a pointer to the
+   * beginning of the data.
+   */
+  void* (*Map)(PP_Resource image_data);
+
+  void (*Unmap)(PP_Resource image_data);
+};
+
+/**
+ * @}
+ * End addtogroup PPB
+ */
+#endif  // PPAPI_C_PPB_IMAGE_DATA_H_