main external API structure. More...

#include <libavcodec/avcodec.h>

Data Fields
const AVClass *	av_class
	information on struct for av_log More...

int	log_level_offset

enum AVMediaType	codec_type

const struct AVCodec *	codec

enum AVCodecID	codec_id

unsigned int	codec_tag
	fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A'). More...

void *	priv_data

struct AVCodecInternal *	internal
	Private context used for internal data. More...

void *	opaque
	Private data of the user, can be used to carry app specific stuff. More...

int64_t	bit_rate
	the average bitrate More...

int	bit_rate_tolerance
	number of bits the bitstream is allowed to diverge from the reference. More...

int	global_quality
	Global quality for codecs which cannot change it per frame. More...

int	compression_level

int	flags
	AV_CODEC_FLAG_*. More...

int	flags2
	AV_CODEC_FLAG2_*. More...

uint8_t *	extradata
	some codecs need / can use extradata like Huffman tables. More...

int	extradata_size

AVRational	time_base
	This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented. More...

int	ticks_per_frame
	For some codecs, the time base is closer to the field rate than the frame rate. More...

int	delay
	Codec delay. More...

int	width
	picture width / height. More...

int	height

int	coded_width
	Bitstream width / height, may be different from width/height e.g. More...

int	coded_height

int	gop_size
	the number of pictures in a group of pictures, or 0 for intra_only More...

enum AVPixelFormat	pix_fmt
	Pixel format, see AV_PIX_FMT_xxx. More...

void(*	draw_horiz_band )(struct AVCodecContext s, const AVFrame src, int offset[AV_NUM_DATA_POINTERS], int y, int type, int height)
	If non NULL, 'draw_horiz_band' is called by the libavcodec decoder to draw a horizontal band. More...

enum AVPixelFormat(*	get_format )(struct AVCodecContext s, const enum AVPixelFormat fmt)
	Callback to negotiate the pixel format. More...

int	max_b_frames
	maximum number of B-frames between non-B-frames Note: The output will be delayed by max_b_frames+1 relative to the input. More...

float	b_quant_factor
	qscale factor between IP and B-frames If > 0 then the last P-frame quantizer will be used (q= lastp_q*factor+offset). More...

float	b_quant_offset
	qscale offset between IP and B-frames More...

int	has_b_frames
	Size of the frame reordering buffer in the decoder. More...

float	i_quant_factor
	qscale factor between P- and I-frames If > 0 then the last P-frame quantizer will be used (q = lastp_q * factor + offset). More...

float	i_quant_offset
	qscale offset between P and I-frames More...

float	lumi_masking
	luminance masking (0-> disabled) More...

float	temporal_cplx_masking
	temporary complexity masking (0-> disabled) More...

float	spatial_cplx_masking
	spatial complexity masking (0-> disabled) More...

float	p_masking
	p block masking (0-> disabled) More...

float	dark_masking
	darkness masking (0-> disabled) More...

int	slice_count
	slice count More...

int *	slice_offset
	slice offsets in the frame in bytes More...

AVRational	sample_aspect_ratio
	sample aspect ratio (0 if unknown) That is the width of a pixel divided by the height of the pixel. More...

int	me_cmp
	motion estimation comparison function More...

int	me_sub_cmp
	subpixel motion estimation comparison function More...

int	mb_cmp
	macroblock comparison function (not supported yet) More...

int	ildct_cmp
	interlaced DCT comparison function More...

int	dia_size
	ME diamond size & shape. More...

int	last_predictor_count
	amount of previous MV predictors (2a+1 x 2a+1 square) More...

int	me_pre_cmp
	motion estimation prepass comparison function More...

int	pre_dia_size
	ME prepass diamond size & shape. More...

int	me_subpel_quality
	subpel ME quality More...

int	me_range
	maximum motion estimation search range in subpel units If 0 then no limit. More...

int	slice_flags
	slice flags More...

int	mb_decision
	macroblock decision mode More...

uint16_t *	intra_matrix
	custom intra quantization matrix Must be allocated with the av_malloc() family of functions, and will be freed in avcodec_free_context(). More...

uint16_t *	inter_matrix
	custom inter quantization matrix Must be allocated with the av_malloc() family of functions, and will be freed in avcodec_free_context(). More...

int	intra_dc_precision
	precision of the intra DC coefficient - 8 More...

int	skip_top
	Number of macroblock rows at the top which are skipped. More...

int	skip_bottom
	Number of macroblock rows at the bottom which are skipped. More...

int	mb_lmin
	minimum MB Lagrange multiplier More...

int	mb_lmax
	maximum MB Lagrange multiplier More...

int	bidir_refine

int	keyint_min
	minimum GOP size More...

int	refs
	number of reference frames More...

int	mv0_threshold
	Note: Value depends upon the compare function used for fullpel ME. More...

enum AVColorPrimaries	color_primaries
	Chromaticity coordinates of the source primaries. More...

enum AVColorTransferCharacteristic	color_trc
	Color Transfer Characteristic. More...

enum AVColorSpace	colorspace
	YUV colorspace type. More...

enum AVColorRange	color_range
	MPEG vs JPEG YUV range. More...

enum AVChromaLocation	chroma_sample_location
	This defines the location of chroma samples. More...

int	slices
	Number of slices. More...

enum AVFieldOrder	field_order
	Field order. More...

int	sample_rate
	samples per second More...

attribute_deprecated int	channels
	number of audio channels More...

enum AVSampleFormat	sample_fmt
	audio sample format More...

int	frame_size
	Number of samples per channel in an audio frame. More...

int	frame_number
	Frame counter, set by libavcodec. More...

int	block_align
	number of bytes per packet if constant and known or 0 Used by some WAV based audio codecs. More...

int	cutoff
	Audio cutoff bandwidth (0 means "automatic") More...

attribute_deprecated uint64_t	channel_layout
	Audio channel layout. More...

attribute_deprecated uint64_t	request_channel_layout
	Request decoder to use this channel layout if it can (0 for default) More...

enum AVAudioServiceType	audio_service_type
	Type of service that the audio stream conveys. More...

enum AVSampleFormat	request_sample_fmt
	desired sample format More...

int(*	get_buffer2 )(struct AVCodecContext s, AVFrame frame, int flags)
	This callback is called at the beginning of each frame to get data buffer(s) for it. More...

float	qcompress
	amount of qscale change between easy & hard scenes (0.0-1.0) More...

float	qblur
	amount of qscale smoothing over time (0.0-1.0) More...

int	qmin
	minimum quantizer More...

int	qmax
	maximum quantizer More...

int	max_qdiff
	maximum quantizer difference between frames More...

int	rc_buffer_size
	decoder bitstream buffer size More...

int	rc_override_count
	ratecontrol override, see RcOverride More...

RcOverride *	rc_override

int64_t	rc_max_rate
	maximum bitrate More...

int64_t	rc_min_rate
	minimum bitrate More...

float	rc_max_available_vbv_use
	Ratecontrol attempt to use, at maximum, of what can be used without an underflow. More...

float	rc_min_vbv_overflow_use
	Ratecontrol attempt to use, at least, times the amount needed to prevent a vbv overflow. More...

int	rc_initial_buffer_occupancy
	Number of bits which should be loaded into the rc buffer before decoding starts. More...

int	trellis
	trellis RD quantization More...

char *	stats_out
	pass1 encoding statistics output buffer More...

char *	stats_in
	pass2 encoding statistics input buffer Concatenated stuff from stats_out of pass1 should be placed here. More...

int	workaround_bugs
	Work around bugs in encoders which sometimes cannot be detected automatically. More...

int	strict_std_compliance
	strictly follow the standard (MPEG-4, ...). More...

int	error_concealment
	error concealment flags More...

int	debug
	debug More...

int	err_recognition
	Error recognition; may misdetect some more or less valid parts as errors. More...

int64_t	reordered_opaque
	opaque 64-bit number (generally a PTS) that will be reordered and output in AVFrame.reordered_opaque More...

const struct AVHWAccel *	hwaccel
	Hardware accelerator in use. More...

void *	hwaccel_context
	Hardware accelerator context. More...

uint64_t	error [AV_NUM_DATA_POINTERS]
	error More...

int	dct_algo
	DCT algorithm, see FF_DCT_* below. More...

int	idct_algo
	IDCT algorithm, see FF_IDCT_* below. More...

int	bits_per_coded_sample
	bits per sample/pixel from the demuxer (needed for huffyuv). More...

