FFmpeg: libavfilter/buffersrc.c Source File
Go to the documentation of this file. 1 /*
2 * Copyright (c) 2008 Vitor Sessak
3 *
4 * This file is part of FFmpeg.
5 *
6 * FFmpeg is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * FFmpeg is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with FFmpeg; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 /**
22 * @file
23 * memory buffer source filter
24 */
25
27
42
48
49 /* video only */
53 #if FF_API_SWS_PARAM_OPTION
54 char *sws_param;
55 #endif
56
58
59 /* audio only */
65
68
69 #define CHECK_VIDEO_PARAM_CHANGE(s, c, width, height, format, pts)\
70 if (c->w != width || c->h != height || c->pix_fmt != format) {\
71 av_log(s, AV_LOG_INFO, "filter context - w: %d h: %d fmt: %d, incoming frame - w: %d h: %d fmt: %d pts_time: %s\n",\
72 c->w, c->h, c->pix_fmt, width, height, format, av_ts2timestr(pts, &s->outputs[0]->time_base));\
73 av_log(s, AV_LOG_WARNING, "Changing video frame properties on the fly is not supported by all filters.\n");\
74 }
75
76 #define CHECK_AUDIO_PARAM_CHANGE(s, c, srate, layout, format, pts)\
77 if (c->sample_fmt != format || c->sample_rate != srate ||\
78 av_channel_layout_compare(&c->ch_layout, &layout) || c->channels != layout.nb_channels) {\
79 av_log(s, AV_LOG_INFO, "filter context - fmt: %s r: %d layout: %"PRIX64" ch: %d, incoming frame - fmt: %s r: %d layout: %"PRIX64" ch: %d pts_time: %s\n",\
80 av_get_sample_fmt_name(c->sample_fmt), c->sample_rate, c->ch_layout.order == AV_CHANNEL_ORDER_NATIVE ? c->ch_layout.u.mask : 0, c->channels,\
81 av_get_sample_fmt_name(format), srate, layout.order == AV_CHANNEL_ORDER_NATIVE ? layout.u.mask : 0, layout.nb_channels, av_ts2timestr(pts, &s->outputs[0]->time_base));\
82 av_log(s, AV_LOG_ERROR, "Changing audio frame properties on the fly is not supported.\n");\
83 return AVERROR(EINVAL);\
84 }
85
87 {
89 if (!par)
91
93
94 return par;
95 }
96
98 {
100
103
104 switch (
ctx->filter->outputs[0].type) {
108 }
109 if (param->
width > 0)
120 if (!
s->hw_frames_ctx)
122 }
123 break;
127 }
130 #if FF_API_OLD_CHANNEL_LAYOUT
132 // if the old/new fields are set inconsistently, prefer the old ones
138 } else
139 #endif
144 }
145 break;
146 default:
148 }
149
150 return 0;
151 }
152
154 {
157 }
158
160 {
162 }
163
165 {
167
168 while (1) {
171 break;
174 }
175 return 0;
176 }
177
179 {
183
184 #if FF_API_OLD_CHANNEL_LAYOUT
188 av_log(
ctx,
AV_LOG_ERROR,
"Layout indicates a different number of channels than actually present\n");
190 }
192 #endif
193
194 s->nb_failed_requests = 0;
195
200
201 refcounted = !!
frame->buf[0];
202
204
205 switch (
ctx->outputs[0]->type) {
209 break;
211 /* For layouts unknown on input but known on link after negotiation. */
212 #if FF_API_OLD_CHANNEL_LAYOUT
214 if (!
frame->channel_layout)
216 s->ch_layout.u.mask : 0;
218 #endif
223 }
226 break;
227 default:
229 }
230
231 }
232
235
238 } else {
243 }
244 }
245
249
254 }
255
256 return 0;
257 }
258
260 {
262
266 }
267
269 {
271
276 }
277
280 c->time_base.num,
c->time_base.den,
c->frame_rate.num,
c->frame_rate.den,
281 c->pixel_aspect.num,
c->pixel_aspect.den);
282
283 #if FF_API_SWS_PARAM_OPTION
286 #endif
287
288 return 0;
289 }
290
292 {
294 }
295
296 #define OFFSET(x) offsetof(BufferSourceContext, x)
297 #define A AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_AUDIO_PARAM
298 #define V AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
299
309 #if FF_API_SWS_PARAM_OPTION
311 #endif
313 };
314
316
324 };
325
327
329 {
331 char buf[128];
333
337 }
338
339 if (
s->channel_layout_str ||
s->ch_layout.nb_channels) {
340 int n;
341
342 if (!
s->ch_layout.nb_channels) {
345 #if FF_API_OLD_CHANNEL_LAYOUT
350 #endif
352 s->channel_layout_str);
354 #if FF_API_OLD_CHANNEL_LAYOUT
355 }
358 s->channel_layout_str);
360 #endif
361 }
362 }
363
364 n =
s->ch_layout.nb_channels;
367 if (n !=
s->channels) {
369 "Mismatching channel count %d and layout '%s' "
370 "(%d channels)\n",
371 s->channels, buf, n);
373 }
374 }
376 }
else if (!
s->channels) {
378 "channel layout specified\n");
380 } else {
383 }
384
385 if (!
s->time_base.num)
387
389 "tb:%d/%d samplefmt:%s samplerate:%d chlayout:%s\n",
391 s->sample_rate, buf);
392
394 }
395
397 {
401 }
402
404 {
410
411 switch (
ctx->outputs[0]->type) {
416 break;
423
428 break;
429 default:
431 }
432
433 return 0;
434 }
435
437 {
439
440 switch (
link->type) {
445
446 if (
c->hw_frames_ctx) {
450 }
451 break;
453 if (!
c->ch_layout.nb_channels) {
457 }
458 break;
459 default:
461 }
462
464 link->frame_rate =
c->frame_rate;
465 return 0;
466 }
467
469 {
471
474 c->nb_failed_requests++;
476 }
477
479 {
484 },
485 };
486
489 .description =
NULL_IF_CONFIG_SMALL(
"Buffer video frames, and make them accessible to the filterchain."),
491
494
498 .priv_class = &buffer_class,
499 };
500
502 {
507 },
508 };
509
512 .description =
NULL_IF_CONFIG_SMALL(
"Buffer audio frames, and make them accessible to the filterchain."),
514
517
521 .priv_class = &abuffer_class,
522 };
#define FF_ENABLE_DEPRECATION_WARNINGS
A list of supported channel layouts.
#define AV_LOG_WARNING
Something somehow does not look correct.
AVPixelFormat
Pixel format.
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
AVFILTER_DEFINE_CLASS(buffer)
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
#define AVERROR_EOF
End of file.
uint64_t av_get_channel_layout(const char *name)
Return a channel layout id that matches name, or 0 if no match is found.
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.
int attribute_align_arg av_buffersrc_add_frame(AVFilterContext *ctx, AVFrame *frame)
Add a frame to the buffer source.
#define FILTER_QUERY_FUNC(func)
@ AV_BUFFERSRC_FLAG_PUSH
Immediately push the frame to the output.
#define AV_LOG_VERBOSE
Detailed information.
#define CHECK_AUDIO_PARAM_CHANGE(s, c, srate, layout, format, pts)
@ AV_BUFFERSRC_FLAG_NO_CHECK_FORMAT
Do not check for format changes.
int ff_filter_graph_run_once(AVFilterGraph *graph)
Run one round of processing on a filter graph.
enum AVChannelOrder order
Channel order used in this layout.
AVBufferRef * av_buffer_ref(const AVBufferRef *buf)
Create a new reference to an AVBuffer.
const char * name
Filter name.
uint64_t mask
This member must be used for AV_CHANNEL_ORDER_NATIVE, and may be used for AV_CHANNEL_ORDER_AMBISONIC ...
int nb_channels
Number of channels in this layout.
static const AVOption abuffer_options[]
A link between two filters.
int av_channel_layout_copy(AVChannelLayout *dst, const AVChannelLayout *src)
Make a copy of a channel layout.
static av_cold void uninit(AVFilterContext *ctx)
void * priv
private data for use by the filter
AVRational sample_aspect_ratio
Video only, the sample (pixel) aspect ratio.
AVRational frame_rate
frame_rate to set in the output link
const AVFilter ff_vsrc_buffer
AVChannelLayout ch_layout
Channel layout of the audio data.
A filter pad used for either input or output.
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
AVChannelLayout ch_layout
Audio only, the audio channel layout.
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
@ AV_CHANNEL_ORDER_NATIVE
The native channel order, i.e.
static const uint16_t mask[17]
@ AV_CHANNEL_ORDER_UNSPEC
Only the channel count is specified, without any further information about the channel order.
static double av_q2d(AVRational a)
Convert an AVRational to a double.
static int push_frame(AVFilterGraph *graph)
static const AVFilterPad avfilter_vsrc_buffer_outputs[]
AVChannelLayout ch_layout
static enum AVPixelFormat pix_fmt
const char * av_get_sample_fmt_name(enum AVSampleFormat sample_fmt)
Return the name of sample_fmt, or NULL if sample_fmt is not recognized.
static const AVOption buffer_options[]
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 link
Describe the class of an AVClass context structure.
union AVChannelLayout::@296 u
Details about which channels are present in this layout.
void av_buffer_unref(AVBufferRef **buf)
Free a given reference and automatically free the buffer if there are no more references to it.
Rational number (pair of numerator and denominator).
@ AV_OPT_TYPE_IMAGE_SIZE
offset must point to two consecutive integers
unsigned nb_failed_requests
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
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
void av_channel_layout_uninit(AVChannelLayout *channel_layout)
Free any allocated data in the channel layout and reset the channel count to 0.
AVRational frame_rate
Video only, the frame rate of the input video.
int av_buffersrc_close(AVFilterContext *ctx, int64_t pts, unsigned flags)
Close the buffer source after EOF.
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
static void copy(const float *p1, float *p2, const int length)
int av_frame_ref(AVFrame *dst, const AVFrame *src)
Set up a new reference to the data described by the source frame.
An AVChannelLayout holds information about the channel layout of audio data.
AVBufferSrcParameters * av_buffersrc_parameters_alloc(void)
Allocate a new AVBufferSrcParameters instance.
int av_get_channel_layout_nb_channels(uint64_t channel_layout)
Return the number of channels in the channel layout.
AVBufferRef * hw_frames_ctx
static int config_props(AVFilterLink *link)
AVBufferRef * hw_frames_ctx
Video with a hwaccel pixel format only.
int sample_rate
Audio only, the audio sampling rate in samples per second.
#define AV_NOPTS_VALUE
Undefined timestamp value.
AVRational time_base
Time base for the timestamps in this frame.
AVRational time_base
The timebase to be used for the timestamps on the input frames.
static int request_frame(AVFilterLink *link)
static av_cold int init_audio(AVFilterContext *ctx)
static int query_formats(AVFilterContext *ctx)
#define CHECK_VIDEO_PARAM_CHANGE(s, c, width, height, format, pts)
int av_buffersrc_parameters_set(AVFilterContext *ctx, AVBufferSrcParameters *param)
Initialize the buffersrc or abuffersrc filter with the provided parameters.
enum AVPixelFormat pix_fmt
int width
Video only, the display dimensions of the input frames.
void ff_avfilter_link_set_in_status(AVFilterLink *link, int status, int64_t pts)
Set the status field of a link from the source filter.
int attribute_align_arg av_buffersrc_add_frame_flags(AVFilterContext *ctx, AVFrame *frame, int flags)
Add a frame to the buffer source.
AVSampleFormat
Audio sample formats.
static av_cold int init_video(AVFilterContext *ctx)
void av_frame_move_ref(AVFrame *dst, AVFrame *src)
Move everything contained in src to dst and reset src.
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
const char * name
Pad name.
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.
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
AVRational sample_aspect_ratio
Sample aspect ratio for the video frame, 0/1 if unknown/unspecified.
AVBufferRef * hw_frames_ctx
For hwaccel-format frames, this should be a reference to the AVHWFramesContext describing the frame.
This structure contains the parameters describing the frames that will be passed to this filter.
int format
video: the pixel format, value corresponds to enum AVPixelFormat audio: the sample format,...
the frame and frame reference mechanism is intended to as much as expensive copies of that data while still allowing the filters to produce correct results The data is stored in buffers represented by AVFrame structures Several references can point to the same frame buffer
int av_channel_layout_from_string(AVChannelLayout *channel_layout, const char *str)
Initialize a channel layout from a given string description.
@ AV_BUFFERSRC_FLAG_KEEP_REF
Keep a reference to the frame.
int av_channel_layout_describe(const AVChannelLayout *channel_layout, char *buf, size_t buf_size)
Get a human-readable string describing the channel layout properties.
#define FF_DISABLE_DEPRECATION_WARNINGS
unsigned av_buffersrc_get_nb_failed_requests(AVFilterContext *buffer_src)
Get the number of failed requests.
A reference to a data buffer.
char * channel_layout_str
static const uint16_t channel_layouts[7]
#define FILTER_OUTPUTS(array)
AVRational time_base
time_base to set in the output link
int attribute_align_arg av_buffersrc_write_frame(AVFilterContext *ctx, const AVFrame *frame)
Add a frame to the buffer source.
#define flags(name, subs,...)
#define AVERROR_BUG
Internal bug, also see AVERROR_BUG2.
const AVFilter ff_asrc_abuffer
enum AVSampleFormat sample_fmt
const char * av_get_pix_fmt_name(enum AVPixelFormat pix_fmt)
Return the short name for a pixel format, NULL in case pix_fmt is unknown.
static const AVFilterPad avfilter_asrc_abuffer_outputs[]
Generated on Wed Aug 24 2022 21:42:01 for FFmpeg by
doxygen
1.8.17