FFmpeg coverage

Directory: ../../../ffmpeg/
File: src/libavcodec/opus/parser.c
Date: 2026-07-22 00:55:30
Exec Total Coverage
Lines: 74 99 74.7%
Functions: 4 4 100.0%
Branches: 40 66 60.6%
Line Branch Exec Source
1 /*
2 * Copyright (c) 2013-2014 Mozilla Corporation
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 /**
22 * @file
23 * Opus parser
24 *
25 * Determines the duration for each packet.
26 */
27
28 #include "libavutil/mem.h"
29
30 #include "libavcodec/avcodec.h"
31 #include "libavcodec/bytestream.h"
32 #include "libavcodec/parser.h"
33 #include "libavcodec/parser_internal.h"
34
35 #include "opus.h"
36 #include "parse.h"
37
38 typedef struct OpusParserContext {
39 ParseContext pc;
40 OpusParseContext ctx;
41 OpusPacket pkt;
42 int extradata_parsed;
43 int ts_framing;
44 } OpusParserContext;
45
46 765 static const uint8_t *parse_opus_ts_header(const uint8_t *start, int *payload_len, int buf_len)
47 {
48 765 const uint8_t *buf = start + 1;
49 int start_trim_flag, end_trim_flag, control_extension_flag, control_extension_length;
50 uint8_t flags;
51 uint64_t payload_len_tmp;
52
53 GetByteContext gb;
54 765 bytestream2_init(&gb, buf, buf_len);
55
56 765 flags = bytestream2_get_byte(&gb);
57 765 start_trim_flag = (flags >> 4) & 1;
58 765 end_trim_flag = (flags >> 3) & 1;
59 765 control_extension_flag = (flags >> 2) & 1;
60
61 765 payload_len_tmp = *payload_len = 0;
62
2/2
✓ Branch 1 taken 2164 times.
✓ Branch 2 taken 765 times.
 2929 while (bytestream2_peek_byte(&gb) == 0xff)
63 2164 payload_len_tmp += bytestream2_get_byte(&gb);
64
65 765 payload_len_tmp += bytestream2_get_byte(&gb);
66
67
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 765 times.
 765 if (start_trim_flag)
68 ✗ bytestream2_skip(&gb, 2);
69
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 765 times.
 765 if (end_trim_flag)
70 ✗ bytestream2_skip(&gb, 2);
71
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 765 times.
 765 if (control_extension_flag) {
72 ✗ control_extension_length = bytestream2_get_byte(&gb);
73 ✗ bytestream2_skip(&gb, control_extension_length);
74 }
75
76
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 765 times.
 765 if (bytestream2_tell(&gb) + payload_len_tmp > buf_len)
77 ✗ return NULL;
78
79 765 *payload_len = payload_len_tmp;
80
81 765 return buf + bytestream2_tell(&gb);
82 }
83
84 22956 static int set_frame_duration(AVCodecParserContext *ctx, AVCodecContext *avctx,
85 const uint8_t *buf, int buf_size)
86 {
87 22956 OpusParserContext *s = ctx->priv_data;
88
89
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 22956 times.
 22956 if (ff_opus_parse_packet(&s->pkt, buf, buf_size, s->ctx.nb_streams > 1) < 0) {
90 ✗ av_log(avctx, AV_LOG_ERROR, "Error parsing Opus packet header.\n");
91 ✗ return AVERROR_INVALIDDATA;
92 }
93
94 22956 ctx->duration = s->pkt.frame_count * s->pkt.frame_duration;
95
96 22956 return 0;
97 }
98
99 /**
100 * Find the end of the current frame in the bitstream.
101 * @return the position of the first byte of the next frame, or -1
102 */
103 766 static int opus_find_frame_end(AVCodecParserContext *ctx, AVCodecContext *avctx,
104 const uint8_t *buf, int buf_size, int *header_len)
105 {
106 766 OpusParserContext *s = ctx->priv_data;
107 766 ParseContext *pc = &s->pc;
108 766 int ret, start_found, i = 0, payload_len = 0;
109 const uint8_t *payload;
110 uint32_t state;
111 uint16_t hdr;
112 766 *header_len = 0;
113
114
2/2
✓ Branch 0 taken 1 times.
✓ Branch 1 taken 765 times.
 766 if (!buf_size)
115 1 return 0;
116
117 765 start_found = pc->frame_start_found;
118 765 state = pc->state;
119 765 payload = buf;
120
121 /* Check if we're using Opus in MPEG-TS framing */
122
3/4
✓ Branch 0 taken 2 times.
✓ Branch 1 taken 763 times.
✓ Branch 2 taken 2 times.
✗ Branch 3 not taken.
 765 if (!s->ts_framing && buf_size > 2) {
123 2 hdr = AV_RB16(buf);
124
1/2
✓ Branch 0 taken 2 times.
✗ Branch 1 not taken.
 2 if ((hdr & OPUS_TS_MASK) == OPUS_TS_HEADER)
125 2 s->ts_framing = 1;
126 }
127
128
2/4
✓ Branch 0 taken 765 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 765 times.
✗ Branch 3 not taken.
 765 if (s->ts_framing && !start_found) {
129
1/2
✓ Branch 0 taken 1530 times.
✗ Branch 1 not taken.
 1530 for (i = 0; i < buf_size-2; i++) {
130 1530 state = (state << 8) | payload[i];
131
2/2
✓ Branch 0 taken 765 times.
✓ Branch 1 taken 765 times.
 1530 if ((state & OPUS_TS_MASK) == OPUS_TS_HEADER) {
132 765 payload = parse_opus_ts_header(payload, &payload_len, buf_size - i);
133
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 765 times.
 765 if (!payload) {
134 ✗ av_log(avctx, AV_LOG_ERROR, "Error parsing Ogg TS header.\n");
135 ✗ return AVERROR_INVALIDDATA;
136 }
137 765 *header_len = payload - buf;
138 765 start_found = 1;
139 765 break;
140 }
141 }
142 }
143
144
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 765 times.
 765 if (!s->ts_framing)
145 ✗ payload_len = buf_size;
146
147
3/6
✓ Branch 0 taken 765 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 765 times.
✗ Branch 3 not taken.
✓ Branch 4 taken 765 times.
✗ Branch 5 not taken.
 765 if (payload_len <= buf_size && (!s->ts_framing || start_found)) {
148 765 ret = set_frame_duration(ctx, avctx, payload, payload_len);
149
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 765 times.
 765 if (ret < 0) {
150 ✗ pc->frame_start_found = 0;
151 ✗ return AVERROR_INVALIDDATA;
152 }
153 }
154
155
1/2
✓ Branch 0 taken 765 times.
✗ Branch 1 not taken.
 765 if (s->ts_framing) {
156
1/2
✓ Branch 0 taken 765 times.
✗ Branch 1 not taken.
 765 if (start_found) {
157
1/2
✓ Branch 0 taken 765 times.
✗ Branch 1 not taken.
 765 if (payload_len + *header_len <= buf_size) {
158 765 pc->frame_start_found = 0;
159 765 pc->state = -1;
160 765 return payload_len + *header_len;
161 }
162 }
163
164 ✗ pc->frame_start_found = start_found;
165 ✗ pc->state = state;
166 ✗ return END_NOT_FOUND;
167 }
168
169 ✗ return buf_size;
170 }
171
172 22980 static int opus_parse(AVCodecParserContext *ctx, AVCodecContext *avctx,
173 const uint8_t **poutbuf, int *poutbuf_size,
174 const uint8_t *buf, int buf_size)
175 {
176 22980 OpusParserContext *s = ctx->priv_data;
177 22980 ParseContext *pc = &s->pc;
178 22980 int next, header_len = 0;
179
180 22980 avctx->sample_rate = 48000;
181
182
3/4
✓ Branch 0 taken 22980 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 49 times.
✓ Branch 3 taken 22931 times.
 22980 if (avctx->extradata && !s->extradata_parsed) {
183
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 49 times.
 49 if (ff_opus_parse_extradata(avctx, &s->ctx) < 0) {
184 ✗ av_log(avctx, AV_LOG_ERROR, "Error parsing Ogg extradata.\n");
185 ✗ goto fail;
186 }
187 49 av_freep(&s->ctx.channel_maps);
188 49 s->extradata_parsed = 1;
189 }
190
191
2/2
✓ Branch 0 taken 22214 times.
✓ Branch 1 taken 766 times.
 22980 if (ctx->flags & PARSER_FLAG_COMPLETE_FRAMES) {
192 22214 next = buf_size;
193
194
3/4
✓ Branch 0 taken 22191 times.
✓ Branch 1 taken 23 times.
✗ Branch 3 not taken.
✓ Branch 4 taken 22191 times.
 22214 if (buf_size && set_frame_duration(ctx, avctx, buf, buf_size) < 0)
195 ✗ goto fail;
196 } else {
197 766 next = opus_find_frame_end(ctx, avctx, buf, buf_size, &header_len);
198
199
3/6
✓ Branch 0 taken 766 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 766 times.
✗ Branch 3 not taken.
✗ Branch 4 not taken.
✓ Branch 5 taken 766 times.
 1532 if (s->ts_framing && next != AVERROR_INVALIDDATA &&
200 766 ff_combine_frame(pc, next, &buf, &buf_size) < 0) {
201 ✗ goto fail;
202 }
203
204
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 766 times.
 766 if (next == AVERROR_INVALIDDATA){
205 ✗ goto fail;
206 }
207 }
208
209 22980 *poutbuf = buf + header_len;
210 22980 *poutbuf_size = buf_size - header_len;
211 22980 return next;
212
213 ✗ fail:
214 ✗ *poutbuf = NULL;
215 ✗ *poutbuf_size = 0;
216 ✗ return buf_size;
217 }
218
219 const FFCodecParser ff_opus_parser = {
220 PARSER_CODEC_LIST(AV_CODEC_ID_OPUS),
221 .priv_data_size = sizeof(OpusParserContext),
222 .parse = opus_parse,
223 .close = ff_parse_close
224 };
225