int	bits_per_raw_sample
	Bits per sample/pixel of internal libavcodec pixel/sample format. More...

int	lowres
	low resolution decoding, 1-> 1/2 size, 2->1/4 size More...

int	thread_count
	thread count is used to decide how many independent tasks should be passed to execute() More...

int	thread_type
	Which multithreading methods to use. More...

int	active_thread_type
	Which multithreading methods are in use by the codec. More...

attribute_deprecated int	thread_safe_callbacks
	Set by the client if its custom get_buffer() callback can be called synchronously from another thread, which allows faster multithreaded decoding. More...

int(*	execute )(struct AVCodecContext c, int(func)(struct AVCodecContext c2, void arg), void arg2, int ret, int count, int size)
	The codec may call this to execute several independent things. More...

int(*	execute2 )(struct AVCodecContext c, int(func)(struct AVCodecContext c2, void arg, int jobnr, int threadnr), void arg2, int ret, int count)
	The codec may call this to execute several independent things. More...

int	nsse_weight
	noise vs. More...

int	profile
	profile More...

int	level
	level More...

enum AVDiscard	skip_loop_filter
	Skip loop filtering for selected frames. More...

enum AVDiscard	skip_idct
	Skip IDCT/dequantization for selected frames. More...

enum AVDiscard	skip_frame
	Skip decoding for selected frames. More...

uint8_t *	subtitle_header
	Header containing style information for text subtitles. More...

int	subtitle_header_size

int	initial_padding
	Audio only. More...

AVRational	framerate

enum AVPixelFormat	sw_pix_fmt
	Nominal unaccelerated pixel format, see AV_PIX_FMT_xxx. More...

AVRational	pkt_timebase
	Timebase in which pkt_dts/pts and AVPacket.dts/pts are. More...

const AVCodecDescriptor *	codec_descriptor
	AVCodecDescriptor. More...

int64_t	pts_correction_num_faulty_pts
	Current statistics for PTS correction. More...

int64_t	pts_correction_num_faulty_dts
	Number of incorrect PTS values so far. More...

int64_t	pts_correction_last_pts
	Number of incorrect DTS values so far. More...

int64_t	pts_correction_last_dts
	PTS of the last frame. More...

char *	sub_charenc
	DTS of the last frame. More...

int	sub_charenc_mode
	Subtitles character encoding mode. More...

int	skip_alpha
	Skip processing alpha if supported by codec. More...

int	seek_preroll
	Number of samples to skip after a discontinuity. More...

attribute_deprecated int	debug_mv

uint16_t *	chroma_intra_matrix
	custom intra quantization matrix More...

uint8_t *	dump_separator
	dump format separator. More...

char *	codec_whitelist
	',' separated list of allowed decoders. More...

unsigned	properties
	Properties of the stream that gets decoded. More...

AVPacketSideData *	coded_side_data
	Additional data associated with the entire coded stream. More...

int	nb_coded_side_data

AVBufferRef *	hw_frames_ctx
	A reference to the AVHWFramesContext describing the input (for encoding) or output (decoding) frames. More...

attribute_deprecated int	sub_text_format

int	trailing_padding
	Audio only. More...

int64_t	max_pixels
	The number of pixels per image to maximally accept. More...

AVBufferRef *	hw_device_ctx
	A reference to the AVHWDeviceContext describing the device which will be used by a hardware encoder/decoder. More...

int	hwaccel_flags
	Bit set of AV_HWACCEL_FLAG_* flags, which affect hardware accelerated decoding (if active). More...

int	apply_cropping
	Video decoding only. More...

int	extra_hw_frames

int	discard_damaged_percentage
	The percentage of damaged samples to discard a frame. More...

int64_t	max_samples
	The number of samples per frame to maximally accept. More...

int	export_side_data
	Bit set of AV_CODEC_EXPORT_DATA_* flags, which affects the kind of metadata exported in frame, packet, or coded stream side data by decoders and encoders. More...

int(*	get_encode_buffer )(struct AVCodecContext s, AVPacket pkt, int flags)
	This callback is called at the beginning of each packet to get a data buffer for it. More...

AVChannelLayout	ch_layout
	Audio channel layout. More...

Detailed Description

main external API structure.

New fields can be added to the end with minor version bumps. Removal, reordering and changes to existing fields require a major version bump. You can use AVOptions (av_opt* / av_set/get*()) to access these fields from user applications. The name string for AVOptions options matches the associated command line parameter name and can be found in libavcodec/options_table.h The AVOption/command line parameter names differ in some cases from the C structure field names for historic reasons or brevity. sizeof(AVCodecContext) must not be used outside libav*.

Examples: decode_audio.c, decode_video.c, demuxing_decoding.c, encode_audio.c, encode_video.c, filtering_audio.c, filtering_video.c, hw_decode.c, muxing.c, qsvdec.c, transcode_aac.c, transcoding.c, vaapi_encode.c, and vaapi_transcode.c.

Definition at line 389 of file avcodec.h.

Field Documentation

◆ av_class

const AVClass* AVCodecContext::av_class

information on struct for av_log

set by avcodec_alloc_context3

Definition at line 394 of file avcodec.h.

◆ log_level_offset

int AVCodecContext::log_level_offset

Definition at line 395 of file avcodec.h.

◆ codec_type

enum AVMediaType AVCodecContext::codec_type

Examples: transcoding.c.

Definition at line 397 of file avcodec.h.

Referenced by init_filter(), open_input_file(), and open_output_file().

◆ codec

const struct AVCodec* AVCodecContext::codec

Examples: demuxing_decoding.c, muxing.c, and transcoding.c.

Definition at line 398 of file avcodec.h.

Referenced by decode_packet(), and open_audio().

◆ codec_id

enum AVCodecID AVCodecContext::codec_id

Examples: muxing.c, qsvdec.c, and transcoding.c.

Definition at line 399 of file avcodec.h.

Referenced by add_stream(), main(), and open_output_file().

◆ codec_tag

unsigned int AVCodecContext::codec_tag

fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').

This is used to work around some encoder bugs. A demuxer should set this to what is stored in the field used to identify the codec. If there are multiple such fields in a container then the demuxer should choose the one which maximizes the information about the used codec. If the codec tag field in a container is larger than 32 bits then the demuxer should remap the longer ID to 32 bits with a table or other structure. Alternatively a new extra_codec_tag + size could be added but for this a clear advantage must be demonstrated first.

encoding: Set by user, if not then the default based on codec_id will be used.
decoding: Set by user, will be converted to uppercase by libavcodec during init.

Definition at line 414 of file avcodec.h.

◆ priv_data

void* AVCodecContext::priv_data

Examples: encode_video.c.

Definition at line 416 of file avcodec.h.

Referenced by main().

◆ internal

struct AVCodecInternal* AVCodecContext::internal

Private context used for internal data.

Unlike priv_data, this is not codec-specific. It is used in general libavcodec functions.

Definition at line 424 of file avcodec.h.

◆ opaque

void* AVCodecContext::opaque

Private data of the user, can be used to carry app specific stuff.

encoding: Set by user.
decoding: Set by user.

Definition at line 431 of file avcodec.h.

◆ bit_rate

int64_t AVCodecContext::bit_rate

the average bitrate

encoding: Set by user; unused for constant quantizer encoding.
decoding: Set by user, may be overwritten by libavcodec if this info is available in the stream

Examples: encode_audio.c, encode_video.c, muxing.c, and transcode_aac.c.

Definition at line 439 of file avcodec.h.

Referenced by add_stream(), main(), and open_output_file().

◆ bit_rate_tolerance

int AVCodecContext::bit_rate_tolerance

number of bits the bitstream is allowed to diverge from the reference.

the reference can be CBR (for CBR pass1) or VBR (for pass2)

encoding: Set by user; unused for constant quantizer encoding.
decoding: unused

Definition at line 447 of file avcodec.h.

◆ global_quality

int AVCodecContext::global_quality

Global quality for codecs which cannot change it per frame.

This should be proportional to MPEG-1/2/4 qscale.

encoding: Set by user.
decoding: unused

Definition at line 455 of file avcodec.h.

◆ compression_level

int AVCodecContext::compression_level

encoding: Set by user.
decoding: unused

Definition at line 461 of file avcodec.h.

◆ flags

int AVCodecContext::flags

AV_CODEC_FLAG_*.

encoding: Set by user.
decoding: Set by user.

Examples: muxing.c, transcode_aac.c, and transcoding.c.

