internal.h File Reference

common internal API header More...

#include <limits.h>
#include <stdint.h>
#include <stddef.h>
#include <assert.h>
#include "config.h"
#include "attributes.h"
#include "timer.h"
#include "cpu.h"
#include "dict.h"
#include "pixfmt.h"
#include "version.h"
#include "libm.h"

Go to the source code of this file.

Macros
#define	NDEBUG
#define	av_export
#define	FF_DISABLE_DEPRECATION_WARNINGS
#define	FF_ENABLE_DEPRECATION_WARNINGS
#define	FF_MEMORY_POISON   0x2a
#define	MAKE_ACCESSORS(str, name, type, field)
#define	E1(x)   x
#define	AV_CHECK_OFFSET(s, m, o)
#define	LOCAL_ALIGNED_A(a, t, v, s, o,...)
#define	LOCAL_ALIGNED_D(a, t, v, s, o,...)
#define	LOCAL_ALIGNED(a, t, v,...)   E1(LOCAL_ALIGNED_A(a, t, v, __VA_ARGS__,,))
#define	LOCAL_ALIGNED_8(t, v,...)   LOCAL_ALIGNED(8, t, v, __VA_ARGS__)
#define	LOCAL_ALIGNED_16(t, v,...)   LOCAL_ALIGNED(16, t, v, __VA_ARGS__)
#define	LOCAL_ALIGNED_32(t, v,...)   LOCAL_ALIGNED(32, t, v, __VA_ARGS__)
#define	FF_ALLOC_OR_GOTO(ctx, p, size, label)
#define	FF_ALLOCZ_OR_GOTO(ctx, p, size, label)
#define	FF_ALLOC_ARRAY_OR_GOTO(ctx, p, nelem, elsize, label)
#define	FF_ALLOCZ_ARRAY_OR_GOTO(ctx, p, nelem, elsize, label)
#define	NULL_IF_CONFIG_SMALL(x)   x
	Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. More...
#define	ONLY_IF_THREADS_ENABLED(x)   NULL
	Define a function with only the non-default version specified. More...
#define	PTRDIFF_SPECIFIER   "td"
#define	SIZE_SPECIFIER   "zu"
#define	ff_dlog(ctx,...)   do { if (0) av_log(ctx, AV_LOG_DEBUG, __VA_ARGS__); } while (0)

