FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
af_bs2b.c
Go to the documentation of this file.
1 /*
2  * This file is part of FFmpeg.
3  *
4  * FFmpeg is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * FFmpeg is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with FFmpeg; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  */
18 
19 /**
20  * @file
21  * Bauer stereo-to-binaural filter
22  */
23 
24 #include <bs2b.h>
25 
27 #include "libavutil/common.h"
28 #include "libavutil/opt.h"
29 
30 #include "audio.h"
31 #include "avfilter.h"
32 #include "formats.h"
33 #include "internal.h"
34 
35 typedef struct Bs2bContext {
36  const AVClass *class;
37 
38  int profile;
39  int fcut;
40  int feed;
41 
42  t_bs2bdp bs2bp;
43 
44  void (*filter)(t_bs2bdp bs2bdp, uint8_t *sample, int n);
45 } Bs2bContext;
46 
47 #define OFFSET(x) offsetof(Bs2bContext, x)
48 #define A AV_OPT_FLAG_AUDIO_PARAM
49 
50 static const AVOption options[] = {
51  { "profile", "Apply a pre-defined crossfeed level",
52  OFFSET(profile), AV_OPT_TYPE_INT, { .i64 = BS2B_DEFAULT_CLEVEL }, 0, INT_MAX, A, "profile" },
53  { "default", "default profile", 0, AV_OPT_TYPE_CONST, { .i64 = BS2B_DEFAULT_CLEVEL }, 0, 0, A, "profile" },
54  { "cmoy", "Chu Moy circuit", 0, AV_OPT_TYPE_CONST, { .i64 = BS2B_CMOY_CLEVEL }, 0, 0, A, "profile" },
55  { "jmeier", "Jan Meier circuit", 0, AV_OPT_TYPE_CONST, { .i64 = BS2B_JMEIER_CLEVEL }, 0, 0, A, "profile" },
56  { "fcut", "Set cut frequency (in Hz)",
57  OFFSET(fcut), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, BS2B_MAXFCUT, A },
58  { "feed", "Set feed level (in Hz)",
59  OFFSET(feed), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, BS2B_MAXFEED, A },
60  { NULL },
61 };
62 
63 static const AVClass bs2b_class = {
64  .class_name = "bs2b filter",
65  .item_name = av_default_item_name,
66  .option = options,
67  .version = LIBAVUTIL_VERSION_INT,
68 };
69 
70 static av_cold int init(AVFilterContext *ctx)
71 {
72  Bs2bContext *bs2b = ctx->priv;
73 
74  if (!(bs2b->bs2bp = bs2b_open()))
75  return AVERROR(ENOMEM);
76 
77  bs2b_set_level(bs2b->bs2bp, bs2b->profile);
78 
79  if (bs2b->fcut)
80  bs2b_set_level_fcut(bs2b->bs2bp, bs2b->fcut);
81 
82  if (bs2b->feed)
83  bs2b_set_level_feed(bs2b->bs2bp, bs2b->feed);
84 
85  return 0;
86 }
87 
88 static av_cold void uninit(AVFilterContext *ctx)
89 {
90  Bs2bContext *bs2b = ctx->priv;
91 
92  if (bs2b->bs2bp)
93  bs2b_close(bs2b->bs2bp);
94 }
95 
97 {
100 
101  static const enum AVSampleFormat sample_fmts[] = {
108  };
109  int ret;
110 
111  if (ff_add_channel_layout(&layouts, AV_CH_LAYOUT_STEREO) != 0)
112  return AVERROR(ENOMEM);
113  ret = ff_set_common_channel_layouts(ctx, layouts);
114  if (ret < 0)
115  return ret;
116 
117  formats = ff_make_format_list(sample_fmts);
118  if (!formats)
119  return AVERROR(ENOMEM);
120  ret = ff_set_common_formats(ctx, formats);
121  if (ret < 0)
122  return ret;
123 
124  formats = ff_all_samplerates();
125  if (!formats)
126  return AVERROR(ENOMEM);
127  return ff_set_common_samplerates(ctx, formats);
128 }
129 
130 static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
131 {
132  int ret;
133  AVFrame *out_frame;
134 
135  Bs2bContext *bs2b = inlink->dst->priv;
136  AVFilterLink *outlink = inlink->dst->outputs[0];
137 
138  if (av_frame_is_writable(frame)) {
139  out_frame = frame;
140  } else {
141  out_frame = ff_get_audio_buffer(inlink, frame->nb_samples);
142  if (!out_frame)
143  return AVERROR(ENOMEM);
144  av_frame_copy(out_frame, frame);
145  ret = av_frame_copy_props(out_frame, frame);
146  if (ret < 0) {
147  av_frame_free(&out_frame);
148  av_frame_free(&frame);
149  return ret;
150  }
151  }
152 
153  bs2b->filter(bs2b->bs2bp, out_frame->extended_data[0], out_frame->nb_samples);
154 
155  if (frame != out_frame)
156  av_frame_free(&frame);
157 
158  return ff_filter_frame(outlink, out_frame);
159 }
160 
161 static int config_output(AVFilterLink *outlink)
162 {
163  AVFilterContext *ctx = outlink->src;
164  Bs2bContext *bs2b = ctx->priv;
165  AVFilterLink *inlink = ctx->inputs[0];
166 
167  int srate = inlink->sample_rate;
168 
169  switch (inlink->format) {
170  case AV_SAMPLE_FMT_U8:
171  bs2b->filter = bs2b_cross_feed_u8;
172  break;
173  case AV_SAMPLE_FMT_S16:
174  bs2b->filter = (void*)bs2b_cross_feed_s16;
175  break;
176  case AV_SAMPLE_FMT_S32:
177  bs2b->filter = (void*)bs2b_cross_feed_s32;
178  break;
179  case AV_SAMPLE_FMT_FLT:
180  bs2b->filter = (void*)bs2b_cross_feed_f;
181  break;
182  case AV_SAMPLE_FMT_DBL:
183  bs2b->filter = (void*)bs2b_cross_feed_d;
184  break;
185  default:
186  return AVERROR_BUG;
187  }
188 
189  if ((srate < BS2B_MINSRATE) || (srate > BS2B_MAXSRATE))
190  return AVERROR(ENOSYS);
191 
192  bs2b_set_srate(bs2b->bs2bp, srate);
193 
194  return 0;
195 }
196 
197 static const AVFilterPad bs2b_inputs[] = {
198  {
199  .name = "default",
200  .type = AVMEDIA_TYPE_AUDIO,
201  .filter_frame = filter_frame,
202  },
203  { NULL }
204 };
205 
206 static const AVFilterPad bs2b_outputs[] = {
207  {
208  .name = "default",
209  .type = AVMEDIA_TYPE_AUDIO,
210  .config_props = config_output,
211  },
212  { NULL }
213 };
214 
216  .name = "bs2b",
217  .description = NULL_IF_CONFIG_SMALL("Bauer stereo-to-binaural filter."),
218  .query_formats = query_formats,
219  .priv_size = sizeof(Bs2bContext),
220  .priv_class = &bs2b_class,
221  .init = init,
222  .uninit = uninit,
223  .inputs = bs2b_inputs,
224  .outputs = bs2b_outputs,
225 };
#define NULL
Definition: coverity.c:32
int 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:523
t_bs2bdp bs2bp
Definition: af_bs2b.c:42
This structure describes decoded (raw) audio or video data.
Definition: frame.h:171
AVOption.
Definition: opt.h:255
static const AVFilterPad outputs[]
Definition: af_ashowinfo.c:248
#define LIBAVUTIL_VERSION_INT
Definition: version.h:62
Main libavfilter public API header.
static const AVFilterPad bs2b_inputs[]
Definition: af_bs2b.c:197
static int filter_frame(AVFilterLink *inlink, AVFrame *frame)
Definition: af_bs2b.c:130
static enum AVSampleFormat formats[]
#define AV_CH_LAYOUT_STEREO
#define sample
AVFilterFormats * ff_make_format_list(const int *fmts)
Create a list of supported formats.
Definition: formats.c:283
const char * name
Pad name.
Definition: internal.h:67
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:72
AVFilterLink ** inputs
array of pointers to input links
Definition: avfilter.h:641
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1145
uint8_t
#define av_cold
Definition: attributes.h:74
AV_SAMPLE_FMT_U8
AVOptions.
static AVFrame * frame
static int query_formats(AVFilterContext *ctx)
Definition: af_bs2b.c:96
signed 32 bits
Definition: samplefmt.h:63
A filter pad used for either input or output.
Definition: internal.h:61
AVFilter ff_af_bs2b
Definition: af_bs2b.c:215
int 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:542
static const AVOption options[]
Definition: af_bs2b.c:50
int ff_add_channel_layout(AVFilterChannelLayouts **l, uint64_t channel_layout)
Definition: formats.c:329
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
int profile
Definition: mxfenc.c:1804
av_default_item_name
#define AVERROR(e)
Definition: error.h:43
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:148
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:175
void * priv
private data for use by the filter
Definition: avfilter.h:654
int av_frame_copy(AVFrame *dst, const AVFrame *src)
Copy the frame data from src to dst.
Definition: frame.c:678
int feed
Definition: af_bs2b.c:40
audio channel layout utility functions
ret
Definition: avfilter.c:974
typedef void(APIENTRY *FF_PFNGLACTIVETEXTUREPROC)(GLenum texture)
int n
Definition: avisynth_c.h:547
static const AVClass bs2b_class
Definition: af_bs2b.c:63
static int config_output(AVFilterLink *outlink)
Definition: af_bs2b.c:161
A list of supported channel layouts.
Definition: formats.h:85
int profile
Definition: af_bs2b.c:38
AVSampleFormat
Audio sample formats.
Definition: samplefmt.h:59
int av_frame_is_writable(AVFrame *frame)
Check if the frame data is writable.
Definition: frame.c:488
int fcut
Definition: af_bs2b.c:39
#define AVERROR_BUG
Internal bug, also see AVERROR_BUG2.
Definition: error.h:50
Describe the class of an AVClass context structure.
Definition: log.h:67
Filter definition.
Definition: avfilter.h:470
static const AVFilterPad inputs[]
Definition: af_ashowinfo.c:239
const char * name
Filter name.
Definition: avfilter.h:474
#define OFFSET(x)
Definition: af_bs2b.c:47
AVFilterLink ** outputs
array of pointers to output links
Definition: avfilter.h:648
enum MovChannelLayoutTag * layouts
Definition: mov_chan.c:434
AVFilterFormats * ff_all_samplerates(void)
Definition: formats.c:379
void(* filter)(t_bs2bdp bs2bdp, uint8_t *sample, int n)
Definition: af_bs2b.c:44
common internal and external API header
signed 16 bits
Definition: samplefmt.h:62
static const AVFilterPad bs2b_outputs[]
Definition: af_bs2b.c:206
A list of supported formats for one end of a filter link.
Definition: formats.h:64
static av_cold void uninit(AVFilterContext *ctx)
Definition: af_bs2b.c:88
An instance of a filter.
Definition: avfilter.h:633
static enum AVSampleFormat sample_fmts[]
Definition: adpcmenc.c:701
#define A
Definition: af_bs2b.c:48
internal API functions
uint8_t ** extended_data
pointers to the data planes/channels.
Definition: frame.h:215
static av_cold int init(AVFilterContext *ctx)
Definition: af_bs2b.c:70
int nb_samples
number of audio samples (per channel) described by this frame
Definition: frame.h:225
int ff_set_common_samplerates(AVFilterContext *ctx, AVFilterFormats *samplerates)
Definition: formats.c:530
int av_frame_copy_props(AVFrame *dst, const AVFrame *src)
Copy only "metadata" fields from src to dst.
Definition: frame.c:548