Definition at line 469 of file avcodec.h.

Referenced by add_stream(), and open_output_file().

◆ flags2

int AVCodecContext::flags2

AV_CODEC_FLAG2_*.

encoding: Set by user.
decoding: Set by user.

Definition at line 476 of file avcodec.h.

◆ extradata

uint8_t* AVCodecContext::extradata

some codecs need / can use extradata like Huffman tables.

MJPEG: Huffman tables rv10: additional flags MPEG-4: global headers (they can be in the bitstream or here) The allocated memory should be AV_INPUT_BUFFER_PADDING_SIZE bytes larger than extradata_size to avoid problems if it is read with the bitstream reader. The bytewise contents of extradata must not depend on the architecture or CPU endianness. Must be allocated with the av_malloc() family of functions.

encoding: Set/allocated/freed by libavcodec.
decoding: Set/allocated/freed by user.

Examples: qsvdec.c.

Definition at line 490 of file avcodec.h.

Referenced by main().

◆ extradata_size

int AVCodecContext::extradata_size

Examples: qsvdec.c.

Definition at line 491 of file avcodec.h.

Referenced by main().

◆ time_base

AVRational AVCodecContext::time_base

This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented.

For fixed-fps content, timebase should be 1/framerate and timestamp increments should be identically 1. This often, but not always is the inverse of the frame rate or field rate for video. 1/time_base is not the average frame rate if the frame rate is not constant.

Like containers, elementary streams also can store timestamps, 1/time_base is the unit in which these timestamps are specified. As example of such codec time base see ISO/IEC 14496-2:2001(E) vop_time_increment_resolution and fixed_vop_rate (fixed_vop_rate == 0 implies that it is different from the framerate)

encoding: MUST be set by user.
decoding: the use of this field for decoding is deprecated. Use framerate instead.

Examples: demuxing_decoding.c, encode_video.c, muxing.c, transcoding.c, vaapi_encode.c, and vaapi_transcode.c.

Definition at line 512 of file avcodec.h.

Referenced by add_stream(), dec_enc(), encode_write_frame(), get_video_frame(), init_filter(), main(), open_output_file(), output_audio_frame(), write_audio_frame(), and write_frame().

◆ ticks_per_frame

int AVCodecContext::ticks_per_frame

For some codecs, the time base is closer to the field rate than the frame rate.

Most notably, H.264 and MPEG-2 specify time_base as half of frame duration if no telecine is used ...

Set to time_base ticks per frame. Default 1, e.g., H.264/MPEG-2 set it to 2.

Definition at line 521 of file avcodec.h.

◆ delay

int AVCodecContext::delay

Codec delay.

Encoding: Number of frames delay there will be from the encoder input to the decoder output. (we assume the decoder matches the spec) Decoding: Number of frames delay in addition to what a standard decoder as specified in the spec would produce.

Video: Number of frames the decoded output will be delayed relative to the encoded input.

Audio: For encoding, this field is unused (see initial_padding).

For decoding, this is the number of samples the decoder needs to output before the decoder's output is valid. When seeking, you should start decoding this many samples prior to your desired seek point.

encoding: Set by libavcodec.
decoding: Set by libavcodec.

Definition at line 545 of file avcodec.h.

◆ width

int AVCodecContext::width

picture width / height.

Note: Those fields may not match the values of the last AVFrame output by avcodec_receive_frame() due frame reordering.

encoding: MUST be set by user.
decoding: May be set by the user before opening the decoder if known e.g. from the container. Some decoders will require the dimensions to be set by the caller. During decoding, the decoder may overwrite those values as required while parsing the data.

Examples: demuxing_decoding.c, encode_video.c, filtering_video.c, muxing.c, transcoding.c, vaapi_encode.c, and vaapi_transcode.c.

Definition at line 562 of file avcodec.h.

Referenced by add_stream(), dec_enc(), get_video_frame(), init_filter(), init_filters(), main(), open_output_file(), and open_video().

◆ height

int AVCodecContext::height

Examples: demuxing_decoding.c, encode_video.c, filtering_video.c, muxing.c, transcoding.c, vaapi_encode.c, and vaapi_transcode.c.

Definition at line 562 of file avcodec.h.

Referenced by add_stream(), dec_enc(), get_video_frame(), init_filter(), init_filters(), main(), open_output_file(), and open_video().

◆ coded_width

int AVCodecContext::coded_width

Bitstream width / height, may be different from width/height e.g.

when the decoded frame is cropped before being output or lowres is enabled.

Note: Those field may not match the value of the last AVFrame output by avcodec_receive_frame() due frame reordering.

encoding: unused
decoding: May be set by the user before opening the decoder if known e.g. from the container. During decoding, the decoder may overwrite those values as required while parsing the data.

Definition at line 577 of file avcodec.h.

◆ coded_height

int AVCodecContext::coded_height

Definition at line 577 of file avcodec.h.

◆ gop_size

int AVCodecContext::gop_size

the number of pictures in a group of pictures, or 0 for intra_only

encoding: Set by user.
decoding: unused

Examples: encode_video.c, and muxing.c.

Definition at line 584 of file avcodec.h.

Referenced by add_stream(), and main().

◆ pix_fmt

enum AVPixelFormat AVCodecContext::pix_fmt

Pixel format, see AV_PIX_FMT_xxx.

May be set by the demuxer if known from headers. May be overridden by the decoder if it knows better.

Note: This field may not match the value of the last AVFrame output by avcodec_receive_frame() due frame reordering.

encoding: Set by user.
decoding: Set by user if known, overridden by libavcodec while parsing the data.

Examples: demuxing_decoding.c, encode_video.c, filtering_video.c, muxing.c, transcoding.c, vaapi_encode.c, and vaapi_transcode.c.

Definition at line 599 of file avcodec.h.

Referenced by add_stream(), dec_enc(), get_video_frame(), init_filter(), init_filters(), main(), open_output_file(), and open_video().

◆ draw_horiz_band

void(* AVCodecContext::draw_horiz_band) (struct AVCodecContext *s, const AVFrame *src, int offset[AV_NUM_DATA_POINTERS], int y, int type, int height)

If non NULL, 'draw_horiz_band' is called by the libavcodec decoder to draw a horizontal band.

It improves cache usage. Not all codecs can do that. You must check the codec capabilities beforehand. When multithreading is used, it may be called from multiple threads at the same time; threads might draw different parts of the same AVFrame, or multiple AVFrames, and there is no guarantee that slices will be drawn in order. The function is also used by hardware acceleration APIs. It is called at least once during frame decoding to pass the data needed for hardware render. In that mode instead of pixel data, AVFrame points to a structure specific to the acceleration API. The application reads the structure and can change some fields to indicate progress or mark state.

encoding: unused
decoding: Set by user.
Parameters

height the height of the slice

y the y position of the slice

type 1->top field, 2->bottom field, 3->frame

offset offset into the AVFrame.data from which the slice should be read

Definition at line 624 of file avcodec.h.

◆ get_format

enum AVPixelFormat(* AVCodecContext::get_format) (struct AVCodecContext *s, const enum AVPixelFormat *fmt)

Callback to negotiate the pixel format.

Decoding only, may be set by the caller before avcodec_open2().

Called by some decoders to select the pixel format that will be used for the output frames. This is mainly used to set up hardware acceleration, then the provided format list contains the corresponding hwaccel pixel formats alongside the "software" one. The software pixel format may also be retrieved from sw_pix_fmt.

This callback will be called when the coded frame properties (such as resolution, pixel format, etc.) change and more than one output format is supported for those new properties. If a hardware pixel format is chosen and initialization for it fails, the callback may be called again immediately.

This callback may be called from different threads if the decoder is multi-threaded, but not from more than one thread simultaneously.

Parameters

fmt	list of formats which may be used in the current configuration, terminated by AV_PIX_FMT_NONE.

Warning: Behavior is undefined if the callback returns a value other than one of the formats in fmt or AV_PIX_FMT_NONE.

Returns: the chosen format or AV_PIX_FMT_NONE

Examples: hw_decode.c, qsvdec.c, and vaapi_transcode.c.

Definition at line 624 of file avcodec.h.

Referenced by main(), and open_input_file().

◆ max_b_frames

int AVCodecContext::max_b_frames

maximum number of B-frames between non-B-frames Note: The output will be delayed by max_b_frames+1 relative to the input.

encoding: Set by user.
decoding: unused

