FFmpeg coverage


Directory: ../../../ffmpeg/
File: src/libavcodec/h2645_parse.h
Date: 2024-11-20 23:03:26
Exec Total Coverage
Lines: 11 11 100.0%
Functions: 1 1 100.0%
Branches: 7 8 87.5%

Line Branch Exec Source
1 /*
2 * H.264/HEVC common parsing code
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_H2645_PARSE_H
22 #define AVCODEC_H2645_PARSE_H
23
24 #include <stdint.h>
25
26 #include "libavutil/buffer.h"
27 #include "libavutil/error.h"
28 #include "libavutil/log.h"
29 #include "codec_id.h"
30 #include "get_bits.h"
31
32 #define MAX_MBPAIR_SIZE (256*1024) // a tighter bound could be calculated if someone cares about a few bytes
33
34 typedef struct H2645NAL {
35 const uint8_t *data;
36 int size;
37
38 /**
39 * Size, in bits, of just the data, excluding the stop bit and any trailing
40 * padding. I.e. what HEVC calls SODB.
41 */
42 int size_bits;
43
44 int raw_size;
45 const uint8_t *raw_data;
46
47 GetBitContext gb;
48
49 /**
50 * NAL unit type
51 */
52 int type;
53
54 /**
55 * H.264 only, nal_ref_idc
56 */
57 int ref_idc;
58
59 /**
60 * HEVC only, nuh_temporal_id_plus_1 - 1
61 */
62 int temporal_id;
63
64 /*
65 * HEVC only, identifier of layer to which nal unit belongs
66 */
67 int nuh_layer_id;
68
69 int skipped_bytes;
70 int skipped_bytes_pos_size;
71 int *skipped_bytes_pos;
72 } H2645NAL;
73
74 typedef struct H2645RBSP {
75 uint8_t *rbsp_buffer;
76 AVBufferRef *rbsp_buffer_ref;
77 int rbsp_buffer_alloc_size;
78 int rbsp_buffer_size;
79 } H2645RBSP;
80
81 /* an input packet split into unescaped NAL units */
82 typedef struct H2645Packet {
83 H2645NAL *nals;
84 H2645RBSP rbsp;
85 int nb_nals;
86 int nals_allocated;
87 unsigned nal_buffer_size;
88 } H2645Packet;
89
90 /**
91 * Extract the raw (unescaped) bitstream.
92 */
93 int ff_h2645_extract_rbsp(const uint8_t *src, int length, H2645RBSP *rbsp,
94 H2645NAL *nal, int small_padding);
95
96 enum {
97 H2645_FLAG_IS_NALFF = (1 << 0),
98 H2645_FLAG_SMALL_PADDING = (1 << 1),
99 H2645_FLAG_USE_REF = (1 << 2),
100 };
101
102 /**
103 * Split an input packet into NAL units.
104 *
105 * If data == raw_data holds true for a NAL unit of the returned pkt, then
106 * said NAL unit does not contain any emulation_prevention_three_byte and
107 * the data is contained in the input buffer pointed to by buf.
108 * Otherwise, the unescaped data is part of the rbsp_buffer described by the
109 * packet's H2645RBSP.
110 *
111 * If the packet's rbsp_buffer_ref is not NULL, the underlying AVBuffer must
112 * own rbsp_buffer. If not and rbsp_buffer is not NULL, H2645_FLAG_USE_REF
113 * must not be set in flags.
114 * If H2645_FLAG_USE_REF is set in flags, rbsp_buffer will be reference-counted
115 * and owned by the underlying AVBuffer of rbsp_buffer_ref.
116 */
117 int ff_h2645_packet_split(H2645Packet *pkt, const uint8_t *buf, int length,
118 void *logctx, int nal_length_size,
119 enum AVCodecID codec_id, int flags);
120
121 /**
122 * Free all the allocated memory in the packet.
123 */
124 void ff_h2645_packet_uninit(H2645Packet *pkt);
125
126 19851 static inline int get_nalsize(int nal_length_size, const uint8_t *buf,
127 int buf_size, int *buf_index, void *logctx)
128 {
129 19851 int i, nalsize = 0;
130
131
2/2
✓ Branch 0 taken 331 times.
✓ Branch 1 taken 19520 times.
19851 if (*buf_index >= buf_size - nal_length_size) {
132 // the end of the buffer is reached, refill it
133 331 return AVERROR_INVALIDDATA;
134 }
135
136
2/2
✓ Branch 0 taken 76132 times.
✓ Branch 1 taken 19520 times.
95652 for (i = 0; i < nal_length_size; i++)
137 76132 nalsize = ((unsigned)nalsize << 8) | buf[(*buf_index)++];
138
3/4
✓ Branch 0 taken 19520 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 2 times.
✓ Branch 3 taken 19518 times.
19520 if (nalsize <= 0 || nalsize > buf_size - *buf_index) {
139 2 av_log(logctx, AV_LOG_ERROR,
140 2 "Invalid NAL unit size (%d > %d).\n", nalsize, buf_size - *buf_index);
141 2 return AVERROR_INVALIDDATA;
142 }
143 19518 return nalsize;
144 }
145
146 #endif /* AVCODEC_H2645_PARSE_H */
147