git.sesse.net Git - ffmpeg/blob - libavcodec/hevc_sei.h

   1 /*
   2  * HEVC Supplementary Enhancement Information messages
   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 #ifndef AVCODEC_HEVC_SEI_H
  22 #define AVCODEC_HEVC_SEI_H
  23
  24 #include <stdint.h>
  25
  26 #include "get_bits.h"
  27
  28 /**
  29  * SEI message types
  30  */
  31 typedef enum {
  32     HEVC_SEI_TYPE_BUFFERING_PERIOD                     = 0,
  33     HEVC_SEI_TYPE_PICTURE_TIMING                       = 1,
  34     HEVC_SEI_TYPE_PAN_SCAN_RECT                        = 2,
  35     HEVC_SEI_TYPE_FILLER_PAYLOAD                       = 3,
  36     HEVC_SEI_TYPE_USER_DATA_REGISTERED_ITU_T_T35       = 4,
  37     HEVC_SEI_TYPE_USER_DATA_UNREGISTERED               = 5,
  38     HEVC_SEI_TYPE_RECOVERY_POINT                       = 6,
  39     HEVC_SEI_TYPE_SCENE_INFO                           = 9,
  40     HEVC_SEI_TYPE_FULL_FRAME_SNAPSHOT                  = 15,
  41     HEVC_SEI_TYPE_PROGRESSIVE_REFINEMENT_SEGMENT_START = 16,
  42     HEVC_SEI_TYPE_PROGRESSIVE_REFINEMENT_SEGMENT_END   = 17,
  43     HEVC_SEI_TYPE_FILM_GRAIN_CHARACTERISTICS           = 19,
  44     HEVC_SEI_TYPE_POST_FILTER_HINT                     = 22,
  45     HEVC_SEI_TYPE_TONE_MAPPING_INFO                    = 23,
  46     HEVC_SEI_TYPE_FRAME_PACKING                        = 45,
  47     HEVC_SEI_TYPE_DISPLAY_ORIENTATION                  = 47,
  48     HEVC_SEI_TYPE_SOP_DESCRIPTION                      = 128,
  49     HEVC_SEI_TYPE_ACTIVE_PARAMETER_SETS                = 129,
  50     HEVC_SEI_TYPE_DECODING_UNIT_INFO                   = 130,
  51     HEVC_SEI_TYPE_TEMPORAL_LEVEL0_INDEX                = 131,
  52     HEVC_SEI_TYPE_DECODED_PICTURE_HASH                 = 132,
  53     HEVC_SEI_TYPE_SCALABLE_NESTING                     = 133,
  54     HEVC_SEI_TYPE_REGION_REFRESH_INFO                  = 134,
  55     HEVC_SEI_TYPE_MASTERING_DISPLAY_INFO               = 137,
  56     HEVC_SEI_TYPE_CONTENT_LIGHT_LEVEL_INFO             = 144,
  57     HEVC_SEI_TYPE_ALTERNATIVE_TRANSFER_CHARACTERISTICS = 147,
  58 } HEVC_SEI_Type;
  59
  60 typedef struct HEVCSEIPictureHash {
  61     uint8_t       md5[3][16];
  62     uint8_t is_md5;
  63 } HEVCSEIPictureHash;
  64
  65 typedef struct HEVCSEIFramePacking {
  66     int present;
  67     int arrangement_type;
  68     int content_interpretation_type;
  69     int quincunx_subsampling;
  70     int current_frame_is_frame0_flag;
  71 } HEVCSEIFramePacking;
  72
  73 typedef struct HEVCSEIDisplayOrientation {
  74     int present;
  75     int anticlockwise_rotation;
  76     int hflip, vflip;
  77 } HEVCSEIDisplayOrientation;
  78
  79 typedef struct HEVCSEIPictureTiming {
  80     int picture_struct;
  81 } HEVCSEIPictureTiming;
  82
  83 typedef struct HEVCSEIA53Caption {
  84     int a53_caption_size;
  85     uint8_t *a53_caption;
  86 } HEVCSEIA53Caption;
  87
  88 typedef struct HEVCSEIMasteringDisplay {
  89     int present;
  90     uint16_t display_primaries[3][2];
  91     uint16_t white_point[2];
  92     uint32_t max_luminance;
  93     uint32_t min_luminance;
  94 } HEVCSEIMasteringDisplay;
  95
  96 typedef struct HEVCSEIContentLight {
  97     int present;
  98     uint16_t max_content_light_level;
  99     uint16_t max_pic_average_light_level;
 100 } HEVCSEIContentLight;
 101
 102 typedef struct HEVCSEIAlternativeTransfer {
 103     int present;
 104     int preferred_transfer_characteristics;
 105 } HEVCSEIAlternativeTransfer;
 106
 107 typedef struct HEVCSEI {
 108     HEVCSEIPictureHash picture_hash;
 109     HEVCSEIFramePacking frame_packing;
 110     HEVCSEIDisplayOrientation display_orientation;
 111     HEVCSEIPictureTiming picture_timing;
 112     HEVCSEIA53Caption a53_caption;
 113     HEVCSEIMasteringDisplay mastering_display;
 114     HEVCSEIContentLight content_light;
 115     int active_seq_parameter_set_id;
 116     HEVCSEIAlternativeTransfer alternative_transfer;
 117 } HEVCSEI;
 118
 119 struct HEVCParamSets;
 120
 121 int ff_hevc_decode_nal_sei(GetBitContext *gb, void *logctx, HEVCSEI *s,
 122                            const struct HEVCParamSets *ps, int type);
 123
 124 /**
 125  * Reset SEI values that are stored on the Context.
 126  * e.g. Caption data that was extracted during NAL
 127  * parsing.
 128  *
 129  * @param s HEVCContext.
 130  */
 131 void ff_hevc_reset_sei(HEVCSEI *s);
 132
 133 #endif /* AVCODEC_HEVC_SEI_H */