mpp/inc/rk_venc_ref.h

24  * MPP reference management system follows the model of H.264/H.265 reference
27  * The reference frame is defined into two type: long-term reference frame and
30  * The lt_ref can be only indexed by long-term reference frame index (lt_idx).
33  * MppEncRefMode defined the way for user to reference the required frame.
35  * Normal reference mode without argument
36  *  REF_TO_PREV_REF_FRM   - refer to previous reference frame in encode order (No matter Lt or St)
37  *  REF_TO_PREV_ST_REF    - refer to previous short-term reference frame
38  *  REF_TO_PREV_LT_REF    - refer to previous long-term reference frame
42  * Normal reference mode with argument
43  *  REF_TO_TEMPORAL_LAYER - refer to previous reference frame with temporal id argument
44  *  REF_TO_LT_REF_IDX     - refer to long-term reference frame with lt_ref_idx argument
45  *  REF_TO_ST_PREV_N_REF    - refer to short-term reference frame with diff frame_num argument
47  * Long-term reference only mode
48  *  REF_TO_ST_REF_SETUP   - use corresponding mode of original short-term reference frame
50  * Short-term reference only mode
53  * By combining frames with these modes user can define many kinds of reference hierarchy
57  * 1. When one frame is marked as long-term reference frame it will be kept in cpb until
59  * 2. When one frame is marked as short-term reference frame it will be inert into cpb when
61  *    reference frame excess the cpb size limit the oldest short-term frame will be removed.
67 /* max 4 long-term reference frame */
76  * 2. Long-term reference config (MppEncRefLtFrmCfg)
78  *    Setup long-term reference index max lt_idx, loop interval and reference
79  *    mode for auto long-term reference frame generation. The encoder will
80  *    mark frame to be long-term reference frame with given interval.
83  *    The long-term reference frame index is unique identifier for a long-term
84  *    reference frame.
85  *    The max long-term reference frame index should NOT larger than
89  *    When lt_gap is zero the long-term reference frame generation is disabled.
91  *    reference frame will be generated for error recovery or smart hierarchy.
94  *    The lt_delay is the delay time for generation of long-term reference frame.
97  *    2.4 ref_mode: Long-term refernce frame reference mode
98  *    NOTE: temporal id of longterm reference frame is always zero.
101  *    Sequence has only one lt_ref 0 and setup one long-term reference frame
112  *    Sequence has lt_ref from 0 to 2 and setup a long-term reference frame
133  * 3. Short-term reference config (MppEncStRefSetup)
136  *    The is_non_ref indicated the current frame is reference frame or not.
141  *    3.3 ref_mode: short-term refernce frame reference mode
144  *    The repeat time of the short-term reference frame configure.
167     /* with ref arg as long-term reference picture index */
169     /* with ref arg as short-term reference picture difference frame_num */
185     RK_S32              lt_idx;         /* lt_idx of the reference frame */
186     RK_S32              temporal_id;    /* temporal_id of the reference frame */
230  * A new reference configure will restart a new gop and clear cpb by default.
232  * reset all the reference frame in cpb.