diff options
Diffstat (limited to 'vpx')
-rw-r--r-- | vpx/vp8.h | 5 | ||||
-rw-r--r-- | vpx/vp8cx.h | 30 | ||||
-rw-r--r-- | vpx/vp8dx.h | 27 |
3 files changed, 47 insertions, 15 deletions
@@ -36,7 +36,7 @@ * * The set of macros define the control functions of VP8 interface */ -enum vp8_dec_control_id +enum vp8_com_control_id { VP8_SET_REFERENCE = 1, /**< pass in an external frame into decoder to be used as reference frame */ VP8_COPY_REFERENCE = 2, /**< get a copy of reference frame from the decoder */ @@ -45,7 +45,8 @@ enum vp8_dec_control_id VP8_SET_DBG_COLOR_MB_MODES = 5, /**< set which macro block modes to color */ VP8_SET_DBG_COLOR_B_MODES = 6, /**< set which blocks modes to color */ VP8_SET_DBG_DISPLAY_MV = 7, /**< set which motion vector modes to draw */ - VP8_COMMON_CTRL_ID_MAX + VP8_COMMON_CTRL_ID_MAX, + VP8_DECODER_CTRL_ID_START = 256, }; /*!\brief post process flags diff --git a/vpx/vp8cx.h b/vpx/vp8cx.h index 5da4fe2b4..f024fcefc 100644 --- a/vpx/vp8cx.h +++ b/vpx/vp8cx.h @@ -24,13 +24,15 @@ #define VP8CX_H #include "vpx/vpx_codec_impl_top.h" -/*!\brief Algorithm interface for VP8 +/*!\name Algorithm interface for VP8 * * This interface provides the capability to encode raw VP8 streams, as would * be found in AVI files. + * @{ */ extern vpx_codec_iface_t vpx_codec_vp8_cx_algo; extern vpx_codec_iface_t* vpx_codec_vp8_cx(void); +/*!@} - end algorithm interface member group*/ #if CONFIG_EXPERIMENTAL @@ -124,7 +126,10 @@ extern vpx_codec_iface_t vpx_codec_vp8x_cx_algo; /*!\brief VP8 encoder control functions * - * The set of macros define the control functions of VP8 encoder interface + * This set of macros define the control functions available for the VP8 + * encoder interface. + * + * \sa #vpx_codec_control */ enum vp8e_enc_control_id { @@ -134,7 +139,18 @@ enum vp8e_enc_control_id VP8E_SET_ROI_MAP, /**< control function to pass an ROI map to encoder */ VP8E_SET_ACTIVEMAP, /**< control function to pass an Active map to encoder */ VP8E_SET_SCALEMODE = 11, /**< control function to set encoder scaling mode */ - VP8E_SET_CPUUSED = 13, /**< control function to set vp8 encoder cpuused */ + /*!\brief control function to set vp8 encoder cpuused + * + * Changes in this value influences, among others, the encoder's selection + * of motion estimation methods. Values greater than 0 will increase encoder + * speed at the expense of quality. + * The full set of adjustments can be found in + * onyx_if.c:vp8_set_speed_features(). + * \todo List highlights of the changes at various levels. + * + * \note Valid range: -16..16 or {-16..-4, 4..16} w/CONFIG_REALTIME_ONLY + */ + VP8E_SET_CPUUSED = 13, VP8E_SET_ENABLEAUTOALTREF, /**< control function to enable vp8 to automatic set and use altref frame */ VP8E_SET_NOISE_SENSITIVITY, /**< control function to set noise sensitivity */ VP8E_SET_SHARPNESS, /**< control function to set sharpness */ @@ -151,7 +167,13 @@ enum vp8e_enc_control_id VP8E_SET_ARNR_STRENGTH , /**< control function to set the filter strength for the arf */ VP8E_SET_ARNR_TYPE , /**< control function to set the type of filter to use for the arf*/ VP8E_SET_TUNING, /**< control function to set visual tuning */ - VP8E_SET_CQ_LEVEL, /**< control function to set constrained quality level */ + /*!\brief control function to set constrained quality level + * + * \attention For this value to be used vpx_codec_enc_cfg_t::g_usage must be + * set to #VPX_CQ. + * \note Valid range: 0..63 + */ + VP8E_SET_CQ_LEVEL, }; /*!\brief vpx 1-D scaling mode diff --git a/vpx/vp8dx.h b/vpx/vp8dx.h index a2a0dd178..4a3aef760 100644 --- a/vpx/vp8dx.h +++ b/vpx/vp8dx.h @@ -24,13 +24,15 @@ #define VP8DX_H #include "vpx/vpx_codec_impl_top.h" -/*!\brief Algorithm interface for VP8 +/*!\name Algorithm interface for VP8 * * This interface provides the capability to decode raw VP8 streams, as would * be found in AVI files and other non-Flash uses. + * @{ */ extern vpx_codec_iface_t vpx_codec_vp8_dx_algo; extern vpx_codec_iface_t* vpx_codec_vp8_dx(void); +/*!@} - end algorithm interface member group*/ /* Include controls common to both the encoder and decoder */ #include "vp8.h" @@ -38,21 +40,28 @@ extern vpx_codec_iface_t* vpx_codec_vp8_dx(void); /*!\brief VP8 decoder control functions * - * The set of macros define the control functions of VP8 decoder interface + * This set of macros define the control functions available for the VP8 + * decoder interface. + * + * \sa #vpx_codec_control */ -enum vp8d_dec_control_id +enum vp8_dec_control_id { - VP8_DECODER_CTRL_ID_START = 256, - VP8D_GET_LAST_REF_UPDATES, /**< control function to get info on which reference frames were updated - by the last decode */ - VP8D_GET_FRAME_CORRUPTED, /**< check if the indicated frame is corrupted */ + /** control function to get info on which reference frames were updated + * by the last decode + */ + VP8D_GET_LAST_REF_UPDATES = VP8_DECODER_CTRL_ID_START, + + /** check if the indicated frame is corrupted */ + VP8D_GET_FRAME_CORRUPTED, + VP8_DECODER_CTRL_ID_MAX } ; -/*!\brief VP8 encoder control function parameter type +/*!\brief VP8 decoder control function parameter type * - * Defines the data types that VP8E control functions take. Note that + * Defines the data types that VP8D control functions take. Note that * additional common controls are defined in vp8.h * */ |