shithub: libvpx

Download patch

ref: a7731ba488202ea62adfedf3fb49477cafe80b88
parent: c22a783bea8512a3413d9dd4abf82622cd89adcd
author: Angie Chiang <angiebird@google.com>
date: Fri Nov 13 14:40:13 EST 2020

Add doxygen for vpx_rc_config

Bug: webm:1707

Change-Id: I65bab6b2b792653e70cb136a5f9a21796e34b829

--- a/vpx/vpx_ext_ratectrl.h
+++ b/vpx/vpx_ext_ratectrl.h
@@ -221,16 +221,18 @@
   int num_frames;
 } vpx_rc_firstpass_stats_t;
 
-/*!\cond
-  TODO(angiebird): document these structures and fields to clear doxygen
-  warnings.*/
+/*!\brief Encode config sent to external rate control model
+ */
 typedef struct vpx_rc_config {
-  int frame_width;
-  int frame_height;
-  int show_frame_count;
+  int frame_width;      /**< frame width */
+  int frame_height;     /**< frame height */
+  int show_frame_count; /**< number of visible frames in the video */
+  /*!
+   * Target bitrate in kilobytes per second
+   */
   int target_bitrate_kbps;
-  int frame_rate_num;
-  int frame_rate_den;
+  int frame_rate_num; /**< numerator of frame rate */
+  int frame_rate_den; /**< denominator of frame rate */
 } vpx_rc_config_t;
 
 /*!\brief Create an external rate control model callback prototype
@@ -294,6 +296,10 @@
  */
 typedef vpx_rc_status_t (*vpx_rc_delete_model_cb_fn_t)(
     vpx_rc_model_t rate_ctrl_model);
+
+/*!\cond
+  TODO(angiebird): document these structures and fields to clear doxygen
+  warnings.*/
 
 typedef struct vpx_rc_funcs {
   vpx_rc_create_model_cb_fn_t create_model;