Pepper: Define PPB_VideoEncoder API.

ppapi/c/ppb_video_encoder.h

+/* Copyright (c) 2015 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.
+ */
+
+/* From ppb_video_encoder.idl modified Fri Jan  9 18:10:26 2015. */
+
+#ifndef PPAPI_C_PPB_VIDEO_ENCODER_H_
+#define PPAPI_C_PPB_VIDEO_ENCODER_H_
+
+#include "ppapi/c/pp_array_output.h"
+#include "ppapi/c/pp_bool.h"
+#include "ppapi/c/pp_codecs.h"
+#include "ppapi/c/pp_completion_callback.h"
+#include "ppapi/c/pp_instance.h"
+#include "ppapi/c/pp_macros.h"
+#include "ppapi/c/pp_resource.h"
+#include "ppapi/c/pp_size.h"
+#include "ppapi/c/pp_stdint.h"
+#include "ppapi/c/ppb_video_frame.h"
+
+#define PPB_VIDEOENCODER_INTERFACE_0_1 "PPB_VideoEncoder;0.1"
+#define PPB_VIDEOENCODER_INTERFACE PPB_VIDEOENCODER_INTERFACE_0_1
+
+/**
+ * @file
+ * This file defines the <code>PPB_VideoEncoder</code> interface.
+ */
+
+
+/**
+ * @addtogroup Interfaces
+ * @{
+ */
+/**
+ * Video encoder interface.
+ *
+ * Typical usage:
+ * - Call Create() to create a new video encoder resource.
+ * - Call GetSupportedFormats() to determine which codecs and profiles are
+ * - available.
+ * - Call Initialize() to initialize the encoder for a supported profile.
+ * - Call GetVideoFrame() to get a video frame resource, copy the frame into
+ * - its buffer, and call Encode() to push the video frame to the encoder. Do
+ * - this continuously, waiting for completion of each call.
+ * - Call GetBitstreamBuffer() continuously (waiting for each previous call to
+ *   complete) to pull encoded pictures from the encoder.
+ * - Call RecycleBitstreamBuffer() after consuming the data in the bitstream
+ * - buffer.
+ * - To destroy the decoder, the plugin should release all of its references to
+ *   it. Any pending callbacks will abort before the decoder is destroyed.
+ *
+ * Available video codecs vary by platform.
+ * All: theora, vorbis, vp8.
+ * Chrome and ChromeOS: aac, h264.
+ * ChromeOS: mpeg4.
+ */
+struct PPB_VideoEncoder_0_1 {
+  /**
+   * Creates a new video encoder resource.
+   *
+   * @param[in] instance A <code>PP_Instance</code> identifying the instance
+   * with the video encoder.
+   *
+   * @return A <code>PP_Resource</code> corresponding to a video encoder if
+   * successful or 0 otherwise.
+   */
+  PP_Resource (*Create)(PP_Instance instance);
+  /**
+   * Determines if the given resource is a video encoder.
+   *
+   * @param[in] resource A <code>PP_Resource</code> identifying a resource.
+   *
+   * @return <code>PP_TRUE</code> if the resource is a
+   * <code>PPB_VideoEncoder</code>, <code>PP_FALSE</code> if the resource is
+   * invalid or some other type.
+   */
+  PP_Bool (*IsVideoEncoder)(PP_Resource resource);
+  /**
+   * Gets an array of supported video encoder profiles.
+   * These can be used to choose profiles when calling Initialize().
+   *
+   * @param[in] video_encoder A <code>PP_Resource</code> identifying the video
+   * encoder.
+   * @param[in] output A <code>PP_ArrayOutput</code> to hold the supported
+   * <code>PP_SupportedVideoProfile</code> structs.
+   * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon
+   * completion of GetSupportedProfiles.
+   *
+   * @return If >= 0, the number of supported profiles returned, otherwise an
+   * error code from <code>pp_errors.h</code>.
+   */
+  int32_t (*GetSupportedProfiles)(PP_Resource video_encoder,
+                                  struct PP_ArrayOutput output,
+                                  struct PP_CompletionCallback callback);
+  /**
+   * Initializes a video encoder resource. This should be called after Create()
+   * and before any functions below.
+   *
+   * @param[in] video_encoder A <code>PP_Resource</code> identifying the video
+   * encoder.
+   * @param[in] input_format The <code>PP_VideoFrame_Format</code> of the
+   * frames which will be encoded.
+   * @param[in] input_visible_size A <code>PP_Size</code> specifying the
+   * dimensions of the visible part of the input frames.
+   * @param[in] output_profile A <code>PP_VideoProfile</code> specifying the
+   * codec profile of the encoded output stream.
+   * @param[in] acceleration A <code>PP_HardwareAcceleration</code> specifying
+   * whether to use a hardware accelerated or a software implementation.
+   * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon
+   * completion.
+   *
+   * @return An int32_t containing an error code from <code>pp_errors.h</code>.
+   * Returns PP_ERROR_NOTSUPPORTED if video encoding is not available, or the
+   * requested codec profile is not supported.
+   */
+  int32_t (*Initialize)(PP_Resource video_decoder,
+                        PP_VideoFrame_Format input_format,
+                        const struct PP_Size* input_visible_size,
+                        PP_VideoProfile output_profile,
+                        uint32_t initial_bitrate,
+                        PP_HardwareAcceleration acceleration,
+                        struct PP_CompletionCallback callback);
+  int32_t (*GetVideoFrame)(PP_Resource video_encoder,
+                           PP_Resource* video_frame,
+                           struct PP_CompletionCallback callback);
+  int32_t (*Encode)(PP_Resource video_encoder,
+                    PP_Resource video_frame,
+                    PP_Bool force_keyframe,
+                    struct PP_CompletionCallback callback);
+  int32_t (*GetBitstreamBuffer)(PP_Resource video_encoder,
+                                struct PP_BitstreamBuffer* bitstream_buffer,
+                                struct PP_CompletionCallback callback);
+  void (*RecycleBitstreamBuffer)(
+      PP_Resource video_decoder,
+      const struct PP_BitstreamBuffer* bitstream_buffer);
+  void (*RequestEncodingParametersChange)(PP_Resource video_decoder,
+                                          uint32_t bitrate,
+                                          uint32_t framerate);
+};
+
+typedef struct PPB_VideoEncoder_0_1 PPB_VideoEncoder;
+/**
+ * @}
+ */
+
+#endif  /* PPAPI_C_PPB_VIDEO_ENCODER_H_ */
+