Functions
void	avpriv_report_missing_feature (void *avc, const char *msg,...) av_printf_format(2
	Log a generic warning message about a missing feature. More...
void void	avpriv_request_sample (void *avc, const char *msg,...) av_printf_format(2
	Log a generic warning message about a missing feature. More...
int	avpriv_open (const char *filename, int flags,...)
	A wrapper for open() setting O_CLOEXEC. More...
int	avpriv_set_systematic_pal2 (uint32_t pal[256], enum AVPixelFormat pix_fmt)
static av_always_inline av_const int	avpriv_mirror (int x, int w)
uint64_t	ff_get_channel_layout (const char *name, int compat)
void	ff_check_pixfmt_descriptors (void)

Variables
const uint8_t	ff_reverse [256]

Detailed Description

common internal API header

Definition in file internal.h.

Macro Definition Documentation

#define NDEBUG

Definition at line 30 of file internal.h.

#define av_export

Definition at line 64 of file internal.h.

#define FF_DISABLE_DEPRECATION_WARNINGS

Definition at line 79 of file internal.h.

Referenced by ac3_decode_init(), asf_parse_packet(), av_dup_packet(), av_free_packet(), av_grow_packet(), av_init_packet(), av_new_packet(), av_packet_from_data(), av_packet_merge_side_data(), avcodec_close(), avcodec_copy_context(), avcodec_decode_audio3(), avcodec_default_get_buffer2(), avcodec_encode_audio(), avcodec_encode_audio2(), avcodec_encode_video(), avcodec_encode_video2(), avcodec_open2(), avfilter_graph_alloc_filter(), bmp_encode_frame(), copy_packet_data(), dca_decode_frame(), dca_decode_init(), decode_registered_user_data_afd(), dnxhd_encode_init(), dnxhd_encode_picture(), dnxhd_load_picture(), dvvideo_encode_frame(), encode_frame(), encode_init(), encode_init_ls(), ff_aac_ac3_parse(), ff_alloc_packet2(), ff_filter_alloc(), ff_init_me(), ff_insert_inpad(), ff_insert_outpad(), ff_interleave_add_packet(), ff_mpv_encode_init(), ff_rate_control_init(), ff_thread_can_start_frame(), ff_thread_release_buffer(), ff_vdpau_common_end_frame(), ff_write_chained(), filter_packet(), flashsv_encode_frame(), frame_copy_props(), frame_end(), frame_worker_thread(), get_buffer_internal(), gif_encode_init(), iec61883_parse_queue_dv(), init_muxer(), libschroedinger_encode_frame(), libx265_encode_frame(), ljpeg_encode_init(), mlp_parse(), mmap_read_frame(), mpeg_decode_user_data(), mxg_read_packet(), pam_encode_init(), parse_packet(), pcx_encode_init(), png_enc_init(), pnm_encode_init(), process_output_surface(), qtrle_encode_frame(), raw_encode_init(), read_restart_header(), rm_assemble_video_frame(), setup_hwaccel_for_pixfmt(), storeframe(), str_read_packet(), submit_packet(), svq1_encode_frame(), svq1_encode_plane(), targa_encode_init(), thread_get_buffer_internal(), update_context_from_thread(), update_context_from_user(), utvideo_encode_frame(), v410_encode_frame(), v4l2_read_packet(), vpx_init(), write_frame(), X264_frame(), X264_init(), XAVS_frame(), XAVS_init(), xvid_encode_frame(), xvid_encode_init(), and yop_read_packet().

#define FF_ENABLE_DEPRECATION_WARNINGS

Definition at line 80 of file internal.h.

Referenced by ac3_decode_init(), asf_parse_packet(), av_dup_packet(), av_free_packet(), av_grow_packet(), av_init_packet(), av_new_packet(), av_packet_from_data(), av_packet_merge_side_data(), avcodec_close(), avcodec_copy_context(), avcodec_decode_audio3(), avcodec_default_get_buffer2(), avcodec_encode_audio(), avcodec_encode_audio2(), avcodec_encode_video(), avcodec_encode_video2(), avcodec_open2(), avfilter_graph_alloc_filter(), bmp_encode_frame(), copy_packet_data(), dca_decode_frame(), dca_decode_init(), decode_registered_user_data_afd(), dnxhd_encode_init(), dnxhd_encode_picture(), dnxhd_load_picture(), dvvideo_encode_frame(), encode_frame(), encode_init(), encode_init_ls(), ff_aac_ac3_parse(), ff_alloc_packet2(), ff_filter_alloc(), ff_init_me(), ff_insert_inpad(), ff_insert_outpad(), ff_interleave_add_packet(), ff_mpv_encode_init(), ff_rate_control_init(), ff_thread_can_start_frame(), ff_thread_release_buffer(), ff_vdpau_common_end_frame(), ff_write_chained(), filter_packet(), flashsv_encode_frame(), frame_copy_props(), frame_end(), frame_worker_thread(), get_buffer_internal(), gif_encode_init(), iec61883_parse_queue_dv(), init_muxer(), libschroedinger_encode_frame(), libx265_encode_frame(), ljpeg_encode_init(), mlp_parse(), mmap_read_frame(), mpeg_decode_user_data(), mxg_read_packet(), pam_encode_init(), parse_packet(), pcx_encode_init(), png_enc_init(), pnm_encode_init(), process_output_surface(), qtrle_encode_frame(), raw_encode_init(), read_restart_header(), rm_assemble_video_frame(), setup_hwaccel_for_pixfmt(), storeframe(), str_read_packet(), submit_packet(), svq1_encode_frame(), svq1_encode_plane(), targa_encode_init(), thread_get_buffer_internal(), update_context_from_thread(), update_context_from_user(), utvideo_encode_frame(), v410_encode_frame(), v4l2_read_packet(), vpx_init(), write_frame(), X264_frame(), X264_init(), XAVS_frame(), XAVS_init(), xvid_encode_frame(), xvid_encode_init(), and yop_read_packet().

#define FF_MEMORY_POISON   0x2a

Definition at line 84 of file internal.h.

Referenced by av_dynarray2_add(), av_malloc(), and pool_release_buffer().

#define MAKE_ACCESSORS	(		str,
			name,
			type,
			field
	)

Value:

type av_##name##_get_##field(const str *s) { return s->field; } \
    void av_##name##_set_##field(str *s, type v) { s->field = v; }

Definition at line 86 of file internal.h.

#define E1

(

x

)

x

Definition at line 92 of file internal.h.

#define AV_CHECK_OFFSET	(		s,
			m,
			o
	)

