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..b11169fcee05f4b1ab9ae10a7f47d926bf0c3e0f
--- /dev/null
+++ b/ppapi/api/pp_media_codec.idl
@@ -0,0 +1,57 @@
+/* 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 profiles.
+ */
+enum PP_MediaCodec_VideoProfile {

[igorc, 2014/04/21 23:12:48]

The enum here is video-specific, however the file name is generic. On the other
hand, ppb_media_codec_video_decoder.idl is video-specific... Just wanted to make
sure this inconsistency is intentional.

[bbudge, 2014/04/21 23:29:06]

It's a little speculative, but the file is intended to contain supporting
structs for video encoding and even audio codecs. That's why I call this
'VideoProfile' here - so we could have 'AudioProfile' as well.

+  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_VIDEOPROFILE_MAX = PP_MEDIACODEC_VP9PROFILE_MAIN
+};
+
+/**
+ * Struct describing a decoded video picture. The decoded picture data is stored
+ * in the GL texture corresponding to |texture_id|. The plugin can determine
+ * which Decode call generated the picture using |user_id|.
+ */
+struct PP_MediaCodec_Picture {
+  /**
+   * User id from the Decode call which generated this picture.
+   * See the PPB_MediaCodecVideoDecoder function Decode() for more details.
+   */
+  int32_t user_id;
+
+  /**
+   * Texture ID in the plugin's GL context. The plugin can use this to render
+   * the decoded picture.
+   */
+  uint32_t texture_id;
+
+  /**
+   * The GL texture target for the decoded picture. Possible values are:
+   *   GL_TEXTURE_2D                 (normalized texture coordinates)
+   *   GL_TEXTURE_RECTANGLE_ARB      (dimension dependent texture coordinates)
+   *
+   * The pixel format of the texture is GL_RGBA.
+   */
+  uint32_t texture_target;
+
+  /**
+   * Dimensions of the texture holding the decoded picture.
+   */
+  PP_Size texture_size;
+};