217 lines
7.0 KiB
C
217 lines
7.0 KiB
C
/*
|
|
* This file is part of FFmpeg.
|
|
*
|
|
* FFmpeg is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* FFmpeg is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with FFmpeg; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef AVCODEC_H264_SEI_H
|
|
#define AVCODEC_H264_SEI_H
|
|
|
|
#include "get_bits.h"
|
|
#include "h264_ps.h"
|
|
|
|
/**
|
|
* SEI message types
|
|
*/
|
|
typedef enum {
|
|
H264_SEI_TYPE_BUFFERING_PERIOD = 0, ///< buffering period (H.264, D.1.1)
|
|
H264_SEI_TYPE_PIC_TIMING = 1, ///< picture timing
|
|
H264_SEI_TYPE_PAN_SCAN_RECT = 2, ///< pan-scan rectangle
|
|
H264_SEI_TYPE_FILLER_PAYLOAD = 3, ///< filler data
|
|
H264_SEI_TYPE_USER_DATA_REGISTERED = 4, ///< registered user data as specified by Rec. ITU-T T.35
|
|
H264_SEI_TYPE_USER_DATA_UNREGISTERED = 5, ///< unregistered user data
|
|
H264_SEI_TYPE_RECOVERY_POINT = 6, ///< recovery point (frame # to decoder sync)
|
|
H264_SEI_TYPE_FRAME_PACKING = 45, ///< frame packing arrangement
|
|
H264_SEI_TYPE_DISPLAY_ORIENTATION = 47, ///< display orientation
|
|
H264_SEI_TYPE_GREEN_METADATA = 56, ///< GreenMPEG information
|
|
H264_SEI_TYPE_MASTERING_DISPLAY_COLOUR_VOLUME = 137, ///< mastering display properties
|
|
H264_SEI_TYPE_ALTERNATIVE_TRANSFER = 147, ///< alternative transfer
|
|
} H264_SEI_Type;
|
|
|
|
/**
|
|
* pic_struct in picture timing SEI message
|
|
*/
|
|
typedef enum {
|
|
H264_SEI_PIC_STRUCT_FRAME = 0, ///< 0: %frame
|
|
H264_SEI_PIC_STRUCT_TOP_FIELD = 1, ///< 1: top field
|
|
H264_SEI_PIC_STRUCT_BOTTOM_FIELD = 2, ///< 2: bottom field
|
|
H264_SEI_PIC_STRUCT_TOP_BOTTOM = 3, ///< 3: top field, bottom field, in that order
|
|
H264_SEI_PIC_STRUCT_BOTTOM_TOP = 4, ///< 4: bottom field, top field, in that order
|
|
H264_SEI_PIC_STRUCT_TOP_BOTTOM_TOP = 5, ///< 5: top field, bottom field, top field repeated, in that order
|
|
H264_SEI_PIC_STRUCT_BOTTOM_TOP_BOTTOM = 6, ///< 6: bottom field, top field, bottom field repeated, in that order
|
|
H264_SEI_PIC_STRUCT_FRAME_DOUBLING = 7, ///< 7: %frame doubling
|
|
H264_SEI_PIC_STRUCT_FRAME_TRIPLING = 8 ///< 8: %frame tripling
|
|
} H264_SEI_PicStructType;
|
|
|
|
/**
|
|
* frame_packing_arrangement types
|
|
*/
|
|
typedef enum {
|
|
H264_SEI_FPA_TYPE_CHECKERBOARD = 0,
|
|
H264_SEI_FPA_TYPE_INTERLEAVE_COLUMN = 1,
|
|
H264_SEI_FPA_TYPE_INTERLEAVE_ROW = 2,
|
|
H264_SEI_FPA_TYPE_SIDE_BY_SIDE = 3,
|
|
H264_SEI_FPA_TYPE_TOP_BOTTOM = 4,
|
|
H264_SEI_FPA_TYPE_INTERLEAVE_TEMPORAL = 5,
|
|
H264_SEI_FPA_TYPE_2D = 6,
|
|
} H264_SEI_FpaType;
|
|
|
|
typedef struct H264SEITimeCode {
|
|
/* When not continuously receiving full timecodes, we have to reference
|
|
the previous timecode received */
|
|
int full;
|
|
int frame;
|
|
int seconds;
|
|
int minutes;
|
|
int hours;
|
|
int dropframe;
|
|
} H264SEITimeCode;
|
|
|
|
typedef struct H264SEIPictureTiming {
|
|
// maximum size of pic_timing according to the spec should be 274 bits
|
|
uint8_t payload[40];
|
|
int payload_size_bits;
|
|
|
|
int present;
|
|
H264_SEI_PicStructType pic_struct;
|
|
|
|
/**
|
|
* Bit set of clock types for fields/frames in picture timing SEI message.
|
|
* For each found ct_type, appropriate bit is set (e.g., bit 1 for
|
|
* interlaced).
|
|
*/
|
|
int ct_type;
|
|
|
|
/**
|
|
* dpb_output_delay in picture timing SEI message, see H.264 C.2.2
|
|
*/
|
|
int dpb_output_delay;
|
|
|
|
/**
|
|
* cpb_removal_delay in picture timing SEI message, see H.264 C.1.2
|
|
*/
|
|
int cpb_removal_delay;
|
|
|
|
/**
|
|
* Maximum three timecodes in a pic_timing SEI.
|
|
*/
|
|
H264SEITimeCode timecode[3];
|
|
|
|
/**
|
|
* Number of timecode in use
|
|
*/
|
|
int timecode_cnt;
|
|
} H264SEIPictureTiming;
|
|
|
|
typedef struct H264SEIAFD {
|
|
int present;
|
|
uint8_t active_format_description;
|
|
} H264SEIAFD;
|
|
|
|
typedef struct H264SEIA53Caption {
|
|
AVBufferRef *buf_ref;
|
|
} H264SEIA53Caption;
|
|
|
|
typedef struct H264SEIUnregistered {
|
|
int x264_build;
|
|
} H264SEIUnregistered;
|
|
|
|
typedef struct H264SEIRecoveryPoint {
|
|
/**
|
|
* recovery_frame_cnt
|
|
*
|
|
* Set to -1 if no recovery point SEI message found or to number of frames
|
|
* before playback synchronizes. Frames having recovery point are key
|
|
* frames.
|
|
*/
|
|
int recovery_frame_cnt;
|
|
} H264SEIRecoveryPoint;
|
|
|
|
typedef struct H264SEIBufferingPeriod {
|
|
int present; ///< Buffering period SEI flag
|
|
int initial_cpb_removal_delay[32]; ///< Initial timestamps for CPBs
|
|
} H264SEIBufferingPeriod;
|
|
|
|
typedef struct H264SEIFramePacking {
|
|
int present;
|
|
int arrangement_id;
|
|
int arrangement_cancel_flag; ///< is previous arrangement canceled, -1 if never received
|
|
H264_SEI_FpaType arrangement_type;
|
|
int arrangement_repetition_period;
|
|
int content_interpretation_type;
|
|
int quincunx_sampling_flag;
|
|
int current_frame_is_frame0_flag;
|
|
} H264SEIFramePacking;
|
|
|
|
typedef struct H264SEIDisplayOrientation {
|
|
int present;
|
|
int anticlockwise_rotation;
|
|
int hflip, vflip;
|
|
} H264SEIDisplayOrientation;
|
|
|
|
typedef struct H264SEIGreenMetaData {
|
|
uint8_t green_metadata_type;
|
|
uint8_t period_type;
|
|
uint16_t num_seconds;
|
|
uint16_t num_pictures;
|
|
uint8_t percent_non_zero_macroblocks;
|
|
uint8_t percent_intra_coded_macroblocks;
|
|
uint8_t percent_six_tap_filtering;
|
|
uint8_t percent_alpha_point_deblocking_instance;
|
|
uint8_t xsd_metric_type;
|
|
uint16_t xsd_metric_value;
|
|
} H264SEIGreenMetaData;
|
|
|
|
typedef struct H264SEIAlternativeTransfer {
|
|
int present;
|
|
int preferred_transfer_characteristics;
|
|
} H264SEIAlternativeTransfer;
|
|
|
|
typedef struct H264SEIContext {
|
|
H264SEIPictureTiming picture_timing;
|
|
H264SEIAFD afd;
|
|
H264SEIA53Caption a53_caption;
|
|
H264SEIUnregistered unregistered;
|
|
H264SEIRecoveryPoint recovery_point;
|
|
H264SEIBufferingPeriod buffering_period;
|
|
H264SEIFramePacking frame_packing;
|
|
H264SEIDisplayOrientation display_orientation;
|
|
H264SEIGreenMetaData green_metadata;
|
|
H264SEIAlternativeTransfer alternative_transfer;
|
|
} H264SEIContext;
|
|
|
|
struct H264ParamSets;
|
|
|
|
int ff_h264_sei_decode(H264SEIContext *h, GetBitContext *gb,
|
|
const struct H264ParamSets *ps, void *logctx);
|
|
|
|
/**
|
|
* Reset SEI values at the beginning of the frame.
|
|
*/
|
|
void ff_h264_sei_uninit(H264SEIContext *h);
|
|
|
|
/**
|
|
* Get stereo_mode string from the h264 frame_packing_arrangement
|
|
*/
|
|
const char *ff_h264_sei_stereo_mode(const H264SEIFramePacking *h);
|
|
|
|
/**
|
|
* Parse the contents of a picture timing message given an active SPS.
|
|
*/
|
|
int ff_h264_sei_process_picture_timing(H264SEIPictureTiming *h, const SPS *sps,
|
|
void *logctx);
|
|
|
|
#endif /* AVCODEC_H264_SEI_H */
|