FFmpeg
parser.c
Go to the documentation of this file.
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"
34 
35 #include "opus.h"
36 #include "parse.h"
37 
38 typedef struct OpusParserContext {
45 
46 static const uint8_t *parse_opus_ts_header(const uint8_t *start, int *payload_len, int buf_len)
47 {
48  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  bytestream2_init(&gb, buf, buf_len);
55 
56  flags = bytestream2_get_byte(&gb);
57  start_trim_flag = (flags >> 4) & 1;
58  end_trim_flag = (flags >> 3) & 1;
59  control_extension_flag = (flags >> 2) & 1;
60 
61  payload_len_tmp = *payload_len = 0;
62  while (bytestream2_peek_byte(&gb) == 0xff)
63  payload_len_tmp += bytestream2_get_byte(&gb);
64 
65  payload_len_tmp += bytestream2_get_byte(&gb);
66 
67  if (start_trim_flag)
68  bytestream2_skip(&gb, 2);
69  if (end_trim_flag)
70  bytestream2_skip(&gb, 2);
71  if (control_extension_flag) {
72  control_extension_length = bytestream2_get_byte(&gb);
73  bytestream2_skip(&gb, control_extension_length);
74  }
75 
76  if (bytestream2_tell(&gb) + payload_len_tmp > buf_len)
77  return NULL;
78 
79  *payload_len = payload_len_tmp;
80 
81  return buf + bytestream2_tell(&gb);
82 }
83 
85  const uint8_t *buf, int buf_size)
86 {
88 
89  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  ctx->duration = s->pkt.frame_count * s->pkt.frame_duration;
95 
96  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  */
104  const uint8_t *buf, int buf_size, int *header_len)
105 {
107  ParseContext *pc = &s->pc;
108  int ret, start_found, i = 0, payload_len = 0;
109  const uint8_t *payload;
110  uint32_t state;
111  uint16_t hdr;
112  *header_len = 0;
113 
114  if (!buf_size)
115  return 0;
116 
117  start_found = pc->frame_start_found;
118  state = pc->state;
119  payload = buf;
120 
121  /* Check if we're using Opus in MPEG-TS framing */
122  if (!s->ts_framing && buf_size > 2) {
123  hdr = AV_RB16(buf);
124  if ((hdr & OPUS_TS_MASK) == OPUS_TS_HEADER)
125  s->ts_framing = 1;
126  }
127 
128  if (s->ts_framing && !start_found) {
129  for (i = 0; i < buf_size-2; i++) {
130  state = (state << 8) | payload[i];
131  if ((state & OPUS_TS_MASK) == OPUS_TS_HEADER) {
132  payload = parse_opus_ts_header(payload, &payload_len, buf_size - i);
133  if (!payload) {
134  av_log(avctx, AV_LOG_ERROR, "Error parsing Ogg TS header.\n");
135  return AVERROR_INVALIDDATA;
136  }
137  *header_len = payload - buf;
138  start_found = 1;
139  break;
140  }
141  }
142  }
143 
144  if (!s->ts_framing)
145  payload_len = buf_size;
146 
147  if (payload_len <= buf_size && (!s->ts_framing || start_found)) {
148  ret = set_frame_duration(ctx, avctx, payload, payload_len);
149  if (ret < 0) {
150  pc->frame_start_found = 0;
151  return AVERROR_INVALIDDATA;
152  }
153  }
154 
155  if (s->ts_framing) {
156  if (start_found) {
157  if (payload_len + *header_len <= buf_size) {
158  pc->frame_start_found = 0;
159  pc->state = -1;
160  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 
173  const uint8_t **poutbuf, int *poutbuf_size,
174  const uint8_t *buf, int buf_size)
175 {
177  ParseContext *pc = &s->pc;
178  int next, header_len = 0;
179 
180  avctx->sample_rate = 48000;
181 
182  if (avctx->extradata && !s->extradata_parsed) {
183  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  av_freep(&s->ctx.channel_maps);
188  s->extradata_parsed = 1;
189  }
190 
192  next = buf_size;
193 
194  if (buf_size && set_frame_duration(ctx, avctx, buf, buf_size) < 0)
195  goto fail;
196  } else {
197  next = opus_find_frame_end(ctx, avctx, buf, buf_size, &header_len);
198 
199  if (s->ts_framing && next != AVERROR_INVALIDDATA &&
200  ff_combine_frame(pc, next, &buf, &buf_size) < 0) {
201  goto fail;
202  }
203 
204  if (next == AVERROR_INVALIDDATA){
205  goto fail;
206  }
207  }
208 
209  *poutbuf = buf + header_len;
210  *poutbuf_size = buf_size - header_len;
211  return next;
212 
213 fail:
214  *poutbuf = NULL;
215  *poutbuf_size = 0;
216  return buf_size;
217 }
218 
221  .priv_data_size = sizeof(OpusParserContext),
222  .parse = opus_parse,
224 };
flags
const SwsFlags flags[]
Definition: swscale.c:85
OpusParserContext::extradata_parsed
int extradata_parsed
Definition: parser.c:42
state
static struct @590 state
AVCodecContext::sample_rate
int sample_rate
samples per second
Definition: avcodec.h:1040
OPUS_TS_MASK
#define OPUS_TS_MASK
Definition: opus.h:33
GetByteContext
Definition: bytestream.h:33
bytestream2_tell
static av_always_inline int bytestream2_tell(const GetByteContext *g)
Definition: bytestream.h:192
ff_parse_close
av_cold void ff_parse_close(AVCodecParserContext *s)
Definition: parser.c:304
parser_internal.h
parse_opus_ts_header
static const uint8_t * parse_opus_ts_header(const uint8_t *start, int *payload_len, int buf_len)
Definition: parser.c:46
opus.h
OpusParserContext
Definition: parser.c:38
OpusParserContext::ts_framing
int ts_framing
Definition: parser.c:43
ParseContext::state
uint32_t state
contains the last few bytes in MSB order
Definition: parser.h:33
close
static av_cold void close(AVCodecParserContext *s)
Definition: apv_parser.c:197
bytestream2_skip
static av_always_inline void bytestream2_skip(GetByteContext *g, unsigned int size)
Definition: bytestream.h:168
ParseContext
Definition: parser.h:28
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:210
parse.h
s
#define s(width, name)
Definition: cbs_vp9.c:198
AVFormatContext::flags
int flags
Flags modifying the (de)muxer behaviour.
Definition: avformat.h:1465
ff_opus_parse_extradata
av_cold int ff_opus_parse_extradata(AVCodecContext *avctx, OpusParseContext *s)
Definition: parse.c:286
ctx
static AVFormatContext * ctx
Definition: movenc.c:49
OpusParserContext::ctx
OpusParseContext ctx
Definition: parser.c:40
ff_opus_parser
const FFCodecParser ff_opus_parser
Definition: parser.c:219
OpusParserContext::pc
ParseContext pc
Definition: parser.c:39
fail
#define fail
Definition: test.h:478
set_frame_duration
static int set_frame_duration(AVCodecParserContext *ctx, AVCodecContext *avctx, const uint8_t *buf, int buf_size)
Definition: parser.c:84
NULL
#define NULL
Definition: coverity.c:32
OPUS_TS_HEADER
#define OPUS_TS_HEADER
Definition: opus.h:32
ParseContext::frame_start_found
int frame_start_found
Definition: parser.h:34
OpusParseContext
Definition: parse.h:63
OpusParserContext::pkt
OpusPacket pkt
Definition: parser.c:41
parse
static int parse(AVCodecParserContext *s, AVCodecContext *avctx, const uint8_t **poutbuf, int *poutbuf_size, const uint8_t *buf, int buf_size)
Definition: apv_parser.c:92
i
#define i(width, name, range_min, range_max)
Definition: cbs_h264.c:63
AV_CODEC_ID_OPUS
@ AV_CODEC_ID_OPUS
Definition: codec_id.h:521
opus_parse
static int opus_parse(AVCodecParserContext *ctx, AVCodecContext *avctx, const uint8_t **poutbuf, int *poutbuf_size, const uint8_t *buf, int buf_size)
Definition: parser.c:172
ff_combine_frame
int ff_combine_frame(ParseContext *pc, int next, const uint8_t **buf, int *buf_size)
Combine the (truncated) bitstream to a complete frame.
Definition: parser.c:217
FFCodecParser
Definition: parser_internal.h:29
PARSER_FLAG_COMPLETE_FRAMES
#define PARSER_FLAG_COMPLETE_FRAMES
Definition: avcodec.h:2638
opus_find_frame_end
static int opus_find_frame_end(AVCodecParserContext *ctx, AVCodecContext *avctx, const uint8_t *buf, int buf_size, int *header_len)
Find the end of the current frame in the bitstream.
Definition: parser.c:103
AVCodecContext::extradata
uint8_t * extradata
Out-of-band global headers that may be used by some codecs.
Definition: avcodec.h:526
parser.h
PARSER_CODEC_LIST
#define PARSER_CODEC_LIST(...)
Definition: parser_internal.h:76
avcodec.h
AVCodecParserContext
Definition: avcodec.h:2604
ret
ret
Definition: filter_design.txt:187
AVCodecContext
main external API structure.
Definition: avcodec.h:443
OpusPacket
Definition: parse.h:31
AVFormatContext::duration
int64_t duration
Duration of the stream, in AV_TIME_BASE fractional seconds.
Definition: avformat.h:1449
mem.h
END_NOT_FOUND
#define END_NOT_FOUND
Definition: parser.h:40
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:35
bytestream.h
bytestream2_init
static av_always_inline void bytestream2_init(GetByteContext *g, const uint8_t *buf, int buf_size)
Definition: bytestream.h:137
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:61
ff_opus_parse_packet
int ff_opus_parse_packet(OpusPacket *pkt, const uint8_t *buf, int buf_size, int self_delimiting)
Parse Opus packet info from raw packet data.
Definition: parse.c:85
AVFormatContext::priv_data
void * priv_data
Format private data.
Definition: avformat.h:1342
AV_RB16
uint64_t_TMPL AV_WL64 unsigned int_TMPL AV_WL32 unsigned int_TMPL AV_WL24 unsigned int_TMPL AV_WL16 uint64_t_TMPL AV_WB64 unsigned int_TMPL AV_WB32 unsigned int_TMPL AV_WB24 unsigned int_TMPL AV_RB16
Definition: bytestream.h:98