FFmpeg coverage


Directory: ../../../ffmpeg/
File: src/libavcodec/h264_sei.h
Date: 2024-04-25 15:36:26
Exec Total Coverage
Lines: 2 2 100.0%
Functions: 1 1 100.0%
Branches: 0 0 -%

Line Branch Exec Source
1 /*
2 * This file is part of FFmpeg.
3 *
4 * FFmpeg is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
8 *
9 * FFmpeg is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with FFmpeg; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17 */
18
19 #ifndef AVCODEC_H264_SEI_H
20 #define AVCODEC_H264_SEI_H
21
22 #include "get_bits.h"
23 #include "h2645_sei.h"
24 #include "h264_ps.h"
25 #include "sei.h"
26
27
28 /**
29 * pic_struct in picture timing SEI message
30 */
31 typedef enum {
32 H264_SEI_PIC_STRUCT_FRAME = 0, ///< 0: %frame
33 H264_SEI_PIC_STRUCT_TOP_FIELD = 1, ///< 1: top field
34 H264_SEI_PIC_STRUCT_BOTTOM_FIELD = 2, ///< 2: bottom field
35 H264_SEI_PIC_STRUCT_TOP_BOTTOM = 3, ///< 3: top field, bottom field, in that order
36 H264_SEI_PIC_STRUCT_BOTTOM_TOP = 4, ///< 4: bottom field, top field, in that order
37 H264_SEI_PIC_STRUCT_TOP_BOTTOM_TOP = 5, ///< 5: top field, bottom field, top field repeated, in that order
38 H264_SEI_PIC_STRUCT_BOTTOM_TOP_BOTTOM = 6, ///< 6: bottom field, top field, bottom field repeated, in that order
39 H264_SEI_PIC_STRUCT_FRAME_DOUBLING = 7, ///< 7: %frame doubling
40 H264_SEI_PIC_STRUCT_FRAME_TRIPLING = 8 ///< 8: %frame tripling
41 } H264_SEI_PicStructType;
42
43 typedef struct H264SEITimeCode {
44 /* When not continuously receiving full timecodes, we have to reference
45 the previous timecode received */
46 int full;
47 int frame;
48 int seconds;
49 int minutes;
50 int hours;
51 int dropframe;
52 } H264SEITimeCode;
53
54 typedef struct H264SEIPictureTiming {
55 // maximum size of pic_timing according to the spec should be 274 bits
56 uint8_t payload[40];
57 int payload_size_bytes;
58
59 int present;
60 H264_SEI_PicStructType pic_struct;
61
62 /**
63 * Bit set of clock types for fields/frames in picture timing SEI message.
64 * For each found ct_type, appropriate bit is set (e.g., bit 1 for
65 * interlaced).
66 */
67 int ct_type;
68
69 /**
70 * dpb_output_delay in picture timing SEI message, see H.264 C.2.2
71 */
72 int dpb_output_delay;
73
74 /**
75 * cpb_removal_delay in picture timing SEI message, see H.264 C.1.2
76 */
77 int cpb_removal_delay;
78
79 /**
80 * Maximum three timecodes in a pic_timing SEI.
81 */
82 H264SEITimeCode timecode[3];
83
84 /**
85 * Number of timecode in use
86 */
87 int timecode_cnt;
88 } H264SEIPictureTiming;
89
90 typedef struct H264SEIRecoveryPoint {
91 /**
92 * recovery_frame_cnt
93 *
94 * Set to -1 if no recovery point SEI message found or to number of frames
95 * before playback synchronizes. Frames having recovery point are key
96 * frames.
97 */
98 int recovery_frame_cnt;
99 } H264SEIRecoveryPoint;
100
101 typedef struct H264SEIBufferingPeriod {
102 int present; ///< Buffering period SEI flag
103 int initial_cpb_removal_delay[32]; ///< Initial timestamps for CPBs
104 } H264SEIBufferingPeriod;
105
106 typedef struct H264SEIGreenMetaData {
107 uint8_t green_metadata_type;
108 uint8_t period_type;
109 uint16_t num_seconds;
110 uint16_t num_pictures;
111 uint8_t percent_non_zero_macroblocks;
112 uint8_t percent_intra_coded_macroblocks;
113 uint8_t percent_six_tap_filtering;
114 uint8_t percent_alpha_point_deblocking_instance;
115 uint8_t xsd_metric_type;
116 uint16_t xsd_metric_value;
117 } H264SEIGreenMetaData;
118
119 typedef struct H264SEIContext {
120 H2645SEI common;
121 H264SEIPictureTiming picture_timing;
122 H264SEIRecoveryPoint recovery_point;
123 H264SEIBufferingPeriod buffering_period;
124 H264SEIGreenMetaData green_metadata;
125 } H264SEIContext;
126
127 struct H264ParamSets;
128
129 int ff_h264_sei_decode(H264SEIContext *h, GetBitContext *gb,
130 const struct H264ParamSets *ps, void *logctx);
131
132 62 static inline int ff_h264_sei_ctx_replace(H264SEIContext *dst,
133 const H264SEIContext *src)
134 {
135 62 return ff_h2645_sei_ctx_replace(&dst->common, &src->common);
136 }
137
138 /**
139 * Reset SEI values at the beginning of the frame.
140 */
141 void ff_h264_sei_uninit(H264SEIContext *h);
142
143 /**
144 * Get stereo_mode string from the h264 frame_packing_arrangement
145 */
146 const char *ff_h264_sei_stereo_mode(const H2645SEIFramePacking *h);
147
148 /**
149 * Parse the contents of a picture timing message given an active SPS.
150 */
151 int ff_h264_sei_process_picture_timing(H264SEIPictureTiming *h, const SPS *sps,
152 void *logctx);
153
154 #endif /* AVCODEC_H264_SEI_H */
155