FFmpeg
Data Structures | Macros | Functions | Variables
af_join.c File Reference

Audio join filter. More...

#include "libavutil/avassert.h"
#include "libavutil/avstring.h"
#include "libavutil/channel_layout.h"
#include "libavutil/common.h"
#include "libavutil/opt.h"
#include "audio.h"
#include "avfilter.h"
#include "formats.h"
#include "filters.h"
#include "internal.h"

Go to the source code of this file.

Data Structures

struct  ChannelMap
 
struct  JoinContext
 

Macros

#define OFFSET(x)   offsetof(JoinContext, x)
 
#define A   AV_OPT_FLAG_AUDIO_PARAM
 
#define F   AV_OPT_FLAG_FILTERING_PARAM
 
#define PARSE_CHANNEL(str, var, inout)
 

Functions

 AVFILTER_DEFINE_CLASS (join)
 
static int parse_maps (AVFilterContext *ctx)
 
static av_cold int join_init (AVFilterContext *ctx)
 
static av_cold void join_uninit (AVFilterContext *ctx)
 
static int join_query_formats (AVFilterContext *ctx)
 
static void guess_map_matching (AVFilterContext *ctx, ChannelMap *ch, uint64_t *inputs)
 
static void guess_map_any (AVFilterContext *ctx, ChannelMap *ch, uint64_t *inputs)
 
static int join_config_output (AVFilterLink *outlink)
 
static int try_push_frame (AVFilterContext *ctx)
 
static int activate (AVFilterContext *ctx)
 

Variables

static const AVOption join_options []
 
static const AVFilterPad avfilter_af_join_outputs []
 
AVFilter ff_af_join
 

Detailed Description

Audio join filter.

Join multiple audio inputs as different channels in a single output

Definition in file af_join.c.

Macro Definition Documentation

#define OFFSET (   x)    offsetof(JoinContext, x)

Definition at line 68 of file af_join.c.

#define A   AV_OPT_FLAG_AUDIO_PARAM

Definition at line 69 of file af_join.c.

Definition at line 70 of file af_join.c.

#define PARSE_CHANNEL (   str,
  var,
  inout 
)
Value:
if (!(var = av_get_channel_layout(str))) { \
av_log(ctx, AV_LOG_ERROR, "Invalid " inout " channel: %s.\n", str);\
return AVERROR(EINVAL); \
} \
av_log(ctx, AV_LOG_ERROR, "Channel map describes more than one " \
inout " channel.\n"); \
return AVERROR(EINVAL); \
}
int av_get_channel_layout_nb_channels(uint64_t channel_layout)
Return the number of channels in the channel layout.
uint64_t av_get_channel_layout(const char *name)
Return a channel layout id that matches name, or 0 if no match is found.
#define av_log(a,...)
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
AVFormatContext * ctx
Definition: movenc.c:48
if(ret)
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a it should return
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later.That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another.Frame references ownership and permissions

Referenced by parse_maps().

Function Documentation

AVFILTER_DEFINE_CLASS ( join  )
static int parse_maps ( AVFilterContext ctx)
static

Definition at line 83 of file af_join.c.

Referenced by join_init().

static av_cold int join_init ( AVFilterContext ctx)
static

Definition at line 162 of file af_join.c.

static av_cold void join_uninit ( AVFilterContext ctx)
static

Definition at line 205 of file af_join.c.

static int join_query_formats ( AVFilterContext ctx)
static

Definition at line 220 of file af_join.c.

static void guess_map_matching ( AVFilterContext ctx,
ChannelMap ch,
uint64_t *  inputs 
)
static

Definition at line 243 of file af_join.c.

Referenced by join_config_output().

static void guess_map_any ( AVFilterContext ctx,
ChannelMap ch,
uint64_t *  inputs 
)
static

Definition at line 261 of file af_join.c.

Referenced by join_config_output().

static int join_config_output ( AVFilterLink outlink)
static

Definition at line 280 of file af_join.c.

static int try_push_frame ( AVFilterContext ctx)
static

Definition at line 362 of file af_join.c.

Referenced by activate().

static int activate ( AVFilterContext ctx)
static

Definition at line 467 of file af_join.c.

Variable Documentation

const AVOption join_options[]
static
Initial value:
= {
{ "inputs", "Number of input streams.", OFFSET(inputs), AV_OPT_TYPE_INT, { .i64 = 2 }, 1, INT_MAX, A|F },
{ "channel_layout", "Channel layout of the "
"output stream.", OFFSET(channel_layout_str), AV_OPT_TYPE_STRING, {.str = "stereo"}, 0, 0, A|F },
{ "map", "A comma-separated list of channels maps in the format "
"'input_stream.input_channel-output_channel.",
OFFSET(map), AV_OPT_TYPE_STRING, .flags = A|F },
{ NULL }
}
#define NULL
Definition: coverity.c:32
#define A
Definition: af_join.c:69
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several inputs
const VDPAUPixFmtMap * map
#define F
Definition: af_join.c:70
#define OFFSET(x)
Definition: af_join.c:68

Definition at line 71 of file af_join.c.

const AVFilterPad avfilter_af_join_outputs[]
static
Initial value:
= {
{
.name = "default",
.config_props = join_config_output,
},
{ NULL }
}
#define NULL
Definition: coverity.c:32
static int join_config_output(AVFilterLink *outlink)
Definition: af_join.c:280

Definition at line 519 of file af_join.c.

AVFilter ff_af_join
Initial value:
= {
.name = "join",
.description = NULL_IF_CONFIG_SMALL("Join multiple audio streams into "
"multi-channel output."),
.priv_size = sizeof(JoinContext),
.priv_class = &join_class,
}
#define NULL
Definition: coverity.c:32
static av_cold int init(AVCodecContext *avctx)
Definition: avrndec.c:35
#define AVFILTER_FLAG_DYNAMIC_INPUTS
The number of the filter inputs is not determined just by AVFilter.inputs.
Definition: avfilter.h:105
static av_cold void join_uninit(AVFilterContext *ctx)
Definition: af_join.c:205
static av_cold int uninit(AVCodecContext *avctx)
Definition: crystalhd.c:279
static av_cold int join_init(AVFilterContext *ctx)
Definition: af_join.c:162
static int join_query_formats(AVFilterContext *ctx)
Definition: af_join.c:220
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:186
static const AVFilterPad avfilter_af_join_outputs[]
Definition: af_join.c:519
static const AVFilterPad outputs[]
Definition: af_acontrast.c:203
static int activate(AVFilterContext *ctx)
Definition: af_join.c:467
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several inputs
#define flags(name, subs,...)
Definition: cbs_av1.c:561
static int query_formats(AVFilterContext *ctx)
Definition: aeval.c:244

Definition at line 528 of file af_join.c.