Examples: encode_video.c, and muxing.c.

Definition at line 661 of file avcodec.h.

Referenced by add_stream(), and main().

◆ b_quant_factor

float AVCodecContext::b_quant_factor

qscale factor between IP and B-frames If > 0 then the last P-frame quantizer will be used (q= lastp_q*factor+offset).

If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).

encoding: Set by user.
decoding: unused

Definition at line 670 of file avcodec.h.

◆ b_quant_offset

float AVCodecContext::b_quant_offset

qscale offset between IP and B-frames

encoding: Set by user.
decoding: unused

Definition at line 677 of file avcodec.h.

◆ has_b_frames

int AVCodecContext::has_b_frames

Size of the frame reordering buffer in the decoder.

For MPEG-2 it is 1 IPB or 0 low delay IP.

encoding: Set by libavcodec.
decoding: Set by libavcodec.

Definition at line 685 of file avcodec.h.

◆ i_quant_factor

float AVCodecContext::i_quant_factor

qscale factor between P- and I-frames If > 0 then the last P-frame quantizer will be used (q = lastp_q * factor + offset).

If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).

encoding: Set by user.
decoding: unused

Definition at line 694 of file avcodec.h.

◆ i_quant_offset

float AVCodecContext::i_quant_offset

qscale offset between P and I-frames

encoding: Set by user.
decoding: unused

Definition at line 701 of file avcodec.h.

◆ lumi_masking

float AVCodecContext::lumi_masking

luminance masking (0-> disabled)

encoding: Set by user.
decoding: unused

Definition at line 708 of file avcodec.h.

◆ temporal_cplx_masking

float AVCodecContext::temporal_cplx_masking

temporary complexity masking (0-> disabled)

encoding: Set by user.
decoding: unused

Definition at line 715 of file avcodec.h.

◆ spatial_cplx_masking

float AVCodecContext::spatial_cplx_masking

spatial complexity masking (0-> disabled)

encoding: Set by user.
decoding: unused

Definition at line 722 of file avcodec.h.

◆ p_masking

float AVCodecContext::p_masking

p block masking (0-> disabled)

encoding: Set by user.
decoding: unused

Definition at line 729 of file avcodec.h.

◆ dark_masking

float AVCodecContext::dark_masking

darkness masking (0-> disabled)

encoding: Set by user.
decoding: unused

Definition at line 736 of file avcodec.h.

◆ slice_count

int AVCodecContext::slice_count

slice count

encoding: Set by libavcodec.
decoding: Set by user (or 0).

Definition at line 743 of file avcodec.h.

◆ slice_offset

int* AVCodecContext::slice_offset

slice offsets in the frame in bytes

encoding: Set/allocated by libavcodec.
decoding: Set/allocated by user (or NULL).

Definition at line 750 of file avcodec.h.

◆ sample_aspect_ratio

AVRational AVCodecContext::sample_aspect_ratio

sample aspect ratio (0 if unknown) That is the width of a pixel divided by the height of the pixel.

Numerator and denominator must be relatively prime and smaller than 256 for some video standards.

encoding: Set by user.
decoding: Set by libavcodec.

Examples: filtering_video.c, transcoding.c, and vaapi_encode.c.

Definition at line 759 of file avcodec.h.

Referenced by init_filter(), init_filters(), main(), and open_output_file().

◆ me_cmp

int AVCodecContext::me_cmp

motion estimation comparison function

encoding: Set by user.
decoding: unused

Definition at line 766 of file avcodec.h.

◆ me_sub_cmp

int AVCodecContext::me_sub_cmp

subpixel motion estimation comparison function

encoding: Set by user.
decoding: unused

Definition at line 772 of file avcodec.h.

◆ mb_cmp

int AVCodecContext::mb_cmp

macroblock comparison function (not supported yet)

encoding: Set by user.
decoding: unused

Definition at line 778 of file avcodec.h.

◆ ildct_cmp

int AVCodecContext::ildct_cmp

interlaced DCT comparison function

encoding: Set by user.
decoding: unused

Definition at line 784 of file avcodec.h.

◆ dia_size

int AVCodecContext::dia_size

ME diamond size & shape.

encoding: Set by user.
decoding: unused

Definition at line 808 of file avcodec.h.

◆ last_predictor_count

int AVCodecContext::last_predictor_count

amount of previous MV predictors (2a+1 x 2a+1 square)

encoding: Set by user.
decoding: unused

Definition at line 815 of file avcodec.h.

◆ me_pre_cmp

int AVCodecContext::me_pre_cmp

motion estimation prepass comparison function

encoding: Set by user.
decoding: unused

Definition at line 822 of file avcodec.h.

◆ pre_dia_size

int AVCodecContext::pre_dia_size

ME prepass diamond size & shape.

encoding: Set by user.
decoding: unused

Definition at line 829 of file avcodec.h.

◆ me_subpel_quality

int AVCodecContext::me_subpel_quality

subpel ME quality

encoding: Set by user.
decoding: unused

Definition at line 836 of file avcodec.h.

◆ me_range

int AVCodecContext::me_range

maximum motion estimation search range in subpel units If 0 then no limit.

encoding: Set by user.
decoding: unused

Definition at line 845 of file avcodec.h.

◆ slice_flags

int AVCodecContext::slice_flags

slice flags

encoding: unused
decoding: Set by user.

Definition at line 852 of file avcodec.h.

◆ mb_decision

int AVCodecContext::mb_decision

macroblock decision mode

encoding: Set by user.
decoding: unused

Examples: muxing.c.

Definition at line 862 of file avcodec.h.

Referenced by add_stream().

◆ intra_matrix

uint16_t* AVCodecContext::intra_matrix

custom intra quantization matrix Must be allocated with the av_malloc() family of functions, and will be freed in avcodec_free_context().

encoding: Set/allocated by user, freed by libavcodec. Can be NULL.
decoding: Set/allocated/freed by libavcodec.

Definition at line 874 of file avcodec.h.

◆ inter_matrix

uint16_t* AVCodecContext::inter_matrix

custom inter quantization matrix Must be allocated with the av_malloc() family of functions, and will be freed in avcodec_free_context().

encoding: Set/allocated by user, freed by libavcodec. Can be NULL.
decoding: Set/allocated/freed by libavcodec.

Definition at line 883 of file avcodec.h.

◆ intra_dc_precision

int AVCodecContext::intra_dc_precision

precision of the intra DC coefficient - 8

encoding: Set by user.
decoding: Set by libavcodec

Definition at line 890 of file avcodec.h.

◆ skip_top

int AVCodecContext::skip_top

Number of macroblock rows at the top which are skipped.

encoding: unused
decoding: Set by user.

Definition at line 897 of file avcodec.h.

◆ skip_bottom

int AVCodecContext::skip_bottom

Number of macroblock rows at the bottom which are skipped.

encoding: unused
decoding: Set by user.

Definition at line 904 of file avcodec.h.

◆ mb_lmin

int AVCodecContext::mb_lmin

minimum MB Lagrange multiplier

encoding: Set by user.
decoding: unused

Definition at line 911 of file avcodec.h.

◆ mb_lmax

int AVCodecContext::mb_lmax

maximum MB Lagrange multiplier

encoding: Set by user.
decoding: unused

Definition at line 918 of file avcodec.h.

◆ bidir_refine

int AVCodecContext::bidir_refine

encoding: Set by user.
decoding: unused

Definition at line 924 of file avcodec.h.

◆ keyint_min

int AVCodecContext::keyint_min

minimum GOP size

encoding: Set by user.
decoding: unused

Definition at line 931 of file avcodec.h.

◆ refs

int AVCodecContext::refs

number of reference frames

encoding: Set by user.
decoding: Set by lavc.

Definition at line 938 of file avcodec.h.

◆ mv0_threshold

int AVCodecContext::mv0_threshold

Note: Value depends upon the compare function used for fullpel ME.

encoding: Set by user.
decoding: unused

Definition at line 945 of file avcodec.h.

◆ color_primaries

enum AVColorPrimaries AVCodecContext::color_primaries

Chromaticity coordinates of the source primaries.

encoding: Set by user
decoding: Set by libavcodec

Definition at line 952 of file avcodec.h.

◆ color_trc

enum AVColorTransferCharacteristic AVCodecContext::color_trc

Color Transfer Characteristic.

encoding: Set by user
decoding: Set by libavcodec

Definition at line 959 of file avcodec.h.

◆ colorspace