Value:

struct check_##o {    \
        int x_##o[offsetof(s, m) == o? 1: -1];         \
    }

Definition at line 97 of file internal.h.

#define LOCAL_ALIGNED_A	(		a,
			t,
			v,
			s,
			o,
			...
	)

Value:

uint8_t la_##v[sizeof(t s o) + (a)];                \
    t (*v) o = (void *)FFALIGN((uintptr_t)la_##v, a)

Definition at line 101 of file internal.h.

#define LOCAL_ALIGNED_D	(		a,
			t,
			v,
			s,
			o,
			...
	)

Value:

DECLARE_ALIGNED(a, t, la_##v) s o;                  \
    t (*v) o = la_##v

Definition at line 105 of file internal.h.

#define LOCAL_ALIGNED	(		a,
			t,
			v,
			...
	)		E1(LOCAL_ALIGNED_A(a, t, v, __VA_ARGS__,,))

Definition at line 109 of file internal.h.

Referenced by do_hybrid_window(), encode_slice_plane(), ff_atrac3p_ipqf(), ff_h264_filter_mb(), ff_hevc_luma_mv_merge_mode(), ff_lpc_calc_coefs(), ff_prores_idct_wrap(), filter_mb_dir(), h264_filter_mb_fast_internal(), and intra_predict().

#define LOCAL_ALIGNED_8	(		t,
			v,
			...
	)		LOCAL_ALIGNED(8, t, v, __VA_ARGS__)

Definition at line 114 of file internal.h.

Referenced by apply_obmc(), and dv_encode_video_segment().

#define LOCAL_ALIGNED_16	(		t,
			v,
			...
	)		LOCAL_ALIGNED(16, t, v, __VA_ARGS__)

Definition at line 120 of file internal.h.

Referenced by apply_channel_coupling(), bink_decode_plane(), binkb_decode_plane(), bit8x8_c(), checkasm_check_bswapdsp(), checkasm_check_h264pred(), checkasm_check_h264qpel(), count_mantissa_bits(), dca_subsubframe(), dct_max8x8_c(), dct_quantize_refine(), dct_quantize_TMPL(), dct_sad8x8_c(), decode_slice_alpha(), decode_slice_chroma(), decode_slice_luma(), decorrelation(), dnxhd_calc_bits_thread(), dv_decode_video_segment(), dv_init_enc_block(), ff_check_alignment(), h263_skip_b_part(), hybrid6_cx(), imc_decode_frame(), mpc7_decode_init(), quant_psnr8x8_c(), rd8x8_c(), rv34_decode_inter_macroblock(), rv34_output_i16x16(), sbr_hf_assemble(), sbr_hf_inverse_filter(), and stereo_processing().

#define LOCAL_ALIGNED_32	(		t,
			v,
			...
	)		LOCAL_ALIGNED(32, t, v, __VA_ARGS__)

Definition at line 126 of file internal.h.

Referenced by intra_recon().

#define FF_ALLOC_OR_GOTO	(		ctx,
			p,
			size,
			label
	)

Value:

{\
    p = av_malloc(size);\
    if (!(p) && (size) != 0) {\
        av_log(ctx, AV_LOG_ERROR, "Cannot allocate memory.\n");\
        goto label;\
    }\
}

Definition at line 129 of file internal.h.

Referenced by adpcm_encode_frame(), adpcm_encode_init(), allocate_buffers(), allocate_sample_buffers(), ape_decode_init(), ff_h264_slice_context_init(), ff_iir_filter_init_coeffs(), ff_snow_common_init_after_header(), init_context_frame(), and sws_init_context().

