ppapi/api/pp_codecs.idl

   1 /* Copyright (c) 2014 The Chromium Authors. All rights reserved.
   2  * Use of this source code is governed by a BSD-style license that can be
   3  * found in the LICENSE file.
   4  */
   5
   6 /**
   7  * Video profiles.
   8  */
   9 enum PP_VideoProfile {
  10   PP_VIDEOPROFILE_H264BASELINE = 0,
  11   PP_VIDEOPROFILE_H264MAIN = 1,
  12   PP_VIDEOPROFILE_H264EXTENDED = 2,
  13   PP_VIDEOPROFILE_H264HIGH = 3,
  14   PP_VIDEOPROFILE_H264HIGH10PROFILE = 4,
  15   PP_VIDEOPROFILE_H264HIGH422PROFILE = 5,
  16   PP_VIDEOPROFILE_H264HIGH444PREDICTIVEPROFILE = 6,
  17   PP_VIDEOPROFILE_H264SCALABLEBASELINE = 7,
  18   PP_VIDEOPROFILE_H264SCALABLEHIGH = 8,
  19   PP_VIDEOPROFILE_H264STEREOHIGH = 9,
  20   PP_VIDEOPROFILE_H264MULTIVIEWHIGH = 10,
  21   PP_VIDEOPROFILE_VP8_ANY = 11,
  22   PP_VIDEOPROFILE_VP9_ANY = 12,
  23   PP_VIDEOPROFILE_MAX = PP_VIDEOPROFILE_VP9_ANY
  24 };
  25
  26 /**
  27  * Hardware acceleration options.
  28  */
  29 enum PP_HardwareAcceleration {
  30   /** Create a hardware accelerated resource only. */
  31   PP_HARDWAREACCELERATION_ONLY = 0,
  32
  33   /**
  34    * Create a hardware accelerated resource if possible. Otherwise, fall back
  35    * to the software implementation.
  36    */
  37   PP_HARDWAREACCELERATION_WITHFALLBACK = 1,
  38
  39   /** Create the software implementation only. */
  40   PP_HARDWAREACCELERATION_NONE = 2,
  41
  42   PP_HARDWAREACCELERATION_LAST = PP_HARDWAREACCELERATION_NONE
  43 };
  44
  45 /**
  46  * Struct describing a decoded video picture. The decoded picture data is stored
  47  * in the GL texture corresponding to |texture_id|. The plugin can determine
  48  * which Decode call generated the picture using |decode_id|.
  49  */
  50 struct PP_VideoPicture {
  51   /**
  52    * |decode_id| parameter of the Decode call which generated this picture.
  53    * See the PPB_VideoDecoder function Decode() for more details.
  54    */
  55   uint32_t decode_id;
  56
  57   /**
  58    * Texture ID in the plugin's GL context. The plugin can use this to render
  59    * the decoded picture.
  60    */
  61   uint32_t texture_id;
  62
  63   /**
  64    * The GL texture target for the decoded picture. Possible values are:
  65    *   GL_TEXTURE_2D
  66    *   GL_TEXTURE_RECTANGLE_ARB
  67    *   GL_TEXTURE_EXTERNAL_OES
  68    *
  69    * The pixel format of the texture is GL_RGBA.
  70    */
  71   uint32_t texture_target;
  72
  73   /**
  74    * Dimensions of the texture holding the decoded picture.
  75    */
  76   PP_Size texture_size;
  77
  78   /**
  79    * The visible subrectangle of the picture. The plugin should display only
  80    * this part of the picture.
  81    */
  82   PP_Rect visible_rect;
  83 };
  84
  85 /**
  86  * Struct describing a decoded video picture. The decoded picture data is stored
  87  * in the GL texture corresponding to |texture_id|. The plugin can determine
  88  * which Decode call generated the picture using |decode_id|.
  89  */
  90 struct PP_VideoPicture_0_1 {
  91   /**
  92    * |decode_id| parameter of the Decode call which generated this picture.
  93    * See the PPB_VideoDecoder function Decode() for more details.
  94    */
  95   uint32_t decode_id;
  96
  97   /**
  98    * Texture ID in the plugin's GL context. The plugin can use this to render
  99    * the decoded picture.
 100    */
 101   uint32_t texture_id;
 102
 103   /**
 104    * The GL texture target for the decoded picture. Possible values are:
 105    *   GL_TEXTURE_2D
 106    *   GL_TEXTURE_RECTANGLE_ARB
 107    *   GL_TEXTURE_EXTERNAL_OES
 108    *
 109    * The pixel format of the texture is GL_RGBA.
 110    */
 111   uint32_t texture_target;
 112
 113   /**
 114    * Dimensions of the texture holding the decoded picture.
 115    */
 116   PP_Size texture_size;
 117 };
 118
 119 /**
 120  * Supported video profile information. See the PPB_VideoEncoder function
 121  * GetSupportedProfiles() for more details.
 122  */
 123 struct PP_VideoProfileDescription {
 124   /**
 125    * The codec profile.
 126    */
 127   PP_VideoProfile profile;
 128
 129   /**
 130    * Dimensions of the maximum resolution of video frames, in pixels.
 131    */
 132   PP_Size max_resolution;
 133
 134   /**
 135    * The numerator of the maximum frame rate.
 136    */
 137   uint32_t max_framerate_numerator;
 138
 139   /**
 140    * The denominator of the maximum frame rate.
 141    */
 142   uint32_t max_framerate_denominator;
 143
 144   /**
 145    * Whether the profile is hardware accelerated.
 146    */
 147   PP_Bool hardware_accelerated;
 148 };
 149
 150 /**
 151  * Supported video profile information. See the PPB_VideoEncoder function
 152  * GetSupportedProfiles() for more details.
 153  */
 154 struct PP_VideoProfileDescription_0_1 {
 155   /**
 156    * The codec profile.
 157    */
 158   PP_VideoProfile profile;
 159
 160   /**
 161    * Dimensions of the maximum resolution of video frames, in pixels.
 162    */
 163   PP_Size max_resolution;
 164
 165   /**
 166    * The numerator of the maximum frame rate.
 167    */
 168   uint32_t max_framerate_numerator;
 169
 170   /**
 171    * The denominator of the maximum frame rate.
 172    */
 173   uint32_t max_framerate_denominator;
 174
 175   /**
 176    * A value indicating if the profile is available in hardware, software, or
 177    * both.
 178    */
 179   PP_HardwareAcceleration acceleration;
 180 };
 181
 182 /**
 183  * Struct describing a bitstream buffer.
 184  */
 185 struct PP_BitstreamBuffer {
 186   /**
 187    * The size, in bytes, of the bitstream data.
 188    */
 189   uint32_t size;
 190
 191   /**
 192    * The base address of the bitstream data.
 193    */
 194   mem_t buffer;
 195
 196   /**
 197    * Whether the buffer represents a key frame.
 198    */
 199   PP_Bool key_frame;
 200 };