enum AVColorSpace AVCodecContext::colorspace

YUV colorspace type.

encoding: Set by user
decoding: Set by libavcodec

Definition at line 966 of file avcodec.h.

◆ color_range

enum AVColorRange AVCodecContext::color_range

MPEG vs JPEG YUV range.

encoding: Set by user
decoding: Set by libavcodec

Definition at line 973 of file avcodec.h.

◆ chroma_sample_location

enum AVChromaLocation AVCodecContext::chroma_sample_location

This defines the location of chroma samples.

encoding: Set by user
decoding: Set by libavcodec

Definition at line 980 of file avcodec.h.

◆ slices

int AVCodecContext::slices

Number of slices.

Indicates number of picture subdivisions. Used for parallelized decoding.

encoding: Set by user
decoding: unused

Definition at line 989 of file avcodec.h.

◆ field_order

enum AVFieldOrder AVCodecContext::field_order

Field order.

encoding: set by libavcodec
decoding: Set by user.

Definition at line 995 of file avcodec.h.

◆ sample_rate

int AVCodecContext::sample_rate

samples per second

Examples: decode_audio.c, demuxing_decoding.c, encode_audio.c, filtering_audio.c, muxing.c, transcode_aac.c, and transcoding.c.

Definition at line 998 of file avcodec.h.

Referenced by add_stream(), init_filter(), init_filters(), init_output_frame(), init_resampler(), main(), open_audio(), open_output_file(), and write_audio_frame().

◆ channels

attribute_deprecated int AVCodecContext::channels

number of audio channels

Deprecated:: use ch_layout.nb_channels

Definition at line 1006 of file avcodec.h.

◆ sample_fmt

enum AVSampleFormat AVCodecContext::sample_fmt

audio sample format

encoding: Set by user.
decoding: Set by libavcodec. sample format

Examples: decode_audio.c, demuxing_decoding.c, encode_audio.c, filtering_audio.c, muxing.c, transcode_aac.c, and transcoding.c.

Definition at line 1014 of file avcodec.h.

Referenced by add_stream(), decode(), init_converted_samples(), init_fifo(), init_filter(), init_filters(), init_output_frame(), init_resampler(), main(), open_audio(), and open_output_file().

◆ frame_size

int AVCodecContext::frame_size

Number of samples per channel in an audio frame.

encoding: set by libavcodec in avcodec_open2(). Each submitted frame except the last must contain exactly frame_size samples per channel. May be 0 when the codec has AV_CODEC_CAP_VARIABLE_FRAME_SIZE set, then the frame size is not restricted.
decoding: may be set by some decoders to indicate constant frame size

Examples: encode_audio.c, muxing.c, and transcode_aac.c.

Definition at line 1026 of file avcodec.h.

Referenced by load_encode_and_write(), main(), and open_audio().

◆ frame_number

int AVCodecContext::frame_number

Frame counter, set by libavcodec.

decoding: total number of frames returned from the decoder so far.
encoding: total number of frames passed to the encoder so far.

Note
the counter is not incremented if encoding/decoding resulted in an error.

Examples: decode_video.c.

Definition at line 1037 of file avcodec.h.

Referenced by decode().

◆ block_align

int AVCodecContext::block_align

number of bytes per packet if constant and known or 0 Used by some WAV based audio codecs.

Definition at line 1043 of file avcodec.h.

◆ cutoff

int AVCodecContext::cutoff

Audio cutoff bandwidth (0 means "automatic")

encoding: Set by user.
decoding: unused

Definition at line 1050 of file avcodec.h.

◆ channel_layout

attribute_deprecated uint64_t AVCodecContext::channel_layout

Audio channel layout.

encoding: set by user.
decoding: set by user, may be overwritten by libavcodec.
Deprecated:
use ch_layout

Definition at line 1060 of file avcodec.h.

◆ request_channel_layout

attribute_deprecated uint64_t AVCodecContext::request_channel_layout

Request decoder to use this channel layout if it can (0 for default)

encoding: unused
decoding: Set by user.
Deprecated:
use "downmix" codec private option

Definition at line 1069 of file avcodec.h.

◆ audio_service_type

enum AVAudioServiceType AVCodecContext::audio_service_type

Type of service that the audio stream conveys.

encoding: Set by user.
decoding: Set by libavcodec.

Definition at line 1077 of file avcodec.h.

◆ request_sample_fmt

enum AVSampleFormat AVCodecContext::request_sample_fmt

desired sample format

encoding: Not used.
decoding: Set by user. Decoder will decode to this format if it can.

Definition at line 1085 of file avcodec.h.

◆ get_buffer2

int(* AVCodecContext::get_buffer2) (struct AVCodecContext *s, AVFrame *frame, int flags)

This callback is called at the beginning of each frame to get data buffer(s) for it.

There may be one contiguous buffer for all the data or there may be a buffer per each data plane or anything in between. What this means is, you may set however many entries in buf[] you feel necessary. Each buffer must be reference-counted using the AVBuffer API (see description of buf[] below).

The following fields will be set in the frame before this callback is called:

format
width, height (video only)
sample_rate, channel_layout, nb_samples (audio only) Their values may differ from the corresponding values in AVCodecContext. This callback must use the frame values, not the codec context values, to calculate the required buffer size.

This callback must fill the following fields in the frame:

data[]
linesize[]
extended_data:
- if the data is planar audio with more than 8 channels, then this callback must allocate and fill extended_data to contain all pointers to all data planes. data[] must hold as many pointers as it can. extended_data must be allocated with av_malloc() and will be freed in av_frame_unref().
- otherwise extended_data must point to data
buf[] must contain one or more pointers to AVBufferRef structures. Each of the frame's data and extended_data pointers must be contained in these. That is, one AVBufferRef for each allocated chunk of memory, not necessarily one AVBufferRef per data[] entry. See: av_buffer_create(), av_buffer_alloc(), and av_buffer_ref().
extended_buf and nb_extended_buf must be allocated with av_malloc() by this callback and filled with the extra buffers if there are more buffers than buf[] can hold. extended_buf will be freed in av_frame_unref().

If AV_CODEC_CAP_DR1 is not set then get_buffer2() must call avcodec_default_get_buffer2() instead of providing buffers allocated by some other means.

Each data plane must be aligned to the maximum required by the target CPU.

See also: avcodec_default_get_buffer2()

Video:

If AV_GET_BUFFER_FLAG_REF is set in flags then the frame may be reused (read and/or written to if it is writable) later by libavcodec.

avcodec_align_dimensions2() should be used to find the required width and height, as they normally need to be rounded up to the next multiple of 16.

Some decoders do not support linesizes changing between frames.

If frame multithreading is used, this callback may be called from a different thread, but not from more than one at once. Does not need to be reentrant.

See also: avcodec_align_dimensions2()

Audio:

Decoders request a buffer of a particular size by setting AVFrame.nb_samples prior to calling get_buffer2(). The decoder may, however, utilize only part of the buffer by setting AVFrame.nb_samples to a smaller value in the output frame.

As a convenience, av_samples_get_buffer_size() and av_samples_fill_arrays() in libavutil may be used by custom get_buffer2() functions to find the required data size and to fill data pointers and linesize. In AVFrame.linesize, only linesize[0] may be set for audio since all planes must be the same size.

See also: av_samples_get_buffer_size(), av_samples_fill_arrays()

encoding: unused
decoding: Set by libavcodec, user can override.

Definition at line 1167 of file avcodec.h.

◆ qcompress

float AVCodecContext::qcompress

amount of qscale change between easy & hard scenes (0.0-1.0)

Definition at line 1170 of file avcodec.h.

◆ qblur

float AVCodecContext::qblur

amount of qscale smoothing over time (0.0-1.0)

Definition at line 1171 of file avcodec.h.

◆ qmin

int AVCodecContext::qmin

minimum quantizer

encoding: Set by user.
decoding: unused

Definition at line 1178 of file avcodec.h.

◆ qmax

int AVCodecContext::qmax

maximum quantizer

encoding: Set by user.
decoding: unused

Definition at line 1185 of file avcodec.h.

◆ max_qdiff

int AVCodecContext::max_qdiff

maximum quantizer difference between frames

encoding: Set by user.
decoding: unused

Definition at line 1192 of file avcodec.h.

◆ rc_buffer_size

int AVCodecContext::rc_buffer_size

decoder bitstream buffer size

encoding: Set by user.
decoding: unused

Definition at line 1199 of file avcodec.h.

