A reference to an AVFilterBuffer. More...

#include <avfilter.h>

Data Fields
AVFilterBuffer *	buf
	the buffer that this is a reference to

uint8_t *	data [8]
	picture/audio data for each plane

uint8_t **	extended_data
	pointers to the data planes/channels.

int	linesize [8]
	number of bytes per line

AVFilterBufferRefVideoProps *	video
	video buffer specific properties

AVFilterBufferRefAudioProps *	audio
	audio buffer specific properties

int64_t	pts
	presentation timestamp.

int64_t	pos
	byte position in stream, -1 if unknown

int	format
	media format

int	perms
	permissions, see the AV_PERM_* flags

enum AVMediaType	type
	media type of buffer data

AVDictionary *	metadata
	dictionary containing metadata key=value tags

Detailed Description

A reference to an AVFilterBuffer.

Since filters can manipulate the origin of a buffer to, for example, crop image without any memcpy, the buffer origin and dimensions are per-reference properties. Linesize is also useful for image flipping, frame to field filters, etc, and so is also per-reference.

TODO: add anything necessary for frame reordering

Examples:: doc/examples/filtering_audio.c, and doc/examples/filtering_video.c.

Definition at line 160 of file avfilter.h.

Field Documentation

AVFilterBufferRefAudioProps* AVFilterBufferRef::audio

audio buffer specific properties

Examples:: doc/examples/filtering_audio.c.

Definition at line 181 of file avfilter.h.

Referenced by av_asrc_buffer_add_samples(), av_buffersink_read_samples(), av_buffersrc_add_ref(), avfilter_copy_buf_props(), avfilter_copy_buffer_ref_props(), avfilter_copy_frame_props(), avfilter_get_audio_buffer_ref_from_arrays_channels(), avfilter_ref_buffer(), avfilter_ref_get_channels(), avfilter_unref_buffer(), buffer_offset(), calc_ptr_alignment(), describe_bufref_to_str(), ff_copy_buffer_ref(), ff_default_get_audio_buffer(), ff_filter_frame(), ff_filter_frame_framed(), ff_filter_frame_needs_framing(), ff_free_pool(), ff_tlog_ref(), filter_frame(), join_request_frame(), lavfi_read_packet(), print_samplesref(), push_frame(), push_samples(), request_frame(), return_audio_frame(), select_frame(), send_out(), store_in_pool(), and write_to_fifo().

AVFilterBuffer* AVFilterBufferRef::buf

the buffer that this is a reference to

Definition at line 161 of file avfilter.h.

Referenced by av_asrc_buffer_add_samples(), av_buffersrc_add_frame(), avfilter_get_audio_buffer_ref_from_arrays_channels(), avfilter_get_audio_buffer_ref_from_frame(), avfilter_get_video_buffer_ref_from_arrays(), avfilter_get_video_buffer_ref_from_frame(), avfilter_ref_buffer(), avfilter_unref_buffer(), decode_video(), does_clip(), ff_copy_buffer_ref(), ff_default_get_video_buffer(), ff_free_pool(), ff_tlog_ref(), ff_vf_next_put_image(), filter_frame(), frame_to_buf(), join_request_frame(), send_out(), store_in_pool(), and video_thread().

uint8_t* AVFilterBufferRef::data[8]

picture/audio data for each plane

Examples:: doc/examples/filtering_audio.c, and doc/examples/filtering_video.c.

Definition at line 162 of file avfilter.h.

Referenced by avfilter_copy_buf_props(), avfilter_get_audio_buffer_ref_from_arrays_channels(), avfilter_get_video_buffer_ref_from_arrays(), avfilter_ref_buffer(), avfilter_unref_buffer(), blend_frame(), blend_image(), buffer_offset(), channelmap_filter_frame(), config_output(), config_video_output(), decimate_frame(), display_picref(), does_clip(), draw_blank_frame(), draw_frame(), draw_glyphs(), draw_text(), drawline(), drawtext(), ff_copy_buffer_ref(), ff_default_get_video_buffer(), ff_filter_frame_framed(), ff_tlog_ref(), ff_vf_next_put_image(), fill_iplimage_from_picref(), fill_picref_from_iplimage(), fill_picture(), fill_picture_monoblack(), fill_picture_rgb(), filter(), filter_frame(), geq_filter_frame(), get_video_buffer(), getpix(), lavfi_read_packet(), overlay_ass_image(), plot_spectrum_column(), pp_filter_frame(), print_samplesref(), process_frame_uyvy422(), process_frame_yuv420p(), process_frame_yuv422p(), request_frame(), scale_slice(), and sub2video_update().

uint8_t** AVFilterBufferRef::extended_data

pointers to the data planes/channels.

For video, this should simply point to data[].

For planar audio, each channel has a separate data pointer, and linesize[0] contains the size of each channel buffer. For packed audio, there is just one data pointer, and linesize[0] contains the total size of the buffer for all channels.

Note: Both data and extended_data will always be set, but for planar audio with more channels that can fit in data, extended_data must be used in order to access all channels.

Definition at line 177 of file avfilter.h.

Referenced by av_buffersink_read_samples(), avfilter_copy_buf_props(), avfilter_get_audio_buffer_ref_from_arrays_channels(), avfilter_get_video_buffer_ref_from_arrays(), avfilter_ref_buffer(), avfilter_unref_buffer(), buffer_offset(), calc_ptr_alignment(), channelmap_filter_frame(), ff_copy_buffer_ref(), ff_filter_frame_framed(), ff_filter_frame_needs_framing(), filter_frame(), join_request_frame(), output_frame(), plot_spectrum_column(), push_samples(), read_from_fifo(), request_frame(), return_audio_frame(), send_silence(), and write_to_fifo().