#define FF_ALLOCZ_OR_GOTO	(		ctx,
			p,
			size,
			label
	)

Value:

{\
    p = av_mallocz(size);\
    if (!(p) && (size) != 0) {\
        av_log(ctx, AV_LOG_ERROR, "Cannot allocate memory.\n");\
        goto label;\
    }\
}

Definition at line 138 of file internal.h.

Referenced by alloc_buffers(), allocate_sample_buffers(), dnxhd_encode_init(), dnxhd_init_vlc(), ff_h264_alloc_tables(), ff_h264_slice_context_init(), ff_iir_filter_init_coeffs(), ff_mpv_common_init(), ff_mpv_encode_init(), init_context_frame(), init_duplicate_context(), and sws_init_context().

#define FF_ALLOC_ARRAY_OR_GOTO	(		ctx,
			p,
			nelem,
			elsize,
			label
	)

Value:

{\
    p = av_malloc_array(nelem, elsize);\
    if (!p) {\
        av_log(ctx, AV_LOG_ERROR, "Cannot allocate memory.\n");\
        goto label;\
    }\
}

Definition at line 147 of file internal.h.

Referenced by adpcm_encode_frame(), allocate_buffers(), allocate_sample_buffers(), init_mdct_win(), initFilter(), and mca().

#define FF_ALLOCZ_ARRAY_OR_GOTO	(		ctx,
			p,
			nelem,
			elsize,
			label
	)

Value:

{\
    p = av_mallocz_array(nelem, elsize);\
    if (!p) {\
        av_log(ctx, AV_LOG_ERROR, "Cannot allocate memory.\n");\
        goto label;\
    }\
}

Definition at line 156 of file internal.h.

Referenced by alloc_buffers(), allocate_buffers(), dnxhd_init_qmat(), dnxhd_init_rc(), dnxhd_init_vlc(), ff_h264_alloc_tables(), ff_mpeg_framesize_alloc(), ff_snow_common_init_after_header(), initFilter(), and mca().

#define NULL_IF_CONFIG_SMALL

(

x

)

x

Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.

Used to disable the definition of strings (for example AVCodec long_names).

Definition at line 175 of file internal.h.

Referenced by mpeg12_class().

#define ONLY_IF_THREADS_ENABLED

(

x

)

NULL

Define a function with only the non-default version specified.

On systems with ELF shared libraries, all symbols exported from FFmpeg libraries are tagged with the name and major version of the library to which they belong. If a function is moved from one library to another, a wrapper must be retained in the original location to preserve binary compatibility.

Functions defined with this macro will never be used to resolve symbols by the build-time linker.

Parameters

type	return type of function
name	name of function
args	argument list of function
ver	version tag to assign function Return NULL if a threading library has not been enabled. Used to disable threading functions in AVCodec definitions when not needed.

Definition at line 214 of file internal.h.

#define PTRDIFF_SPECIFIER   "td"

Definition at line 249 of file internal.h.

Referenced by decode_cblk(), decode_chunks(), decode_slice(), encode_dvd_subtitles(), ff_mjpeg_decode_frame(), ff_mjpeg_find_marker(), ff_vorbis_comment(), flac_parse(), load_input_picture(), parse_packed_headers(), wma_decode_superframe(), zmbv_decode_xor_16(), zmbv_decode_xor_32(), and zmbv_decode_xor_8().

#define SIZE_SPECIFIER   "zu"

Definition at line 250 of file internal.h.

Referenced by ape_read_header(), dump_enc_cfg(), get_http_header_data(), get_tcp_server_response(), jpeg2000_decode_packet(), queue_frames(), read_data_packet(), read_geobtag(), and vpx_init().

#define ff_dlog	(		ctx,
			...
	)		do { if (0) av_log(ctx, AV_LOG_DEBUG, __VA_ARGS__); } while (0)

Definition at line 256 of file internal.h.

Function Documentation

void avpriv_report_missing_feature	(	void *	avc,
		const char *	msg,
			...
	)

Log a generic warning message about a missing feature.

Parameters

