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 {
+  /**
+   * 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] A NULL-terminated array of pointer to <code>PP_Size</code>
+   * 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] PP_Size[] preview_sizes);

[wuchengli, 2014/08/12 10:16:42]

As we discussed, [out] PP_Size[] (that is, PP_Size* preview_sizes[]) can be
used. I'll use it for this CL and add array_size back. I'll also upload another
CL to make IDL generator generate PP_Size**.

http://www.eskimo.com/~scs/cclass/notes/sx10f.html

[Justin Chuang, 2014/08/12 11:44:12]

Lesson learned. Generating double pointers can be more readable.
Besides, I think it's good enough to return NULL-terminated array.

+
+  /**
+   * 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] A NULL-terminated array of pointer to <code>PP_Size</code>
+   * 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] PP_Size[] jpeg_sizes);
+};