2 * HEVC Supplementary Enhancement Information messages
4 * Copyright (C) 2012 - 2013 Guillaume Martres
5 * Copyright (C) 2012 - 2013 Gildas Cocherel
6 * Copyright (C) 2013 Vittorio Giovara
8 * This file is part of FFmpeg.
10 * FFmpeg is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU Lesser General Public
12 * License as published by the Free Software Foundation; either
13 * version 2.1 of the License, or (at your option) any later version.
15 * FFmpeg is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * Lesser General Public License for more details.
20 * You should have received a copy of the GNU Lesser General Public
21 * License along with FFmpeg; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
30 static int decode_nal_sei_decoded_picture_hash(HEVCSEIPictureHash *s, GetBitContext *gb)
34 //uint16_t picture_crc;
35 //uint32_t picture_checksum;
36 hash_type = get_bits(gb, 8);
38 for (cIdx = 0; cIdx < 3/*((s->sps->chroma_format_idc == 0) ? 1 : 3)*/; cIdx++) {
41 for (i = 0; i < 16; i++)
42 s->md5[cIdx][i] = get_bits(gb, 8);
43 } else if (hash_type == 1) {
44 // picture_crc = get_bits(gb, 16);
46 } else if (hash_type == 2) {
47 // picture_checksum = get_bits_long(gb, 32);
54 static int decode_nal_sei_mastering_display_info(HEVCSEIMasteringDisplay *s, GetBitContext *gb)
57 // Mastering primaries
58 for (i = 0; i < 3; i++) {
59 s->display_primaries[i][0] = get_bits(gb, 16);
60 s->display_primaries[i][1] = get_bits(gb, 16);
63 s->white_point[0] = get_bits(gb, 16);
64 s->white_point[1] = get_bits(gb, 16);
66 // Max and min luminance of mastering display
67 s->max_luminance = get_bits_long(gb, 32);
68 s->min_luminance = get_bits_long(gb, 32);
70 // As this SEI message comes before the first frame that references it,
71 // initialize the flag to 2 and decrement on IRAP access unit so it
72 // persists for the coded video sequence (e.g., between two IRAPs)
77 static int decode_nal_sei_content_light_info(HEVCSEIContentLight *s, GetBitContext *gb)
79 // Max and average light levels
80 s->max_content_light_level = get_bits(gb, 16);
81 s->max_pic_average_light_level = get_bits(gb, 16);
82 // As this SEI message comes before the first frame that references it,
83 // initialize the flag to 2 and decrement on IRAP access unit so it
84 // persists for the coded video sequence (e.g., between two IRAPs)
89 static int decode_nal_sei_frame_packing_arrangement(HEVCSEIFramePacking *s, GetBitContext *gb)
91 get_ue_golomb_long(gb); // frame_packing_arrangement_id
92 s->present = !get_bits1(gb);
95 s->arrangement_type = get_bits(gb, 7);
96 s->quincunx_subsampling = get_bits1(gb);
97 s->content_interpretation_type = get_bits(gb, 6);
99 // spatial_flipping_flag, frame0_flipped_flag, field_views_flag
101 s->current_frame_is_frame0_flag = get_bits1(gb);
102 // frame0_self_contained_flag, frame1_self_contained_flag
105 if (!s->quincunx_subsampling && s->arrangement_type != 5)
106 skip_bits(gb, 16); // frame[01]_grid_position_[xy]
107 skip_bits(gb, 8); // frame_packing_arrangement_reserved_byte
108 skip_bits1(gb); // frame_packing_arrangement_persistence_flag
110 skip_bits1(gb); // upsampled_aspect_ratio_flag
114 static int decode_nal_sei_display_orientation(HEVCSEIDisplayOrientation *s, GetBitContext *gb)
116 s->present = !get_bits1(gb);
119 s->hflip = get_bits1(gb); // hor_flip
120 s->vflip = get_bits1(gb); // ver_flip
122 s->anticlockwise_rotation = get_bits(gb, 16);
123 skip_bits1(gb); // display_orientation_persistence_flag
129 static int decode_nal_sei_pic_timing(HEVCSEI *s, GetBitContext *gb, const HEVCParamSets *ps,
130 void *logctx, int size)
132 HEVCSEIPictureTiming *h = &s->picture_timing;
135 if (!ps->sps_list[s->active_seq_parameter_set_id])
136 return(AVERROR(ENOMEM));
137 sps = (HEVCSPS*)ps->sps_list[s->active_seq_parameter_set_id]->data;
139 if (sps->vui.frame_field_info_present_flag) {
140 int pic_struct = get_bits(gb, 4);
141 h->picture_struct = AV_PICTURE_STRUCTURE_UNKNOWN;
142 if (pic_struct == 2 || pic_struct == 10 || pic_struct == 12) {
143 av_log(logctx, AV_LOG_DEBUG, "BOTTOM Field\n");
144 h->picture_struct = AV_PICTURE_STRUCTURE_BOTTOM_FIELD;
145 } else if (pic_struct == 1 || pic_struct == 9 || pic_struct == 11) {
146 av_log(logctx, AV_LOG_DEBUG, "TOP Field\n");
147 h->picture_struct = AV_PICTURE_STRUCTURE_TOP_FIELD;
148 } else if (pic_struct == 7) {
149 av_log(logctx, AV_LOG_DEBUG, "Frame/Field Doubling\n");
150 h->picture_struct = HEVC_SEI_PIC_STRUCT_FRAME_DOUBLING;
151 } else if (pic_struct == 8) {
152 av_log(logctx, AV_LOG_DEBUG, "Frame/Field Tripling\n");
153 h->picture_struct = HEVC_SEI_PIC_STRUCT_FRAME_TRIPLING;
155 get_bits(gb, 2); // source_scan_type
156 get_bits(gb, 1); // duplicate_flag
160 skip_bits_long(gb, 8 * size);
165 static int decode_registered_user_data_closed_caption(HEVCSEIA53Caption *s, GetBitContext *gb,
171 return AVERROR(EINVAL);
173 ret = ff_parse_a53_cc(&s->buf_ref, gb->buffer + get_bits_count(gb) / 8, size);
178 skip_bits_long(gb, size * 8);
183 static int decode_nal_sei_user_data_unregistered(HEVCSEIUnregistered *s, GetBitContext *gb,
186 AVBufferRef *buf_ref, **tmp;
188 if (size < 16 || size >= INT_MAX - 1)
189 return AVERROR_INVALIDDATA;
191 tmp = av_realloc_array(s->buf_ref, s->nb_buf_ref + 1, sizeof(*s->buf_ref));
193 return AVERROR(ENOMEM);
196 buf_ref = av_buffer_alloc(size + 1);
198 return AVERROR(ENOMEM);
200 for (int i = 0; i < size; i++)
201 buf_ref->data[i] = get_bits(gb, 8);
202 buf_ref->data[size] = 0;
203 buf_ref->size = size;
204 s->buf_ref[s->nb_buf_ref++] = buf_ref;
209 static int decode_nal_sei_user_data_registered_itu_t_t35(HEVCSEI *s, GetBitContext *gb,
212 uint32_t country_code;
213 uint32_t user_identifier;
216 return AVERROR(EINVAL);
219 country_code = get_bits(gb, 8);
220 if (country_code == 0xFF) {
228 user_identifier = get_bits_long(gb, 32);
230 switch (user_identifier) {
231 case MKBETAG('G', 'A', '9', '4'):
232 return decode_registered_user_data_closed_caption(&s->a53_caption, gb, size);
234 skip_bits_long(gb, size * 8);
240 static int decode_nal_sei_active_parameter_sets(HEVCSEI *s, GetBitContext *gb, void *logctx)
242 int num_sps_ids_minus1;
244 unsigned active_seq_parameter_set_id;
246 get_bits(gb, 4); // active_video_parameter_set_id
247 get_bits(gb, 1); // self_contained_cvs_flag
248 get_bits(gb, 1); // num_sps_ids_minus1
249 num_sps_ids_minus1 = get_ue_golomb_long(gb); // num_sps_ids_minus1
251 if (num_sps_ids_minus1 < 0 || num_sps_ids_minus1 > 15) {
252 av_log(logctx, AV_LOG_ERROR, "num_sps_ids_minus1 %d invalid\n", num_sps_ids_minus1);
253 return AVERROR_INVALIDDATA;
256 active_seq_parameter_set_id = get_ue_golomb_long(gb);
257 if (active_seq_parameter_set_id >= HEVC_MAX_SPS_COUNT) {
258 av_log(logctx, AV_LOG_ERROR, "active_parameter_set_id %d invalid\n", active_seq_parameter_set_id);
259 return AVERROR_INVALIDDATA;
261 s->active_seq_parameter_set_id = active_seq_parameter_set_id;
263 for (i = 1; i <= num_sps_ids_minus1; i++)
264 get_ue_golomb_long(gb); // active_seq_parameter_set_id[i]
269 static int decode_nal_sei_alternative_transfer(HEVCSEIAlternativeTransfer *s, GetBitContext *gb)
272 s->preferred_transfer_characteristics = get_bits(gb, 8);
276 static int decode_nal_sei_timecode(HEVCSEITimeCode *s, GetBitContext *gb)
278 s->num_clock_ts = get_bits(gb, 2);
280 for (int i = 0; i < s->num_clock_ts; i++) {
281 s->clock_timestamp_flag[i] = get_bits(gb, 1);
283 if (s->clock_timestamp_flag[i]) {
284 s->units_field_based_flag[i] = get_bits(gb, 1);
285 s->counting_type[i] = get_bits(gb, 5);
286 s->full_timestamp_flag[i] = get_bits(gb, 1);
287 s->discontinuity_flag[i] = get_bits(gb, 1);
288 s->cnt_dropped_flag[i] = get_bits(gb, 1);
290 s->n_frames[i] = get_bits(gb, 9);
292 if (s->full_timestamp_flag[i]) {
293 s->seconds_value[i] = av_clip(get_bits(gb, 6), 0, 59);
294 s->minutes_value[i] = av_clip(get_bits(gb, 6), 0, 59);
295 s->hours_value[i] = av_clip(get_bits(gb, 5), 0, 23);
297 s->seconds_flag[i] = get_bits(gb, 1);
298 if (s->seconds_flag[i]) {
299 s->seconds_value[i] = av_clip(get_bits(gb, 6), 0, 59);
300 s->minutes_flag[i] = get_bits(gb, 1);
301 if (s->minutes_flag[i]) {
302 s->minutes_value[i] = av_clip(get_bits(gb, 6), 0, 59);
303 s->hours_flag[i] = get_bits(gb, 1);
304 if (s->hours_flag[i]) {
305 s->hours_value[i] = av_clip(get_bits(gb, 5), 0, 23);
311 s->time_offset_length[i] = get_bits(gb, 5);
312 if (s->time_offset_length[i] > 0) {
313 s->time_offset_value[i] = get_bits(gb, s->time_offset_length[i]);
323 static int decode_nal_sei_prefix(GetBitContext *gb, void *logctx, HEVCSEI *s,
324 const HEVCParamSets *ps, int type, int size)
327 case 256: // Mismatched value from HM 8.1
328 return decode_nal_sei_decoded_picture_hash(&s->picture_hash, gb);
329 case HEVC_SEI_TYPE_FRAME_PACKING:
330 return decode_nal_sei_frame_packing_arrangement(&s->frame_packing, gb);
331 case HEVC_SEI_TYPE_DISPLAY_ORIENTATION:
332 return decode_nal_sei_display_orientation(&s->display_orientation, gb);
333 case HEVC_SEI_TYPE_PICTURE_TIMING:
334 return decode_nal_sei_pic_timing(s, gb, ps, logctx, size);
335 case HEVC_SEI_TYPE_MASTERING_DISPLAY_INFO:
336 return decode_nal_sei_mastering_display_info(&s->mastering_display, gb);
337 case HEVC_SEI_TYPE_CONTENT_LIGHT_LEVEL_INFO:
338 return decode_nal_sei_content_light_info(&s->content_light, gb);
339 case HEVC_SEI_TYPE_ACTIVE_PARAMETER_SETS:
340 return decode_nal_sei_active_parameter_sets(s, gb, logctx);
341 case HEVC_SEI_TYPE_USER_DATA_REGISTERED_ITU_T_T35:
342 return decode_nal_sei_user_data_registered_itu_t_t35(s, gb, size);
343 case HEVC_SEI_TYPE_USER_DATA_UNREGISTERED:
344 return decode_nal_sei_user_data_unregistered(&s->unregistered, gb, size);
345 case HEVC_SEI_TYPE_ALTERNATIVE_TRANSFER_CHARACTERISTICS:
346 return decode_nal_sei_alternative_transfer(&s->alternative_transfer, gb);
347 case HEVC_SEI_TYPE_TIME_CODE:
348 return decode_nal_sei_timecode(&s->timecode, gb);
350 av_log(logctx, AV_LOG_DEBUG, "Skipped PREFIX SEI %d\n", type);
351 skip_bits_long(gb, 8 * size);
356 static int decode_nal_sei_suffix(GetBitContext *gb, void *logctx, HEVCSEI *s,
360 case HEVC_SEI_TYPE_DECODED_PICTURE_HASH:
361 return decode_nal_sei_decoded_picture_hash(&s->picture_hash, gb);
363 av_log(logctx, AV_LOG_DEBUG, "Skipped SUFFIX SEI %d\n", type);
364 skip_bits_long(gb, 8 * size);
369 static int decode_nal_sei_message(GetBitContext *gb, void *logctx, HEVCSEI *s,
370 const HEVCParamSets *ps, int nal_unit_type)
372 int payload_type = 0;
373 int payload_size = 0;
375 av_log(logctx, AV_LOG_DEBUG, "Decoding SEI\n");
377 while (byte == 0xFF) {
378 if (get_bits_left(gb) < 16 || payload_type > INT_MAX - 255)
379 return AVERROR_INVALIDDATA;
380 byte = get_bits(gb, 8);
381 payload_type += byte;
384 while (byte == 0xFF) {
385 if (get_bits_left(gb) < 8 + 8LL*payload_size)
386 return AVERROR_INVALIDDATA;
387 byte = get_bits(gb, 8);
388 payload_size += byte;
390 if (nal_unit_type == HEVC_NAL_SEI_PREFIX) {
391 return decode_nal_sei_prefix(gb, logctx, s, ps, payload_type, payload_size);
392 } else { /* nal_unit_type == NAL_SEI_SUFFIX */
393 return decode_nal_sei_suffix(gb, logctx, s, payload_type, payload_size);
397 static int more_rbsp_data(GetBitContext *gb)
399 return get_bits_left(gb) > 0 && show_bits(gb, 8) != 0x80;
402 int ff_hevc_decode_nal_sei(GetBitContext *gb, void *logctx, HEVCSEI *s,
403 const HEVCParamSets *ps, int type)
408 ret = decode_nal_sei_message(gb, logctx, s, ps, type);
411 } while (more_rbsp_data(gb));
415 void ff_hevc_reset_sei(HEVCSEI *s)
417 av_buffer_unref(&s->a53_caption.buf_ref);
419 for (int i = 0; i < s->unregistered.nb_buf_ref; i++)
420 av_buffer_unref(&s->unregistered.buf_ref[i]);
421 s->unregistered.nb_buf_ref = 0;
422 av_freep(&s->unregistered.buf_ref);