[in]	avc	a pointer to an arbitrary struct of which the first field is a pointer to an AVClass struct
[in]	msg	string containing the name of the missing feature

Referenced by aac_adtstoasc_filter(), amr_decode_fix_avctx(), amrnb_decode_frame(), amrnb_decode_init(), amrwb_decode_init(), atrac3p_decode_frame(), cpia_decode_frame(), decode_audio_specific_config(), decode_eld_specific_config(), decode_frame(), decode_ga_specific_config(), decode_gop_header(), decode_group3_2d_line(), decode_header(), decode_seq_header(), decode_subframe(), decode_tones_info(), ff_dca_xll_decode_header(), ff_get_wav_header(), ff_ivi_decode_frame(), ff_jpegls_decode_picture(), ff_mjpeg_decode_sof(), ff_rv10_encode_picture_header(), ff_spdif_read_packet(), ff_vc1_parse_frame_header_adv(), g2m_load_cursor(), handle_id3(), hevc_handle_packet(), mpegaudio_parse(), ogg_replace_stream(), old_codec37(), old_codec47(), parse_adts_frame_header(), parse_MP4SLDescrTag(), qdm2_decode_init(), read_frame_header(), read_sbr_extension(), rpl_read_header(), rso_read_header(), tiff_decode_tag(), vp6_parse_header(), vp9_handle_packet(), vqa_decode_init(), xcbgrab_read_header(), and xwd_decode_frame().

void void avpriv_request_sample	(	void *	avc,
		const char *	msg,
			...
	)

Log a generic warning message about a missing feature.

Additionally request that a sample showcasing the feature be uploaded.

Parameters

[in]	avc	a pointer to an arbitrary struct of which the first field is a pointer to an AVClass struct
[in]	msg	string containing the name of the missing feature

Referenced by aac_decode_er_frame(), alac_decode_init(), amrwb_decode_frame(), ape_decode_init(), apng_read_packet(), asf_get_packet(), ast_read_header(), avi_extract_stream_metadata(), avr_read_header(), cdxl_decode_frame(), cine_read_header(), cinepak_decode(), compute_band_indexes(), cook_decode_init(), dca_decode_frame(), dca_subframe_footer(), dca_subframe_header(), decode_audio_block(), decode_band_hdr(), decode_bytes(), decode_cdlms(), decode_channel_transform(), decode_eld_specific_config(), decode_element(), decode_frame(), decode_frame_headers(), decode_ga_specific_config(), decode_ics(), decode_init(), decode_mvc2(), decode_nal_units(), decode_nop(), decode_packet(), decode_scalefactors(), decode_sgirle8(), decode_subframe(), decode_wmv9(), decode_yuv_frame(), determine_bitrate(), dsf_read_header(), dss_read_header(), dxtory_decode_v2_410(), dxtory_decode_v2_420(), dxtory_decode_v2_444(), dxtory_decode_v2_565(), dxtory_decode_v2_rgb(), dxva2_mpeg2_decode_slice(), ea_read_packet(), encode_frame(), epaf_read_header(), execute_code(), exif_add_metadata(), ff_adx_decode_header(), ff_dca_exss_parse_header(), ff_dca_xll_decode_header(), ff_eac3_parse_header(), ff_get_wav_header(), ff_h264_decode_seq_parameter_set(), ff_h264_decode_slice_header(), ff_hevc_parse_sps(), ff_jpegls_decode_lse(), ff_mjpeg_decode_sof(), ff_opus_parse_extradata(), ff_parse_mpeg2_descriptor(), ff_spdif_read_packet(), fill_coding_method_array(), flashsv_decode_frame(), flic_decode_init(), flv_read_packet(), flv_set_audio_codec(), flv_set_video_codec(), g2m_decode_frame(), get_packet_header(), get_poc(), get_siz(), handle_p_frame_apng(), hq_decode_frame(), iff_read_header(), imc_decode_init(), jp2_find_codestream(), jpeg2000_decode_packet(), lag_decode_zero_run_line(), latm_decode_audio_specific_config(), lvf_read_header(), mimic_decode_frame(), mov_build_index(), mov_read_mdhd(), mpc7_decode_init(), mpc8_decode_init(), msrle_decode_pal4(), mtv_read_header(), mv_read_header(), mxf_parse_structural_metadata(), mxf_read_packet_old(), mxf_read_primer_pack(), nist_read_header(), oma_read_header(), on2avc_decode_init(), paf_video_decode(), parse_dsd_prop(), parse_fmtp(), parse_MP4SLDescrTag(), parse_setup_header(), parse_video_var(), pix_decode_frame(), process_audio_header_eacs(), process_audio_header_elements(), process_ea_header(), process_frame_obj(), ptx_decode_frame(), qdm2_decode_init(), qt_rtp_parse_packet(), read_block_data(), read_frame(), read_header(), read_major_sync(), read_restart_header(), read_sbr_extension(), read_stream_mux_config(), read_table(), rm_read_audio_stream_info(), rm_read_header(), rpl_read_header(), rsd_read_header(), rso_read_header(), rv10_decode_init(), rv10_decode_picture_header(), save_bits(), save_subtitle_set(), scan_file(), smc_decode_stream(), smjpeg_read_header(), spdif_get_offset_and_codec(), spdif_header_dts(), spdif_header_truehd(), sunrast_decode_frame(), synth_superframe(), tdsc_load_cursor(), tdsc_parse_dtsm(), tm2_read_header(), truemotion1_decode_header(), truespeech_decode_init(), unsupported(), update_odml_entry(), vc1_decode_init(), vcr1_decode_init(), vp7_decode_frame_header(), vp8_decode_frame_header(), vqa_decode_init(), wsaud_read_header(), xa_decode(), xan_wc3_copy_pixel_run(), xmv_read_header(), xwd_decode_frame(), xwma_read_header(), and zero12v_decode_init().

