/* * Copyright (c) 2012 Google, Inc. * * This file is part of FFmpeg. * * FFmpeg is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * FFmpeg is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with FFmpeg; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ /** * @file * audio channel mapping filter */ #include #include "libavutil/avstring.h" #include "libavutil/channel_layout.h" #include "libavutil/common.h" #include "libavutil/mathematics.h" #include "libavutil/mem.h" #include "libavutil/opt.h" #include "libavutil/samplefmt.h" #include "audio.h" #include "avfilter.h" #include "filters.h" #include "formats.h" struct ChannelMap { int in_channel; int out_channel; int in_channel_idx; int out_channel_idx; }; enum MappingMode { MAP_NONE, MAP_ONE_INT, MAP_ONE_STR, MAP_PAIR_INT_INT, MAP_PAIR_INT_STR, MAP_PAIR_STR_INT, MAP_PAIR_STR_STR }; typedef struct ChannelMapContext { const AVClass *class; char *mapping_str; AVChannelLayout output_layout; struct ChannelMap *map; int nch; enum MappingMode mode; uint8_t **source_planes; } ChannelMapContext; #define OFFSET(x) offsetof(ChannelMapContext, x) #define A AV_OPT_FLAG_AUDIO_PARAM #define F AV_OPT_FLAG_FILTERING_PARAM static const AVOption channelmap_options[] = { { "map", "A comma-separated list of input channel numbers in output order.", OFFSET(mapping_str), AV_OPT_TYPE_STRING, .flags = A|F }, { "channel_layout", "Output channel layout.", OFFSET(output_layout), AV_OPT_TYPE_CHLAYOUT, .flags = A|F }, { NULL } }; AVFILTER_DEFINE_CLASS(channelmap); static void channelmap_uninit(AVFilterContext *ctx) { ChannelMapContext *s = ctx->priv; av_freep(&s->map); av_freep(&s->source_planes); } static char* split(char *message, char delim) { char *next = strchr(message, delim); if (next) *next++ = '\0'; return next; } static int get_channel_idx(char **map, int *ch, char delim) { char *next; int len; int n = 0; if (!*map) return AVERROR(EINVAL); next = split(*map, delim); if (!next && delim == '-') return AVERROR(EINVAL); len = strlen(*map); sscanf(*map, "%d%n", ch, &n); if (n != len) return AVERROR(EINVAL); if (*ch < 0) return AVERROR(EINVAL); *map = next; return 0; } static int get_channel(char **map, int *ch, char delim) { char *next = split(*map, delim); if (!next && delim == '-') return AVERROR(EINVAL); *ch = av_channel_from_string(*map); if (*ch < 0) return AVERROR(EINVAL); *map = next; return 0; } static int check_idx_and_id(AVFilterContext *ctx, int channel_idx, int channel, AVChannelLayout *ch_layout, const char *io) { char channel_name[64]; char layout_name[256]; int nb_channels = ch_layout->nb_channels; if (channel_idx < 0 || channel_idx >= nb_channels) { av_channel_layout_describe(ch_layout, layout_name, sizeof(layout_name)); if (channel >= 0) { av_channel_name(channel_name, sizeof(channel_name), channel); av_log(ctx, AV_LOG_ERROR, "%sput channel '%s' not available from %sput layout '%s'\n", io, channel_name, io, layout_name); } else { av_log(ctx, AV_LOG_ERROR, "%sput channel #%d not available from %sput layout '%s'\n", io, channel_idx, io, layout_name); } return AVERROR(EINVAL); } return 0; } static av_cold int channelmap_init(AVFilterContext *ctx) { ChannelMapContext *s = ctx->priv; char *mapping, separator = '|'; int map_entries = 0; enum MappingMode mode; int64_t out_ch_mask = 0; uint8_t *presence_map = NULL; int ret = 0; int i; mapping = s->mapping_str; if (!mapping) { mode = MAP_NONE; } else { char *dash = strchr(mapping, '-'); if (!dash) { // short mapping if (av_isdigit(*mapping)) mode = MAP_ONE_INT; else mode = MAP_ONE_STR; } else if (av_isdigit(*mapping)) { if (av_isdigit(*(dash+1))) mode = MAP_PAIR_INT_INT; else mode = MAP_PAIR_INT_STR; } else { if (av_isdigit(*(dash+1))) mode = MAP_PAIR_STR_INT; else mode = MAP_PAIR_STR_STR; } } if (mode != MAP_NONE) { char *sep = mapping; map_entries = 1; while ((sep = strchr(sep, separator))) { if (*++sep) // Allow trailing comma map_entries++; } s->map = av_malloc_array(map_entries, sizeof(*s->map)); if (!s->map) return AVERROR(ENOMEM); } for (i = 0; i < map_entries; i++) { int in_ch_idx = -1, out_ch_idx = -1; int in_ch = -1, out_ch = -1; static const char err[] = "Failed to parse channel map\n"; s->map[i].in_channel_idx = -1; s->map[i].out_channel_idx = -1; s->map[i].in_channel = -1; s->map[i].out_channel = -1; switch (mode) { case MAP_ONE_INT: if (get_channel_idx(&mapping, &in_ch_idx, separator) < 0) { av_log(ctx, AV_LOG_ERROR, err); return AVERROR(EINVAL); } s->map[i].in_channel_idx = in_ch_idx; s->map[i].out_channel_idx = i; break; case MAP_ONE_STR: if (get_channel(&mapping, &in_ch, separator) < 0) { av_log(ctx, AV_LOG_ERROR, err); return AVERROR(EINVAL); } s->map[i].in_channel = in_ch; s->map[i].out_channel_idx = i; break; case MAP_PAIR_INT_INT: if (get_channel_idx(&mapping, &in_ch_idx, '-') < 0 || get_channel_idx(&mapping, &out_ch_idx, separator) < 0) { av_log(ctx, AV_LOG_ERROR, err); return AVERROR(EINVAL); } s->map[i].in_channel_idx = in_ch_idx; s->map[i].out_channel_idx = out_ch_idx; break; case MAP_PAIR_INT_STR: if (get_channel_idx(&mapping, &in_ch_idx, '-') < 0 || get_channel(&mapping, &out_ch, separator) < 0) { av_log(ctx, AV_LOG_ERROR, err); return AVERROR(EINVAL); } s->map[i].in_channel_idx = in_ch_idx; s->map[i].out_channel = out_ch; if (out_ch < 63) out_ch_mask |= 1ULL << out_ch; else out_ch_mask = -1; break; case MAP_PAIR_STR_INT: if (get_channel(&mapping, &in_ch, '-') < 0 || get_channel_idx(&mapping, &out_ch_idx, separator) < 0) { av_log(ctx, AV_LOG_ERROR, err); return AVERROR(EINVAL); } s->map[i].in_channel = in_ch; s->map[i].out_channel_idx = out_ch_idx; break; case MAP_PAIR_STR_STR: if (get_channel(&mapping, &in_ch, '-') < 0 || get_channel(&mapping, &out_ch, separator) < 0) { av_log(ctx, AV_LOG_ERROR, err); return AVERROR(EINVAL); } s->map[i].in_channel = in_ch; s->map[i].out_channel = out_ch; if (out_ch < 63) out_ch_mask |= 1ULL << out_ch; else out_ch_mask = -1; break; } } s->mode = mode; s->nch = map_entries; if (s->output_layout.nb_channels == 0) { if (out_ch_mask > 0) av_channel_layout_from_mask(&s->output_layout, out_ch_mask); else if (map_entries) av_channel_layout_default(&s->output_layout, map_entries); } if (mode == MAP_NONE) { int i; s->nch = s->output_layout.nb_channels; s->map = av_malloc_array(s->nch, sizeof(*s->map)); if (!s->map) return AVERROR(ENOMEM); for (i = 0; i < s->nch; i++) { s->map[i].in_channel_idx = i; s->map[i].out_channel_idx = i; } } else if (s->nch != s->output_layout.nb_channels) { char buf[256]; av_channel_layout_describe(&s->output_layout, buf, sizeof(buf)); av_log(ctx, AV_LOG_ERROR, "Output channel layout %s does not match the number of channels mapped %d.\n", buf, s->nch); return AVERROR(EINVAL); } if (!s->output_layout.nb_channels) { av_log(ctx, AV_LOG_ERROR, "Output channel layout is not set and " "cannot be guessed from the maps.\n"); return AVERROR(EINVAL); } if (mode == MAP_PAIR_INT_STR || mode == MAP_PAIR_STR_STR) { for (i = 0; i < s->nch; i++) { s->map[i].out_channel_idx = av_channel_layout_index_from_channel( &s->output_layout, s->map[i].out_channel); } } presence_map = av_calloc(s->nch, sizeof(*presence_map)); for (i = 0; i < s->nch; i++) { const int out_idx = s->map[i].out_channel_idx; ret = check_idx_and_id(ctx, out_idx, s->map[i].out_channel, &s->output_layout, "out"); if (ret < 0) break; if (presence_map[out_idx]) { char layout_name[256]; av_channel_layout_describe(&s->output_layout, layout_name, sizeof(layout_name)); av_log(ctx, AV_LOG_ERROR, "Mapping %d assigns channel #%d twice in output layout '%s'.\n", i + 1, s->map[i].out_channel_idx, layout_name); ret = AVERROR(EINVAL); break; } presence_map[out_idx] = 1; } av_freep(&presence_map); if (ret < 0) return ret; return 0; } static int channelmap_query_formats(const AVFilterContext *ctx, AVFilterFormatsConfig **cfg_in, AVFilterFormatsConfig **cfg_out) { const ChannelMapContext *s = ctx->priv; AVFilterChannelLayouts *channel_layouts = NULL; int ret; ret = ff_set_common_formats2(ctx, cfg_in, cfg_out, ff_planar_sample_fmts()); if (ret < 0) return ret; ret = ff_add_channel_layout(&channel_layouts, &s->output_layout); if (ret < 0) return ret; ret = ff_channel_layouts_ref(channel_layouts, &cfg_out[0]->channel_layouts); if (ret < 0) return ret; return 0; } static int channelmap_filter_frame(AVFilterLink *inlink, AVFrame *buf) { AVFilterContext *ctx = inlink->dst; AVFilterLink *outlink = ctx->outputs[0]; const ChannelMapContext *s = ctx->priv; const int nch_in = inlink->ch_layout.nb_channels; const int nch_out = s->nch; int ch, ret; memcpy(s->source_planes, buf->extended_data, nch_in * sizeof(s->source_planes[0])); if (nch_out > nch_in) { if (nch_out > FF_ARRAY_ELEMS(buf->data)) { uint8_t **new_extended_data = av_calloc(nch_out, sizeof(*buf->extended_data)); if (!new_extended_data) { av_frame_free(&buf); return AVERROR(ENOMEM); } if (buf->extended_data == buf->data) { buf->extended_data = new_extended_data; } else { av_free(buf->extended_data); buf->extended_data = new_extended_data; } } else if (buf->extended_data != buf->data) { av_free(buf->extended_data); buf->extended_data = buf->data; } } for (ch = 0; ch < nch_out; ch++) { buf->extended_data[s->map[ch].out_channel_idx] = s->source_planes[s->map[ch].in_channel_idx]; } if (buf->data != buf->extended_data) memcpy(buf->data, buf->extended_data, FFMIN(FF_ARRAY_ELEMS(buf->data), nch_out) * sizeof(buf->data[0])); if ((ret = av_channel_layout_copy(&buf->ch_layout, &outlink->ch_layout)) < 0) return ret; return ff_filter_frame(outlink, buf); } static int channelmap_config_input(AVFilterLink *inlink) { AVFilterContext *ctx = inlink->dst; ChannelMapContext *s = ctx->priv; int i, err = 0; for (i = 0; i < s->nch; i++) { struct ChannelMap *m = &s->map[i]; if (s->mode == MAP_PAIR_STR_INT || s->mode == MAP_PAIR_STR_STR || s->mode == MAP_ONE_STR) { m->in_channel_idx = av_channel_layout_index_from_channel( &inlink->ch_layout, m->in_channel); } if (check_idx_and_id(ctx, m->in_channel_idx, m->in_channel, &inlink->ch_layout, "in") < 0) err = AVERROR(EINVAL); } av_freep(&s->source_planes); s->source_planes = av_calloc(inlink->ch_layout.nb_channels, sizeof(*s->source_planes)); if (!s->source_planes) return AVERROR(ENOMEM); return err; } static const AVFilterPad avfilter_af_channelmap_inputs[] = { { .name = "default", .type = AVMEDIA_TYPE_AUDIO, .flags = AVFILTERPAD_FLAG_NEEDS_WRITABLE, .filter_frame = channelmap_filter_frame, .config_props = channelmap_config_input, }, }; const AVFilter ff_af_channelmap = { .name = "channelmap", .description = NULL_IF_CONFIG_SMALL("Remap audio channels."), .init = channelmap_init, .uninit = channelmap_uninit, .priv_size = sizeof(ChannelMapContext), .priv_class = &channelmap_class, FILTER_INPUTS(avfilter_af_channelmap_inputs), FILTER_OUTPUTS(ff_audio_default_filterpad), FILTER_QUERY_FUNC2(channelmap_query_formats), };