granicus.if.org Git - libvpx/blob - vpx/vp8cx.h

   1 /*
   2  *  Copyright (c) 2010 The WebM project authors. All Rights Reserved.
   3  *
   4  *  Use of this source code is governed by a BSD-style license
   5  *  that can be found in the LICENSE file in the root of the source
   6  *  tree. An additional intellectual property rights grant can be found
   7  *  in the file PATENTS.  All contributing project authors may
   8  *  be found in the AUTHORS file in the root of the source tree.
   9  */
  10 #ifndef VPX_VP8CX_H_
  11 #define VPX_VP8CX_H_
  12
  13 /*!\defgroup vp8_encoder WebM VP8/VP9 Encoder
  14  * \ingroup vp8
  15  *
  16  * @{
  17  */
  18 #include "./vp8.h"
  19 #include "./vpx_encoder.h"
  20
  21 /*!\file
  22  * \brief Provides definitions for using VP8 or VP9 encoder algorithm within the
  23  *        vpx Codec Interface.
  24  */
  25
  26 #ifdef __cplusplus
  27 extern "C" {
  28 #endif
  29
  30 /*!\name Algorithm interface for VP8
  31  *
  32  * This interface provides the capability to encode raw VP8 streams.
  33  * @{
  34  */
  35 extern vpx_codec_iface_t  vpx_codec_vp8_cx_algo;
  36 extern vpx_codec_iface_t *vpx_codec_vp8_cx(void);
  37 /*!@} - end algorithm interface member group*/
  38
  39 /*!\name Algorithm interface for VP9
  40  *
  41  * This interface provides the capability to encode raw VP9 streams.
  42  * @{
  43  */
  44 extern vpx_codec_iface_t  vpx_codec_vp9_cx_algo;
  45 extern vpx_codec_iface_t *vpx_codec_vp9_cx(void);
  46 /*!@} - end algorithm interface member group*/
  47
  48
  49 /*
  50  * Algorithm Flags
  51  */
  52
  53 /*!\brief Don't reference the last frame
  54  *
  55  * When this flag is set, the encoder will not use the last frame as a
  56  * predictor. When not set, the encoder will choose whether to use the
  57  * last frame or not automatically.
  58  */
  59 #define VP8_EFLAG_NO_REF_LAST      (1<<16)
  60
  61
  62 /*!\brief Don't reference the golden frame
  63  *
  64  * When this flag is set, the encoder will not use the golden frame as a
  65  * predictor. When not set, the encoder will choose whether to use the
  66  * golden frame or not automatically.
  67  */
  68 #define VP8_EFLAG_NO_REF_GF        (1<<17)
  69
  70
  71 /*!\brief Don't reference the alternate reference frame
  72  *
  73  * When this flag is set, the encoder will not use the alt ref frame as a
  74  * predictor. When not set, the encoder will choose whether to use the
  75  * alt ref frame or not automatically.
  76  */
  77 #define VP8_EFLAG_NO_REF_ARF       (1<<21)
  78
  79
  80 /*!\brief Don't update the last frame
  81  *
  82  * When this flag is set, the encoder will not update the last frame with
  83  * the contents of the current frame.
  84  */
  85 #define VP8_EFLAG_NO_UPD_LAST      (1<<18)
  86
  87
  88 /*!\brief Don't update the golden frame
  89  *
  90  * When this flag is set, the encoder will not update the golden frame with
  91  * the contents of the current frame.
  92  */
  93 #define VP8_EFLAG_NO_UPD_GF        (1<<22)
  94
  95
  96 /*!\brief Don't update the alternate reference frame
  97  *
  98  * When this flag is set, the encoder will not update the alt ref frame with
  99  * the contents of the current frame.
 100  */
 101 #define VP8_EFLAG_NO_UPD_ARF       (1<<23)
 102
 103
 104 /*!\brief Force golden frame update
 105  *
 106  * When this flag is set, the encoder copy the contents of the current frame
 107  * to the golden frame buffer.
 108  */
 109 #define VP8_EFLAG_FORCE_GF         (1<<19)
 110
 111
 112 /*!\brief Force alternate reference frame update
 113  *
 114  * When this flag is set, the encoder copy the contents of the current frame
 115  * to the alternate reference frame buffer.
 116  */
 117 #define VP8_EFLAG_FORCE_ARF        (1<<24)
 118
 119
 120 /*!\brief Disable entropy update
 121  *
 122  * When this flag is set, the encoder will not update its internal entropy
 123  * model based on the entropy of this frame.
 124  */
 125 #define VP8_EFLAG_NO_UPD_ENTROPY   (1<<20)
 126
 127
 128 /*!\brief VPx encoder control functions
 129  *
 130  * This set of macros define the control functions available for VPx
 131  * encoder interface.
 132  *
 133  * \sa #vpx_codec_control
 134  */
 135 enum vp8e_enc_control_id {
 136   /*!\brief Codec control function to set mode of entropy update in encoder.
 137    *
 138    * Supported in codecs: VP8, VP9
 139    */
 140   VP8E_UPD_ENTROPY           = 5,
 141
 142   /*!\brief Codec control function to set reference update mode in encoder.
 143    *
 144    * Supported in codecs: VP8, VP9
 145    */
 146   VP8E_UPD_REFERENCE,
 147
 148   /*!\brief Codec control function to set which reference frame encoder can use.
 149    *
 150    * Supported in codecs: VP8, VP9
 151    */
 152   VP8E_USE_REFERENCE,
 153
 154   /*!\brief Codec control function to pass an ROI map to encoder.
 155    *
 156    * Supported in codecs: VP8, VP9
 157    */
 158   VP8E_SET_ROI_MAP,
 159
 160   /*!\brief Codec control function to pass an Active map to encoder.
 161    *
 162    * Supported in codecs: VP8, VP9
 163    */
 164   VP8E_SET_ACTIVEMAP,
 165
 166   /*!\brief Codec control function to set encoder scaling mode.
 167    *
 168    * Supported in codecs: VP8, VP9
 169    */
 170   VP8E_SET_SCALEMODE         = 11,
 171
 172   /*!\brief Codec control function to set encoder internal speed settings.
 173    *
 174    * Changes in this value influences, among others, the encoder's selection
 175    * of motion estimation methods. Values greater than 0 will increase encoder
 176    * speed at the expense of quality.
 177    *
 178    * \note Valid range for VP8: -16..16
 179    * \note Valid range for VP9: -8..8
 180    *
 181    * Supported in codecs: VP8, VP9
 182    */
 183   VP8E_SET_CPUUSED           = 13,
 184
 185   /*!\brief Codec control function to enable automatic set and use alf frames.
 186    *
 187    * Supported in codecs: VP8, VP9
 188    */
 189   VP8E_SET_ENABLEAUTOALTREF,
 190
 191   /*!\brief control function to set noise sensitivity
 192    *
 193    * 0: off, 1: OnYOnly, 2: OnYUV,
 194    * 3: OnYUVAggressive, 4: Adaptive
 195    *
 196    * Supported in codecs: VP8
 197    */
 198   VP8E_SET_NOISE_SENSITIVITY,
 199
 200   /*!\brief Codec control function to set sharpness.
 201    *
 202    * Supported in codecs: VP8, VP9
 203    */
 204   VP8E_SET_SHARPNESS,
 205
 206   /*!\brief Codec control function to set the threshold for MBs treated static.
 207    *
 208    * Supported in codecs: VP8, VP9
 209    */
 210   VP8E_SET_STATIC_THRESHOLD,
 211
 212   /*!\brief Codec control function to set the number of token partitions.
 213    *
 214    * Supported in codecs: VP8
 215    */
 216   VP8E_SET_TOKEN_PARTITIONS,
 217
 218   /*!\brief Codec control function to get last quantizer chosen by the encoder.
 219    *
 220    * Return value uses internal quantizer scale defined by the codec.
 221    *
 222    * Supported in codecs: VP8, VP9
 223    */
 224   VP8E_GET_LAST_QUANTIZER,
 225
 226   /*!\brief Codec control function to get last quantizer chosen by the encoder.
 227    *
 228    * Return value uses the 0..63 scale as used by the rc_*_quantizer config
 229    * parameters.
 230    *
 231    * Supported in codecs: VP8, VP9
 232    */
 233   VP8E_GET_LAST_QUANTIZER_64,
 234
 235   /*!\brief Codec control function to set the max no of frames to create arf.
 236    *
 237    * Supported in codecs: VP8, VP9
 238    */
 239   VP8E_SET_ARNR_MAXFRAMES,
 240
 241   /*!\brief Codec control function to set the filter strength for the arf.
 242    *
 243    * Supported in codecs: VP8, VP9
 244    */
 245   VP8E_SET_ARNR_STRENGTH,
 246
 247   /*!\deprecated control function to set the filter type to use for the arf. */
 248   VP8E_SET_ARNR_TYPE,
 249
 250   /*!\brief Codec control function to set visual tuning.
 251    *
 252    * Supported in codecs: VP8, VP9
 253    */
 254   VP8E_SET_TUNING,
 255
 256   /*!\brief Codec control function to set constrained quality level.
 257    *
 258    * \attention For this value to be used vpx_codec_enc_cfg_t::g_usage must be
 259    *            set to #VPX_CQ.
 260    * \note Valid range: 0..63
 261    *
 262    * Supported in codecs: VP8, VP9
 263    */
 264   VP8E_SET_CQ_LEVEL,
 265
 266   /*!\brief Codec control function to set Max data rate for Intra frames.
 267    *
 268    * This value controls additional clamping on the maximum size of a
 269    * keyframe. It is expressed as a percentage of the average
 270    * per-frame bitrate, with the special (and default) value 0 meaning
 271    * unlimited, or no additional clamping beyond the codec's built-in
 272    * algorithm.
 273    *
 274    * For example, to allocate no more than 4.5 frames worth of bitrate
 275    * to a keyframe, set this to 450.
 276    *
 277    * Supported in codecs: VP8, VP9
 278    */
 279   VP8E_SET_MAX_INTRA_BITRATE_PCT,
 280
 281   /*!\brief Codec control function to set reference and update frame flags.
 282    *
 283    *  Supported in codecs: VP8
 284    */
 285   VP8E_SET_FRAME_FLAGS,
 286
 287   /*!\brief Codec control function to set max data rate for Inter frames.
 288    *
 289    * This value controls additional clamping on the maximum size of an
 290    * inter frame. It is expressed as a percentage of the average
 291    * per-frame bitrate, with the special (and default) value 0 meaning
 292    * unlimited, or no additional clamping beyond the codec's built-in
 293    * algorithm.
 294    *
 295    * For example, to allow no more than 4.5 frames worth of bitrate
 296    * to an inter frame, set this to 450.
 297    *
 298    * Supported in codecs: VP9
 299    */
 300   VP9E_SET_MAX_INTER_BITRATE_PCT,
 301
 302   /*!\brief Boost percentage for Golden Frame in CBR mode.
 303    *
 304    * This value controls the amount of boost given to Golden Frame in
 305    * CBR mode. It is expressed as a percentage of the average
 306    * per-frame bitrate, with the special (and default) value 0 meaning
 307    * the feature is off, i.e., no golden frame boost in CBR mode and
 308    * average bitrate target is used.
 309    *
 310    * For example, to allow 100% more bits, i.e, 2X, in a golden frame
 311    * than average frame, set this to 100.
 312    *
 313    * Supported in codecs: VP9
 314    */
 315   VP9E_SET_GF_CBR_BOOST_PCT,
 316
 317   /*!\brief Codec control function to set the temporal layer id.
 318    *
 319    * For temporal scalability: this control allows the application to set the
 320    * layer id for each frame to be encoded. Note that this control must be set
 321    * for every frame prior to encoding. The usage of this control function
 322    * supersedes the internal temporal pattern counter, which is now deprecated.
 323    *
 324    * Supported in codecs: VP8
 325    */
 326   VP8E_SET_TEMPORAL_LAYER_ID,
 327
 328   /*!\brief Codec control function to set encoder screen content mode.
 329    *
 330    * 0: off, 1: On, 2: On with more aggressive rate control.
 331    *
 332    * Supported in codecs: VP8
 333    */
 334   VP8E_SET_SCREEN_CONTENT_MODE,
 335
 336   /*!\brief Codec control function to set lossless encoding mode.
 337    *
 338    * VP9 can operate in lossless encoding mode, in which the bitstream
 339    * produced will be able to decode and reconstruct a perfect copy of
 340    * input source. This control function provides a mean to switch encoder
 341    * into lossless coding mode(1) or normal coding mode(0) that may be lossy.
 342    *                          0 = lossy coding mode
 343    *                          1 = lossless coding mode
 344    *
 345    *  By default, encoder operates in normal coding mode (maybe lossy).
 346    *
 347    * Supported in codecs: VP9
 348    */
 349   VP9E_SET_LOSSLESS,
 350
 351   /*!\brief Codec control function to set number of tile columns.
 352    *
 353    * In encoding and decoding, VP9 allows an input image frame be partitioned
 354    * into separated vertical tile columns, which can be encoded or decoded
 355    * independently. This enables easy implementation of parallel encoding and
 356    * decoding. This control requests the encoder to use column tiles in
 357    * encoding an input frame, with number of tile columns (in Log2 unit) as
 358    * the parameter:
 359    *             0 = 1 tile column
 360    *             1 = 2 tile columns
 361    *             2 = 4 tile columns
 362    *             .....
 363    *             n = 2**n tile columns
 364    * The requested tile columns will be capped by encoder based on image size
 365    * limitation (The minimum width of a tile column is 256 pixel, the maximum
 366    * is 4096).
 367    *
 368    * By default, the value is 0, i.e. one single column tile for entire image.
 369    *
 370    * Supported in codecs: VP9
 371    */
 372   VP9E_SET_TILE_COLUMNS,
 373
 374   /*!\brief Codec control function to set number of tile rows.
 375    *
 376    * In encoding and decoding, VP9 allows an input image frame be partitioned
 377    * into separated horizontal tile rows. Tile rows are encoded or decoded
 378    * sequentially. Even though encoding/decoding of later tile rows depends on
 379    * earlier ones, this allows the encoder to output data packets for tile rows
 380    * prior to completely processing all tile rows in a frame, thereby reducing
 381    * the latency in processing between input and output. The parameter
 382    * for this control describes the number of tile rows, which has a valid
 383    * range [0, 2]:
 384    *            0 = 1 tile row
 385    *            1 = 2 tile rows
 386    *            2 = 4 tile rows
 387    *
 388    * By default, the value is 0, i.e. one single row tile for entire image.
 389    *
 390    * Supported in codecs: VP9
 391    */
 392   VP9E_SET_TILE_ROWS,
 393
 394   /*!\brief Codec control function to enable frame parallel decoding feature.
 395    *
 396    * VP9 has a bitstream feature to reduce decoding dependency between frames
 397    * by turning off backward update of probability context used in encoding
 398    * and decoding. This allows staged parallel processing of more than one
 399    * video frames in the decoder. This control function provides a mean to
 400    * turn this feature on or off for bitstreams produced by encoder.
 401    *
 402    * By default, this feature is off.
 403    *
 404    * Supported in codecs: VP9
 405    */
 406   VP9E_SET_FRAME_PARALLEL_DECODING,
 407
 408   /*!\brief Codec control function to set adaptive quantization mode.
 409    *
 410    * VP9 has a segment based feature that allows encoder to adaptively change
 411    * quantization parameter for each segment within a frame to improve the
 412    * subjective quality. This control makes encoder operate in one of the
 413    * several AQ_modes supported.
 414    *
 415    * By default, encoder operates with AQ_Mode 0(adaptive quantization off).
 416    *
 417    * Supported in codecs: VP9
 418    */
 419   VP9E_SET_AQ_MODE,
 420
 421   /*!\brief Codec control function to enable/disable periodic Q boost.
 422    *
 423    * One VP9 encoder speed feature is to enable quality boost by lowering
 424    * frame level Q periodically. This control function provides a mean to
 425    * turn on/off this feature.
 426    *               0 = off
 427    *               1 = on
 428    *
 429    * By default, the encoder is allowed to use this feature for appropriate
 430    * encoding modes.
 431    *
 432    * Supported in codecs: VP9
 433    */
 434   VP9E_SET_FRAME_PERIODIC_BOOST,
 435
 436   /*!\brief Codec control function to set noise sensitivity.
 437    *
 438    *  0: off, 1: On(YOnly)
 439    *
 440    * Supported in codecs: VP9
 441    */
 442   VP9E_SET_NOISE_SENSITIVITY,
 443
 444   /*!\brief Codec control function to turn on/off SVC in encoder.
 445    * \note Return value is VPX_CODEC_INVALID_PARAM if the encoder does not
 446    *       support SVC in its current encoding mode
 447    *  0: off, 1: on
 448    *
 449    * Supported in codecs: VP9
 450    */
 451   VP9E_SET_SVC,
 452
 453   /*!\brief Codec control function to set parameters for SVC.
 454    * \note Parameters contain min_q, max_q, scaling factor for each of the
 455    *       SVC layers.
 456    *
 457    * Supported in codecs: VP9
 458    */
 459   VP9E_SET_SVC_PARAMETERS,
 460
 461   /*!\brief Codec control function to set svc layer for spatial and temporal.
 462    * \note Valid ranges: 0..#vpx_codec_enc_cfg::ss_number_layers for spatial
 463    *                     layer and 0..#vpx_codec_enc_cfg::ts_number_layers for
 464    *                     temporal layer.
 465    *
 466    * Supported in codecs: VP9
 467    */
 468   VP9E_SET_SVC_LAYER_ID,
 469
 470   /*!\brief Codec control function to set content type.
 471    * \note Valid parameter range:
 472    *              VP9E_CONTENT_DEFAULT = Regular video content (Default)
 473    *              VP9E_CONTENT_SCREEN  = Screen capture content
 474    *
 475    * Supported in codecs: VP9
 476    */
 477   VP9E_SET_TUNE_CONTENT,
 478
 479   /*!\brief Codec control function to get svc layer ID.
 480    * \note The layer ID returned is for the data packet from the registered
 481    *       callback function.
 482    *
 483    * Supported in codecs: VP9
 484    */
 485   VP9E_GET_SVC_LAYER_ID,
 486
 487   /*!\brief Codec control function to register callback to get per layer packet.
 488    * \note Parameter for this control function is a structure with a callback
 489    *       function and a pointer to private data used by the callback.
 490    *
 491    * Supported in codecs: VP9
 492    */
 493   VP9E_REGISTER_CX_CALLBACK,
 494
 495   /*!\brief Codec control function to set color space info.
 496    * \note Valid ranges: 0..7, default is "UNKNOWN".
 497    *                     0 = UNKNOWN,
 498    *                     1 = BT_601
 499    *                     2 = BT_709
 500    *                     3 = SMPTE_170
 501    *                     4 = SMPTE_240
 502    *                     5 = BT_2020
 503    *                     6 = RESERVED
 504    *                     7 = SRGB
 505    *
 506    * Supported in codecs: VP9
 507    */
 508   VP9E_SET_COLOR_SPACE,
 509
 510   /*!\brief Codec control function to set temporal layering mode.
 511    * \note Valid ranges: 0..3, default is "0" (VP9E_TEMPORAL_LAYERING_MODE_NOLAYERING).
 512    *                     0 = VP9E_TEMPORAL_LAYERING_MODE_NOLAYERING
 513    *                     1 = VP9E_TEMPORAL_LAYERING_MODE_BYPASS
 514    *                     2 = VP9E_TEMPORAL_LAYERING_MODE_0101
 515    *                     3 = VP9E_TEMPORAL_LAYERING_MODE_0212
 516    *
 517    * Supported in codecs: VP9
 518    */
 519   VP9E_SET_TEMPORAL_LAYERING_MODE,
 520
 521   /*!\brief Codec control function to set minimum interval between GF/ARF frames
 522    *
 523    * By default the value is set as 4.
 524    *
 525    * Supported in codecs: VP9
 526    */
 527   VP9E_SET_MIN_GF_INTERVAL,
 528
 529   /*!\brief Codec control function to set minimum interval between GF/ARF frames
 530    *
 531    * By default the value is set as 16.
 532    *
 533    * Supported in codecs: VP9
 534    */
 535   VP9E_SET_MAX_GF_INTERVAL,
 536
 537   /*!\brief Codec control function to get an Active map back from the encoder.
 538    *
 539    * Supported in codecs: VP9
 540    */
 541   VP9E_GET_ACTIVEMAP,
 542 };
 543
 544 /*!\brief vpx 1-D scaling mode
 545  *
 546  * This set of constants define 1-D vpx scaling modes
 547  */
 548 typedef enum vpx_scaling_mode_1d {
 549   VP8E_NORMAL      = 0,
 550   VP8E_FOURFIVE    = 1,
 551   VP8E_THREEFIVE   = 2,
 552   VP8E_ONETWO      = 3
 553 } VPX_SCALING_MODE;
 554
 555 /*!\brief Temporal layering mode enum for VP9 SVC.
 556  *
 557  * This set of macros define the different temporal layering modes.
 558  * Supported codecs: VP9 (in SVC mode)
 559  *
 560  */
 561 typedef enum vp9e_temporal_layering_mode {
 562   /*!\brief No temporal layering.
 563    * Used when only spatial layering is used.
 564    */
 565   VP9E_TEMPORAL_LAYERING_MODE_NOLAYERING   = 0,
 566
 567   /*!\brief Bypass mode.
 568    * Used when application needs to control temporal layering.
 569    * This will only work when the number of spatial layers equals 1.
 570    */
 571   VP9E_TEMPORAL_LAYERING_MODE_BYPASS       = 1,
 572
 573   /*!\brief 0-1-0-1... temporal layering scheme with two temporal layers.
 574    */
 575   VP9E_TEMPORAL_LAYERING_MODE_0101         = 2,
 576
 577   /*!\brief 0-2-1-2... temporal layering scheme with three temporal layers.
 578    */
 579   VP9E_TEMPORAL_LAYERING_MODE_0212         = 3
 580 } VP9E_TEMPORAL_LAYERING_MODE;
 581
 582 /*!\brief  vpx region of interest map
 583  *
 584  * These defines the data structures for the region of interest map
 585  *
 586  */
 587
 588 typedef struct vpx_roi_map {
 589   /*! An id between 0 and 3 for each 16x16 region within a frame. */
 590   unsigned char *roi_map;
 591   unsigned int rows;       /**< Number of rows. */
 592   unsigned int cols;       /**< Number of columns. */
 593   // TODO(paulwilkins): broken for VP9 which has 8 segments
 594   // q and loop filter deltas for each segment
 595   // (see MAX_MB_SEGMENTS)
 596   int delta_q[4];          /**< Quantizer deltas. */
 597   int delta_lf[4];         /**< Loop filter deltas. */
 598   /*! Static breakout threshold for each segment. */
 599   unsigned int static_threshold[4];
 600 } vpx_roi_map_t;
 601
 602 /*!\brief  vpx active region map
 603  *
 604  * These defines the data structures for active region map
 605  *
 606  */
 607
 608
 609 typedef struct vpx_active_map {
 610   unsigned char  *active_map; /**< specify an on (1) or off (0) each 16x16 region within a frame */
 611   unsigned int    rows;       /**< number of rows */
 612   unsigned int    cols;       /**< number of cols */
 613 } vpx_active_map_t;
 614
 615 /*!\brief  vpx image scaling mode
 616  *
 617  * This defines the data structure for image scaling mode
 618  *
 619  */
 620 typedef struct vpx_scaling_mode {
 621   VPX_SCALING_MODE    h_scaling_mode;  /**< horizontal scaling mode */
 622   VPX_SCALING_MODE    v_scaling_mode;  /**< vertical scaling mode   */
 623 } vpx_scaling_mode_t;
 624
 625 /*!\brief VP8 token partition mode
 626  *
 627  * This defines VP8 partitioning mode for compressed data, i.e., the number of
 628  * sub-streams in the bitstream. Used for parallelized decoding.
 629  *
 630  */
 631
 632 typedef enum {
 633   VP8_ONE_TOKENPARTITION   = 0,
 634   VP8_TWO_TOKENPARTITION   = 1,
 635   VP8_FOUR_TOKENPARTITION  = 2,
 636   VP8_EIGHT_TOKENPARTITION = 3
 637 } vp8e_token_partitions;
 638
 639 /*!brief VP9 encoder content type */
 640 typedef enum {
 641   VP9E_CONTENT_DEFAULT,
 642   VP9E_CONTENT_SCREEN,
 643   VP9E_CONTENT_INVALID
 644 } vp9e_tune_content;
 645
 646 /*!\brief VP8 model tuning parameters
 647  *
 648  * Changes the encoder to tune for certain types of input material.
 649  *
 650  */
 651 typedef enum {
 652   VP8_TUNE_PSNR,
 653   VP8_TUNE_SSIM
 654 } vp8e_tuning;
 655
 656 /*!\brief  vp9 svc layer parameters
 657  *
 658  * This defines the spatial and temporal layer id numbers for svc encoding.
 659  * This is used with the #VP9E_SET_SVC_LAYER_ID control to set the spatial and
 660  * temporal layer id for the current frame.
 661  *
 662  */
 663 typedef struct vpx_svc_layer_id {
 664   int spatial_layer_id;       /**< Spatial layer id number. */
 665   int temporal_layer_id;      /**< Temporal layer id number. */
 666 } vpx_svc_layer_id_t;
 667
 668 /*!\brief VP8 encoder control function parameter type
 669  *
 670  * Defines the data types that VP8E control functions take. Note that
 671  * additional common controls are defined in vp8.h
 672  *
 673  */
 674
 675
 676 /* These controls have been deprecated in favor of the flags parameter to
 677  * vpx_codec_encode(). See the definition of VP8_EFLAG_* above.
 678  */
 679 VPX_CTRL_USE_TYPE_DEPRECATED(VP8E_UPD_ENTROPY,            int)
 680 VPX_CTRL_USE_TYPE_DEPRECATED(VP8E_UPD_REFERENCE,          int)
 681 VPX_CTRL_USE_TYPE_DEPRECATED(VP8E_USE_REFERENCE,          int)
 682
 683 VPX_CTRL_USE_TYPE(VP8E_SET_FRAME_FLAGS,        int)
 684 VPX_CTRL_USE_TYPE(VP8E_SET_TEMPORAL_LAYER_ID,  int)
 685 VPX_CTRL_USE_TYPE(VP8E_SET_ROI_MAP,            vpx_roi_map_t *)
 686 VPX_CTRL_USE_TYPE(VP8E_SET_ACTIVEMAP,          vpx_active_map_t *)
 687 VPX_CTRL_USE_TYPE(VP8E_SET_SCALEMODE,          vpx_scaling_mode_t *)
 688
 689 VPX_CTRL_USE_TYPE(VP9E_SET_SVC,                int)
 690 VPX_CTRL_USE_TYPE(VP9E_SET_SVC_PARAMETERS,     void *)
 691 VPX_CTRL_USE_TYPE(VP9E_REGISTER_CX_CALLBACK,   void *)
 692 VPX_CTRL_USE_TYPE(VP9E_SET_SVC_LAYER_ID,       vpx_svc_layer_id_t *)
 693
 694 VPX_CTRL_USE_TYPE(VP8E_SET_CPUUSED,            int)
 695 VPX_CTRL_USE_TYPE(VP8E_SET_ENABLEAUTOALTREF,   unsigned int)
 696 VPX_CTRL_USE_TYPE(VP8E_SET_NOISE_SENSITIVITY,  unsigned int)
 697 VPX_CTRL_USE_TYPE(VP8E_SET_SHARPNESS,          unsigned int)
 698 VPX_CTRL_USE_TYPE(VP8E_SET_STATIC_THRESHOLD,   unsigned int)
 699 VPX_CTRL_USE_TYPE(VP8E_SET_TOKEN_PARTITIONS,   int) /* vp8e_token_partitions */
 700
 701 VPX_CTRL_USE_TYPE(VP8E_SET_ARNR_MAXFRAMES,     unsigned int)
 702 VPX_CTRL_USE_TYPE(VP8E_SET_ARNR_STRENGTH,     unsigned int)
 703 VPX_CTRL_USE_TYPE_DEPRECATED(VP8E_SET_ARNR_TYPE,     unsigned int)
 704 VPX_CTRL_USE_TYPE(VP8E_SET_TUNING,             int) /* vp8e_tuning */
 705 VPX_CTRL_USE_TYPE(VP8E_SET_CQ_LEVEL,      unsigned int)
 706
 707 VPX_CTRL_USE_TYPE(VP9E_SET_TILE_COLUMNS,  int)
 708 VPX_CTRL_USE_TYPE(VP9E_SET_TILE_ROWS,  int)
 709
 710 VPX_CTRL_USE_TYPE(VP8E_GET_LAST_QUANTIZER,     int *)
 711 VPX_CTRL_USE_TYPE(VP8E_GET_LAST_QUANTIZER_64,  int *)
 712 VPX_CTRL_USE_TYPE(VP9E_GET_SVC_LAYER_ID,  vpx_svc_layer_id_t *)
 713
 714 VPX_CTRL_USE_TYPE(VP8E_SET_MAX_INTRA_BITRATE_PCT, unsigned int)
 715 VPX_CTRL_USE_TYPE(VP8E_SET_MAX_INTER_BITRATE_PCT, unsigned int)
 716
 717 VPX_CTRL_USE_TYPE(VP8E_SET_SCREEN_CONTENT_MODE, unsigned int)
 718
 719 VPX_CTRL_USE_TYPE(VP9E_SET_GF_CBR_BOOST_PCT, unsigned int)
 720
 721 VPX_CTRL_USE_TYPE(VP9E_SET_LOSSLESS, unsigned int)
 722
 723 VPX_CTRL_USE_TYPE(VP9E_SET_FRAME_PARALLEL_DECODING, unsigned int)
 724
 725 VPX_CTRL_USE_TYPE(VP9E_SET_AQ_MODE, unsigned int)
 726
 727 VPX_CTRL_USE_TYPE(VP9E_SET_FRAME_PERIODIC_BOOST, unsigned int)
 728
 729 VPX_CTRL_USE_TYPE(VP9E_SET_NOISE_SENSITIVITY,  unsigned int)
 730
 731 VPX_CTRL_USE_TYPE(VP9E_SET_TUNE_CONTENT, int) /* vp9e_tune_content */
 732
 733 VPX_CTRL_USE_TYPE(VP9E_SET_COLOR_SPACE, int)
 734
 735 VPX_CTRL_USE_TYPE(VP9E_SET_MIN_GF_INTERVAL,  unsigned int)
 736 #define VPX_CTRL_VP9E_SET_MIN_GF_INTERVAL
 737
 738 VPX_CTRL_USE_TYPE(VP9E_SET_MAX_GF_INTERVAL,  unsigned int)
 739 #define VPX_CTRL_VP9E_SET_MAX_GF_INTERVAL
 740
 741 VPX_CTRL_USE_TYPE(VP9E_GET_ACTIVEMAP, vpx_active_map_t *)
 742 /*! @} - end defgroup vp8_encoder */
 743 #ifdef __cplusplus
 744 }  // extern "C"
 745 #endif
 746
 747 #endif  // VPX_VP8CX_H_