Pepper VideoDecoder API definition.

ppapi/api/pp_media_codec.idl

Index: ppapi/api/pp_media_codec.idl
diff --git a/ppapi/api/pp_media_codec.idl b/ppapi/api/pp_media_codec.idl
new file mode 100644
index 0000000000000000000000000000000000000000..03587ff00b4637d28814aa532c13117fb8c0ffbc
--- /dev/null
+++ b/ppapi/api/pp_media_codec.idl
@@ -0,0 +1,56 @@
+/* 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.
+ */
+
+/**
+ * Video decoder profiles.
+ */
+enum PP_MediaCodec_Profile {
+  PP_MEDIACODEC_H264PROFILE_BASELINE = 0,
+  PP_MEDIACODEC_H264PROFILE_MAIN = 1,
+  PP_MEDIACODEC_H264PROFILE_EXTENDED = 2,
+  PP_MEDIACODEC_H264PROFILE_HIGH = 3,
+  PP_MEDIACODEC_H264PROFILE_HIGH10PROFILE = 4,
+  PP_MEDIACODEC_H264PROFILE_HIGH422PROFILE = 5,
+  PP_MEDIACODEC_H264PROFILE_HIGH444PREDICTIVEPROFILE = 6,
+  PP_MEDIACODEC_H264PROFILE_SCALABLEBASELINE = 7,
+  PP_MEDIACODEC_H264PROFILE_SCALABLEHIGH = 8,
+  PP_MEDIACODEC_H264PROFILE_STEREOHIGH = 9,
+  PP_MEDIACODEC_H264PROFILE_MULTIVIEWHIGH = 10,
+  PP_MEDIACODEC_VP8PROFILE_MAIN = 11,
+  PP_MEDIACODEC_VP9PROFILE_MAIN = 12,
+  PP_MEDIACODEC_PROFILE_MAX = PP_MEDIACODEC_VP9PROFILE_MAIN
+};
+
+/**
+ * Struct describing a decoded video picture. The decoded picture data from the
+ * bitstream buffer corresponding to |picture_id| is stored in the GL texture
+ * corresponding to |texture_id|.
+ */
+struct PP_MediaCodec_PictureBuffer {
+  /**
+   * Identifier of the last bitstream buffer which decoded into this picture.
+   * See the PPB_MediaCodecVideoDecoder function Decode() for more details.
+   */
+  int32_t picture_id;
+
+  /**
+   * Texture ID in the plugin's GL context. The plugin can use this to render

[igorc, 2014/04/11 22:13:18]

Could you elaborate on what plugin's GL context is? Is it the one used for
decoder init?

[bbudge, 2014/04/16 00:51:05]

Done.

+   * the decoded picture.
+   */
+  uint32_t texture_id;
+
+  /**
+   * The type of GL texture used to hold the decoded picture. The possible
+   * values are:
+   *   GL_TEXTURE_2D
+   *   GL_TEXTURE_RECTANGLE_ARB
+   */
+  uint32_t texture_target;

[igorc, 2014/04/11 22:13:18]

Could you also document or expose pixel format? Similarly to internal format in
http://www.opengl.org/sdk/docs/man2/xhtml/glCopyTexImage2D.xml

[bbudge, 2014/04/16 00:51:05]

Done.

+
+  /**
+   * Dimensions of the texture holding the decoded picture.
+   */
+  PP_Size texture_size;
+};