Go to the documentation of this file.
70 #define OFFSET(x) offsetof(JoinContext, x)
71 #define A AV_OPT_FLAG_AUDIO_PARAM
72 #define F AV_OPT_FLAG_FILTERING_PARAM
75 {
"channel_layout",
"Channel layout of the "
77 {
"map",
"A comma-separated list of channels maps in the format "
78 "'input_stream.input_channel-output_channel.",
83 #define MAP_SEPARATOR '|'
95 int input_idx, out_ch_idx;
102 if (!(sep = strchr(cur,
'-'))) {
111 if (out_ch_idx < 0) {
116 map = &
s->channels[out_ch_idx];
118 if (
map->input >= 0) {
125 input_idx = strtol(cur, &cur, 0);
126 if (input_idx < 0 || input_idx >=
s->inputs) {
135 map->input = input_idx;
137 map->in_channel_idx = strtol(cur, &p, 0);
141 if (
map->in_channel < 0) {
145 }
else if (
map->in_channel_idx < 0) {
162 #if FF_API_OLD_CHANNEL_LAYOUT
169 s->channel_layout_str);
171 #if FF_API_OLD_CHANNEL_LAYOUT
175 s->channel_layout_str);
180 s->channels =
av_calloc(
s->ch_layout.nb_channels,
sizeof(*
s->channels));
181 s->buffers =
av_calloc(
s->ch_layout.nb_channels,
sizeof(*
s->buffers));
182 s->input_frames =
av_calloc(
s->inputs,
sizeof(*
s->input_frames));
183 if (!
s->channels || !
s->buffers|| !
s->input_frames)
186 for (
i = 0;
i <
s->ch_layout.nb_channels;
i++) {
188 s->channels[
i].input = -1;
189 s->channels[
i].in_channel_idx = -1;
196 for (
i = 0;
i <
s->inputs;
i++) {
216 for (
i = 0;
i <
s->inputs &&
s->input_frames;
i++) {
235 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
256 memmove(chl->
ch + idx, chl->
ch + idx + 1,
257 (chl->
nb_ch - idx - 1) *
sizeof(*chl->
ch));
268 for (
int i = 0;
i < chl->
nb_ch;
i++)
269 if (chl->
ch[
i] == ch)
279 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
293 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
308 char inbuf[64], outbuf[64];
312 inputs_unused =
av_calloc(
ctx->nb_inputs,
sizeof(*inputs_unused));
315 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
327 for (
int ch_idx = 0; ch_idx < iu->
nb_ch; ch_idx++) {
329 if (iu->
ch[ch_idx] < 0) {
339 for (
i = 0;
i <
s->ch_layout.nb_channels;
i++) {
349 ichl = &
inlink->ch_layout;
350 iu = &inputs_unused[ch->
input];
358 "input stream #%d.\n", inbuf,
378 for (
i = 0;
i <
s->ch_layout.nb_channels;
i++) {
386 for (
i = 0;
i <
s->ch_layout.nb_channels;
i++) {
395 "output channel '%s'.\n",
411 for (
i = 0;
i <
s->ch_layout.nb_channels;
i++) {
426 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
427 if (inputs_unused[
i].nb_ch ==
ctx->inputs[
i]->ch_layout.nb_channels)
433 for (
i = 0;
i <
ctx->nb_inputs;
i++)
444 int linesize = INT_MAX;
445 int nb_samples = INT_MAX;
449 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
450 if (!
s->input_frames[
i]) {
454 nb_samples =
FFMIN(nb_samples,
s->input_frames[
i]->nb_samples);
474 for (
i = 0;
i <
s->ch_layout.nb_channels;
i++) {
489 for (j = 0; j < nb_buffers; j++)
490 if (
s->buffers[j]->buffer == buf->
buffer)
493 s->buffers[nb_buffers++] = buf;
528 #if FF_API_OLD_CHANNEL_LAYOUT
550 for (
i = 0;
i <
ctx->nb_inputs;
i++)
559 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
562 !
s->input_frames[
i]) {
580 if (!
s->input_frames[0]) {
594 if (
s->input_frames[0])
595 nb_samples =
s->input_frames[0]->nb_samples;
597 for (
i = 1;
i <
ctx->nb_inputs && nb_samples > 0;
i++) {
598 if (
s->input_frames[
i])
607 if (!
s->eof && !
s->input_frames[
i]) {
627 "multi-channel output."),
629 .priv_class = &join_class,
AVBufferRef ** extended_buf
For planar audio which requires more than AV_NUM_DATA_POINTERS AVBufferRef pointers,...
#define FF_ENABLE_DEPRECATION_WARNINGS
A list of supported channel layouts.
#define AV_LOG_WARNING
Something somehow does not look correct.
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
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
int64_t duration
Duration of the frame, in the same units as pts.
enum MovChannelLayoutTag * layouts
#define AVERROR_EOF
End of file.
The exact code depends on how similar the blocks are and how related they are to the and needs to apply these operations to the correct inlink or outlink if there are several Macros are available to factor that when no extra processing is inlink
char * av_asprintf(const char *fmt,...)
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
This structure describes decoded (raw) audio or video data.
int64_t pts
Presentation timestamp in time_base units (time when frame should be shown to user).
static void guess_map_matching(AVFilterContext *ctx, ChannelMap *ch, ChannelList *inputs)
enum AVChannel av_channel_layout_channel_from_index(const AVChannelLayout *channel_layout, unsigned int idx)
Get the channel with the given index in a channel layout.
#define FILTER_QUERY_FUNC(func)
#define AV_LOG_VERBOSE
Detailed information.
AVBufferRef * av_buffer_ref(const AVBufferRef *buf)
Create a new reference to an AVBuffer.
const char * name
Filter name.
int nb_channels
Number of channels in this layout.
AVBufferRef * buf[AV_NUM_DATA_POINTERS]
AVBuffer references backing the data for this frame.
A link between two filters.
static enum AVChannel channel_list_pop(ChannelList *chl, int idx)
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
int ff_inlink_consume_frame(AVFilterLink *link, AVFrame **rframe)
Take a frame from the link's FIFO and update the link's stats.
#define FF_FILTER_FORWARD_STATUS_BACK_ALL(outlink, filter)
Forward the status on an output link to all input links.
int input
input stream index
AVChannelLayout ch_layout
Channel layout of the audio data.
static int join_query_formats(AVFilterContext *ctx)
#define AVFILTER_FLAG_DYNAMIC_INPUTS
The number of the filter inputs is not determined just by AVFilter.inputs.
attribute_deprecated int channels
number of audio channels, only used for audio.
AVBufferRef ** buffers
Temporary storage for buffer references, for assembling the output frame.
A filter pad used for either input or output.
AVFrame ** input_frames
Temporary storage for input frames, until we get one on each input.
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
static int parse_maps(AVFilterContext *ctx)
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
#define FF_ARRAY_ELEMS(a)
attribute_deprecated uint64_t channel_layout
Channel layout of the audio data.
static const uint16_t mask[17]
static void ff_outlink_set_status(AVFilterLink *link, int status, int64_t pts)
Set the status field of a link from the source filter.
void ff_inlink_request_frame(AVFilterLink *link)
Mark that a frame is wanted on the link.
static void guess_map_any(AVFilterContext *ctx, ChannelMap *ch, ChannelList *inputs)
FF_ENABLE_DEPRECATION_WARNINGS int av_channel_layout_from_mask(AVChannelLayout *channel_layout, uint64_t mask)
Initialize a native channel layout from a bitmask indicating which channels are present.
int(* init)(AVBSFContext *ctx)
#define av_assert0(cond)
assert() equivalent, that is always enabled.
int av_channel_layout_index_from_string(const AVChannelLayout *channel_layout, const char *str)
Get the index in a channel layout of a channel described by the given string.
int64_t av_rescale_q(int64_t a, AVRational bq, AVRational cq)
Rescale a 64-bit integer by 2 rational numbers.
Describe the class of an AVClass context structure.
int ff_inlink_consume_samples(AVFilterLink *link, unsigned min, unsigned max, AVFrame **rframe)
Take samples from the link's FIFO and update the link's stats.
int ff_append_inpad_free_name(AVFilterContext *f, AVFilterPad *p)
uint64_t av_get_channel_layout(const char *name)
Return a channel layout id that matches name, or 0 if no match is found.
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
static const AVOption join_options[]
int ff_inlink_acknowledge_status(AVFilterLink *link, int *rstatus, int64_t *rpts)
Test and acknowledge the change of status on the link.
AVBufferRef * av_frame_get_plane_buffer(const AVFrame *frame, int plane)
Get the buffer reference a given data plane is stored in.
char * channel_layout_str
AVChannelLayout ch_layout
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
An AVChannelLayout holds information about the channel layout of audio data.
int sample_rate
Sample rate of the audio data.
int format
agreed upon media format
static AVRational av_make_q(int num, int den)
Create an AVRational.
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames,...
AVFilterContext * src
source filter
int in_channel_idx
index of in_channel in the input stream data
static av_cold void join_uninit(AVFilterContext *ctx)
int sample_rate
samples per second
int av_channel_layout_from_string(AVChannelLayout *channel_layout, const char *str)
Initialize a channel layout from a given string description.
int nb_samples
number of audio samples (per channel) described by this frame
#define i(width, name, range_min, range_max)
int av_channel_name(char *buf, size_t buf_size, enum AVChannel channel_id)
Get a human readable string in an abbreviated form describing a given channel.
uint8_t ** extended_data
pointers to the data planes/channels.
#define av_malloc_array(a, b)
const char * name
Pad name.
int ff_inlink_queued_samples(AVFilterLink *link)
void * av_calloc(size_t nmemb, size_t size)
static int activate(AVFilterContext *ctx)
static const AVFilterPad avfilter_af_join_outputs[]
enum AVMediaType type
AVFilterPad type.
enum AVChannel av_channel_from_string(const char *str)
This is the inverse function of av_channel_name().
@ AV_CHAN_NONE
Invalid channel index.
int av_channel_layout_index_from_channel(const AVChannelLayout *channel_layout, enum AVChannel channel)
Get the index of a given channel in a channel layout.
AVRational time_base
Define the time base used by the PTS of the frames/samples which will pass through this link.
int av_channel_layout_copy(AVChannelLayout *dst, const AVChannelLayout *src)
Make a copy of a channel layout.
#define FF_DISABLE_DEPRECATION_WARNINGS
A reference to a data buffer.
const VDPAUPixFmtMap * map
AVChannelLayout ch_layout
channel layout of current buffer (see libavutil/channel_layout.h)
static int join_config_output(AVFilterLink *outlink)
#define FILTER_OUTPUTS(array)
static av_cold int join_init(AVFilterContext *ctx)
const AVFilter ff_af_join
int linesize[AV_NUM_DATA_POINTERS]
For video, a positive or negative value, which is typically indicating the size in bytes of each pict...
static av_cold int uninit(AVCodecContext *avctx)
the definition of that something depends on the semantic of the filter The callback must examine the status of the filter s links and proceed accordingly The status of output links is stored in the status_in and status_out fields and tested by the ff_outlink_frame_wanted() function. If this function returns true
static int try_push_frame(AVFilterContext *ctx)
static enum AVChannel channel_list_pop_ch(ChannelList *chl, enum AVChannel ch)
AVFILTER_DEFINE_CLASS(join)
int nb_extended_buf
Number of elements in extended_buf.