2 * AV1 helper functions for muxers
3 * Copyright (c) 2018 James Almer <jamrial@gmail.com>
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 #include "libavutil/avassert.h"
23 #include "libavutil/mem.h"
24 #include "libavcodec/av1.h"
25 #include "libavcodec/av1_parse.h"
26 #include "libavcodec/profiles.h"
27 #include "libavcodec/put_bits.h"
30 #include "avio_internal.h"
32 static int av1_filter_obus(AVIOContext *pb, const uint8_t *buf,
33 int size, int *offset)
35 const uint8_t *start = buf, *end = buf + size;
37 int off, start_pos, type, temporal_id, spatial_id;
43 } state = START_NOT_FOUND;
47 int len = parse_obu_header(buf, end - buf, &obu_size, &start_pos,
48 &type, &temporal_id, &spatial_id);
53 case AV1_OBU_TEMPORAL_DELIMITER:
54 case AV1_OBU_REDUNDANT_FRAME_HEADER:
55 case AV1_OBU_TILE_LIST:
57 if (state == START_FOUND)
61 if (state == START_NOT_FOUND) {
64 } else if (state == END_FOUND) {
65 state = OFFSET_IMPOSSIBLE;
68 avio_write(pb, buf, len);
76 *offset = state != OFFSET_IMPOSSIBLE ? off : -1;
81 int ff_av1_filter_obus(AVIOContext *pb, const uint8_t *buf, int size)
83 return av1_filter_obus(pb, buf, size, NULL);
86 int ff_av1_filter_obus_buf(const uint8_t *in, uint8_t **out,
87 int *size, int *offset)
93 len = ret = av1_filter_obus(NULL, in, *size, &off);
105 buf = av_malloc(len + AV_INPUT_BUFFER_PADDING_SIZE);
107 return AVERROR(ENOMEM);
109 ffio_init_context(&pb, buf, len, 1, NULL, NULL, NULL, NULL);
111 ret = av1_filter_obus(&pb, in, *size, NULL);
112 av_assert1(ret == len);
114 memset(buf + len, 0, AV_INPUT_BUFFER_PADDING_SIZE);
123 static inline void uvlc(GetBitContext *gb)
125 int leading_zeros = 0;
127 while (get_bits_left(gb)) {
133 if (leading_zeros >= 32)
136 skip_bits_long(gb, leading_zeros);
139 static int parse_color_config(AV1SequenceParameters *seq_params, GetBitContext *gb)
142 int high_bitdepth = get_bits1(gb);
143 if (seq_params->profile == FF_PROFILE_AV1_PROFESSIONAL && high_bitdepth)
144 twelve_bit = get_bits1(gb);
146 seq_params->bitdepth = 8 + (high_bitdepth * 2) + (twelve_bit * 2);
148 if (seq_params->profile == FF_PROFILE_AV1_HIGH)
149 seq_params->monochrome = 0;
151 seq_params->monochrome = get_bits1(gb);
153 seq_params->color_description_present_flag = get_bits1(gb);
154 if (seq_params->color_description_present_flag) {
155 seq_params->color_primaries = get_bits(gb, 8);
156 seq_params->transfer_characteristics = get_bits(gb, 8);
157 seq_params->matrix_coefficients = get_bits(gb, 8);
159 seq_params->color_primaries = AVCOL_PRI_UNSPECIFIED;
160 seq_params->transfer_characteristics = AVCOL_TRC_UNSPECIFIED;
161 seq_params->matrix_coefficients = AVCOL_SPC_UNSPECIFIED;
164 if (seq_params->monochrome) {
165 seq_params->color_range = get_bits1(gb);
166 seq_params->chroma_subsampling_x = 1;
167 seq_params->chroma_subsampling_y = 1;
168 seq_params->chroma_sample_position = 0;
170 } else if (seq_params->color_primaries == AVCOL_PRI_BT709 &&
171 seq_params->transfer_characteristics == AVCOL_TRC_IEC61966_2_1 &&
172 seq_params->matrix_coefficients == AVCOL_SPC_RGB) {
173 seq_params->chroma_subsampling_x = 0;
174 seq_params->chroma_subsampling_y = 0;
176 seq_params->color_range = get_bits1(gb);
178 if (seq_params->profile == FF_PROFILE_AV1_MAIN) {
179 seq_params->chroma_subsampling_x = 1;
180 seq_params->chroma_subsampling_y = 1;
181 } else if (seq_params->profile == FF_PROFILE_AV1_HIGH) {
182 seq_params->chroma_subsampling_x = 0;
183 seq_params->chroma_subsampling_y = 0;
186 seq_params->chroma_subsampling_x = get_bits1(gb);
187 if (seq_params->chroma_subsampling_x)
188 seq_params->chroma_subsampling_y = get_bits1(gb);
190 seq_params->chroma_subsampling_y = 0;
192 seq_params->chroma_subsampling_x = 1;
193 seq_params->chroma_subsampling_y = 0;
196 if (seq_params->chroma_subsampling_x && seq_params->chroma_subsampling_y)
197 seq_params->chroma_sample_position = get_bits(gb, 2);
200 skip_bits1(gb); // separate_uv_delta_q
205 static int parse_sequence_header(AV1SequenceParameters *seq_params, const uint8_t *buf, int size)
208 int reduced_still_picture_header;
209 int frame_width_bits_minus_1, frame_height_bits_minus_1;
212 size_bits = get_obu_bit_length(buf, size, AV1_OBU_SEQUENCE_HEADER);
216 ret = init_get_bits(&gb, buf, size_bits);
220 memset(seq_params, 0, sizeof(*seq_params));
222 seq_params->profile = get_bits(&gb, 3);
224 skip_bits1(&gb); // still_picture
225 reduced_still_picture_header = get_bits1(&gb);
227 if (reduced_still_picture_header) {
228 seq_params->level = get_bits(&gb, 5);
229 seq_params->tier = 0;
231 int initial_display_delay_present_flag, operating_points_cnt_minus_1;
232 int decoder_model_info_present_flag, buffer_delay_length_minus_1;
234 if (get_bits1(&gb)) { // timing_info_present_flag
235 skip_bits_long(&gb, 32); // num_units_in_display_tick
236 skip_bits_long(&gb, 32); // time_scale
238 if (get_bits1(&gb)) // equal_picture_interval
239 uvlc(&gb); // num_ticks_per_picture_minus_1
241 decoder_model_info_present_flag = get_bits1(&gb);
242 if (decoder_model_info_present_flag) {
243 buffer_delay_length_minus_1 = get_bits(&gb, 5);
244 skip_bits_long(&gb, 32); // num_units_in_decoding_tick
245 skip_bits(&gb, 10); // buffer_removal_time_length_minus_1 (5)
246 // frame_presentation_time_length_minus_1 (5)
249 decoder_model_info_present_flag = 0;
251 initial_display_delay_present_flag = get_bits1(&gb);
253 operating_points_cnt_minus_1 = get_bits(&gb, 5);
254 for (int i = 0; i <= operating_points_cnt_minus_1; i++) {
255 int seq_level_idx, seq_tier;
257 skip_bits(&gb, 12); // operating_point_idc
258 seq_level_idx = get_bits(&gb, 5);
260 if (seq_level_idx > 7)
261 seq_tier = get_bits1(&gb);
265 if (decoder_model_info_present_flag) {
266 if (get_bits1(&gb)) { // decoder_model_present_for_this_op
267 skip_bits_long(&gb, buffer_delay_length_minus_1 + 1); // decoder_buffer_delay
268 skip_bits_long(&gb, buffer_delay_length_minus_1 + 1); // encoder_buffer_delay
269 skip_bits1(&gb); // low_delay_mode_flag
273 if (initial_display_delay_present_flag) {
274 if (get_bits1(&gb)) // initial_display_delay_present_for_this_op
275 skip_bits(&gb, 4); // initial_display_delay_minus_1
279 seq_params->level = seq_level_idx;
280 seq_params->tier = seq_tier;
285 frame_width_bits_minus_1 = get_bits(&gb, 4);
286 frame_height_bits_minus_1 = get_bits(&gb, 4);
288 skip_bits(&gb, frame_width_bits_minus_1 + 1); // max_frame_width_minus_1
289 skip_bits(&gb, frame_height_bits_minus_1 + 1); // max_frame_height_minus_1
291 if (!reduced_still_picture_header) {
292 if (get_bits1(&gb)) // frame_id_numbers_present_flag
293 skip_bits(&gb, 7); // delta_frame_id_length_minus_2 (4), additional_frame_id_length_minus_1 (3)
296 skip_bits(&gb, 3); // use_128x128_superblock (1), enable_filter_intra (1), enable_intra_edge_filter (1)
298 if (!reduced_still_picture_header) {
299 int enable_order_hint, seq_force_screen_content_tools;
301 skip_bits(&gb, 4); // enable_interintra_compound (1), enable_masked_compound (1)
302 // enable_warped_motion (1), enable_dual_filter (1)
304 enable_order_hint = get_bits1(&gb);
305 if (enable_order_hint)
306 skip_bits(&gb, 2); // enable_jnt_comp (1), enable_ref_frame_mvs (1)
308 if (get_bits1(&gb)) // seq_choose_screen_content_tools
309 seq_force_screen_content_tools = 2;
311 seq_force_screen_content_tools = get_bits1(&gb);
313 if (seq_force_screen_content_tools) {
314 if (!get_bits1(&gb)) // seq_choose_integer_mv
315 skip_bits1(&gb); // seq_force_integer_mv
318 if (enable_order_hint)
319 skip_bits(&gb, 3); // order_hint_bits_minus_1
322 skip_bits(&gb, 3); // enable_superres (1), enable_cdef (1), enable_restoration (1)
324 parse_color_config(seq_params, &gb);
326 skip_bits1(&gb); // film_grain_params_present
328 if (get_bits_left(&gb))
329 return AVERROR_INVALIDDATA;
334 int ff_av1_parse_seq_header(AV1SequenceParameters *seq, const uint8_t *buf, int size)
337 int start_pos, type, temporal_id, spatial_id;
340 return AVERROR_INVALIDDATA;
343 int len = parse_obu_header(buf, size, &obu_size, &start_pos,
344 &type, &temporal_id, &spatial_id);
349 case AV1_OBU_SEQUENCE_HEADER:
351 return AVERROR_INVALIDDATA;
353 return parse_sequence_header(seq, buf + start_pos, obu_size);
361 return AVERROR_INVALIDDATA;
364 int ff_isom_write_av1c(AVIOContext *pb, const uint8_t *buf, int size)
366 AVIOContext *seq_pb = NULL, *meta_pb = NULL;
367 AV1SequenceParameters seq_params;
372 int start_pos, type, temporal_id, spatial_id;
373 int ret, nb_seq = 0, seq_size, meta_size;
376 return AVERROR_INVALIDDATA;
378 ret = avio_open_dyn_buf(&seq_pb);
381 ret = avio_open_dyn_buf(&meta_pb);
386 int len = parse_obu_header(buf, size, &obu_size, &start_pos,
387 &type, &temporal_id, &spatial_id);
394 case AV1_OBU_SEQUENCE_HEADER:
396 if (!obu_size || nb_seq > 1) {
397 ret = AVERROR_INVALIDDATA;
400 ret = parse_sequence_header(&seq_params, buf + start_pos, obu_size);
404 avio_write(seq_pb, buf, len);
406 case AV1_OBU_METADATA:
408 ret = AVERROR_INVALIDDATA;
411 avio_write(meta_pb, buf, len);
420 seq_size = avio_get_dyn_buf(seq_pb, &seq);
422 ret = AVERROR_INVALIDDATA;
426 init_put_bits(&pbc, header, sizeof(header));
428 put_bits(&pbc, 1, 1); // marker
429 put_bits(&pbc, 7, 1); // version
430 put_bits(&pbc, 3, seq_params.profile);
431 put_bits(&pbc, 5, seq_params.level);
432 put_bits(&pbc, 1, seq_params.tier);
433 put_bits(&pbc, 1, seq_params.bitdepth > 8);
434 put_bits(&pbc, 1, seq_params.bitdepth == 12);
435 put_bits(&pbc, 1, seq_params.monochrome);
436 put_bits(&pbc, 1, seq_params.chroma_subsampling_x);
437 put_bits(&pbc, 1, seq_params.chroma_subsampling_y);
438 put_bits(&pbc, 2, seq_params.chroma_sample_position);
439 put_bits(&pbc, 8, 0); // padding
440 flush_put_bits(&pbc);
442 avio_write(pb, header, sizeof(header));
443 avio_write(pb, seq, seq_size);
445 meta_size = avio_get_dyn_buf(meta_pb, &meta);
447 avio_write(pb, meta, meta_size);
450 ffio_free_dyn_buf(&seq_pb);
451 ffio_free_dyn_buf(&meta_pb);