FFmpeg  2.1.1
asrc_anullsrc.c
Go to the documentation of this file.
1 /*
2  * Copyright 2010 S.N. Hemanth Meenakshisundaram <smeenaks ucsd edu>
3  * Copyright 2010 Stefano Sabatini <stefano.sabatini-lala poste it>
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * FFmpeg is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with FFmpeg; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21 
22 /**
23  * @file
24  * null audio source
25  */
26 
27 #include <inttypes.h>
28 #include <stdio.h>
29 
30 #include "libavutil/channel_layout.h"
31 #include "libavutil/internal.h"
32 #include "libavutil/opt.h"
33 #include "audio.h"
34 #include "avfilter.h"
35 #include "internal.h"
36 
37 typedef struct {
38  const AVClass *class;
40  uint64_t channel_layout;
43  int nb_samples; ///< number of samples per requested frame
44  int64_t pts;
45 } ANullContext;
46 
47 #define OFFSET(x) offsetof(ANullContext, x)
48 #define FLAGS AV_OPT_FLAG_AUDIO_PARAM|AV_OPT_FLAG_FILTERING_PARAM
49 
50 static const AVOption anullsrc_options[]= {
51  { "channel_layout", "set channel_layout", OFFSET(channel_layout_str), AV_OPT_TYPE_STRING, {.str = "stereo"}, 0, 0, FLAGS },
52  { "cl", "set channel_layout", OFFSET(channel_layout_str), AV_OPT_TYPE_STRING, {.str = "stereo"}, 0, 0, FLAGS },
53  { "sample_rate", "set sample rate", OFFSET(sample_rate_str) , AV_OPT_TYPE_STRING, {.str = "44100"}, 0, 0, FLAGS },
54  { "r", "set sample rate", OFFSET(sample_rate_str) , AV_OPT_TYPE_STRING, {.str = "44100"}, 0, 0, FLAGS },
55  { "nb_samples", "set the number of samples per requested frame", OFFSET(nb_samples), AV_OPT_TYPE_INT, {.i64 = 1024}, 0, INT_MAX, FLAGS },
56  { "n", "set the number of samples per requested frame", OFFSET(nb_samples), AV_OPT_TYPE_INT, {.i64 = 1024}, 0, INT_MAX, FLAGS },
57  { NULL }
58 };
59 
60 AVFILTER_DEFINE_CLASS(anullsrc);
61 
62 static av_cold int init(AVFilterContext *ctx)
63 {
64  ANullContext *null = ctx->priv;
65  int ret;
66 
67  if ((ret = ff_parse_sample_rate(&null->sample_rate,
68  null->sample_rate_str, ctx)) < 0)
69  return ret;
70 
71  if ((ret = ff_parse_channel_layout(&null->channel_layout,
72  null->channel_layout_str, ctx)) < 0)
73  return ret;
74 
75  return 0;
76 }
77 
79 {
80  ANullContext *null = ctx->priv;
81  int64_t chlayouts[] = { null->channel_layout, -1 };
82  int sample_rates[] = { null->sample_rate, -1 };
83 
87 
88  return 0;
89 }
90 
91 static int config_props(AVFilterLink *outlink)
92 {
93  ANullContext *null = outlink->src->priv;
94  char buf[128];
95 
96  av_get_channel_layout_string(buf, sizeof(buf), 0, null->channel_layout);
97  av_log(outlink->src, AV_LOG_VERBOSE,
98  "sample_rate:%d channel_layout:'%s' nb_samples:%d\n",
99  null->sample_rate, buf, null->nb_samples);
100 
101  return 0;
102 }
103 
104 static int request_frame(AVFilterLink *outlink)
105 {
106  int ret;
107  ANullContext *null = outlink->src->priv;
108  AVFrame *samplesref;
109 
110  samplesref = ff_get_audio_buffer(outlink, null->nb_samples);
111  if (!samplesref)
112  return AVERROR(ENOMEM);
113 
114  samplesref->pts = null->pts;
115  samplesref->channel_layout = null->channel_layout;
116  samplesref->sample_rate = outlink->sample_rate;
117 
118  ret = ff_filter_frame(outlink, av_frame_clone(samplesref));
119  av_frame_free(&samplesref);
120  if (ret < 0)
121  return ret;
122 
123  null->pts += null->nb_samples;
124  return ret;
125 }
126 
128  {
129  .name = "default",
130  .type = AVMEDIA_TYPE_AUDIO,
131  .config_props = config_props,
132  .request_frame = request_frame,
133  },
134  { NULL }
135 };
136 
138  .name = "anullsrc",
139  .description = NULL_IF_CONFIG_SMALL("Null audio source, return empty audio frames."),
140  .init = init,
141  .query_formats = query_formats,
142  .priv_size = sizeof(ANullContext),
143  .inputs = NULL,
144  .outputs = avfilter_asrc_anullsrc_outputs,
145  .priv_class = &anullsrc_class,
146 };
AVFilter avfilter_asrc_anullsrc
This structure describes decoded (raw) audio or video data.
Definition: frame.h:96
AVOption.
Definition: opt.h:253
const char * name
Filter name.
Definition: avfilter.h:468
char * channel_layout_str
Definition: asrc_anullsrc.c:39
void * priv
private data for use by the filter
Definition: avfilter.h:648
static const AVFilterPad outputs[]
Definition: af_ashowinfo.c:111
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...
#define OFFSET(x)
Definition: asrc_anullsrc.c:47
#define av_cold
Definition: avcodec.h:653
AVFilterFormats * ff_make_format_list(const int *fmts)
Create a list of supported formats.
Definition: formats.c:294
const char * name
Pad name.
Definition: internal.h:66
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1118
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
Definition: frame.h:182
#define AV_LOG_VERBOSE
Detailed information.
Definition: avcodec.h:4163
void ff_set_common_formats(AVFilterContext *ctx, AVFilterFormats *formats)
A helper for query_formats() which sets all links to the same list of formats.
Definition: formats.c:531
static int config_props(AVFilterLink *outlink)
Definition: asrc_anullsrc.c:91
AVFilterFormats * ff_all_formats(enum AVMediaType type)
Return a list of all formats supported by FFmpeg for the given media type.
Definition: formats.c:343
A filter pad used for either input or output.
Definition: internal.h:60
AVFrame * ff_get_audio_buffer(AVFilterLink *link, int nb_samples)
Request an audio samples buffer with a specific set of permissions.
Definition: audio.c:70
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:151
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:123
int nb_samples
number of samples per requested frame
Definition: asrc_anullsrc.c:43
static const int sample_rates[]
Definition: dcaenc.h:32
uint64_t channel_layout
Channel layout of the audio data.
Definition: frame.h:354
common internal API header
ret
Definition: avfilter.c:961
Main libavfilter public API header.
#define FLAGS
Definition: asrc_anullsrc.c:48
AVFilterChannelLayouts * avfilter_make_format64_list(const int64_t *fmts)
Definition: formats.c:303
static const AVFilterPad avfilter_asrc_anullsrc_outputs[]
static int query_formats(AVFilterContext *ctx)
Definition: asrc_anullsrc.c:78
uint64_t channel_layout
Definition: asrc_anullsrc.c:40
void * buf
Definition: avisynth_c.h:594
Describe the class of an AVClass context structure.
Definition: log.h:50
int sample_rate
Sample rate of the audio data.
Definition: frame.h:349
Filter definition.
Definition: avfilter.h:464
static const AVFilterPad inputs[]
Definition: af_ashowinfo.c:102
static const AVOption anullsrc_options[]
Definition: asrc_anullsrc.c:50
static int request_frame(AVFilterLink *outlink)
AVFrame * av_frame_clone(AVFrame *src)
Create a new frame that references the same data as src.
Definition: frame.c:338
void ff_set_common_samplerates(AVFilterContext *ctx, AVFilterFormats *samplerates)
Definition: formats.c:519
int ff_parse_channel_layout(int64_t *ret, const char *arg, void *log_ctx)
Parse a channel layout or a corresponding integer representation.
Definition: formats.c:618
int ff_parse_sample_rate(int *ret, const char *arg, void *log_ctx)
Parse a sample rate.
Definition: formats.c:606
#define AVFILTER_DEFINE_CLASS(fname)
Definition: internal.h:301
static av_cold int init(AVFilterContext *ctx)
Definition: asrc_anullsrc.c:62
#define AVERROR(e)
An instance of a filter.
Definition: avfilter.h:627
void ff_set_common_channel_layouts(AVFilterContext *ctx, AVFilterChannelLayouts *layouts)
A helper for query_formats() which sets all links to the same list of channel layouts/sample rates...
Definition: formats.c:512
internal API functions
void av_get_channel_layout_string(char *buf, int buf_size, int nb_channels, uint64_t channel_layout)
Return a description of a channel layout.
char * sample_rate_str
Definition: asrc_anullsrc.c:41