Pepper: add Image Capture interfaces.

ppapi/api/private/ppb_camera_capabilities_private.idl

+/* Copyright 2014 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_CameraCapabilities_Private interface for
+ * establishing an image capture configuration resource within the browser.
+ */
+
+[generate_thunk]
+
+label Chrome {
+  M39 = 0.1
+};
+
+/**
+ * The <code>PPB_CameraCapabilities_Private</code> interface contains pointers
+ * to several functions for getting the image capture capabilities within the
+ * browser.
+ */
+[version=0.1]
+interface PPB_CameraCapabilities_Private {
+  /**
+   * Creates a PPB_CameraCapabilities_Private resource.
+   *
+   * @param[in] instance A <code>PP_Instance</code> identifying one instance of
+   * a module.
+   *
+   * @return A <code>PP_Resource</code> corresponding to a
+   * PPB_CameraCapabilities_Private resource if successful, 0 if failed.
+   */
+  PP_Resource Create([in] PP_Instance instance);
+

[Justin Chuang, 2014/08/14 03:23:46]

Paired Close()?

[wuchengli, 2014/08/14 03:44:47]

This is a plugin-side immutable object. No need to Close. Every pepper resource
needs a Create function.

+  /**
+   * IsCameraCapabilities() determines if the given resource is a
+   * <code>PPB_CameraCapabilities_Private</code>.
+   *
+   * @param[in] resource A <code>PP_Resource</code> corresponding to an image
+   * capture capabilities resource.
+   *
+   * @return A <code>PP_Bool</code> containing <code>PP_TRUE</code> if the given
+   * resource is an <code>PP_CameraCapabilities_Private</code> resource,
+   * otherwise <code>PP_FALSE</code>.
+   */
+  PP_Bool IsCameraCapabilities(
+      [in] PP_Resource resource);
+
+  /**
+   * GetSupportedPreviewSizes() returns the supported preview sizes for the
+   * given <code>PPB_CameraCapabilities_Private</code>.
+   *
+   * @param[in] capabilities A <code>PP_Resource</code> corresponding to an
+   * image capture capabilities resource.
+   * @param[out] array_size The size of preview size array.
+   * @param[out] A NULL-terminated array of pointer to <code>PP_Size</code>

[Justin Chuang, 2014/08/14 03:23:46]

Is it still NULL-terminated?

[wuchengli, 2014/08/14 03:44:47]

Oops. I forgot to update the comments. Done.

+   * corresponding to the supported preview sizes in pixels. The ownership of
+   * the array belongs to <code> PPB_CameraCapabilities_Private</code> and the
+   * caller should not free it. When a PPB_CameraCapabilities_Private is
+   * deleted, the array returning from this is no longer valid.
+   */
+  void GetSupportedPreviewSizes(
+      [in] PP_Resource capabilities,
+      [out] int32_t array_size,
+      [out, size_is(array_size)] PP_Size[] preview_sizes);
+
+  /**
+   * GetSupportedJpegSize() returns the supported JPEG sizes for the given
+   * <code>PPB_CameraCapabilities_Private</code>.
+   *
+   * @param[in] capabilities A <code>PP_Resource</code> corresponding to an
+   * image capture capabilities resource.
+   * @param[out] array_size The size of JPEG size array. If the output of this
+   * is 0, the camera has no support for generating JPEG images.
+   * @param[out] A NULL-terminated array of pointer to <code>PP_Size</code>

[Justin Chuang, 2014/08/14 03:23:46]

dittos

[wuchengli, 2014/08/14 03:44:47]

Done.

+   * corresponding to the supported JPEG image sizes in pixels. The ownership
+   * of the array belongs to <code>PPB_CameraCapabilities_Private</code> and
+   * the caller should not free it. When a PPB_CameraCapabilities_Private is
+   * deleted, the array returning from this is no longer valid.
+   */
+  void GetSupportedJpegSizes(
+      [in] PP_Resource capabilities,
+      [out] int32_t array_size,
+      [out, size_is(array_size)] PP_Size[] jpeg_sizes);
+};