◆ rc_override_count

int AVCodecContext::rc_override_count

ratecontrol override, see RcOverride

encoding: Allocated/set/freed by user.
decoding: unused

Definition at line 1206 of file avcodec.h.

◆ rc_override

RcOverride* AVCodecContext::rc_override

Definition at line 1207 of file avcodec.h.

◆ rc_max_rate

int64_t AVCodecContext::rc_max_rate

maximum bitrate

encoding: Set by user.
decoding: Set by user, may be overwritten by libavcodec.

Definition at line 1214 of file avcodec.h.

◆ rc_min_rate

int64_t AVCodecContext::rc_min_rate

minimum bitrate

encoding: Set by user.
decoding: unused

Definition at line 1221 of file avcodec.h.

◆ rc_max_available_vbv_use

float AVCodecContext::rc_max_available_vbv_use

Ratecontrol attempt to use, at maximum, of what can be used without an underflow.

encoding: Set by user.
decoding: unused.

Definition at line 1228 of file avcodec.h.

◆ rc_min_vbv_overflow_use

float AVCodecContext::rc_min_vbv_overflow_use

Ratecontrol attempt to use, at least, times the amount needed to prevent a vbv overflow.

encoding: Set by user.
decoding: unused.

Definition at line 1235 of file avcodec.h.

◆ rc_initial_buffer_occupancy

int AVCodecContext::rc_initial_buffer_occupancy

Number of bits which should be loaded into the rc buffer before decoding starts.

encoding: Set by user.
decoding: unused

Definition at line 1242 of file avcodec.h.

◆ trellis

int AVCodecContext::trellis

trellis RD quantization

encoding: Set by user.
decoding: unused

Definition at line 1249 of file avcodec.h.

◆ stats_out

char* AVCodecContext::stats_out

pass1 encoding statistics output buffer

encoding: Set by libavcodec.
decoding: unused

Definition at line 1256 of file avcodec.h.

◆ stats_in

char* AVCodecContext::stats_in

pass2 encoding statistics input buffer Concatenated stuff from stats_out of pass1 should be placed here.

encoding: Allocated/set/freed by user.
decoding: unused

Definition at line 1264 of file avcodec.h.

◆ workaround_bugs

int AVCodecContext::workaround_bugs

Work around bugs in encoders which sometimes cannot be detected automatically.

encoding: Set by user
decoding: Set by user

Definition at line 1271 of file avcodec.h.

◆ strict_std_compliance

int AVCodecContext::strict_std_compliance

strictly follow the standard (MPEG-4, ...).

encoding: Set by user.
decoding: Set by user. Setting this to STRICT or higher means the encoder and decoder will generally do stupid things, whereas setting it to unofficial or lower will mean the encoder might produce output that is not supported by all spec-compliant decoders. Decoders don't differentiate between normal, unofficial and experimental (that is, they always try to decode things when they can) unless they are explicitly asked to behave stupidly (=strictly conform to the specs)

Definition at line 1300 of file avcodec.h.

◆ error_concealment

int AVCodecContext::error_concealment

error concealment flags

encoding: unused
decoding: Set by user.

Definition at line 1312 of file avcodec.h.

◆ debug

int AVCodecContext::debug

debug

encoding: Set by user.
decoding: Set by user.

Definition at line 1322 of file avcodec.h.

◆ err_recognition

int AVCodecContext::err_recognition

Error recognition; may misdetect some more or less valid parts as errors.

encoding: Set by user.
decoding: Set by user.

Definition at line 1344 of file avcodec.h.

◆ reordered_opaque

int64_t AVCodecContext::reordered_opaque

opaque 64-bit number (generally a PTS) that will be reordered and output in AVFrame.reordered_opaque

encoding: Set by libavcodec to the reordered_opaque of the input frame corresponding to the last returned packet. Only supported by encoders with the AV_CODEC_CAP_ENCODER_REORDERED_OPAQUE capability.
decoding: Set by user.

Definition at line 1372 of file avcodec.h.

◆ hwaccel

const struct AVHWAccel* AVCodecContext::hwaccel

Hardware accelerator in use.

encoding: unused.
decoding: Set by libavcodec

Definition at line 1379 of file avcodec.h.

◆ hwaccel_context

void* AVCodecContext::hwaccel_context

Hardware accelerator context.

For some hardware accelerators, a global context needs to be provided by the user. In that case, this holds display-dependent data FFmpeg cannot instantiate itself. Please refer to the FFmpeg HW accelerator documentation to know how to fill this.

encoding: unused
decoding: Set by user

Definition at line 1390 of file avcodec.h.

◆ error

uint64_t AVCodecContext::error[AV_NUM_DATA_POINTERS]

error

encoding: Set by libavcodec if flags & AV_CODEC_FLAG_PSNR.
decoding: unused

Definition at line 1397 of file avcodec.h.

◆ dct_algo

int AVCodecContext::dct_algo

DCT algorithm, see FF_DCT_* below.

encoding: Set by user.
decoding: unused

Definition at line 1404 of file avcodec.h.

◆ idct_algo

int AVCodecContext::idct_algo

IDCT algorithm, see FF_IDCT_* below.

encoding: Set by user.
decoding: Set by user.

Definition at line 1417 of file avcodec.h.

◆ bits_per_coded_sample

int AVCodecContext::bits_per_coded_sample

bits per sample/pixel from the demuxer (needed for huffyuv).

encoding: Set by libavcodec.
decoding: Set by user.

Definition at line 1441 of file avcodec.h.

◆ bits_per_raw_sample

int AVCodecContext::bits_per_raw_sample

Bits per sample/pixel of internal libavcodec pixel/sample format.

encoding: set by user.
decoding: set by libavcodec.

Definition at line 1448 of file avcodec.h.

◆ lowres

int AVCodecContext::lowres

low resolution decoding, 1-> 1/2 size, 2->1/4 size

encoding: unused
decoding: Set by user.

Definition at line 1455 of file avcodec.h.

◆ thread_count

int AVCodecContext::thread_count

thread count is used to decide how many independent tasks should be passed to execute()

encoding: Set by user.
decoding: Set by user.

Definition at line 1463 of file avcodec.h.

◆ thread_type

int AVCodecContext::thread_type

Which multithreading methods to use.

Use of FF_THREAD_FRAME will increase decoding delay by one frame per thread, so clients which cannot provide future frames should not use it.

encoding: Set by user, otherwise the default is used.
decoding: Set by user, otherwise the default is used.

Definition at line 1473 of file avcodec.h.

◆ active_thread_type

int AVCodecContext::active_thread_type

Which multithreading methods are in use by the codec.

encoding: Set by libavcodec.
decoding: Set by libavcodec.

Definition at line 1482 of file avcodec.h.

◆ thread_safe_callbacks

attribute_deprecated int AVCodecContext::thread_safe_callbacks

Set by the client if its custom get_buffer() callback can be called synchronously from another thread, which allows faster multithreaded decoding.

draw_horiz_band() will be called from other threads regardless of this setting. Ignored if the default get_buffer() is used.

encoding: Set by user.
decoding: Set by user.

Deprecated:
the custom get_buffer2() callback should always be thread-safe. Thread-unsafe get_buffer2() implementations will be invalid starting with LIBAVCODEC_VERSION_MAJOR=60; in other words, libavcodec will behave as if this field was always set to 1. Callers that want to be forward compatible with future libavcodec versions should wrap access to this field in #if LIBAVCODEC_VERSION_MAJOR < 60

Definition at line 1502 of file avcodec.h.

◆ execute

int(* AVCodecContext::execute) (struct AVCodecContext *c, int(*func)(struct AVCodecContext *c2, void *arg), void *arg2, int *ret, int count, int size)

The codec may call this to execute several independent things.

It will return only after finishing all tasks. The user may replace this with some multithreaded implementation, the default implementation will execute the parts serially.

Parameters

count

the number of things to execute

encoding: Set by libavcodec, user can override.
decoding: Set by libavcodec, user can override.

Definition at line 1514 of file avcodec.h.

◆ execute2

int(* AVCodecContext::execute2) (struct AVCodecContext *c, int(*func)(struct AVCodecContext *c2, void *arg, int jobnr, int threadnr), void *arg2, int *ret, int count)

The codec may call this to execute several independent things.

It will return only after finishing all tasks. The user may replace this with some multithreaded implementation, the default implementation will execute the parts serially.

Parameters

