FFmpeg 7.1.1
Loading...
Searching...
No Matches
decode_filter_audio.c
Go to the documentation of this file.
1/*
2 * Copyright (c) 2010 Nicolas George
3 * Copyright (c) 2011 Stefano Sabatini
4 * Copyright (c) 2012 Clément Bœsch
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
23 */
24
25/**
26 * @file audio decoding and filtering usage example
27 * @example decode_filter_audio.c
28 *
29 * Demux, decode and filter audio input file, generate a raw audio
30 * file to be played with ffplay.
31 */
32
33#include <unistd.h>
34
35#include <libavcodec/avcodec.h>
40#include <libavutil/mem.h>
41#include <libavutil/opt.h>
42
43static const char *filter_descr = "aresample=8000,aformat=sample_fmts=s16:channel_layouts=mono";
44static const char *player = "ffplay -f s16le -ar 8000 -ac 1 -";
45
51static int audio_stream_index = -1;
52
53static int open_input_file(const char *filename)
54{
55 const AVCodec *dec;
56 int ret;
57
58 if ((ret = avformat_open_input(&fmt_ctx, filename, NULL, NULL)) < 0) {
59 av_log(NULL, AV_LOG_ERROR, "Cannot open input file\n");
60 return ret;
61 }
62
63 if ((ret = avformat_find_stream_info(fmt_ctx, NULL)) < 0) {
64 av_log(NULL, AV_LOG_ERROR, "Cannot find stream information\n");
65 return ret;
66 }
67
68 /* select the audio stream */
69 ret = av_find_best_stream(fmt_ctx, AVMEDIA_TYPE_AUDIO, -1, -1, &dec, 0);
70 if (ret < 0) {
71 av_log(NULL, AV_LOG_ERROR, "Cannot find an audio stream in the input file\n");
72 return ret;
73 }
75
76 /* create decoding context */
78 if (!dec_ctx)
79 return AVERROR(ENOMEM);
81
82 /* init the audio decoder */
83 if ((ret = avcodec_open2(dec_ctx, dec, NULL)) < 0) {
84 av_log(NULL, AV_LOG_ERROR, "Cannot open audio decoder\n");
85 return ret;
86 }
87
88 return 0;
89}
90
91static int init_filters(const char *filters_descr)
92{
93 char args[512];
94 int ret = 0;
95 const AVFilter *abuffersrc = avfilter_get_by_name("abuffer");
96 const AVFilter *abuffersink = avfilter_get_by_name("abuffersink");
99 static const enum AVSampleFormat out_sample_fmts[] = { AV_SAMPLE_FMT_S16, -1 };
100 static const int out_sample_rates[] = { 8000, -1 };
101 const AVFilterLink *outlink;
103
105 if (!outputs || !inputs || !filter_graph) {
106 ret = AVERROR(ENOMEM);
107 goto end;
108 }
109
110 /* buffer audio source: the decoded frames from the decoder will be inserted here. */
113 ret = snprintf(args, sizeof(args),
114 "time_base=%d/%d:sample_rate=%d:sample_fmt=%s:channel_layout=",
115 time_base.num, time_base.den, dec_ctx->sample_rate,
117 av_channel_layout_describe(&dec_ctx->ch_layout, args + ret, sizeof(args) - ret);
118 ret = avfilter_graph_create_filter(&buffersrc_ctx, abuffersrc, "in",
119 args, NULL, filter_graph);
120 if (ret < 0) {
121 av_log(NULL, AV_LOG_ERROR, "Cannot create audio buffer source\n");
122 goto end;
123 }
124
125 /* buffer audio sink: to terminate the filter chain. */
126 ret = avfilter_graph_create_filter(&buffersink_ctx, abuffersink, "out",
127 NULL, NULL, filter_graph);
128 if (ret < 0) {
129 av_log(NULL, AV_LOG_ERROR, "Cannot create audio buffer sink\n");
130 goto end;
131 }
132
133 ret = av_opt_set_int_list(buffersink_ctx, "sample_fmts", out_sample_fmts, -1,
135 if (ret < 0) {
136 av_log(NULL, AV_LOG_ERROR, "Cannot set output sample format\n");
137 goto end;
138 }
139
140 ret = av_opt_set(buffersink_ctx, "ch_layouts", "mono",
142 if (ret < 0) {
143 av_log(NULL, AV_LOG_ERROR, "Cannot set output channel layout\n");
144 goto end;
145 }
146
147 ret = av_opt_set_int_list(buffersink_ctx, "sample_rates", out_sample_rates, -1,
149 if (ret < 0) {
150 av_log(NULL, AV_LOG_ERROR, "Cannot set output sample rate\n");
151 goto end;
152 }
153
154 /*
155 * Set the endpoints for the filter graph. The filter_graph will
156 * be linked to the graph described by filters_descr.
157 */
158
159 /*
160 * The buffer source output must be connected to the input pad of
161 * the first filter described by filters_descr; since the first
162 * filter input label is not specified, it is set to "in" by
163 * default.
164 */
165 outputs->name = av_strdup("in");
166 outputs->filter_ctx = buffersrc_ctx;
167 outputs->pad_idx = 0;
168 outputs->next = NULL;
169
170 /*
171 * The buffer sink input must be connected to the output pad of
172 * the last filter described by filters_descr; since the last
173 * filter output label is not specified, it is set to "out" by
174 * default.
175 */
176 inputs->name = av_strdup("out");
177 inputs->filter_ctx = buffersink_ctx;
178 inputs->pad_idx = 0;
179 inputs->next = NULL;
180
181 if ((ret = avfilter_graph_parse_ptr(filter_graph, filters_descr,
182 &inputs, &outputs, NULL)) < 0)
183 goto end;
184
185 if ((ret = avfilter_graph_config(filter_graph, NULL)) < 0)
186 goto end;
187
188 /* Print summary of the sink buffer
189 * Note: args buffer is reused to store channel layout string */
190 outlink = buffersink_ctx->inputs[0];
191 av_channel_layout_describe(&outlink->ch_layout, args, sizeof(args));
192 av_log(NULL, AV_LOG_INFO, "Output: srate:%dHz fmt:%s chlayout:%s\n",
193 (int)outlink->sample_rate,
194 (char *)av_x_if_null(av_get_sample_fmt_name(outlink->format), "?"),
195 args);
196
197end:
198 avfilter_inout_free(&inputs);
199 avfilter_inout_free(&outputs);
200
201 return ret;
202}
203
204static void print_frame(const AVFrame *frame)
205{
206 const int n = frame->nb_samples * frame->ch_layout.nb_channels;
207 const uint16_t *p = (uint16_t*)frame->data[0];
208 const uint16_t *p_end = p + n;
209
210 while (p < p_end) {
211 fputc(*p & 0xff, stdout);
212 fputc(*p>>8 & 0xff, stdout);
213 p++;
214 }
215 fflush(stdout);
216}
217
218int main(int argc, char **argv)
219{
220 int ret;
221 AVPacket *packet = av_packet_alloc();
223 AVFrame *filt_frame = av_frame_alloc();
224
225 if (!packet || !frame || !filt_frame) {
226 fprintf(stderr, "Could not allocate frame or packet\n");
227 exit(1);
228 }
229 if (argc != 2) {
230 fprintf(stderr, "Usage: %s file | %s\n", argv[0], player);
231 exit(1);
232 }
233
234 if ((ret = open_input_file(argv[1])) < 0)
235 goto end;
236 if ((ret = init_filters(filter_descr)) < 0)
237 goto end;
238
239 /* read all packets */
240 while (1) {
241 if ((ret = av_read_frame(fmt_ctx, packet)) < 0)
242 break;
243
244 if (packet->stream_index == audio_stream_index) {
245 ret = avcodec_send_packet(dec_ctx, packet);
246 if (ret < 0) {
247 av_log(NULL, AV_LOG_ERROR, "Error while sending a packet to the decoder\n");
248 break;
249 }
250
251 while (ret >= 0) {
253 if (ret == AVERROR(EAGAIN) || ret == AVERROR_EOF) {
254 break;
255 } else if (ret < 0) {
256 av_log(NULL, AV_LOG_ERROR, "Error while receiving a frame from the decoder\n");
257 goto end;
258 }
259
260 if (ret >= 0) {
261 /* push the audio data from decoded frame into the filtergraph */
263 av_log(NULL, AV_LOG_ERROR, "Error while feeding the audio filtergraph\n");
264 break;
265 }
266
267 /* pull filtered audio from the filtergraph */
268 while (1) {
269 ret = av_buffersink_get_frame(buffersink_ctx, filt_frame);
270 if (ret == AVERROR(EAGAIN) || ret == AVERROR_EOF)
271 break;
272 if (ret < 0)
273 goto end;
274 print_frame(filt_frame);
275 av_frame_unref(filt_frame);
276 }
278 }
279 }
280 }
281 av_packet_unref(packet);
282 }
283 if (ret == AVERROR_EOF) {
284 /* signal EOF to the filtergraph */
286 av_log(NULL, AV_LOG_ERROR, "Error while closing the filtergraph\n");
287 goto end;
288 }
289
290 /* pull remaining frames from the filtergraph */
291 while (1) {
292 ret = av_buffersink_get_frame(buffersink_ctx, filt_frame);
293 if (ret == AVERROR(EAGAIN) || ret == AVERROR_EOF)
294 break;
295 if (ret < 0)
296 goto end;
297 print_frame(filt_frame);
298 av_frame_unref(filt_frame);
299 }
300 }
301
302end:
306 av_packet_free(&packet);
308 av_frame_free(&filt_frame);
309
310 if (ret < 0 && ret != AVERROR_EOF) {
311 fprintf(stderr, "Error occurred: %s\n", av_err2str(ret));
312 exit(1);
313 }
314
315 exit(0);
316}
Libavcodec external API header.
Main libavformat public API header.
int main(int argc, char *argv[])
memory buffer sink API for audio and video
Memory buffer source API.
Public libavutil channel layout APIs header.
AVFilterGraph * filter_graph
static AVFormatContext * fmt_ctx
AVFilterContext * buffersink_ctx
static const char * filter_descr
static int audio_stream_index
AVFilterContext * buffersrc_ctx
static const char * player
static int open_input_file(const char *filename)
static AVCodecContext * dec_ctx
static void print_frame(const AVFrame *frame)
static AVFrame * frame
int avcodec_open2(AVCodecContext *avctx, const AVCodec *codec, AVDictionary **options)
Initialize the AVCodecContext to use the given AVCodec.
AVCodecContext * avcodec_alloc_context3(const AVCodec *codec)
Allocate an AVCodecContext and set its fields to default values.
int avcodec_parameters_to_context(AVCodecContext *codec, const struct AVCodecParameters *par)
Fill the codec context based on the values from the supplied codec parameters.
void avcodec_free_context(AVCodecContext **avctx)
Free the codec context and everything associated with it and write NULL to the provided pointer.
int avcodec_receive_frame(AVCodecContext *avctx, AVFrame *frame)
Return decoded output data from a decoder or encoder (when the AV_CODEC_FLAG_RECON_FRAME flag is used...
int avcodec_send_packet(AVCodecContext *avctx, const AVPacket *avpkt)
Supply raw packet data as input to a decoder.
void av_packet_free(AVPacket **pkt)
Free the packet, if the packet is reference counted, it will be unreferenced first.
void av_packet_unref(AVPacket *pkt)
Wipe the packet.
AVPacket * av_packet_alloc(void)
Allocate an AVPacket and set its fields to default values.
int av_read_frame(AVFormatContext *s, AVPacket *pkt)
Return the next frame of a stream.
int av_find_best_stream(AVFormatContext *ic, enum AVMediaType type, int wanted_stream_nb, int related_stream, const struct AVCodec **decoder_ret, int flags)
Find the "best" stream in the file.
int avformat_open_input(AVFormatContext **ps, const char *url, const AVInputFormat *fmt, AVDictionary **options)
Open an input stream and read the header.
int avformat_find_stream_info(AVFormatContext *ic, AVDictionary **options)
Read packets of a media file to get stream information.
void avformat_close_input(AVFormatContext **s)
Close an opened input AVFormatContext.
int av_buffersink_get_frame(AVFilterContext *ctx, AVFrame *frame)
Get a frame with filtered data from sink and put it in frame.
av_warn_unused_result int av_buffersrc_add_frame_flags(AVFilterContext *buffer_src, AVFrame *frame, int flags)
Add a frame to the buffer source.
@ AV_BUFFERSRC_FLAG_KEEP_REF
Keep a reference to the frame.
Definition buffersrc.h:53
int avfilter_graph_config(AVFilterGraph *graphctx, void *log_ctx)
Check validity and configure all the links and formats in the graph.
const AVFilter * avfilter_get_by_name(const char *name)
Get a filter definition matching the given name.
void avfilter_inout_free(AVFilterInOut **inout)
Free the supplied list of AVFilterInOut and set *inout to NULL.
int avfilter_graph_parse_ptr(AVFilterGraph *graph, const char *filters, AVFilterInOut **inputs, AVFilterInOut **outputs, void *log_ctx)
Add a graph described by a string to a graph.
void avfilter_graph_free(AVFilterGraph **graph)
Free a graph, destroy its links, and set *graph to NULL.
int avfilter_graph_create_filter(AVFilterContext **filt_ctx, const AVFilter *filt, const char *name, const char *args, void *opaque, AVFilterGraph *graph_ctx)
Create and add a filter instance into an existing graph.
AVFilterInOut * avfilter_inout_alloc(void)
Allocate a single AVFilterInOut entry.
AVFilterGraph * avfilter_graph_alloc(void)
Allocate a filter graph.
void av_channel_layout_default(AVChannelLayout *ch_layout, int nb_channels)
Get the default channel layout for a given number of channels.
int av_channel_layout_describe(const AVChannelLayout *channel_layout, char *buf, size_t buf_size)
Get a human-readable string describing the channel layout properties.
@ AV_CHANNEL_ORDER_UNSPEC
Only the channel count is specified, without any further information about the channel order.
#define AVERROR_EOF
End of file.
Definition error.h:57
#define av_err2str(errnum)
Convenience macro, the return value should be used only directly in function arguments but never stan...
Definition error.h:122
#define AVERROR(e)
Definition error.h:45
void av_frame_unref(AVFrame *frame)
Unreference all the buffers referenced by frame and reset the frame fields.
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
#define AV_LOG_INFO
Standard information.
Definition log.h:191
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition log.h:180
void av_log(void *avcl, int level, const char *fmt,...) av_printf_format(3
Send the specified message to the log if the level is less than or equal to the current av_log_level.
char * av_strdup(const char *s) av_malloc_attrib
Duplicate a string.
static void * av_x_if_null(const void *p, const void *x)
Return x default pointer in case p is NULL.
Definition avutil.h:312
@ AVMEDIA_TYPE_AUDIO
Definition avutil.h:202
const char * av_get_sample_fmt_name(enum AVSampleFormat sample_fmt)
Return the name of sample_fmt, or NULL if sample_fmt is not recognized.
AVSampleFormat
Audio sample formats.
Definition samplefmt.h:55
@ AV_SAMPLE_FMT_S16
signed 16 bits
Definition samplefmt.h:58
#define AV_OPT_SEARCH_CHILDREN
Search in possible children of the given object first.
Definition opt.h:605
int av_opt_set(void *obj, const char *name, const char *val, int search_flags)
#define av_opt_set_int_list(obj, name, val, term, flags)
Set a binary option to an integer list.
Definition opt.h:899
Memory handling functions.
AVOptions.
enum AVChannelOrder order
Channel order used in this layout.
int nb_channels
Number of channels in this layout.
main external API structure.
Definition avcodec.h:451
AVChannelLayout ch_layout
Audio channel layout.
Definition avcodec.h:1071
enum AVSampleFormat sample_fmt
audio sample format
Definition avcodec.h:1063
int sample_rate
samples per second
Definition avcodec.h:1056
AVCodec.
Definition codec.h:187
An instance of a filter.
Definition avfilter.h:457
AVFilterLink ** inputs
array of pointers to input links
Definition avfilter.h:465
A linked-list of the inputs/outputs of the filter chain.
Definition avfilter.h:903
AVFilterContext * filter_ctx
filter context associated to this input/output
Definition avfilter.h:908
int pad_idx
index of the filt_ctx pad to use for linking
Definition avfilter.h:911
char * name
unique name for this input/output in the list
Definition avfilter.h:905
struct AVFilterInOut * next
next input/input in the list, NULL if this is the last
Definition avfilter.h:914
Filter definition.
Definition avfilter.h:201
Format I/O context.
Definition avformat.h:1287
AVStream ** streams
A list of all streams in the file.
Definition avformat.h:1355
This structure describes decoded (raw) audio or video data.
Definition frame.h:389
int nb_samples
number of audio samples (per channel) described by this frame
Definition frame.h:469
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition frame.h:410
AVChannelLayout ch_layout
Channel layout of the audio data.
Definition frame.h:790
This structure stores compressed data.
Definition packet.h:516
int stream_index
Definition packet.h:541
Rational number (pair of numerator and denominator).
Definition rational.h:58
int num
Numerator.
Definition rational.h:59
int den
Denominator.
Definition rational.h:60
AVCodecParameters * codecpar
Codec parameters associated with this stream.
Definition avformat.h:771
AVRational time_base
This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented.
Definition avformat.h:787
static int init_filters(void)
Definition transcode.c:395