int avpriv_open	(	const char *	filename,
		int	flags,
			...
	)

A wrapper for open() setting O_CLOEXEC.

Definition at line 66 of file file_open.c.

Referenced by av_file_map(), av_fopen_utf8(), bktr_init(), dv1394_read_header(), fbdev_read_header(), fbdev_write_header(), ff_fbdev_get_device_list(), ff_oss_audio_open(), and read_random().

int avpriv_set_systematic_pal2	(	uint32_t	pal[256],
		enum AVPixelFormat	pix_fmt
	)

Definition at line 152 of file imgutils.c.

Referenced by av_image_alloc(), bmp_encode_frame(), filter_frame(), gif_encode_init(), gif_write_header(), pcx_encode_frame(), raw_init_decoder(), and video_get_buffer().

static av_always_inline av_const int avpriv_mirror ( int  x, int  w  )

static

Definition at line 266 of file internal.h.

Referenced by avfilter_transform(), blur(), compose(), decompose(), spatial_compose53i_buffered_init(), spatial_compose53i_dy(), spatial_compose53i_dy_buffered(), spatial_compose53i_init(), spatial_compose53i_init2(), spatial_compose97i_buffered_init(), spatial_compose97i_dy(), spatial_compose97i_dy_buffered(), spatial_compose97i_init(), spatial_compose97i_init2(), spatial_compose_daub97i_dy(), spatial_compose_dirac53i_dy(), spatial_decompose53i(), and spatial_decompose97i().

uint64_t ff_get_channel_layout	(	const char *	name,
		int	compat
	)

Definition at line 160 of file channel_layout.c.

Referenced by av_get_channel_layout(), and av_opt_set().

void ff_check_pixfmt_descriptors

(

void

)

Definition at line 2184 of file pixdesc.c.

Variable Documentation

const uint8_t ff_reverse[256]

Definition at line 23 of file reverse.c.

Referenced by asv2_get_bits(), asv2_put_bits(), bitswap_32(), decode_frame(), deinvert_buffer(), dsd2pcm_translate(), encode_frame(), eval_expr(), fft(), inv_bits(), ir2_decode_frame(), pcm_decode_frame(), pcm_encode_frame(), s302m_decode_frame(), s302m_encode2_frame(), tiff_unpack_fax(), tiff_unpack_strip(), webp_get_vlc(), wnv1_get_code(), xbm_decode_frame(), and xbm_encode_frame().