c	context passed also to func
count	the number of things to execute
arg2	argument passed unchanged to func
ret	return values of executed functions, must have space for "count" values. May be NULL.
func	function that will be called count times, with jobnr from 0 to count-1. threadnr will be in the range 0 to c->thread_count-1 < MAX_THREADS and so that no two instances of func executing at the same time will have the same threadnr.

Returns

always 0 currently, but code should handle a future improvement where when any call to func returns < 0 no further calls to func may be done and < 0 is returned.

encoding: Set by libavcodec, user can override.
decoding: Set by libavcodec, user can override.

Definition at line 1533 of file avcodec.h.

◆ nsse_weight

int AVCodecContext::nsse_weight

noise vs.

sse weight for the nsse comparison function

encoding: Set by user.
decoding: unused

Definition at line 1540 of file avcodec.h.

◆ profile

int AVCodecContext::profile

profile

encoding: Set by user.
decoding: Set by libavcodec.

Definition at line 1547 of file avcodec.h.

◆ level

int AVCodecContext::level

level

encoding: Set by user.
decoding: Set by libavcodec.

Definition at line 1673 of file avcodec.h.

◆ skip_loop_filter

enum AVDiscard AVCodecContext::skip_loop_filter

Skip loop filtering for selected frames.

encoding: unused
decoding: Set by user.

Definition at line 1681 of file avcodec.h.

◆ skip_idct

enum AVDiscard AVCodecContext::skip_idct

Skip IDCT/dequantization for selected frames.

encoding: unused
decoding: Set by user.

Definition at line 1688 of file avcodec.h.

◆ skip_frame

enum AVDiscard AVCodecContext::skip_frame

Skip decoding for selected frames.

encoding: unused
decoding: Set by user.

Definition at line 1695 of file avcodec.h.

◆ subtitle_header

uint8_t* AVCodecContext::subtitle_header

Header containing style information for text subtitles.

For SUBTITLE_ASS subtitle type, it should contain the whole ASS [Script Info] and [V4+ Styles] section, plus the [Events] line and the Format line following. It shouldn't include any Dialogue line.

encoding: Set/allocated/freed by user (before avcodec_open2())
decoding: Set/allocated/freed by libavcodec (by avcodec_open2())

Definition at line 1705 of file avcodec.h.

◆ subtitle_header_size

int AVCodecContext::subtitle_header_size

Definition at line 1706 of file avcodec.h.

◆ initial_padding

int AVCodecContext::initial_padding

Audio only.

The number of "priming" samples (padding) inserted by the encoder at the beginning of the audio. I.e. this number of leading decoded samples must be discarded by the caller to get the original audio without leading padding.

decoding: unused
encoding: Set by libavcodec. The timestamps on the output packets are adjusted by the encoder so that they always refer to the first sample of the data actually contained in the packet, including any added padding. E.g. if the timebase is 1/samplerate and the timestamp of the first input sample is 0, the timestamp of the first output packet will be -initial_padding.

Definition at line 1723 of file avcodec.h.

◆ framerate

AVRational AVCodecContext::framerate

decoding: For codecs that store a framerate value in the compressed bitstream, the decoder may export it here. { 0, 1} when unknown.
encoding: May be used to signal the framerate of CFR content to an encoder.

Examples: encode_video.c, transcoding.c, vaapi_encode.c, and vaapi_transcode.c.

Definition at line 1732 of file avcodec.h.

Referenced by dec_enc(), main(), open_input_file(), and open_output_file().

◆ sw_pix_fmt

enum AVPixelFormat AVCodecContext::sw_pix_fmt

Nominal unaccelerated pixel format, see AV_PIX_FMT_xxx.

encoding: unused.
decoding: Set by libavcodec before calling get_format()

Definition at line 1739 of file avcodec.h.

◆ pkt_timebase

AVRational AVCodecContext::pkt_timebase

Timebase in which pkt_dts/pts and AVPacket.dts/pts are.

encoding unused.
decoding set by user.

Examples: transcode_aac.c.

Definition at line 1746 of file avcodec.h.

Referenced by open_input_file().

◆ codec_descriptor

const AVCodecDescriptor* AVCodecContext::codec_descriptor

AVCodecDescriptor.

encoding: unused.
decoding: set by libavcodec.

Definition at line 1753 of file avcodec.h.

◆ pts_correction_num_faulty_pts

int64_t AVCodecContext::pts_correction_num_faulty_pts

Current statistics for PTS correction.

decoding: maintained and used by libavcodec, not intended to be used by user apps
encoding: unused

Definition at line 1760 of file avcodec.h.

◆ pts_correction_num_faulty_dts

int64_t AVCodecContext::pts_correction_num_faulty_dts

Number of incorrect PTS values so far.

Definition at line 1761 of file avcodec.h.

◆ pts_correction_last_pts

int64_t AVCodecContext::pts_correction_last_pts

Number of incorrect DTS values so far.

Definition at line 1762 of file avcodec.h.

◆ pts_correction_last_dts

int64_t AVCodecContext::pts_correction_last_dts

PTS of the last frame.

Definition at line 1763 of file avcodec.h.

◆ sub_charenc

char* AVCodecContext::sub_charenc

DTS of the last frame.

Character encoding of the input subtitles file.

decoding: set by user
encoding: unused

Definition at line 1770 of file avcodec.h.

◆ sub_charenc_mode

int AVCodecContext::sub_charenc_mode

Subtitles character encoding mode.

Formats or codecs might be adjusting this setting (if they are doing the conversion themselves for instance).

decoding: set by libavcodec
encoding: unused

Definition at line 1778 of file avcodec.h.

◆ skip_alpha

int AVCodecContext::skip_alpha

Skip processing alpha if supported by codec.

Note that if the format uses pre-multiplied alpha (common with VP6, and recommended due to better video quality/compression) the image will look as if alpha-blended onto a black background. However for formats that do not use pre-multiplied alpha there might be serious artefacts (though e.g. libswscale currently assumes pre-multiplied alpha anyway).

decoding: set by user
encoding: unused

Definition at line 1796 of file avcodec.h.

◆ seek_preroll

int AVCodecContext::seek_preroll

Number of samples to skip after a discontinuity.

decoding: unused
encoding: set by libavcodec

Definition at line 1803 of file avcodec.h.

◆ debug_mv

attribute_deprecated int AVCodecContext::debug_mv

Deprecated:: unused

Definition at line 1810 of file avcodec.h.

◆ chroma_intra_matrix

uint16_t* AVCodecContext::chroma_intra_matrix

custom intra quantization matrix

encoding: Set by user, can be NULL.
decoding: unused.

Definition at line 1821 of file avcodec.h.

◆ dump_separator

uint8_t* AVCodecContext::dump_separator

dump format separator.

can be ", " or "\n " or anything else

encoding: Set by user.
decoding: Set by user.

Definition at line 1829 of file avcodec.h.

◆ codec_whitelist

char* AVCodecContext::codec_whitelist

',' separated list of allowed decoders.

If NULL then all are allowed

encoding: unused
decoding: set by user

Definition at line 1837 of file avcodec.h.

◆ properties

unsigned AVCodecContext::properties

Properties of the stream that gets decoded.

encoding: unused
decoding: set by libavcodec

Definition at line 1844 of file avcodec.h.

◆ coded_side_data

AVPacketSideData* AVCodecContext::coded_side_data

Additional data associated with the entire coded stream.

decoding: unused
encoding: may be set by libavcodec after avcodec_open2().

Definition at line 1855 of file avcodec.h.

◆ nb_coded_side_data

int AVCodecContext::nb_coded_side_data

Definition at line 1856 of file avcodec.h.

◆ hw_frames_ctx

AVBufferRef* AVCodecContext::hw_frames_ctx

A reference to the AVHWFramesContext describing the input (for encoding) or output (decoding) frames.

The reference is set by the caller and afterwards owned (and freed) by libavcodec - it should never be read by the caller after being set.

decoding: This field should be set by the caller from the get_format() callback. The previous reference (if any) will always be unreffed by libavcodec before the get_format() call.

If the default get_buffer2() is used with a hwaccel pixel format, then this AVHWFramesContext will be used for allocating the frame buffers.
encoding: For hardware encoders configured to use a hwaccel pixel format, this field should be set by the caller to a reference to the AVHWFramesContext describing input frames. AVHWFramesContext.format must be equal to AVCodecContext.pix_fmt.

This field should be set before avcodec_open2() is called.

Examples: vaapi_encode.c, and vaapi_transcode.c.

