Pepper VideoDecoder API definition.

ppapi/api/pp_media_codec.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.
+ */
+
+/**
+ * Video profiles.
+ */
+enum PP_MediaCodec_VideoProfile {
+  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_VIDEOPROFILE_MAX = PP_MEDIACODEC_VP8PROFILE_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 |decode_id|.
+ */
+struct PP_MediaCodec_Picture {
+  /**
+   * |decode_id| parameter of the Decode call which generated this picture.
+   * See the PPB_MediaCodecVideoDecoder function Decode() for more details.
+   */
+  uint32_t decode_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_BGRA.

[Ami GONE FROM CHROMIUM, 2014/04/23 21:05:46]

Per IM convo, I don't believe this is guaranteed anywhere in writing, but I
suspect it is true in practice.  Definitely worth adding a test for it in your
impl CL if you want to promise it here.

(related: r230229)

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