xref: /aosp_15_r20/external/libvpx/vp9/common/vp9_onyxc_int.h (revision fb1b10ab9aebc7c7068eedab379b749d7e3900be)
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 
11 #ifndef VPX_VP9_COMMON_VP9_ONYXC_INT_H_
12 #define VPX_VP9_COMMON_VP9_ONYXC_INT_H_
13 
14 #include "./vpx_config.h"
15 #include "vpx/internal/vpx_codec_internal.h"
16 #include "./vp9_rtcd.h"
17 #include "vp9/common/vp9_alloccommon.h"
18 #include "vp9/common/vp9_loopfilter.h"
19 #include "vp9/common/vp9_entropymv.h"
20 #include "vp9/common/vp9_entropy.h"
21 #include "vp9/common/vp9_entropymode.h"
22 #include "vp9/common/vp9_frame_buffers.h"
23 #include "vp9/common/vp9_quant_common.h"
24 #include "vp9/common/vp9_tile_common.h"
25 
26 #if CONFIG_VP9_POSTPROC
27 #include "vp9/common/vp9_postproc.h"
28 #endif
29 
30 #ifdef __cplusplus
31 extern "C" {
32 #endif
33 
34 #define REFS_PER_FRAME 3
35 
36 #define REF_FRAMES_LOG2 3
37 #define REF_FRAMES (1 << REF_FRAMES_LOG2)
38 
39 // 1 scratch frame for the new frame, REFS_PER_FRAME for scaled references on
40 // the encoder.
41 #define FRAME_BUFFERS (REF_FRAMES + 1 + REFS_PER_FRAME)
42 
43 #define FRAME_CONTEXTS_LOG2 2
44 #define FRAME_CONTEXTS (1 << FRAME_CONTEXTS_LOG2)
45 
46 #define NUM_PING_PONG_BUFFERS 2
47 
48 extern const struct {
49   PARTITION_CONTEXT above;
50   PARTITION_CONTEXT left;
51 } partition_context_lookup[BLOCK_SIZES];
52 
53 typedef enum {
54   SINGLE_REFERENCE = 0,
55   COMPOUND_REFERENCE = 1,
56   REFERENCE_MODE_SELECT = 2,
57   REFERENCE_MODES = 3,
58 } REFERENCE_MODE;
59 
60 typedef struct {
61   int_mv mv[2];
62   MV_REFERENCE_FRAME ref_frame[2];
63 } MV_REF;
64 
65 typedef struct {
66   int ref_count;
67   MV_REF *mvs;
68   int mi_rows;
69   int mi_cols;
70   uint8_t released;
71 
72   // Note that frame_index/frame_coding_index are only set by set_frame_index()
73   // on the encoder side.
74 
75   // TODO(angiebird): Set frame_index/frame_coding_index on the decoder side
76   // properly.
77   int frame_index;         // Display order in the video, it's equivalent to the
78                            // show_idx defined in EncodeFrameInfo.
79   int frame_coding_index;  // The coding order (starting from zero) of this
80                            // frame.
81   vpx_codec_frame_buffer_t raw_frame_buffer;
82   YV12_BUFFER_CONFIG buf;
83 } RefCntBuffer;
84 
85 typedef struct BufferPool {
86   // Private data associated with the frame buffer callbacks.
87   void *cb_priv;
88 
89   vpx_get_frame_buffer_cb_fn_t get_fb_cb;
90   vpx_release_frame_buffer_cb_fn_t release_fb_cb;
91 
92   RefCntBuffer frame_bufs[FRAME_BUFFERS];
93 
94   // Frame buffers allocated internally by the codec.
95   InternalFrameBufferList int_frame_buffers;
96 } BufferPool;
97 
98 typedef struct VP9Common {
99   struct vpx_internal_error_info error;
100   vpx_color_space_t color_space;
101   vpx_color_range_t color_range;
102   int width;
103   int height;
104   int render_width;
105   int render_height;
106   int last_width;
107   int last_height;
108 
109   // TODO(jkoleszar): this implies chroma ss right now, but could vary per
110   // plane. Revisit as part of the future change to YV12_BUFFER_CONFIG to
111   // support additional planes.
112   int subsampling_x;
113   int subsampling_y;
114 
115 #if CONFIG_VP9_HIGHBITDEPTH
116   int use_highbitdepth;  // Marks if we need to use 16bit frame buffers.
117 #endif
118 
119   YV12_BUFFER_CONFIG *frame_to_show;
120   RefCntBuffer *prev_frame;
121 
122   // TODO(hkuang): Combine this with cur_buf in macroblockd.
123   RefCntBuffer *cur_frame;
124 
125   int ref_frame_map[REF_FRAMES]; /* maps fb_idx to reference slot */
126 
127   // Prepare ref_frame_map for the next frame.
128   // Only used in frame parallel decode.
129   int next_ref_frame_map[REF_FRAMES];
130 
131   // TODO(jkoleszar): could expand active_ref_idx to 4, with 0 as intra, and
132   // roll new_fb_idx into it.
133 
134   // Each frame can reference REFS_PER_FRAME buffers
135   RefBuffer frame_refs[REFS_PER_FRAME];
136 
137   int new_fb_idx;
138 
139   int cur_show_frame_fb_idx;
140 
141 #if CONFIG_VP9_POSTPROC
142   YV12_BUFFER_CONFIG post_proc_buffer;
143   YV12_BUFFER_CONFIG post_proc_buffer_int;
144 #endif
145 
146   FRAME_TYPE last_frame_type; /* last frame's frame type for motion search.*/
147   FRAME_TYPE frame_type;
148 
149   int show_frame;
150   int last_show_frame;
151   int show_existing_frame;
152 
153   // Flag signaling that the frame is encoded using only INTRA modes.
154   uint8_t intra_only;
155   uint8_t last_intra_only;
156 
157   int allow_high_precision_mv;
158 
159   // Flag signaling that the frame context should be reset to default values.
160   // 0 or 1 implies don't reset, 2 reset just the context specified in the
161   // frame header, 3 reset all contexts.
162   int reset_frame_context;
163 
164   // MBs, mb_rows/cols is in 16-pixel units; mi_rows/cols is in
165   // MODE_INFO (8-pixel) units.
166   int MBs;
167   int mb_rows, mi_rows;
168   int mb_cols, mi_cols;
169   int mi_stride;
170 
171   /* profile settings */
172   TX_MODE tx_mode;
173 
174   int base_qindex;
175   int y_dc_delta_q;
176   int uv_dc_delta_q;
177   int uv_ac_delta_q;
178   int16_t y_dequant[MAX_SEGMENTS][2];
179   int16_t uv_dequant[MAX_SEGMENTS][2];
180 
181   /* We allocate a MODE_INFO struct for each macroblock, together with
182      an extra row on top and column on the left to simplify prediction. */
183   int mi_alloc_size;
184   MODE_INFO *mip; /* Base of allocated array */
185   MODE_INFO *mi;  /* Corresponds to upper left visible macroblock */
186 
187   // TODO(agrange): Move prev_mi into encoder structure.
188   // prev_mip and prev_mi will only be allocated in VP9 encoder.
189   MODE_INFO *prev_mip; /* MODE_INFO array 'mip' from last decoded frame */
190   MODE_INFO *prev_mi;  /* 'mi' from last frame (points into prev_mip) */
191 
192   // Separate mi functions between encoder and decoder.
193   int (*alloc_mi)(struct VP9Common *cm, int mi_size);
194   void (*free_mi)(struct VP9Common *cm);
195   void (*setup_mi)(struct VP9Common *cm);
196 
197   // Grid of pointers to 8x8 MODE_INFO structs.  Any 8x8 not in the visible
198   // area will be NULL.
199   MODE_INFO **mi_grid_base;
200   MODE_INFO **mi_grid_visible;
201   MODE_INFO **prev_mi_grid_base;
202   MODE_INFO **prev_mi_grid_visible;
203 
204   // Whether to use previous frame's motion vectors for prediction.
205   int use_prev_frame_mvs;
206 
207   // Persistent mb segment id map used in prediction.
208   int seg_map_idx;
209   int prev_seg_map_idx;
210 
211   uint8_t *seg_map_array[NUM_PING_PONG_BUFFERS];
212   uint8_t *last_frame_seg_map;
213   uint8_t *current_frame_seg_map;
214   int seg_map_alloc_size;
215 
216   INTERP_FILTER interp_filter;
217 
218   loop_filter_info_n lf_info;
219 
220   int refresh_frame_context; /* Two state 0 = NO, 1 = YES */
221 
222   int ref_frame_sign_bias[MAX_REF_FRAMES]; /* Two state 0, 1 */
223 
224   struct loopfilter lf;
225   struct segmentation seg;
226 
227   // Context probabilities for reference frame prediction
228   MV_REFERENCE_FRAME comp_fixed_ref;
229   MV_REFERENCE_FRAME comp_var_ref[2];
230   REFERENCE_MODE reference_mode;
231 
232   FRAME_CONTEXT *fc;              /* this frame entropy */
233   FRAME_CONTEXT *frame_contexts;  // FRAME_CONTEXTS
234   unsigned int frame_context_idx; /* Context to use/update */
235   FRAME_COUNTS counts;
236 
237   // TODO(angiebird): current_video_frame/current_frame_coding_index into a
238   // structure
239   unsigned int current_video_frame;
240   // Each show or no show frame is assigned with a coding index based on its
241   // coding order (starting from zero).
242 
243   // Current frame's coding index.
244   int current_frame_coding_index;
245   BITSTREAM_PROFILE profile;
246 
247   // VPX_BITS_8 in profile 0 or 1, VPX_BITS_10 or VPX_BITS_12 in profile 2 or 3.
248   vpx_bit_depth_t bit_depth;
249   vpx_bit_depth_t dequant_bit_depth;  // bit_depth of current dequantizer
250 
251 #if CONFIG_VP9_POSTPROC
252   struct postproc_state postproc_state;
253 #endif
254 
255   int error_resilient_mode;
256   int frame_parallel_decoding_mode;
257 
258   int log2_tile_cols, log2_tile_rows;
259   int byte_alignment;
260   int skip_loop_filter;
261 
262   // External BufferPool passed from outside.
263   BufferPool *buffer_pool;
264 
265   PARTITION_CONTEXT *above_seg_context;
266   ENTROPY_CONTEXT *above_context;
267   int above_context_alloc_cols;
268 
269   int lf_row;
270 } VP9_COMMON;
271 
init_frame_indexes(VP9_COMMON * cm)272 static INLINE void init_frame_indexes(VP9_COMMON *cm) {
273   cm->current_video_frame = 0;
274   cm->current_frame_coding_index = 0;
275 }
276 
update_frame_indexes(VP9_COMMON * cm,int show_frame)277 static INLINE void update_frame_indexes(VP9_COMMON *cm, int show_frame) {
278   if (show_frame) {
279     // Don't increment frame counters if this was an altref buffer
280     // update not a real frame
281     ++cm->current_video_frame;
282   }
283   ++cm->current_frame_coding_index;
284 }
285 
286 typedef struct {
287   int frame_width;
288   int frame_height;
289   int render_frame_width;
290   int render_frame_height;
291   int mi_rows;
292   int mi_cols;
293   int mb_rows;
294   int mb_cols;
295   int num_mbs;
296   vpx_bit_depth_t bit_depth;
297 } FRAME_INFO;
298 
init_frame_info(FRAME_INFO * frame_info,const VP9_COMMON * cm)299 static INLINE void init_frame_info(FRAME_INFO *frame_info,
300                                    const VP9_COMMON *cm) {
301   frame_info->frame_width = cm->width;
302   frame_info->frame_height = cm->height;
303   frame_info->render_frame_width = cm->render_width;
304   frame_info->render_frame_height = cm->render_height;
305   frame_info->mi_cols = cm->mi_cols;
306   frame_info->mi_rows = cm->mi_rows;
307   frame_info->mb_cols = cm->mb_cols;
308   frame_info->mb_rows = cm->mb_rows;
309   frame_info->num_mbs = cm->MBs;
310   frame_info->bit_depth = cm->bit_depth;
311   // TODO(angiebird): Figure out how to get subsampling_x/y here
312 }
313 
get_buf_frame(VP9_COMMON * cm,int index)314 static INLINE YV12_BUFFER_CONFIG *get_buf_frame(VP9_COMMON *cm, int index) {
315   if (index < 0 || index >= FRAME_BUFFERS) return NULL;
316   if (cm->error.error_code != VPX_CODEC_OK) return NULL;
317   return &cm->buffer_pool->frame_bufs[index].buf;
318 }
319 
get_ref_frame(VP9_COMMON * cm,int index)320 static INLINE YV12_BUFFER_CONFIG *get_ref_frame(VP9_COMMON *cm, int index) {
321   if (index < 0 || index >= REF_FRAMES) return NULL;
322   if (cm->ref_frame_map[index] < 0) return NULL;
323   assert(cm->ref_frame_map[index] < FRAME_BUFFERS);
324   return &cm->buffer_pool->frame_bufs[cm->ref_frame_map[index]].buf;
325 }
326 
get_frame_new_buffer(VP9_COMMON * cm)327 static INLINE YV12_BUFFER_CONFIG *get_frame_new_buffer(VP9_COMMON *cm) {
328   return &cm->buffer_pool->frame_bufs[cm->new_fb_idx].buf;
329 }
330 
get_free_fb(VP9_COMMON * cm)331 static INLINE int get_free_fb(VP9_COMMON *cm) {
332   RefCntBuffer *const frame_bufs = cm->buffer_pool->frame_bufs;
333   int i;
334 
335   for (i = 0; i < FRAME_BUFFERS; ++i)
336     if (frame_bufs[i].ref_count == 0) break;
337 
338   if (i != FRAME_BUFFERS) {
339     frame_bufs[i].ref_count = 1;
340   } else {
341     // Reset i to be INVALID_IDX to indicate no free buffer found.
342     i = INVALID_IDX;
343   }
344 
345   return i;
346 }
347 
ref_cnt_fb(RefCntBuffer * bufs,int * idx,int new_idx)348 static INLINE void ref_cnt_fb(RefCntBuffer *bufs, int *idx, int new_idx) {
349   const int ref_index = *idx;
350 
351   if (ref_index >= 0 && bufs[ref_index].ref_count > 0)
352     bufs[ref_index].ref_count--;
353 
354   *idx = new_idx;
355 
356   bufs[new_idx].ref_count++;
357 }
358 
mi_cols_aligned_to_sb(int n_mis)359 static INLINE int mi_cols_aligned_to_sb(int n_mis) {
360   return ALIGN_POWER_OF_TWO(n_mis, MI_BLOCK_SIZE_LOG2);
361 }
362 
frame_is_intra_only(const VP9_COMMON * const cm)363 static INLINE int frame_is_intra_only(const VP9_COMMON *const cm) {
364   return cm->frame_type == KEY_FRAME || cm->intra_only;
365 }
366 
set_partition_probs(const VP9_COMMON * const cm,MACROBLOCKD * const xd)367 static INLINE void set_partition_probs(const VP9_COMMON *const cm,
368                                        MACROBLOCKD *const xd) {
369   xd->partition_probs =
370       frame_is_intra_only(cm)
371           ? &vp9_kf_partition_probs[0]
372           : (const vpx_prob(*)[PARTITION_TYPES - 1]) cm->fc->partition_prob;
373 }
374 
vp9_init_macroblockd(VP9_COMMON * cm,MACROBLOCKD * xd,tran_low_t * dqcoeff)375 static INLINE void vp9_init_macroblockd(VP9_COMMON *cm, MACROBLOCKD *xd,
376                                         tran_low_t *dqcoeff) {
377   int i;
378 
379   for (i = 0; i < MAX_MB_PLANE; ++i) {
380     xd->plane[i].dqcoeff = dqcoeff;
381     xd->above_context[i] =
382         cm->above_context +
383         i * sizeof(*cm->above_context) * 2 * mi_cols_aligned_to_sb(cm->mi_cols);
384 
385     if (get_plane_type(i) == PLANE_TYPE_Y) {
386       memcpy(xd->plane[i].seg_dequant, cm->y_dequant, sizeof(cm->y_dequant));
387     } else {
388       memcpy(xd->plane[i].seg_dequant, cm->uv_dequant, sizeof(cm->uv_dequant));
389     }
390     xd->fc = cm->fc;
391   }
392 
393   xd->above_seg_context = cm->above_seg_context;
394   xd->mi_stride = cm->mi_stride;
395   xd->error_info = &cm->error;
396 
397   set_partition_probs(cm, xd);
398 }
399 
get_partition_probs(const MACROBLOCKD * xd,int ctx)400 static INLINE const vpx_prob *get_partition_probs(const MACROBLOCKD *xd,
401                                                   int ctx) {
402   return xd->partition_probs[ctx];
403 }
404 
set_skip_context(MACROBLOCKD * xd,int mi_row,int mi_col)405 static INLINE void set_skip_context(MACROBLOCKD *xd, int mi_row, int mi_col) {
406   const int above_idx = mi_col * 2;
407   const int left_idx = (mi_row * 2) & 15;
408   int i;
409   for (i = 0; i < MAX_MB_PLANE; ++i) {
410     struct macroblockd_plane *const pd = &xd->plane[i];
411     pd->above_context = &xd->above_context[i][above_idx >> pd->subsampling_x];
412     pd->left_context = &xd->left_context[i][left_idx >> pd->subsampling_y];
413   }
414 }
415 
calc_mi_size(int len)416 static INLINE int calc_mi_size(int len) {
417   // len is in mi units.
418   return len + MI_BLOCK_SIZE;
419 }
420 
set_mi_row_col(MACROBLOCKD * xd,const TileInfo * const tile,int mi_row,int bh,int mi_col,int bw,int mi_rows,int mi_cols)421 static INLINE void set_mi_row_col(MACROBLOCKD *xd, const TileInfo *const tile,
422                                   int mi_row, int bh, int mi_col, int bw,
423                                   int mi_rows, int mi_cols) {
424   xd->mb_to_top_edge = -((mi_row * MI_SIZE) * 8);
425   xd->mb_to_bottom_edge = ((mi_rows - bh - mi_row) * MI_SIZE) * 8;
426   xd->mb_to_left_edge = -((mi_col * MI_SIZE) * 8);
427   xd->mb_to_right_edge = ((mi_cols - bw - mi_col) * MI_SIZE) * 8;
428 
429   // Are edges available for intra prediction?
430   xd->above_mi = (mi_row != 0) ? xd->mi[-xd->mi_stride] : NULL;
431   xd->left_mi = (mi_col > tile->mi_col_start) ? xd->mi[-1] : NULL;
432 }
433 
update_partition_context(MACROBLOCKD * xd,int mi_row,int mi_col,BLOCK_SIZE subsize,BLOCK_SIZE bsize)434 static INLINE void update_partition_context(MACROBLOCKD *xd, int mi_row,
435                                             int mi_col, BLOCK_SIZE subsize,
436                                             BLOCK_SIZE bsize) {
437   PARTITION_CONTEXT *const above_ctx = xd->above_seg_context + mi_col;
438   PARTITION_CONTEXT *const left_ctx = xd->left_seg_context + (mi_row & MI_MASK);
439 
440   // num_4x4_blocks_wide_lookup[bsize] / 2
441   const int bs = num_8x8_blocks_wide_lookup[bsize];
442 
443   // update the partition context at the end notes. set partition bits
444   // of block sizes larger than the current one to be one, and partition
445   // bits of smaller block sizes to be zero.
446   memset(above_ctx, partition_context_lookup[subsize].above, bs);
447   memset(left_ctx, partition_context_lookup[subsize].left, bs);
448 }
449 
partition_plane_context(const MACROBLOCKD * xd,int mi_row,int mi_col,BLOCK_SIZE bsize)450 static INLINE int partition_plane_context(const MACROBLOCKD *xd, int mi_row,
451                                           int mi_col, BLOCK_SIZE bsize) {
452   const PARTITION_CONTEXT *above_ctx = xd->above_seg_context + mi_col;
453   const PARTITION_CONTEXT *left_ctx = xd->left_seg_context + (mi_row & MI_MASK);
454   const int bsl = mi_width_log2_lookup[bsize];
455   int above = (*above_ctx >> bsl) & 1, left = (*left_ctx >> bsl) & 1;
456 
457   assert(b_width_log2_lookup[bsize] == b_height_log2_lookup[bsize]);
458   assert(bsl >= 0);
459 
460   return (left * 2 + above) + bsl * PARTITION_PLOFFSET;
461 }
462 
463 #ifdef __cplusplus
464 }  // extern "C"
465 #endif
466 
467 #endif  // VPX_VP9_COMMON_VP9_ONYXC_INT_H_
468