Pepper: add Image Capture interfaces.

ppapi/api/private/ppb_camera_capabilities_private.idl

+/* Copyright (c) 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</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);
+
+  /**
+   * GetSupportedJpegSize() returns the supported Jpeg sizes for the given

[Pawel Osciak, 2014/08/03 08:34:38]

Should this be Jpeg-specific? Does this have a corresponding camera API call?
Perhaps we should rather have a list of supported formats returned by the call? 

[Pawel Osciak, 2014/08/03 08:34:38]

s/Jpeg/JPEG/

[wuchengli, 2014/08/06 08:14:57]

This has a corresponding camera API call and should be Jpeg-specific. Also,
cameras may have different supported sizes for different output formats.

[wuchengli, 2014/08/06 08:14:57]

Replaced all Jpeg with JPEG.

+   * <code>PPB_CameraCapabilities</code>.
+   *
+   * @param[in] capabilities A <code>PP_Resource</code> corresponding to an
+   * image capture capabilities resource.
+   * @param[inout] array_size The size of Jpeg size array. If the output of this
+   * is 0, the camera has no support of generating Jpeg pictures.

[Pawel Osciak, 2014/08/03 08:34:38]

s/of/for/

[wuchengli, 2014/08/06 08:14:57]

Done.

+   * @param[out] jpeg_sizes An array of <code>PP_Size</code> corresonding to

[Pawel Osciak, 2014/08/03 08:34:38]

s/corresonding/corresponding/

[wuchengli, 2014/08/06 08:14:57]

Done.

+   * the supported Jpeg photo sizes in pixels of the camera.

[Pawel Osciak, 2014/08/03 08:34:38]

s/ of the camera//

I think we should stick to one of {picture, photo, image} in general in this
file and everywhere else.

[wuchengli, 2014/08/06 08:14:57]

Done.
Changed everything to image.

+   */
+  void GetSupportedJpegSizes(
+      [in] PP_Resource capabilities,
+      [inout] int32_t array_size,
+      [out] PP_Size[] jpeg_sizes);

[wuchengli, 2014/07/29 05:34:27]

dmichael@ When I ran generator.py, there was an error message -- TGenError:
'There is no default value for rtype  struct PP_Size*. Maybe you should provide
an on_failure attribute in the IDL file.'. Do you know why? Is adding on_failure
the right solution?

[dmichael (off chromium), 2014/07/29 23:07:05]

That doesn't seem right. We should not touch out-params in case of error. You
can probably add
[on_failure=NULL]
right before the method to shut up the IDL generator. If not, we may need to fix
it...

+};