Go to the documentation of this file.
69 #define OFFSET(x) offsetof(JoinContext, x)
70 #define A AV_OPT_FLAG_AUDIO_PARAM
71 #define F AV_OPT_FLAG_FILTERING_PARAM
74 {
"channel_layout",
"Channel layout of the "
76 {
"map",
"A comma-separated list of channels maps in the format "
77 "'input_stream.input_channel-output_channel.",
82 #define MAP_SEPARATOR '|'
94 int input_idx, out_ch_idx;
101 if (!(sep = strchr(cur,
'-'))) {
110 if (out_ch_idx < 0) {
115 map = &
s->channels[out_ch_idx];
117 if (
map->input >= 0) {
124 input_idx = strtol(cur, &cur, 0);
125 if (input_idx < 0 || input_idx >=
s->inputs) {
134 map->input = input_idx;
136 map->in_channel_idx = strtol(cur, &p, 0);
140 if (
map->in_channel < 0) {
144 }
else if (
map->in_channel_idx < 0) {
159 s->channels =
av_calloc(
s->ch_layout.nb_channels,
sizeof(*
s->channels));
160 s->buffers =
av_calloc(
s->ch_layout.nb_channels,
sizeof(*
s->buffers));
161 s->input_frames =
av_calloc(
s->inputs,
sizeof(*
s->input_frames));
162 if (!
s->channels || !
s->buffers|| !
s->input_frames)
165 for (
i = 0;
i <
s->ch_layout.nb_channels;
i++) {
167 s->channels[
i].input = -1;
168 s->channels[
i].in_channel_idx = -1;
175 for (
i = 0;
i <
s->inputs;
i++) {
195 for (
i = 0;
i <
s->inputs &&
s->input_frames;
i++) {
214 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
235 memmove(chl->
ch + idx, chl->
ch + idx + 1,
236 (chl->
nb_ch - idx - 1) *
sizeof(*chl->
ch));
247 for (
int i = 0;
i < chl->
nb_ch;
i++)
248 if (chl->
ch[
i] == ch)
258 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
272 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
287 char inbuf[64], outbuf[64];
291 inputs_unused =
av_calloc(
ctx->nb_inputs,
sizeof(*inputs_unused));
294 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
306 for (
int ch_idx = 0; ch_idx < iu->
nb_ch; ch_idx++) {
308 if (iu->
ch[ch_idx] < 0) {
318 for (
i = 0;
i <
s->ch_layout.nb_channels;
i++) {
328 ichl = &
inlink->ch_layout;
329 iu = &inputs_unused[ch->
input];
337 "input stream #%d.\n", inbuf,
357 for (
i = 0;
i <
s->ch_layout.nb_channels;
i++) {
365 for (
i = 0;
i <
s->ch_layout.nb_channels;
i++) {
374 "output channel '%s'.\n",
390 for (
i = 0;
i <
s->ch_layout.nb_channels;
i++) {
405 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
406 if (inputs_unused[
i].nb_ch ==
ctx->inputs[
i]->ch_layout.nb_channels)
412 for (
i = 0;
i <
ctx->nb_inputs;
i++)
423 int linesize = INT_MAX;
424 int nb_samples = INT_MAX;
428 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
429 if (!
s->input_frames[
i]) {
433 nb_samples =
FFMIN(nb_samples,
s->input_frames[
i]->nb_samples);
445 sizeof(*
frame->extended_data));
446 if (!
frame->extended_data) {
453 for (
i = 0;
i <
s->ch_layout.nb_channels;
i++) {
468 for (j = 0; j < nb_buffers; j++)
469 if (
s->buffers[j]->buffer == buf->
buffer)
472 s->buffers[nb_buffers++] = buf;
479 sizeof(*
frame->extended_buf));
480 if (!
frame->extended_buf) {
481 frame->nb_extended_buf = 0;
493 for (
i = 0;
i <
frame->nb_extended_buf;
i++) {
496 if (!
frame->extended_buf[
i]) {
502 frame->nb_samples = nb_samples;
511 frame->pts =
s->input_frames[0]->pts;
512 frame->linesize[0] = linesize;
523 for (
i = 0;
i <
ctx->nb_inputs;
i++)
532 for (
i = 0;
i <
ctx->nb_inputs;
i++) {
535 !
s->input_frames[
i]) {
553 if (!
s->input_frames[0]) {
567 if (
s->input_frames[0])
568 nb_samples =
s->input_frames[0]->nb_samples;
570 for (
i = 1;
i <
ctx->nb_inputs && nb_samples > 0;
i++) {
571 if (
s->input_frames[
i])
580 if (!
s->eof && !
s->input_frames[
i]) {
600 "multi-channel output."),
602 .priv_class = &join_class,
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.
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.
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 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.
A link between two filters.
static enum AVChannel channel_list_pop(ChannelList *chl, int idx)
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
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.
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)
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)
#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.
#define FILTER_OUTPUTS(array)
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)
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
@ AV_OPT_TYPE_CHLAYOUT
Underlying C type is AVChannelLayout.
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.
int(* init)(AVBSFContext *ctx)
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 format
agreed upon media format
static AVRational av_make_q(int num, int den)
Create an AVRational.
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
static void uninit(AVBSFContext *ctx)
#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.
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 frame
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.
@ AV_OPT_TYPE_INT
Underlying C type is int.
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.
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)
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...
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
@ AV_OPT_TYPE_STRING
Underlying C type is a uint8_t* that is either NULL or points to a C string allocated with the av_mal...
static int try_push_frame(AVFilterContext *ctx)
static enum AVChannel channel_list_pop_ch(ChannelList *chl, enum AVChannel ch)
AVFILTER_DEFINE_CLASS(join)
#define FILTER_QUERY_FUNC(func)