Definition at line 1880 of file avcodec.h.

Referenced by dec_enc(), main(), and set_hwframe_ctx().

◆ sub_text_format

attribute_deprecated int AVCodecContext::sub_text_format

Deprecated:: unused

Definition at line 1887 of file avcodec.h.

◆ trailing_padding

int AVCodecContext::trailing_padding

Audio only.

The amount of padding (in samples) appended by the encoder to the end of the audio. I.e. this number of decoded samples must be discarded by the caller from the end of the stream to get the original audio without any trailing padding.

decoding: unused
encoding: unused

Definition at line 1900 of file avcodec.h.

◆ max_pixels

int64_t AVCodecContext::max_pixels

The number of pixels per image to maximally accept.

decoding: set by user
encoding: set by user

Definition at line 1908 of file avcodec.h.

◆ hw_device_ctx

AVBufferRef* AVCodecContext::hw_device_ctx

A reference to the AVHWDeviceContext describing the device which will be used by a hardware encoder/decoder.

The reference is set by the caller and afterwards owned (and freed) by libavcodec.

This should be used if either the codec device does not require hardware frames or any that are used are to be allocated internally by libavcodec. If the user wishes to supply any of the frames used as encoder input or decoder output then hw_frames_ctx should be used instead. When hw_frames_ctx is set in get_format() for a decoder, this field will be ignored while decoding the associated stream segment, but may again be used on a following one after another get_format() call.

For both encoders and decoders this field should be set before avcodec_open2() is called and must not be written to thereafter.

Note that some decoders may require this field to be set initially in order to support hw_frames_ctx at all - in that case, all frames contexts used must be created on the same device.

Examples: hw_decode.c, qsvdec.c, and vaapi_transcode.c.

Definition at line 1930 of file avcodec.h.

Referenced by hw_decoder_init(), main(), and open_input_file().

◆ hwaccel_flags

int AVCodecContext::hwaccel_flags

Bit set of AV_HWACCEL_FLAG_* flags, which affect hardware accelerated decoding (if active).

encoding: unused
decoding: Set by user (either before avcodec_open2(), or in the AVCodecContext.get_format callback)

Definition at line 1939 of file avcodec.h.

◆ apply_cropping

int AVCodecContext::apply_cropping

Video decoding only.

Certain video codecs support cropping, meaning that only a sub-rectangle of the decoded frame is intended for display. This option controls how cropping is handled by libavcodec.

When set to 1 (the default), libavcodec will apply cropping internally. I.e. it will modify the output frame width/height fields and offset the data pointers (only by as much as possible while preserving alignment, or by the full amount if the AV_CODEC_FLAG_UNALIGNED flag is set) so that the frames output by the decoder refer only to the cropped area. The crop_* fields of the output frames will be zero.

When set to 0, the width/height fields of the output frames will be set to the coded dimensions and the crop_* fields will describe the cropping rectangle. Applying the cropping is left to the caller.

Warning: When hardware acceleration with opaque output frames is used, libavcodec is unable to apply cropping from the top/left border.

Note: when this option is set to zero, the width/height fields of the AVCodecContext and output AVFrames have different meanings. The codec context fields store display dimensions (with the coded dimensions in coded_width/height), while the frame fields store the coded dimensions (with the display dimensions being determined by the crop_* fields).

Definition at line 1966 of file avcodec.h.

◆ extra_hw_frames

int AVCodecContext::extra_hw_frames

Definition at line 1980 of file avcodec.h.

◆ discard_damaged_percentage

int AVCodecContext::discard_damaged_percentage

The percentage of damaged samples to discard a frame.

decoding: set by user
encoding: unused

Definition at line 1988 of file avcodec.h.

◆ max_samples

int64_t AVCodecContext::max_samples

The number of samples per frame to maximally accept.

decoding: set by user
encoding: set by user

Definition at line 1996 of file avcodec.h.

◆ export_side_data

int AVCodecContext::export_side_data

Bit set of AV_CODEC_EXPORT_DATA_* flags, which affects the kind of metadata exported in frame, packet, or coded stream side data by decoders and encoders.

decoding: set by user
encoding: set by user

Definition at line 2006 of file avcodec.h.

◆ get_encode_buffer

int(* AVCodecContext::get_encode_buffer) (struct AVCodecContext *s, AVPacket *pkt, int flags)

This callback is called at the beginning of each packet to get a data buffer for it.

The following field will be set in the packet before this callback is called:

size This callback must use the above value to calculate the required buffer size, which must padded by at least AV_INPUT_BUFFER_PADDING_SIZE bytes.

In some specific cases, the encoder may not use the entire buffer allocated by this callback. This will be reflected in the size value in the packet once returned by avcodec_receive_packet().

This callback must fill the following fields in the packet:

data: alignment requirements for AVPacket apply, if any. Some architectures and encoders may benefit from having aligned data.
buf: must contain a pointer to an AVBufferRef structure. The packet's data pointer must be contained in it. See: av_buffer_create(), av_buffer_alloc(), and av_buffer_ref().

If AV_CODEC_CAP_DR1 is not set then get_encode_buffer() must call avcodec_default_get_encode_buffer() instead of providing a buffer allocated by some other means.

The flags field may contain a combination of AV_GET_ENCODE_BUFFER_FLAG_ flags. They may be used for example to hint what use the buffer may get after being created. Implementations of this callback may ignore flags they don't understand. If AV_GET_ENCODE_BUFFER_FLAG_REF is set in flags then the packet may be reused (read and/or written to if it is writable) later by libavcodec.

This callback must be thread-safe, as when frame threading is used, it may be called from multiple threads simultaneously.

See also: avcodec_default_get_encode_buffer()

encoding: Set by libavcodec, user can override.
decoding: unused

Definition at line 2048 of file avcodec.h.

◆ ch_layout

AVChannelLayout AVCodecContext::ch_layout

Audio channel layout.

encoding: must be set by the caller, to one of AVCodec.ch_layouts.
decoding: may be set by the caller if known e.g. from the container. The decoder can then override during decoding as needed.

Examples: decode_audio.c, demuxing_decoding.c, encode_audio.c, filtering_audio.c, muxing.c, transcode_aac.c, and transcoding.c.

Definition at line 2056 of file avcodec.h.

Referenced by add_stream(), decode(), init_converted_samples(), init_fifo(), init_filter(), init_filters(), init_output_frame(), init_resampler(), main(), open_audio(), and open_output_file().

The documentation for this struct was generated from the following file:

libavcodec/avcodec.h

height	the height of the slice
y	the y position of the slice
type	1->top field, 2->bottom field, 3->frame
offset	offset into the AVFrame.data from which the slice should be read

Data Fields

Detailed Description

Field Documentation

◆ av_class

◆ log_level_offset

◆ codec_type

◆ codec

◆ codec_id

◆ codec_tag

◆ priv_data

◆ internal

◆ opaque

◆ bit_rate

◆ bit_rate_tolerance

◆ global_quality

◆ compression_level

◆ flags

◆ flags2

◆ extradata

◆ extradata_size

◆ time_base

◆ ticks_per_frame

◆ delay

◆ width

◆ height

◆ coded_width

◆ coded_height

◆ gop_size

◆ pix_fmt

◆ draw_horiz_band

◆ get_format

◆ max_b_frames

◆ b_quant_factor

◆ b_quant_offset

◆ has_b_frames

◆ i_quant_factor

◆ i_quant_offset

◆ lumi_masking

◆ temporal_cplx_masking

◆ spatial_cplx_masking

◆ p_masking

◆ dark_masking

◆ slice_count

◆ slice_offset

◆ sample_aspect_ratio

◆ me_cmp

◆ me_sub_cmp

◆ mb_cmp

◆ ildct_cmp

◆ dia_size

◆ last_predictor_count

◆ me_pre_cmp

◆ pre_dia_size

◆ me_subpel_quality

◆ me_range

◆ slice_flags

◆ mb_decision

◆ intra_matrix

◆ inter_matrix

◆ intra_dc_precision

◆ skip_top

◆ skip_bottom

◆ mb_lmin

◆ mb_lmax

◆ bidir_refine

◆ keyint_min

◆ refs

◆ mv0_threshold

◆ color_primaries

◆ color_trc

◆ colorspace

◆ color_range

◆ chroma_sample_location

◆ slices

◆ field_order

◆ sample_rate

◆ channels

◆ sample_fmt

◆ frame_size

◆ frame_number