FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
af_channelsplit.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  * Channel split filter
22  *
23  * Split an audio stream into per-channel streams.
24  */
25 
26 #include "libavutil/attributes.h"
28 #include "libavutil/internal.h"
29 #include "libavutil/opt.h"
30 
31 #include "audio.h"
32 #include "avfilter.h"
33 #include "formats.h"
34 #include "internal.h"
35 
36 typedef struct ChannelSplitContext {
37  const AVClass *class;
38 
39  uint64_t channel_layout;
42 
43 #define OFFSET(x) offsetof(ChannelSplitContext, x)
44 #define A AV_OPT_FLAG_AUDIO_PARAM
45 #define F AV_OPT_FLAG_FILTERING_PARAM
46 static const AVOption channelsplit_options[] = {
47  { "channel_layout", "Input channel layout.", OFFSET(channel_layout_str), AV_OPT_TYPE_STRING, { .str = "stereo" }, .flags = A|F },
48  { NULL }
49 };
50 
51 AVFILTER_DEFINE_CLASS(channelsplit);
52 
53 static av_cold int init(AVFilterContext *ctx)
54 {
55  ChannelSplitContext *s = ctx->priv;
56  int nb_channels;
57  int ret = 0, i;
58 
60  av_log(ctx, AV_LOG_ERROR, "Error parsing channel layout '%s'.\n",
62  ret = AVERROR(EINVAL);
63  goto fail;
64  }
65 
67  for (i = 0; i < nb_channels; i++) {
68  uint64_t channel = av_channel_layout_extract_channel(s->channel_layout, i);
69  AVFilterPad pad = { 0 };
70 
72  pad.name = av_get_channel_name(channel);
73 
74  ff_insert_outpad(ctx, i, &pad);
75  }
76 
77 fail:
78  return ret;
79 }
80 
82 {
83  ChannelSplitContext *s = ctx->priv;
84  AVFilterChannelLayouts *in_layouts = NULL;
85  int i;
86 
89 
90  ff_add_channel_layout(&in_layouts, s->channel_layout);
91  ff_channel_layouts_ref(in_layouts, &ctx->inputs[0]->out_channel_layouts);
92 
93  for (i = 0; i < ctx->nb_outputs; i++) {
94  AVFilterChannelLayouts *out_layouts = NULL;
95  uint64_t channel = av_channel_layout_extract_channel(s->channel_layout, i);
96 
97  ff_add_channel_layout(&out_layouts, channel);
98  ff_channel_layouts_ref(out_layouts, &ctx->outputs[i]->in_channel_layouts);
99  }
100 
101  return 0;
102 }
103 
104 static int filter_frame(AVFilterLink *inlink, AVFrame *buf)
105 {
106  AVFilterContext *ctx = inlink->dst;
107  int i, ret = 0;
108 
109  for (i = 0; i < ctx->nb_outputs; i++) {
110  AVFrame *buf_out = av_frame_clone(buf);
111 
112  if (!buf_out) {
113  ret = AVERROR(ENOMEM);
114  break;
115  }
116 
117  buf_out->data[0] = buf_out->extended_data[0] = buf_out->extended_data[i];
118  buf_out->channel_layout =
120  av_frame_set_channels(buf_out, 1);
121 
122  ret = ff_filter_frame(ctx->outputs[i], buf_out);
123  if (ret < 0)
124  break;
125  }
126  av_frame_free(&buf);
127  return ret;
128 }
129 
131  {
132  .name = "default",
133  .type = AVMEDIA_TYPE_AUDIO,
134  .filter_frame = filter_frame,
135  },
136  { NULL }
137 };
138 
140  .name = "channelsplit",
141  .description = NULL_IF_CONFIG_SMALL("Split audio into per-channel streams."),
142  .priv_size = sizeof(ChannelSplitContext),
143  .priv_class = &channelsplit_class,
144  .init = init,
146  .inputs = avfilter_af_channelsplit_inputs,
147  .outputs = NULL,
149 };
void av_frame_set_channels(AVFrame *frame, int val)
#define NULL
Definition: coverity.c:32
const char * s
Definition: avisynth_c.h:631
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
Main libavfilter public API header.
enum AVMediaType type
AVFilterPad type.
Definition: internal.h:74
Macro definitions for various function/variable attributes.
int av_get_channel_layout_nb_channels(uint64_t channel_layout)
Return the number of channels in the channel layout.
const char * name
Pad name.
Definition: internal.h:69
uint64_t av_get_channel_layout(const char *name)
Return a channel layout id that matches name, or 0 if no match is found.
AVFilterLink ** inputs
array of pointers to input links
Definition: avfilter.h:641
int ff_channel_layouts_ref(AVFilterChannelLayouts *f, AVFilterChannelLayouts **ref)
Add *ref as a new reference to f.
Definition: formats.c:417
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
Definition: avfilter.c:1158
#define F
#define av_cold
Definition: attributes.h:74
#define A
AVOptions.
#define AVFILTER_FLAG_DYNAMIC_OUTPUTS
The number of the filter outputs is not determined just by AVFilter.outputs.
Definition: avfilter.h:437
#define av_log(a,...)
A filter pad used for either input or output.
Definition: internal.h:63
AVFILTER_DEFINE_CLASS(channelsplit)
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
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
int ff_add_channel_layout(AVFilterChannelLayouts **l, uint64_t channel_layout)
Definition: formats.c:329
#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
unsigned nb_outputs
number of output pads
Definition: avfilter.h:652
#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
static const AVFilterPad avfilter_af_channelsplit_inputs[]
#define fail()
Definition: checkasm.h:57
uint64_t channel_layout
Channel layout of the audio data.
Definition: frame.h:427
common internal API header
#define OFFSET(x)
audio channel layout utility functions
AVFilterFormats * ff_planar_sample_fmts(void)
Construct a formats list containing all planar sample formats.
Definition: formats.c:367
AVFrame * av_frame_clone(const AVFrame *src)
Create a new frame that references the same data as src.
Definition: frame.c:451
A list of supported channel layouts.
Definition: formats.h:85
static int filter_frame(AVFilterLink *inlink, AVFrame *buf)
static const AVOption channelsplit_options[]
void * buf
Definition: avisynth_c.h:553
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
static av_cold int init(AVFilterContext *ctx)
AVFilterLink ** outputs
array of pointers to output links
Definition: avfilter.h:648
AVFilterFormats * ff_all_samplerates(void)
Definition: formats.c:379
static int flags
Definition: cpu.c:47
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:182
uint64_t av_channel_layout_extract_channel(uint64_t channel_layout, int index)
Get the channel with the given index in channel_layout.
const char * av_get_channel_name(uint64_t channel)
Get the name of a given channel.
static int query_formats(AVFilterContext *ctx)
AVFilter ff_af_channelsplit
An instance of a filter.
Definition: avfilter.h:633
int nb_channels
internal API functions
uint8_t ** extended_data
pointers to the data planes/channels.
Definition: frame.h:215
static int ff_insert_outpad(AVFilterContext *f, unsigned index, AVFilterPad *p)
Insert a new output pad for the filter.
Definition: internal.h:285
int ff_set_common_samplerates(AVFilterContext *ctx, AVFilterFormats *samplerates)
Definition: formats.c:530