FFmpeg coverage


Directory: ../../../ffmpeg/
File: src/libavcodec/vaapi_av1.c
Date: 2026-05-02 03:33:10
Exec Total Coverage
Lines: 0 283 0.0%
Functions: 0 7 0.0%
Branches: 0 112 0.0%

Line Branch Exec Source
1 /*
2 * AV1 HW decode acceleration through VA API
3 *
4 * This file is part of FFmpeg.
5 *
6 * FFmpeg is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * FFmpeg is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with FFmpeg; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #include "libavutil/frame.h"
22 #include "libavutil/mem.h"
23 #include "hwaccel_internal.h"
24 #include "vaapi_decode.h"
25 #include "internal.h"
26 #include "av1dec.h"
27 #include "thread.h"
28
29 typedef struct VAAPIAV1FrameRef {
30 AVFrame *frame;
31 int valid;
32 } VAAPIAV1FrameRef;
33
34 typedef struct VAAPIAV1DecContext {
35 VAAPIDecodeContext base;
36
37 /**
38 * For film grain case, VAAPI generate 2 output for each frame,
39 * current_frame will not apply film grain, and will be used for
40 * references for next frames. Maintain the reference list without
41 * applying film grain here. And current_display_picture will be
42 * used to apply film grain and push to downstream.
43 */
44 VAAPIAV1FrameRef ref_tab[AV1_NUM_REF_FRAMES];
45 AVFrame *tmp_frame;
46
47 int nb_slice_params;
48 VASliceParameterBufferAV1 *slice_params;
49 } VAAPIAV1DecContext;
50
51 static VASurfaceID vaapi_av1_surface_id(AV1Frame *vf)
52 {
53 if (vf->f)
54 return ff_vaapi_get_surface_id(vf->f);
55 else
56 return VA_INVALID_SURFACE;
57 }
58
59 static int8_t vaapi_av1_get_bit_depth_idx(AVCodecContext *avctx)
60 {
61 AV1DecContext *s = avctx->priv_data;
62 const AV1RawSequenceHeader *seq = s->raw_seq;
63 int8_t bit_depth = 8;
64
65 if (seq->seq_profile == 2 && seq->color_config.high_bitdepth)
66 bit_depth = seq->color_config.twelve_bit ? 12 : 10;
67 else if (seq->seq_profile <= 2)
68 bit_depth = seq->color_config.high_bitdepth ? 10 : 8;
69 else {
70 av_log(avctx, AV_LOG_ERROR,
71 "Couldn't get bit depth from profile:%d.\n", seq->seq_profile);
72 return -1;
73 }
74 return bit_depth == 8 ? 0 : bit_depth == 10 ? 1 : 2;
75 }
76
77 static av_cold int vaapi_av1_decode_uninit(AVCodecContext *avctx)
78 {
79 VAAPIAV1DecContext *ctx = avctx->internal->hwaccel_priv_data;
80
81 av_frame_free(&ctx->tmp_frame);
82
83 for (int i = 0; i < FF_ARRAY_ELEMS(ctx->ref_tab); i++)
84 av_frame_free(&ctx->ref_tab[i].frame);
85
86 av_freep(&ctx->slice_params);
87
88 return ff_vaapi_decode_uninit(avctx);
89 }
90
91 static av_cold int vaapi_av1_decode_init(AVCodecContext *avctx)
92 {
93 VAAPIAV1DecContext *ctx = avctx->internal->hwaccel_priv_data;
94
95 int ret = ff_vaapi_decode_init(avctx);
96 if (ret < 0)
97 return ret;
98
99 ctx->tmp_frame = av_frame_alloc();
100 if (!ctx->tmp_frame) {
101 vaapi_av1_decode_uninit(avctx);
102 return AVERROR(ENOMEM);
103 }
104
105 for (int i = 0; i < FF_ARRAY_ELEMS(ctx->ref_tab); i++) {
106 ctx->ref_tab[i].frame = av_frame_alloc();
107 if (!ctx->ref_tab[i].frame) {
108 vaapi_av1_decode_uninit(avctx);
109 return AVERROR(ENOMEM);
110 }
111 ctx->ref_tab[i].valid = 0;
112 }
113
114 return ret;
115 }
116
117 static int vaapi_av1_start_frame(AVCodecContext *avctx,
118 av_unused const AVBufferRef *buffer_ref,
119 av_unused const uint8_t *buffer,
120 av_unused uint32_t size)
121 {
122 AV1DecContext *s = avctx->priv_data;
123 const AV1RawSequenceHeader *seq = s->raw_seq;
124 const AV1RawFrameHeader *frame_header = s->raw_frame_header;
125 const AV1RawFilmGrainParams *film_grain = &s->cur_frame.film_grain;
126 VAAPIDecodePicture *pic = s->cur_frame.hwaccel_picture_private;
127 VAAPIAV1DecContext *ctx = avctx->internal->hwaccel_priv_data;
128 VADecPictureParameterBufferAV1 pic_param;
129 int8_t bit_depth_idx;
130 int err = 0;
131 int apply_grain = !(avctx->export_side_data & AV_CODEC_EXPORT_DATA_FILM_GRAIN) && film_grain->apply_grain;
132 uint8_t remap_lr_type[4] = {AV1_RESTORE_NONE, AV1_RESTORE_SWITCHABLE, AV1_RESTORE_WIENER, AV1_RESTORE_SGRPROJ};
133 uint8_t segmentation_feature_signed[AV1_SEG_LVL_MAX] = {1, 1, 1, 1, 1, 0, 0, 0};
134 uint8_t segmentation_feature_max[AV1_SEG_LVL_MAX] = {255, AV1_MAX_LOOP_FILTER,
135 AV1_MAX_LOOP_FILTER, AV1_MAX_LOOP_FILTER, AV1_MAX_LOOP_FILTER, 7 , 0 , 0 };
136
137 bit_depth_idx = vaapi_av1_get_bit_depth_idx(avctx);
138 if (bit_depth_idx < 0)
139 goto fail;
140
141 if (apply_grain) {
142 if (ctx->tmp_frame->buf[0])
143 av_frame_unref(ctx->tmp_frame);
144 err = ff_thread_get_buffer(avctx, ctx->tmp_frame, AV_GET_BUFFER_FLAG_REF);
145 if (err < 0)
146 goto fail;
147 pic->output_surface = ff_vaapi_get_surface_id(ctx->tmp_frame);
148 } else {
149 pic->output_surface = ff_vaapi_get_surface_id(s->cur_frame.f);
150 }
151
152 memset(&pic_param, 0, sizeof(VADecPictureParameterBufferAV1));
153 pic_param = (VADecPictureParameterBufferAV1) {
154 .profile = seq->seq_profile,
155 .order_hint_bits_minus_1 = seq->order_hint_bits_minus_1,
156 .bit_depth_idx = bit_depth_idx,
157 .matrix_coefficients = seq->color_config.matrix_coefficients,
158 .current_frame = pic->output_surface,
159 .current_display_picture = ff_vaapi_get_surface_id(s->cur_frame.f),
160 .frame_width_minus1 = frame_header->frame_width_minus_1,
161 .frame_height_minus1 = frame_header->frame_height_minus_1,
162 .primary_ref_frame = frame_header->primary_ref_frame,
163 .order_hint = frame_header->order_hint,
164 .tile_cols = frame_header->tile_cols,
165 .tile_rows = frame_header->tile_rows,
166 .context_update_tile_id = frame_header->context_update_tile_id,
167 .superres_scale_denominator = frame_header->use_superres ?
168 frame_header->coded_denom + AV1_SUPERRES_DENOM_MIN :
169 AV1_SUPERRES_NUM,
170 .interp_filter = frame_header->interpolation_filter,
171 .filter_level[0] = frame_header->loop_filter_level[0],
172 .filter_level[1] = frame_header->loop_filter_level[1],
173 .filter_level_u = frame_header->loop_filter_level[2],
174 .filter_level_v = frame_header->loop_filter_level[3],
175 .base_qindex = frame_header->base_q_idx,
176 .y_dc_delta_q = frame_header->delta_q_y_dc,
177 .u_dc_delta_q = frame_header->delta_q_u_dc,
178 .u_ac_delta_q = frame_header->delta_q_u_ac,
179 .v_dc_delta_q = frame_header->delta_q_v_dc,
180 .v_ac_delta_q = frame_header->delta_q_v_ac,
181 .cdef_damping_minus_3 = frame_header->cdef_damping_minus_3,
182 .cdef_bits = frame_header->cdef_bits,
183 .seq_info_fields.fields = {
184 .still_picture = seq->still_picture,
185 .use_128x128_superblock = seq->use_128x128_superblock,
186 .enable_filter_intra = seq->enable_filter_intra,
187 .enable_intra_edge_filter = seq->enable_intra_edge_filter,
188 .enable_interintra_compound = seq->enable_interintra_compound,
189 .enable_masked_compound = seq->enable_masked_compound,
190 .enable_dual_filter = seq->enable_dual_filter,
191 .enable_order_hint = seq->enable_order_hint,
192 .enable_jnt_comp = seq->enable_jnt_comp,
193 .enable_cdef = seq->enable_cdef,
194 .mono_chrome = seq->color_config.mono_chrome,
195 .color_range = seq->color_config.color_range,
196 .subsampling_x = seq->color_config.subsampling_x,
197 .subsampling_y = seq->color_config.subsampling_y,
198 .chroma_sample_position = seq->color_config.chroma_sample_position,
199 .film_grain_params_present = seq->film_grain_params_present &&
200 !(avctx->export_side_data & AV_CODEC_EXPORT_DATA_FILM_GRAIN),
201 },
202 .seg_info.segment_info_fields.bits = {
203 .enabled = frame_header->segmentation_enabled,
204 .update_map = frame_header->segmentation_update_map,
205 .temporal_update = frame_header->segmentation_temporal_update,
206 .update_data = frame_header->segmentation_update_data,
207 },
208 .film_grain_info = {
209 .film_grain_info_fields.bits = {
210 .apply_grain = apply_grain,
211 .chroma_scaling_from_luma = film_grain->chroma_scaling_from_luma,
212 .grain_scaling_minus_8 = film_grain->grain_scaling_minus_8,
213 .ar_coeff_lag = film_grain->ar_coeff_lag,
214 .ar_coeff_shift_minus_6 = film_grain->ar_coeff_shift_minus_6,
215 .grain_scale_shift = film_grain->grain_scale_shift,
216 .overlap_flag = film_grain->overlap_flag,
217 .clip_to_restricted_range = film_grain->clip_to_restricted_range,
218 },
219 .grain_seed = film_grain->grain_seed,
220 .num_y_points = film_grain->num_y_points,
221 .num_cb_points = film_grain->num_cb_points,
222 .num_cr_points = film_grain->num_cr_points,
223 .cb_mult = film_grain->cb_mult,
224 .cb_luma_mult = film_grain->cb_luma_mult,
225 .cb_offset = film_grain->cb_offset,
226 .cr_mult = film_grain->cr_mult,
227 .cr_luma_mult = film_grain->cr_luma_mult,
228 .cr_offset = film_grain->cr_offset,
229 },
230 .pic_info_fields.bits = {
231 .frame_type = frame_header->frame_type,
232 .show_frame = frame_header->show_frame,
233 .showable_frame = frame_header->showable_frame,
234 .error_resilient_mode = frame_header->error_resilient_mode,
235 .disable_cdf_update = frame_header->disable_cdf_update,
236 .allow_screen_content_tools = frame_header->allow_screen_content_tools,
237 .force_integer_mv = s->cur_frame.force_integer_mv,
238 .allow_intrabc = frame_header->allow_intrabc,
239 .use_superres = frame_header->use_superres,
240 .allow_high_precision_mv = frame_header->allow_high_precision_mv,
241 .is_motion_mode_switchable = frame_header->is_motion_mode_switchable,
242 .use_ref_frame_mvs = frame_header->use_ref_frame_mvs,
243 .disable_frame_end_update_cdf = frame_header->disable_frame_end_update_cdf,
244 .uniform_tile_spacing_flag = frame_header->uniform_tile_spacing_flag,
245 .allow_warped_motion = frame_header->allow_warped_motion,
246 },
247 .loop_filter_info_fields.bits = {
248 .sharpness_level = frame_header->loop_filter_sharpness,
249 .mode_ref_delta_enabled = frame_header->loop_filter_delta_enabled,
250 .mode_ref_delta_update = frame_header->loop_filter_delta_update,
251 },
252 .mode_control_fields.bits = {
253 .delta_q_present_flag = frame_header->delta_q_present,
254 .log2_delta_q_res = frame_header->delta_q_res,
255 .delta_lf_present_flag = frame_header->delta_lf_present,
256 .log2_delta_lf_res = frame_header->delta_lf_res,
257 .delta_lf_multi = frame_header->delta_lf_multi,
258 .tx_mode = frame_header->tx_mode,
259 .reference_select = frame_header->reference_select,
260 .reduced_tx_set_used = frame_header->reduced_tx_set,
261 .skip_mode_present = frame_header->skip_mode_present,
262 },
263 .loop_restoration_fields.bits = {
264 .yframe_restoration_type = remap_lr_type[frame_header->lr_type[0]],
265 .cbframe_restoration_type = remap_lr_type[frame_header->lr_type[1]],
266 .crframe_restoration_type = remap_lr_type[frame_header->lr_type[2]],
267 .lr_unit_shift = frame_header->lr_unit_shift,
268 .lr_uv_shift = frame_header->lr_uv_shift,
269 },
270 .qmatrix_fields.bits = {
271 .using_qmatrix = frame_header->using_qmatrix,
272 .qm_y = frame_header->qm_y,
273 .qm_u = frame_header->qm_u,
274 .qm_v = frame_header->qm_v,
275 }
276 };
277
278 for (int i = 0; i < AV1_NUM_REF_FRAMES; i++) {
279 if (pic_param.pic_info_fields.bits.frame_type == AV1_FRAME_KEY && frame_header->show_frame)
280 pic_param.ref_frame_map[i] = VA_INVALID_ID;
281 else
282 pic_param.ref_frame_map[i] = ctx->ref_tab[i].valid ?
283 ff_vaapi_get_surface_id(ctx->ref_tab[i].frame) :
284 vaapi_av1_surface_id(&s->ref[i]);
285 }
286 for (int i = 0; i < AV1_REFS_PER_FRAME; i++) {
287 pic_param.ref_frame_idx[i] = frame_header->ref_frame_idx[i];
288 }
289 for (int i = 0; i < AV1_TOTAL_REFS_PER_FRAME; i++) {
290 pic_param.ref_deltas[i] = frame_header->loop_filter_ref_deltas[i];
291 }
292 for (int i = 0; i < 2; i++) {
293 pic_param.mode_deltas[i] = frame_header->loop_filter_mode_deltas[i];
294 }
295 for (int i = 0; i < (1 << frame_header->cdef_bits); i++) {
296 pic_param.cdef_y_strengths[i] =
297 (frame_header->cdef_y_pri_strength[i] << 2) +
298 frame_header->cdef_y_sec_strength[i];
299 pic_param.cdef_uv_strengths[i] =
300 (frame_header->cdef_uv_pri_strength[i] << 2) +
301 frame_header->cdef_uv_sec_strength[i];
302 }
303 for (int i = 0; i < frame_header->tile_cols; i++) {
304 pic_param.width_in_sbs_minus_1[i] =
305 frame_header->width_in_sbs_minus_1[i];
306 }
307 for (int i = 0; i < frame_header->tile_rows; i++) {
308 pic_param.height_in_sbs_minus_1[i] =
309 frame_header->height_in_sbs_minus_1[i];
310 }
311 for (int i = AV1_REF_FRAME_LAST; i <= AV1_REF_FRAME_ALTREF; i++) {
312 pic_param.wm[i - 1].invalid = s->cur_frame.gm_invalid[i];
313 pic_param.wm[i - 1].wmtype = s->cur_frame.gm_type[i];
314 for (int j = 0; j < 6; j++)
315 pic_param.wm[i - 1].wmmat[j] = s->cur_frame.gm_params[i][j];
316 }
317 for (int i = 0; i < AV1_MAX_SEGMENTS; i++) {
318 for (int j = 0; j < AV1_SEG_LVL_MAX; j++) {
319 pic_param.seg_info.feature_mask[i] |= (frame_header->feature_enabled[i][j] << j);
320 if (segmentation_feature_signed[j])
321 pic_param.seg_info.feature_data[i][j] = av_clip(frame_header->feature_value[i][j],
322 -segmentation_feature_max[j], segmentation_feature_max[j]);
323 else
324 pic_param.seg_info.feature_data[i][j] = av_clip(frame_header->feature_value[i][j],
325 0, segmentation_feature_max[j]);
326 }
327 }
328 if (apply_grain) {
329 for (int i = 0; i < film_grain->num_y_points; i++) {
330 pic_param.film_grain_info.point_y_value[i] =
331 film_grain->point_y_value[i];
332 pic_param.film_grain_info.point_y_scaling[i] =
333 film_grain->point_y_scaling[i];
334 }
335 for (int i = 0; i < film_grain->num_cb_points; i++) {
336 pic_param.film_grain_info.point_cb_value[i] =
337 film_grain->point_cb_value[i];
338 pic_param.film_grain_info.point_cb_scaling[i] =
339 film_grain->point_cb_scaling[i];
340 }
341 for (int i = 0; i < film_grain->num_cr_points; i++) {
342 pic_param.film_grain_info.point_cr_value[i] =
343 film_grain->point_cr_value[i];
344 pic_param.film_grain_info.point_cr_scaling[i] =
345 film_grain->point_cr_scaling[i];
346 }
347 for (int i = 0; i < 24; i++) {
348 pic_param.film_grain_info.ar_coeffs_y[i] =
349 film_grain->ar_coeffs_y_plus_128[i] - 128;
350 }
351 for (int i = 0; i < 25; i++) {
352 pic_param.film_grain_info.ar_coeffs_cb[i] =
353 film_grain->ar_coeffs_cb_plus_128[i] - 128;
354 pic_param.film_grain_info.ar_coeffs_cr[i] =
355 film_grain->ar_coeffs_cr_plus_128[i] - 128;
356 }
357 }
358 err = ff_vaapi_decode_make_param_buffer(avctx, pic,
359 VAPictureParameterBufferType,
360 &pic_param, sizeof(pic_param));
361 if (err < 0)
362 goto fail;
363
364 return 0;
365
366 fail:
367 ff_vaapi_decode_cancel(avctx, pic);
368 return err;
369 }
370
371 static int vaapi_av1_end_frame(AVCodecContext *avctx)
372 {
373 const AV1DecContext *s = avctx->priv_data;
374 const AV1RawFrameHeader *header = s->raw_frame_header;
375 const AV1RawFilmGrainParams *film_grain = &s->cur_frame.film_grain;
376 VAAPIDecodePicture *pic = s->cur_frame.hwaccel_picture_private;
377 VAAPIAV1DecContext *ctx = avctx->internal->hwaccel_priv_data;
378
379 int apply_grain = !(avctx->export_side_data & AV_CODEC_EXPORT_DATA_FILM_GRAIN) && film_grain->apply_grain;
380 int ret;
381 ret = ff_vaapi_decode_issue(avctx, pic);
382 if (ret < 0)
383 return ret;
384
385 for (int i = 0; i < AV1_NUM_REF_FRAMES; i++) {
386 if (header->refresh_frame_flags & (1 << i)) {
387 if (ctx->ref_tab[i].frame->buf[0])
388 av_frame_unref(ctx->ref_tab[i].frame);
389
390 if (apply_grain) {
391 ret = av_frame_ref(ctx->ref_tab[i].frame, ctx->tmp_frame);
392 if (ret < 0)
393 return ret;
394 ctx->ref_tab[i].valid = 1;
395 } else {
396 ctx->ref_tab[i].valid = 0;
397 }
398 }
399 }
400
401 return 0;
402 }
403
404 static int vaapi_av1_decode_slice(AVCodecContext *avctx,
405 const uint8_t *buffer,
406 uint32_t size)
407 {
408 const AV1DecContext *s = avctx->priv_data;
409 VAAPIDecodePicture *pic = s->cur_frame.hwaccel_picture_private;
410 VAAPIAV1DecContext *ctx = avctx->internal->hwaccel_priv_data;
411 int err, nb_params;
412
413 nb_params = s->tg_end - s->tg_start + 1;
414 if (ctx->nb_slice_params < nb_params) {
415 VASliceParameterBufferAV1 *tmp = av_realloc_array(ctx->slice_params,
416 nb_params,
417 sizeof(*ctx->slice_params));
418 if (!tmp) {
419 ctx->nb_slice_params = 0;
420 err = AVERROR(ENOMEM);
421 goto fail;
422 }
423 ctx->slice_params = tmp;
424 ctx->nb_slice_params = nb_params;
425 }
426
427 for (int i = s->tg_start; i <= s->tg_end; i++) {
428 ctx->slice_params[i - s->tg_start] = (VASliceParameterBufferAV1) {
429 .slice_data_size = s->tile_group_info[i].tile_size,
430 .slice_data_offset = s->tile_group_info[i].tile_offset,
431 .slice_data_flag = VA_SLICE_DATA_FLAG_ALL,
432 .tile_row = s->tile_group_info[i].tile_row,
433 .tile_column = s->tile_group_info[i].tile_column,
434 .tg_start = s->tg_start,
435 .tg_end = s->tg_end,
436 };
437 }
438
439 err = ff_vaapi_decode_make_slice_buffer(avctx, pic, ctx->slice_params, nb_params,
440 sizeof(VASliceParameterBufferAV1),
441 buffer,
442 size);
443 if (err)
444 goto fail;
445
446 return 0;
447
448 fail:
449 ff_vaapi_decode_cancel(avctx, pic);
450 return err;
451 }
452
453 const FFHWAccel ff_av1_vaapi_hwaccel = {
454 .p.name = "av1_vaapi",
455 .p.type = AVMEDIA_TYPE_VIDEO,
456 .p.id = AV_CODEC_ID_AV1,
457 .p.pix_fmt = AV_PIX_FMT_VAAPI,
458 .start_frame = vaapi_av1_start_frame,
459 .end_frame = vaapi_av1_end_frame,
460 .decode_slice = vaapi_av1_decode_slice,
461 .frame_priv_data_size = sizeof(VAAPIDecodePicture),
462 .init = vaapi_av1_decode_init,
463 .uninit = vaapi_av1_decode_uninit,
464 .frame_params = ff_vaapi_common_frame_params,
465 .priv_data_size = sizeof(VAAPIAV1DecContext),
466 .caps_internal = HWACCEL_CAP_ASYNC_SAFE,
467 };
468