Go to the documentation of this file.
71 #define CHECK_VIDEO_PARAM_CHANGE(s, c, width, height, format, csp, range, pts)\
72 c->link_delta = c->w != width || c->h != height || c->pix_fmt != format ||\
73 c->color_space != csp || c->color_range != range;\
74 c->prev_delta = c->prev_w != width || c->prev_h != height || c->prev_pix_fmt != format ||\
75 c->prev_color_space != csp || c->prev_color_range != range;\
77 int loglevel = c->prev_delta ? AV_LOG_WARNING : AV_LOG_DEBUG;\
78 av_log(s, loglevel, "Changing video frame properties on the fly is not supported by all filters.\n");\
79 av_log(s, loglevel, "filter context - w: %d h: %d fmt: %d csp: %s range: %s, incoming frame - w: %d h: %d fmt: %d csp: %s range: %s pts_time: %s\n",\
80 c->w, c->h, c->pix_fmt, av_color_space_name(c->color_space), av_color_range_name(c->color_range),\
81 width, height, format, av_color_space_name(csp), av_color_range_name(range),\
82 av_ts2timestr(pts, &s->outputs[0]->time_base));\
86 av_log(s, AV_LOG_VERBOSE, "video frame properties congruent with link at pts_time: %s\n", av_ts2timestr(pts, &s->outputs[0]->time_base));\
89 c->prev_pix_fmt = format;\
90 c->prev_color_space = csp;\
91 c->prev_color_range = range;\
94 #define CHECK_AUDIO_PARAM_CHANGE(s, c, srate, layout, format, pts)\
95 if (c->sample_fmt != format || c->sample_rate != srate ||\
96 av_channel_layout_compare(&c->ch_layout, &layout) || c->channels != layout.nb_channels) {\
97 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",\
98 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,\
99 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));\
100 av_log(s, AV_LOG_ERROR, "Changing audio frame properties on the fly is not supported.\n");\
101 return AVERROR(EINVAL);\
124 switch (
ctx->filter->outputs[0].type) {
127 s->pix_fmt =
s->prev_pix_fmt = param->
format;
129 if (param->
width > 0)
130 s->w =
s->prev_w = param->
width;
140 if (!
s->hw_frames_ctx)
198 s->nb_failed_requests = 0;
207 refcounted = !!
frame->buf[0];
211 switch (
ctx->outputs[0]->type) {
243 #if FF_API_INTERLACED_FRAME
245 if (
copy->interlaced_frame)
247 if (
copy->top_field_first)
260 copy->colorspace =
ctx->outputs[0]->colorspace;
262 copy->color_range =
ctx->outputs[0]->color_range;
295 if (!
c->hw_frames_ctx) {
297 "to a HW format requires hw_frames_ctx to be non-NULL!\n");
301 if (
c->w <= 0 ||
c->h <= 0) {
305 if (
av_q2d(
c->time_base) <= 0) {
312 c->time_base.num,
c->time_base.den,
c->frame_rate.num,
c->frame_rate.den,
313 c->pixel_aspect.num,
c->pixel_aspect.den,
324 #define OFFSET(x) offsetof(BufferSourceContext, x)
325 #define A AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_AUDIO_PARAM
326 #define V AV_OPT_FLAG_FILTERING_PARAM|AV_OPT_FLAG_VIDEO_PARAM
391 if (
s->channel_layout_str ||
s->ch_layout.nb_channels) {
394 if (!
s->ch_layout.nb_channels) {
398 s->channel_layout_str);
403 n =
s->ch_layout.nb_channels;
406 if (n !=
s->channels) {
408 "Mismatching channel count %d and layout '%s' "
410 s->channels, buf, n);
415 }
else if (!
s->channels) {
417 "channel layout specified\n");
424 if (!
s->time_base.num)
428 "tb:%d/%d samplefmt:%s samplerate:%d chlayout:%s\n",
430 s->sample_rate, buf);
454 switch (
ctx->outputs[0]->type) {
508 switch (
link->type) {
514 if (
c->hw_frames_ctx) {
550 c->nb_failed_requests++;
564 .description =
NULL_IF_CONFIG_SMALL(
"Buffer video frames, and make them accessible to the filterchain."),
573 .priv_class = &buffer_class,
586 .description =
NULL_IF_CONFIG_SMALL(
"Buffer audio frames, and make them accessible to the filterchain."),
595 .priv_class = &abuffer_class,
enum AVColorSpace color_space
Video only, the YUV colorspace and range.
int ff_filter_graph_run_once(AVFilterGraph *graph)
Run one round of processing on a filter graph.
#define FF_ENABLE_DEPRECATION_WARNINGS
A list of supported channel layouts.
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
@ AV_OPT_TYPE_SAMPLE_FMT
Underlying C type is enum AVSampleFormat.
static int query_formats(const AVFilterContext *ctx, AVFilterFormatsConfig **cfg_in, AVFilterFormatsConfig **cfg_out)
AVFILTER_DEFINE_CLASS(buffer)
@ AVCOL_SPC_YCGCO_RE
YCgCo-R, even addition of bits.
int ff_filter_frame(AVFilterLink *link, AVFrame *frame)
Send a frame of data to the next filter.
const AVPixFmtDescriptor * av_pix_fmt_desc_get(enum AVPixelFormat pix_fmt)
#define AVERROR_EOF
End of file.
This structure describes decoded (raw) audio or video data.
@ AVCOL_RANGE_JPEG
Full range content.
@ AVCOL_SPC_NB
Not part of ABI.
int attribute_align_arg av_buffersrc_add_frame(AVFilterContext *ctx, AVFrame *frame)
Add a frame to the buffer source.
#define AV_LOG_VERBOSE
Detailed information.
@ AVCOL_SPC_RGB
order of coefficients is actually GBR, also IEC 61966-2-1 (sRGB), YZX and ST 428-1
#define CHECK_AUDIO_PARAM_CHANGE(s, c, srate, layout, format, pts)
AVBufferRef * av_buffer_ref(const AVBufferRef *buf)
Create a new reference to an AVBuffer.
const char * name
Filter name.
@ AV_OPT_TYPE_RATIONAL
Underlying C type is AVRational.
int nb_channels
Number of channels in this layout.
static const AVOption abuffer_options[]
A link between two filters.
int ff_fmt_is_regular_yuv(enum AVPixelFormat fmt)
Returns true if a pixel format is "regular YUV", which includes all pixel formats that are affected b...
@ AVCOL_SPC_BT2020_CL
ITU-R BT2020 constant luminance system.
Link properties exposed to filter code, but not external callers.
#define AV_FRAME_FLAG_TOP_FIELD_FIRST
A flag to mark frames where the top field is displayed first if the content is interlaced.
static av_cold void uninit(AVFilterContext *ctx)
int ff_fmt_is_forced_full_range(enum AVPixelFormat fmt)
Returns true if a YUV pixel format is forced full range (i.e.
@ AVCOL_SPC_BT470BG
also ITU-R BT601-6 625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM / IEC 61966-2-4 xvYCC601
@ AV_BUFFERSRC_FLAG_KEEP_REF
Keep a reference to the frame.
const char * av_color_space_name(enum AVColorSpace space)
void * priv
private data for use by the filter
AVRational sample_aspect_ratio
Video only, the sample (pixel) aspect ratio.
#define AV_PIX_FMT_FLAG_HWACCEL
Pixel format is an HW accelerated format.
AVRational frame_rate
frame_rate to set in the output link
@ AVCOL_RANGE_NB
Not part of ABI.
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.
#define AV_FRAME_FLAG_KEY
A flag to mark frames that are keyframes.
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.
static void ff_outlink_set_status(AVFilterLink *link, int status, int64_t pts)
Set the status field of a link from the source filter.
@ AVCOL_SPC_SMPTE170M
also ITU-R BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC / functionally identical to above
static enum AVPixelFormat pix_fmt
@ 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
AVFrame * av_frame_clone(const AVFrame *src)
Create a new frame that references the same data as src.
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[]
#define FILTER_OUTPUTS(array)
@ AVCOL_SPC_IPT_C2
SMPTE ST 2128, IPT-C2.
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
@ AVCOL_SPC_CHROMA_DERIVED_CL
Chromaticity-derived constant luminance system.
const char * av_color_range_name(enum AVColorRange range)
Describe the class of an AVClass context structure.
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
Underlying C type is two consecutive integers.
unsigned nb_failed_requests
@ AVCOL_SPC_YCGCO
used by Dirac / VC-2 and H.264 FRext, see ITU-T SG16
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
uint64_t flags
Combination of AV_PIX_FMT_FLAG_...
@ AVCOL_RANGE_UNSPECIFIED
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
static FilterLink * ff_filter_link(AVFilterLink *link)
AVRational frame_rate
Video only, the frame rate of the input video.
#define attribute_align_arg
int av_buffersrc_close(AVFilterContext *ctx, int64_t pts, unsigned flags)
Close the buffer source after EOF.
int(* init)(AVBSFContext *ctx)
#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)
An AVChannelLayout holds information about the channel layout of audio data.
AVBufferSrcParameters * av_buffersrc_parameters_alloc(void)
Allocate a new AVBufferSrcParameters instance.
@ AVCOL_SPC_YCGCO_RO
YCgCo-R, odd addition of bits.
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.
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 av_cold int init_audio(AVFilterContext *ctx)
enum AVColorSpace color_space prev_color_space
@ AVCOL_SPC_CHROMA_DERIVED_NCL
Chromaticity-derived non-constant luminance system.
AVBufferRef * hw_frames_ctx
For hwaccel pixel formats, this should be a reference to the AVHWFramesContext describing the frames.
@ AVCOL_SPC_SMPTE240M
derived from 170M primaries and D65 white point, 170M is derived from BT470 System M's primaries
int av_channel_layout_from_string(AVChannelLayout *channel_layout, const char *str)
Initialize a channel layout from a given string description.
int av_buffersrc_parameters_set(AVFilterContext *ctx, AVBufferSrcParameters *param)
Initialize the buffersrc or abuffersrc filter with the provided parameters.
int width
Video only, the display dimensions of the input frames.
@ AVCOL_SPC_BT2020_NCL
ITU-R BT2020 non-constant luminance system.
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.
AVColorSpace
YUV colorspace type.
AVSampleFormat
Audio sample formats.
#define FILTER_QUERY_FUNC2(func)
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...
@ AV_BUFFERSRC_FLAG_PUSH
Immediately push the frame to the output.
const char * name
Pad name.
static int activate(AVFilterContext *ctx)
#define AV_FRAME_FLAG_INTERLACED
A flag to mark frames whose content is interlaced.
@ AVCOL_RANGE_MPEG
Narrow or limited range content.
This struct describes a set or pool of "hardware" frames (i.e.
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.
#define CHECK_VIDEO_PARAM_CHANGE(s, c, width, height, format, csp, range, pts)
enum AVColorRange color_range
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
@ AVCOL_SPC_FCC
FCC Title 47 Code of Federal Regulations 73.682 (a)(20)
enum AVPixelFormat pix_fmt prev_pix_fmt
@ AV_OPT_TYPE_INT
Underlying C type is int.
void av_channel_layout_uninit(AVChannelLayout *channel_layout)
Free any allocated data in the channel layout and reset the channel count to 0.
@ AV_OPT_TYPE_PIXEL_FMT
Underlying C type is enum AVPixelFormat.
int ff_outlink_get_status(AVFilterLink *link)
Get the status on an output link.
int av_channel_layout_copy(AVChannelLayout *dst, const AVChannelLayout *src)
Make a copy of a channel layout.
#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]
@ AVCOL_SPC_SMPTE2085
SMPTE 2085, Y'D'zD'x.
enum AVColorRange color_range prev_color_range
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
@ AV_BUFFERSRC_FLAG_NO_CHECK_FORMAT
Do not check for format changes.
AVRational frame_rate
Frame rate of the stream on the link, or 1/0 if unknown or variable.
@ 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...
@ AVCOL_SPC_BT709
also ITU-R BT1361 / IEC 61966-2-4 xvYCC709 / derived in SMPTE RP 177 Annex B
AVColorRange
Visual content value range.
@ AVCOL_SPC_ICTCP
ITU-R BT.2100-0, ICtCp.
@ AV_OPT_TYPE_CONST
Special option type for declaring named constants.
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[]