PPAPI: implement GetSupportedPreviewSizes

ppapi/api/private/ppb_image_capture_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.
  */
 
 /**
  * Defines the <code>PPB_ImageCapture_Private</code> interface. Used for
  * acquiring a single still image from a camera source.
  */
 
 [generate_thunk]
 
 label Chrome {
-  M39 = 0.1
+  M42 = 0.1
 };
 
 /**
  * To query camera capabilities:
  * 1. Get a PPB_ImageCapture_Private object by Create().
  * 2. Open() camera device with track id of MediaStream video track.
  * 3. Call GetCameraCapabilities() to get a
  *    <code>PPB_CameraCapabilities_Private</code> object, which can be used to
  *    query camera capabilities.
  */
 interface PPB_ImageCapture_Private {
   /**
    * Creates a PPB_ImageCapture_Private resource.
    *
    * @param[in] instance A <code>PP_Instance</code> identifying one instance
    * of a module.
-   * @param[in] camera_source_id A <code>PP_Var</code> identifying a camera
-   * source. The type is string. The ID can be obtained from
-   * MediaStreamTrack.getSources() or MediaStreamVideoTrack.id. If a
-   * MediaStreamVideoTrack is associated with the same source and the track
-   * is closed, this PPB_ImageCapture_Private object can still do image capture.
-   * @param[in] error_callback A <code>PPB_ImageCapture_Private_ErrorCallback
-   * </code> callback to indicate the image capture has failed.
-   * @param[inout] user_data An opaque pointer that will be passed to the
-   * callbacks of PPB_ImageCapture_Private.
    *
    * @return A <code>PP_Resource</code> corresponding to a
    * PPB_ImageCapture_Private resource if successful, 0 if failed.
    */
-  PP_Resource Create([in] PP_Instance instance,
-                     [in] PP_Var camera_source_id,
-                     [inout] mem_t user_data);
+  PP_Resource Create([in] PP_Instance instance);
 
   /**
    * Determines if a resource is an image capture resource.
    *
    * @param[in] resource The <code>PP_Resource</code> to test.
    *
    * @return A <code>PP_Bool</code> with <code>PP_TRUE</code> if the given
    * resource is an image capture resource or <code>PP_FALSE</code>
    * otherwise.
    */
   PP_Bool IsImageCapture([in] PP_Resource resource);
 
   /**
+   * Opens a video capture device.
+   *
+   * @param[in] image_capture A <code>PP_Resource</code> corresponding to an
+   * image capture resource.
+   * @param[in] device_id A <code>PP_Var</code> identifying a camera device. The
+   * type is string. The ID can be obtained from MediaStreamTrack.getSources()
+   * or MediaStreamVideoTrack.id.
+   * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon
+   * completion of <code>Open()</code>.
+   *
+   * @return An error code from <code>pp_errors.h</code>.
+   */
+  int32_t Open(
+      [in] PP_Resource image_capture,
+      [in] PP_Var device_id,
+      [in] PP_CompletionCallback callback);
+
+  /**
    * Disconnects from the camera and cancels all pending capture requests.
    * After this returns, no callbacks will be called. If <code>
    * PPB_ImageCapture_Private</code> is destroyed and is not closed yet, this
    * function will be automatically called. Calling this more than once has no
    * effect.
    *
    * @param[in] image_capture A <code>PP_Resource</code> corresponding to an
    * image capture resource.
-   * @param[in] callback <code>PP_CompletionCallback</code> to be called upon
-   * completion of <code>Close()</code>.
-   *
-   * @return An int32_t containing a result code from <code>pp_errors.h</code>.
    */
-  int32_t Close([in] PP_Resource resource,
-                [in] PP_CompletionCallback callback);
+  void Close([in] PP_Resource image_capture);
 
   /**
    * Gets the camera capabilities.
    *
    * The camera capabilities do not change for a given camera source.
    *
    * @param[in] image_capture A <code>PP_Resource</code> corresponding to an
    * image capture resource.
    * @param[out] capabilities A <code>PPB_CameraCapabilities_Private</code> for
    * storing the image capture capabilities on success. Otherwise, the value
    * will not be changed.
    * @param[in] callback <code>PP_CompletionCallback</code> to be called upon
    * completion of <code>GetCameraCapabilities()</code>.
    *
    * @return An int32_t containing a result code from <code>pp_errors.h</code>.
    */
   int32_t GetCameraCapabilities([in] PP_Resource image_capture,
                                 [out] PP_Resource capabilities,
                                 [in] PP_CompletionCallback callback);
 };